uql-orm 0.20.1 → 0.21.0

package/dist/migrate/cli-config.js

@@ -1,8 +1,13 @@
 import { stat } from 'node:fs/promises';
 import { resolve } from 'node:path';
-import { createJiti } from 'jiti';
+/** `jiti` (1.8 MB) makes `uql.config.ts` loadable; imported here so only projects with one pay for it. */
+async function importConfig(path) {
+    const { createJiti } = await import('jiti').catch(() => {
+        throw new Error("Loading a uql config file requires 'jiti'. Run `npm i -D jiti`, or pass the config inline instead of via a config file.");
+    });
+    return createJiti(process.cwd()).import(path, { default: true });
+}
 export async function loadConfig(customPath) {
-    const jiti = createJiti(process.cwd());
     if (customPath) {
         const fullPath = resolve(process.cwd(), customPath);
         const exists = await stat(fullPath)
@@ -12,7 +17,7 @@ export async function loadConfig(customPath) {
             throw new Error(`Could not find uql configuration file at ${customPath}`);
         }
         try {
-            const config = await jiti.import(fullPath, { default: true });
+            const config = await importConfig(fullPath);
             return config;
         }
         catch (error) {
@@ -26,10 +31,9 @@ export async function loadConfig(customPath) {
             .then(() => true)
             .catch(() => false);
         if (exists) {
-            const config = await jiti.import(fullPath, { default: true });
+            const config = await importConfig(fullPath);
             return config;
         }
     }
     throw new Error('Could not find uql configuration file. Create a uql.config.ts or uql.config.js file in your project root.');
 }
-//# sourceMappingURL=cli-config.js.map

package/dist/migrate/cli.d.ts

@@ -17,4 +17,3 @@ export declare function runSync(migrator: Migrator, args: string[], config: Part
 export declare function runGenerateFromDb(migrator: Migrator, args: string[], config: Partial<Config>): Promise<void>;
 export declare function runDriftCheck(migrator: Migrator, config: Partial<Config>): Promise<void>;
 export declare function printHelp(): void;
-//# sourceMappingURL=cli.d.ts.map

package/dist/migrate/cli.js

@@ -288,8 +288,9 @@ export async function runDriftCheck(migrator, config) {
         const expectedAST = builder.fromEntities(config.entities);
         // Build actual schema from database
         const actualAST = await migrator.schemaIntrospector.introspect();
-        // Detect drift
-        const report = detectDrift(expectedAST, actualAST);
+        // Detect drift. The dialect renders canonical types as SQL - without it every type formats as
+        // `unknown` and type drift compares equal, silently reporting a mismatched column as in sync.
+        const report = detectDrift(expectedAST, actualAST, { dialect: config.pool?.dialect });
         printDriftReport(report);
     }
 }
@@ -395,4 +396,3 @@ Examples:
   uql-orm/migrate drift:check
 `);
 }
-//# sourceMappingURL=cli.js.map

package/dist/migrate/codegen/entityCodeGenerator.d.ts

@@ -134,4 +134,3 @@ export declare class EntityCodeGenerator {
  * Create an EntityCodeGenerator from SchemaAST.
  */
 export declare function createEntityCodeGenerator(ast: SchemaAST, options?: EntityCodeGeneratorOptions): EntityCodeGenerator;
-//# sourceMappingURL=entityCodeGenerator.d.ts.map

package/dist/migrate/codegen/entityCodeGenerator.js

@@ -402,4 +402,3 @@ export class EntityCodeGenerator {
 export function createEntityCodeGenerator(ast, options) {
     return new EntityCodeGenerator(ast, options);
 }
-//# sourceMappingURL=entityCodeGenerator.js.map

package/dist/migrate/codegen/entityMerger.d.ts

@@ -112,4 +112,3 @@ export declare class EntityMerger {
  * Create an EntityMerger instance.
  */
 export declare function createEntityMerger(options?: EntityMergerOptions): EntityMerger;
-//# sourceMappingURL=entityMerger.d.ts.map

package/dist/migrate/codegen/entityMerger.js

@@ -291,4 +291,3 @@ export class EntityMerger {
 export function createEntityMerger(options) {
     return new EntityMerger(options);
 }
-//# sourceMappingURL=entityMerger.js.map

package/dist/migrate/codegen/index.d.ts

@@ -8,4 +8,3 @@ export { createEntityMerger, EntityMerger, type EntityMergerOptions, type FieldT
 export { createMigrationCodeGenerator, type GeneratedMigration, MigrationCodeGenerator, type MigrationCodeOptions, } from './migrationCodeGenerator.js';
 export { buildSqlQuerierMigrationModule, EMPTY_MANUAL_MIGRATION_DOWN_INNER, EMPTY_MANUAL_MIGRATION_UP_INNER, emitSqlRunCall, emitSqlRunCalls, type SqlMigrationModuleOptions, } from './migrationFile.js';
 export { createRelationDetector, type RelationDetectorOptions, SmartRelationDetector, } from './smartRelationDetector.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/migrate/codegen/index.js

@@ -12,4 +12,3 @@ export { createMigrationCodeGenerator, MigrationCodeGenerator, } from './migrati
 export { buildSqlQuerierMigrationModule, EMPTY_MANUAL_MIGRATION_DOWN_INNER, EMPTY_MANUAL_MIGRATION_UP_INNER, emitSqlRunCall, emitSqlRunCalls, } from './migrationFile.js';
 // Smart relation detector
 export { createRelationDetector, SmartRelationDetector, } from './smartRelationDetector.js';
-//# sourceMappingURL=index.js.map

package/dist/migrate/codegen/migrationCodeGenerator.d.ts

@@ -59,4 +59,3 @@ export declare class MigrationCodeGenerator {
  * Factory function to create a MigrationCodeGenerator.
  */
 export declare function createMigrationCodeGenerator(options?: MigrationCodeOptions): MigrationCodeGenerator;
-//# sourceMappingURL=migrationCodeGenerator.d.ts.map

package/dist/migrate/codegen/migrationCodeGenerator.js

@@ -353,4 +353,3 @@ ${this.indentBlock(down, 1)}
 export function createMigrationCodeGenerator(options) {
     return new MigrationCodeGenerator(options);
 }
-//# sourceMappingURL=migrationCodeGenerator.js.map

package/dist/migrate/codegen/migrationFile.d.ts

@@ -26,4 +26,3 @@ export declare const EMPTY_MANUAL_MIGRATION_DOWN_INNER = "    // Add your rollba
  * Full contents of a `export default { async up/down(querier) { ... } }` migration module.
  */
 export declare function buildSqlQuerierMigrationModule(options: SqlMigrationModuleOptions): string;
-//# sourceMappingURL=migrationFile.d.ts.map

package/dist/migrate/codegen/migrationFile.js

@@ -45,4 +45,3 @@ ${options.downInner}
 };
 `;
 }
-//# sourceMappingURL=migrationFile.js.map

package/dist/migrate/codegen/smartRelationDetector.d.ts

@@ -45,4 +45,3 @@ export declare class SmartRelationDetector {
  * Create a SmartRelationDetector for the given AST.
  */
 export declare function createRelationDetector(ast: SchemaAST, options?: RelationDetectorOptions): SmartRelationDetector;
-//# sourceMappingURL=smartRelationDetector.d.ts.map

package/dist/migrate/codegen/smartRelationDetector.js

@@ -132,4 +132,3 @@ export class SmartRelationDetector {
 export function createRelationDetector(ast, options) {
     return new SmartRelationDetector(ast, options);
 }
-//# sourceMappingURL=smartRelationDetector.js.map

package/dist/migrate/drift/driftDetector.d.ts

@@ -77,4 +77,3 @@ export declare function createDriftDetector(expectedAST: SchemaAST, actualAST: S
  * Quick check for schema drift.
  */
 export declare function detectDrift(expectedAST: SchemaAST, actualAST: SchemaAST, options?: DriftDetectorOptions): DriftReport;
-//# sourceMappingURL=driftDetector.d.ts.map

package/dist/migrate/drift/driftDetector.js

@@ -244,4 +244,3 @@ export function detectDrift(expectedAST, actualAST, options) {
     const detector = new DriftDetector(expectedAST, actualAST, options);
     return detector.detect();
 }
-//# sourceMappingURL=driftDetector.js.map

package/dist/migrate/drift/index.d.ts

@@ -4,4 +4,3 @@
  * Detects schema drift between expected and actual database schemas.
  */
 export { createDriftDetector, DriftDetector, type DriftDetectorOptions, detectDrift, } from './driftDetector.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/migrate/drift/index.js

@@ -4,4 +4,3 @@
  * Detects schema drift between expected and actual database schemas.
  */
 export { createDriftDetector, DriftDetector, detectDrift, } from './driftDetector.js';
-//# sourceMappingURL=index.js.map

package/dist/migrate/generator/index.d.ts

@@ -1,3 +1,2 @@
 export { createSchemaGenerator, SqlSchemaGenerator } from '../schemaGenerator.js';
 export { createSchemaGeneratorAsync } from '../schemaGeneratorAsync.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/migrate/generator/index.js

@@ -1,3 +1,2 @@
 export { createSchemaGenerator, SqlSchemaGenerator } from '../schemaGenerator.js';
 export { createSchemaGeneratorAsync } from '../schemaGeneratorAsync.js';
-//# sourceMappingURL=index.js.map

package/dist/migrate/generator/mongoSchemaGenerator.d.ts

@@ -46,4 +46,3 @@ export declare class MongoSchemaGenerator extends AbstractDialect implements Sch
     generateDropForeignKeySql(): string;
     diffSchema<E>(entity: Type<E>, currentTable: TableNode | undefined): SchemaDiff | undefined;
 }
-//# sourceMappingURL=mongoSchemaGenerator.d.ts.map

package/dist/migrate/generator/mongoSchemaGenerator.js

@@ -186,4 +186,3 @@ export class MongoSchemaGenerator extends AbstractDialect {
         };
     }
 }
-//# sourceMappingURL=mongoSchemaGenerator.js.map

package/dist/migrate/index.d.ts

@@ -13,4 +13,3 @@ export { createSchemaGeneratorAsync } from './schemaGeneratorAsync.js';
 export { DatabaseMigrationStorage } from './storage/databaseStorage.js';
 export { JsonMigrationStorage } from './storage/jsonStorage.js';
 export * from './sync/index.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/migrate/index.js

@@ -20,4 +20,3 @@ export { DatabaseMigrationStorage } from './storage/databaseStorage.js';
 export { JsonMigrationStorage } from './storage/jsonStorage.js';
 // Schema sync
 export * from './sync/index.js';
-//# sourceMappingURL=index.js.map

package/dist/migrate/introspection/abstractSqlSchemaIntrospector.d.ts

@@ -75,4 +75,3 @@ export declare abstract class AbstractSqlSchemaIntrospector extends BaseSqlIntro
     /** Parse default value string to appropriate type. */
     protected abstract parseDefaultValue(defaultValue: string | null): unknown;
 }
-//# sourceMappingURL=abstractSqlSchemaIntrospector.d.ts.map

package/dist/migrate/introspection/abstractSqlSchemaIntrospector.js

@@ -158,4 +158,3 @@ export class AbstractSqlSchemaIntrospector extends BaseSqlIntrospector {
         return Number(value);
     }
 }
-//# sourceMappingURL=abstractSqlSchemaIntrospector.js.map

package/dist/migrate/introspection/baseSqlIntrospector.d.ts

@@ -23,4 +23,3 @@ export declare abstract class BaseSqlIntrospector {
     private buildIndexes;
     private columnSchemaToCanonical;
 }
-//# sourceMappingURL=baseSqlIntrospector.d.ts.map

package/dist/migrate/introspection/baseSqlIntrospector.js

@@ -129,4 +129,3 @@ export class BaseSqlIntrospector {
         };
     }
 }
-//# sourceMappingURL=baseSqlIntrospector.js.map

package/dist/migrate/introspection/index.d.ts

@@ -3,4 +3,3 @@ export * from './mongoIntrospector.js';
 export { MariadbSchemaIntrospector, MysqlSchemaIntrospector } from './mysqlIntrospector.js';
 export * from './postgresIntrospector.js';
 export * from './sqliteIntrospector.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/migrate/introspection/index.js

@@ -3,4 +3,3 @@ export * from './mongoIntrospector.js';
 export { MariadbSchemaIntrospector, MysqlSchemaIntrospector } from './mysqlIntrospector.js';
 export * from './postgresIntrospector.js';
 export * from './sqliteIntrospector.js';
-//# sourceMappingURL=index.js.map

package/dist/migrate/introspection/mongoIntrospector.d.ts

@@ -12,4 +12,3 @@ export declare class MongoSchemaIntrospector implements SchemaIntrospector {
     getTableNames(): Promise<string[]>;
     tableExists(tableName: string): Promise<boolean>;
 }
-//# sourceMappingURL=mongoIntrospector.d.ts.map

package/dist/migrate/introspection/mongoIntrospector.js

@@ -97,4 +97,3 @@ export class MongoSchemaIntrospector {
         return names.includes(tableName);
     }
 }
-//# sourceMappingURL=mongoIntrospector.js.map

package/dist/migrate/introspection/mysqlIntrospector.d.ts

@@ -54,4 +54,3 @@ type MysqlColumnRow = {
  */
 export declare const MariadbSchemaIntrospector: typeof MysqlSchemaIntrospector;
 export {};
-//# sourceMappingURL=mysqlIntrospector.d.ts.map

package/dist/migrate/introspection/mysqlIntrospector.js

@@ -167,4 +167,3 @@ export class MysqlSchemaIntrospector extends AbstractSqlSchemaIntrospector {
  * MariaDB uses the same information_schema structure as MySQL.
  */
 export const MariadbSchemaIntrospector = MysqlSchemaIntrospector;
-//# sourceMappingURL=mysqlIntrospector.js.map

package/dist/migrate/introspection/postgresIntrospector.d.ts

@@ -50,4 +50,3 @@ type PostgresColumnRow = {
     column_comment: string | null;
 };
 export {};
-//# sourceMappingURL=postgresIntrospector.d.ts.map

package/dist/migrate/introspection/postgresIntrospector.js

@@ -218,4 +218,3 @@ export class PostgresSchemaIntrospector extends AbstractSqlSchemaIntrospector {
         return columnDefault?.includes('nextval(') ?? false;
     }
 }
-//# sourceMappingURL=postgresIntrospector.js.map

package/dist/migrate/introspection/sqliteIntrospector.d.ts

@@ -55,4 +55,3 @@ type SqliteForeignKeyRow = {
     match: string;
 };
 export {};
-//# sourceMappingURL=sqliteIntrospector.d.ts.map

package/dist/migrate/introspection/sqliteIntrospector.js

@@ -180,4 +180,3 @@ export class SqliteSchemaIntrospector extends AbstractSqlSchemaIntrospector {
         return defaultValue;
     }
 }
-//# sourceMappingURL=sqliteIntrospector.js.map

package/dist/migrate/migrator.d.ts

@@ -165,4 +165,3 @@ export interface BuilderMigrationDefinition {
  * ```
  */
 export declare function defineBuilderMigration(migration: BuilderMigrationDefinition): BuilderMigrationDefinition;
-//# sourceMappingURL=migrator.d.ts.map

package/dist/migrate/migrator.js

@@ -611,4 +611,3 @@ export function defineMigration(migration) {
 export function defineBuilderMigration(migration) {
     return migration;
 }
-//# sourceMappingURL=migrator.js.map

package/dist/migrate/schemaGenerator.d.ts

@@ -139,4 +139,3 @@ export declare class SqlSchemaGenerator implements SchemaGenerator {
  * For MongoDB, use `createSchemaGeneratorAsync` from `./schemaGeneratorAsync.js` so the optional `mongodb` peer is not loaded at import time.
  */
 export declare function createSchemaGenerator(dialect: AbstractDialect, namingStrategy?: NamingStrategy, defaultForeignKeyAction?: ForeignKeyAction): SchemaGenerator | undefined;
-//# sourceMappingURL=schemaGenerator.d.ts.map

package/dist/migrate/schemaGenerator.js

@@ -709,4 +709,3 @@ export function createSchemaGenerator(dialect, namingStrategy, defaultForeignKey
     }
     return new SqlSchemaGenerator(dialect, defaultForeignKeyAction);
 }
-//# sourceMappingURL=schemaGenerator.js.map

package/dist/migrate/schemaGeneratorAsync.d.ts

@@ -6,4 +6,3 @@ import type { NamingStrategy, SchemaGenerator } from '../type/index.js';
  * `mongodb` is only loaded when this path runs. SQL dialects delegate to {@link createSchemaGenerator}.
  */
 export declare function createSchemaGeneratorAsync(dialect: AbstractDialect, namingStrategy?: NamingStrategy, defaultForeignKeyAction?: ForeignKeyAction): Promise<SchemaGenerator | undefined>;
-//# sourceMappingURL=schemaGeneratorAsync.d.ts.map

package/dist/migrate/schemaGeneratorAsync.js

@@ -10,4 +10,3 @@ export async function createSchemaGeneratorAsync(dialect, namingStrategy, defaul
     }
     return createSchemaGenerator(dialect, namingStrategy, defaultForeignKeyAction);
 }
-//# sourceMappingURL=schemaGeneratorAsync.js.map

package/dist/migrate/storage/databaseStorage.d.ts

@@ -22,4 +22,3 @@ export declare class DatabaseMigrationStorage implements MigrationStorage {
      */
     unlogWithQuerier(querier: SqlQuerier, migrationName: string): Promise<void>;
 }
-//# sourceMappingURL=databaseStorage.d.ts.map

package/dist/migrate/storage/databaseStorage.js

@@ -75,4 +75,3 @@ export class DatabaseMigrationStorage {
         await querier.run(sql, [migrationName]);
     }
 }
-//# sourceMappingURL=databaseStorage.js.map

package/dist/migrate/storage/index.d.ts

@@ -1,3 +1,2 @@
 export * from './databaseStorage.js';
 export * from './jsonStorage.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/migrate/storage/index.js

@@ -1,3 +1,2 @@
 export * from './databaseStorage.js';
 export * from './jsonStorage.js';
-//# sourceMappingURL=index.js.map

package/dist/migrate/storage/jsonStorage.d.ts

@@ -13,4 +13,3 @@ export declare class JsonMigrationStorage implements MigrationStorage {
     unlogWithQuerier(_querier: SqlQuerier, migrationName: string): Promise<void>;
     private save;
 }
-//# sourceMappingURL=jsonStorage.d.ts.map

package/dist/migrate/storage/jsonStorage.js

@@ -40,4 +40,3 @@ export class JsonMigrationStorage {
         await fs.writeFile(this.filePath, JSON.stringify(this.executedMigrations, null, 2), 'utf-8');
     }
 }
-//# sourceMappingURL=jsonStorage.js.map

package/dist/migrate/sync/index.d.ts

@@ -4,4 +4,3 @@
  * Orchestrates schema synchronization with configurable direction modes.
  */
 export { createSchemaSync, SchemaSync, type SchemaSyncOptions, type SchemaSyncResult, type SyncConflict, } from './schemaSync.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/migrate/sync/index.js

@@ -4,4 +4,3 @@
  * Orchestrates schema synchronization with configurable direction modes.
  */
 export { createSchemaSync, SchemaSync, } from './schemaSync.js';
-//# sourceMappingURL=index.js.map

package/dist/migrate/sync/schemaSync.d.ts

@@ -129,4 +129,3 @@ export declare class SchemaSync {
  * Create a SchemaSync instance.
  */
 export declare function createSchemaSync(options: SchemaSyncOptions): SchemaSync;
-//# sourceMappingURL=schemaSync.d.ts.map

package/dist/migrate/sync/schemaSync.js

@@ -257,4 +257,3 @@ export class SchemaSync {
 export function createSchemaSync(options) {
     return new SchemaSync(options);
 }
-//# sourceMappingURL=schemaSync.js.map

package/dist/mongo/index.d.ts

@@ -3,4 +3,3 @@ 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.js

@@ -3,4 +3,3 @@ export * from './mongoDialect.js';
 export * from './mongodbNativeDialect.js';
 export * from './mongodbQuerier.js';
 export * from './mongodbQuerierPool.js';
-//# sourceMappingURL=index.js.map

package/dist/mongo/mongoDialect.d.ts

@@ -1,19 +1,75 @@
 import { type Document, type Filter, ObjectId, type Sort, type UpdateFilter } from 'mongodb';
 import { AbstractDialect } from '../dialect/abstractDialect.js';
-import type { DialectFeatures, EntityMeta, FieldValue, Query, QueryAggMap, QueryAggregate, QueryExclude, QueryGroupMap, QueryOptions, QuerySelectValue, QuerySortMap, QueryVectorSearch, QueryWhere, RelationKey, Type } from '../type/index.js';
+import type { DialectFeatures, EntityMeta, FieldValue, Query, QueryAggMap, QueryAggregate, QueryExclude, QueryGroupMap, QueryOptions, QuerySelectValue, QuerySortMap, QueryVectorSearch, QueryWhere, Type } from '../type/index.js';
 import { type CallbackKey, type RelationRequestSummary } from '../util/index.js';
 /** Default {@link DialectFeatures} for MongoDB; shared by {@link MongoDialect} and its schema generator. */
 export declare const mongoDialectFeatures: DialectFeatures;
 export declare class MongoDialect extends AbstractDialect {
+    #private;
     protected readonly featureDefaults: DialectFeatures;
     readonly dialectName = "mongodb";
     readonly insertIdSource = "returning";
     private static readonly ID_KEY;
+    /** Temporary lookup fields for relation conditions, dropped with `$unset` after the `$match`. */
+    private static readonly REL_TEMP_PREFIX;
+    private static readonly REL_COUNT_KEY;
+    private static readonly REL_NESTED_KEY;
     private static readonly VECTOR_INDEX_TYPES;
     private static readonly AGGREGATE_OP_MAP;
+    /**
+     * MongoDB stores the primary key as `_id`; everything else resolves as usual. Projections, sorts,
+     * `$group` refs and `$where` keys all map through here, so no read path can address a property name
+     * the document does not use.
+     */
+    columnOf<E>(meta: EntityMeta<E>, key: string): string;
     where<E extends Document>(entity: Type<E>, where?: QueryWhere<E>, opts?: QueryOptions): Filter<E>;
-    /** Renders a `$where` tree without applying entity filters (used for same-scope `$and`/`$or` recursion). */
+    /**
+     * A `$where` that may constrain relations, split into the `$lookup` stages it needs and the `$match`
+     * filter that consumes them. Each relation condition becomes one correlated lookup into a temporary
+     * field plus an ordinary condition on that field, so the caller's boolean structure survives intact
+     * (a relation inside `$or` still means what it says) and nothing depends on materializing ids.
+     * `unset` names the temporary fields, which the caller drops once the match is done.
+     */
+    whereWithRelations<E extends Document>(entity: Type<E>, where?: QueryWhere<E>, opts?: QueryOptions): {
+        readonly stages: MongoAggregationPipelineEntry<Document>[];
+        readonly filter: Filter<E>;
+        readonly unset: string[];
+    };
+    /** Whether a `$where` constrains any relation, and so needs the aggregation path rather than a cursor. */
+    constrainsRelations<E extends Document>(entity: Type<E>, where: QueryWhere<E> | undefined): boolean;
+    /**
+     * Renders a `$where` tree without applying entity filters (used for same-scope `$and`/`$or`
+     * recursion). Relation keys need `$lookup` stages, so they are only accepted when `lookups` is
+     * given - a plain `find`/`updateMany` filter has nowhere to put them.
+     */
     private renderFilter;
+    /**
+     * Emits the correlated `$lookup` for one relation condition and returns the condition that tests its
+     * result: presence of a row for a plain relation filter, a comparison against the row count for
+     * `$size`. The target's (and, for ManyToMany, the junction's) own filters scope the lookup, so a
+     * relation subquery can no more read out-of-scope rows than a direct query on the target can.
+     */
+    private appendRelationLookup;
+    /**
+     * ManyToMany counts/tests junction rows, so the target is reached from inside the junction's own
+     * lookup - the junction's filters apply too, since a soft-deleted link is not a link.
+     */
+    private junctionLookup;
+    /**
+     * Compares the looked-up row count, which is `[{ n: <count> }]` or `[]` when nothing matched - hence
+     * the `$ifNull` fallback to 0, so `{ $size: 0 }` matches parents with no related row at all.
+     */
+    private compareRelationCount;
+    /** Whether a query subtracts `key` from the projection, via `$exclude` or a negative `$select`. */
+    private subtractsKey;
+    /** `raw()` renders SQL, so it has no MongoDB equivalent - say so instead of emitting `{}`. */
+    private assertNoRaw;
+    /**
+     * A dotted key addresses an embedded path, whose root must still be a declared field - otherwise it
+     * is a typo (or an injected key) that would silently match nothing, the same guard the SQL dialects
+     * apply to JSON paths.
+     */
+    private assertKnownPathRoot;
     protected mapTableNameRow(row: {
         table_name: string;
     }): string;
@@ -30,9 +86,35 @@ export declare class MongoDialect extends AbstractDialect {
      * else is a per-field map whose operator objects each need mapping.
      */
     private transformElemMatch;
-    select<E extends Document>(entity: Type<E>, select?: QuerySelectValue<E>, exclude?: QueryExclude<E>): Record<string, 1>;
+    select<E extends Document>(entity: Type<E>, select?: QuerySelectValue<E>, exclude?: QueryExclude<E>): Record<string, 0 | 1>;
     sort<E extends Document>(entity: Type<E>, sort?: QuerySortMap<E>): Sort;
+    /**
+     * Aggregate results are keyed by `$group`/`$agg` alias rather than by column, so an aggregate
+     * `$sort` addresses those aliases as-is - the same reason the SQL dialects sort by alias there.
+     */
+    private aliasSort;
+    /** Shared direction normalization; `mapKey` decides whether keys are columns or aggregate aliases. */
+    private sortBy;
+    /**
+     * {@link columnOf} for a possibly dotted key: only the root is a field key, the rest addresses an
+     * embedded path (`kind.city` -> `<kind's column>.city`).
+     */
+    private pathOf;
     aggregationPipeline<E extends Document>(entity: Type<E>, q: Query<E>, relationSummary?: RelationRequestSummary<E>, opts?: QueryOptions): MongoAggregationPipelineEntry<E>[];
+    /**
+     * `$lookup`/`$unwind` stages for the joinable relations a query populates. Shared by the plain
+     * aggregation pipeline and the `$vectorSearch` one, so relations load the same way in both.
+     */
+    relationStages<E extends Document>(entity: Type<E>, q: Query<E>, relationSummary?: RelationRequestSummary<E>, opts?: QueryOptions): MongoAggregationPipelineEntry<E>[];
+    /**
+     * The correlated join for a single-valued or one-to-many relation. MongoDB runs a lookup's `pipeline`
+     * after its own localField/foreignField match, so the target's filters layer on top of the join
+     * condition with no `let`/`$expr` rewrite: m1 joins the parent's FK to the target's `_id`, every other
+     * direction joins the parent's `_id` to the target's FK.
+     */
+    private joinKeys;
+    /** `[column, key]` for the fields whose stored name differs from their property name, memoized per entity. */
+    private renamedColumns;
     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;
@@ -87,6 +169,10 @@ export type MongoAggregationPipelineEntry<E extends Document> = {
     $unwind?: MongoAggregationUnwind;
     $group?: Record<string, unknown>;
     $project?: Record<string, unknown>;
+    $addFields?: Record<string, unknown>;
+    $vectorSearch?: Record<string, unknown>;
+    $count?: string;
+    $unset?: string | string[];
     $skip?: number;
     $limit?: number;
 };
@@ -95,7 +181,8 @@ type MongoAggregationLookup<E extends Document> = {
     readonly foreignField?: string;
     readonly localField?: string;
     readonly pipeline?: MongoAggregationPipelineEntry<FieldValue<E>>[];
-    readonly as?: RelationKey<E>;
+    /** A relation key when populating, a temporary field when a relation condition is being tested. */
+    readonly as?: string;
 };
 type MongoAggregationUnwind = {
     readonly path?: string;
@@ -108,4 +195,3 @@ export type ExtractedVectorSort<E> = {
     readonly regularSort: QuerySortMap<E>;
 };
 export {};
-//# sourceMappingURL=mongoDialect.d.ts.map