@mikro-orm/core 7.0.2-dev.9 → 7.0.2

package/utils/Configuration.d.ts

@@ -1,7 +1,27 @@
 import type { NamingStrategy } from '../naming-strategy/NamingStrategy.js';
 import { type CacheAdapter, type SyncCacheAdapter } from '../cache/CacheAdapter.js';
 import type { EntityRepository } from '../entity/EntityRepository.js';
-import type { AnyEntity, CompiledFunctions, Constructor, Dictionary, EnsureDatabaseOptions, EntityClass, EntityMetadata, FilterDef, GenerateOptions, Highlighter, HydratorConstructor, IHydrator, IMigrationGenerator, IPrimaryKey, MaybePromise, Migration, MigrationObject, Seeder, SeederObject } from '../typings.js';
+import type {
+  AnyEntity,
+  CompiledFunctions,
+  Constructor,
+  Dictionary,
+  EnsureDatabaseOptions,
+  EntityClass,
+  EntityMetadata,
+  FilterDef,
+  GenerateOptions,
+  Highlighter,
+  HydratorConstructor,
+  IHydrator,
+  IMigrationGenerator,
+  IPrimaryKey,
+  MaybePromise,
+  Migration,
+  MigrationObject,
+  Seeder,
+  SeederObject,
+} from '../typings.js';
 import { type Logger, type LoggerNamespace, type LoggerOptions } from '../logging/Logger.js';
 import type { EntityManager } from '../EntityManager.js';
 import type { Platform } from '../platforms/Platform.js';
@@ -15,888 +35,920 @@ import { DataloaderType, FlushMode, LoadStrategy, PopulateHint, type EmbeddedPre
 import { EntityComparator } from './EntityComparator.js';
 import type { Type } from '../types/Type.js';
 import type { MikroORM } from '../MikroORM.js';
-export declare class Configuration<D extends IDatabaseDriver = IDatabaseDriver, EM extends EntityManager<D> = D[typeof EntityManagerType] & EntityManager<D>> {
-    #private;
-    constructor(options: Partial<Options>, validate?: boolean);
-    getPlatform(): ReturnType<D['getPlatform']>;
-    /**
-     * Gets specific configuration option. Falls back to specified `defaultValue` if provided.
-     */
-    get<T extends keyof Options<D, EM>, U extends Options<D, EM>[T]>(key: T, defaultValue?: U): U;
-    getAll(): Options<D, EM>;
-    /**
-     * Overrides specified configuration value.
-     */
-    set<T extends keyof Options<D, EM>, U extends Options<D, EM>[T]>(key: T, value: U): void;
-    /**
-     * Resets the configuration to its default value
-     */
-    reset<T extends keyof Options<D, EM>>(key: T): void;
-    /**
-     * Gets Logger instance.
-     */
-    getLogger(): Logger;
-    /**
-     * Gets the logger instance for slow queries.
-     * Falls back to the main logger if no custom slow query logger factory is configured.
-     */
-    getSlowQueryLogger(): Logger;
-    getDataloaderType(): DataloaderType;
-    getSchema(skipDefaultSchema?: boolean): string | undefined;
-    /**
-     * Gets current database driver instance.
-     */
-    getDriver(): D;
-    registerExtension(name: string, cb: () => unknown): void;
-    getExtension<T>(name: string): T | undefined;
-    /**
-     * Gets instance of NamingStrategy. (cached)
-     */
-    getNamingStrategy(): NamingStrategy;
-    /**
-     * Gets instance of Hydrator. (cached)
-     */
-    getHydrator(metadata: MetadataStorage): IHydrator;
-    /**
-     * Gets instance of Comparator. (cached)
-     */
-    getComparator(metadata: MetadataStorage): EntityComparator;
-    /**
-     * Gets instance of MetadataProvider. (cached)
-     */
-    getMetadataProvider(): MetadataProvider;
-    /**
-     * Gets instance of metadata CacheAdapter. (cached)
-     */
-    getMetadataCacheAdapter(): SyncCacheAdapter;
-    /**
-     * Gets instance of CacheAdapter for result cache. (cached)
-     */
-    getResultCacheAdapter(): CacheAdapter;
-    /**
-     * Gets EntityRepository class to be instantiated.
-     */
-    getRepositoryClass(repository: () => EntityClass<EntityRepository<AnyEntity>>): Options<D, EM>['entityRepository'];
-    /**
-     * Creates instance of given service and caches it.
-     */
-    getCachedService<T extends {
-        new (...args: any[]): InstanceType<T>;
-    }>(cls: T, ...args: ConstructorParameters<T>): InstanceType<T>;
-    resetServiceCache(): void;
-    private init;
-    private sync;
-    private validateOptions;
+/** Holds and validates all ORM configuration options, providing access to drivers, loggers, cache adapters, and other services. */
+export declare class Configuration<
+  D extends IDatabaseDriver = IDatabaseDriver,
+  EM extends EntityManager<D> = D[typeof EntityManagerType] & EntityManager<D>,
+> {
+  #private;
+  constructor(options: Partial<Options>, validate?: boolean);
+  /** Returns the database platform instance. */
+  getPlatform(): ReturnType<D['getPlatform']>;
+  /**
+   * Gets specific configuration option. Falls back to specified `defaultValue` if provided.
+   */
+  get<T extends keyof Options<D, EM>, U extends Options<D, EM>[T]>(key: T, defaultValue?: U): U;
+  /** Returns all configuration options. */
+  getAll(): Options<D, EM>;
+  /**
+   * Overrides specified configuration value.
+   */
+  set<T extends keyof Options<D, EM>, U extends Options<D, EM>[T]>(key: T, value: U): void;
+  /**
+   * Resets the configuration to its default value
+   */
+  reset<T extends keyof Options<D, EM>>(key: T): void;
+  /**
+   * Gets Logger instance.
+   */
+  getLogger(): Logger;
+  /**
+   * Gets the logger instance for slow queries.
+   * Falls back to the main logger if no custom slow query logger factory is configured.
+   */
+  getSlowQueryLogger(): Logger;
+  /** Returns the configured dataloader type, normalizing boolean values. */
+  getDataloaderType(): DataloaderType;
+  /** Returns the configured schema name, optionally skipping the platform's default schema. */
+  getSchema(skipDefaultSchema?: boolean): string | undefined;
+  /**
+   * Gets current database driver instance.
+   */
+  getDriver(): D;
+  /** Registers a lazily-initialized extension by name. */
+  registerExtension(name: string, cb: () => unknown): void;
+  /** Returns a previously registered extension by name, initializing it on first access. */
+  getExtension<T>(name: string): T | undefined;
+  /**
+   * Gets instance of NamingStrategy. (cached)
+   */
+  getNamingStrategy(): NamingStrategy;
+  /**
+   * Gets instance of Hydrator. (cached)
+   */
+  getHydrator(metadata: MetadataStorage): IHydrator;
+  /**
+   * Gets instance of Comparator. (cached)
+   */
+  getComparator(metadata: MetadataStorage): EntityComparator;
+  /**
+   * Gets instance of MetadataProvider. (cached)
+   */
+  getMetadataProvider(): MetadataProvider;
+  /**
+   * Gets instance of metadata CacheAdapter. (cached)
+   */
+  getMetadataCacheAdapter(): SyncCacheAdapter;
+  /**
+   * Gets instance of CacheAdapter for result cache. (cached)
+   */
+  getResultCacheAdapter(): CacheAdapter;
+  /**
+   * Gets EntityRepository class to be instantiated.
+   */
+  getRepositoryClass(repository: () => EntityClass<EntityRepository<AnyEntity>>): Options<D, EM>['entityRepository'];
+  /**
+   * Creates instance of given service and caches it.
+   */
+  getCachedService<
+    T extends {
+      new (...args: any[]): InstanceType<T>;
+    },
+  >(cls: T, ...args: ConstructorParameters<T>): InstanceType<T>;
+  /** Clears the cached service instances, forcing re-creation on next access. */
+  resetServiceCache(): void;
+  private init;
+  private sync;
+  private validateOptions;
 }
 /**
  * Type helper to make it easier to use `mikro-orm.config.js`.
  */
-export declare function defineConfig<D extends IDatabaseDriver = IDatabaseDriver, EM extends EntityManager<D> = EntityManager<D>, Entities extends (string | EntityClass<AnyEntity> | EntitySchema)[] = (string | EntityClass<AnyEntity> | EntitySchema)[]>(options: Partial<Options<D, EM, Entities>>): Partial<Options<D, EM, Entities>>;
+export declare function defineConfig<
+  D extends IDatabaseDriver = IDatabaseDriver,
+  EM extends EntityManager<D> = EntityManager<D>,
+  Entities extends (string | EntityClass<AnyEntity> | EntitySchema)[] = (
+    | string
+    | EntityClass<AnyEntity>
+    | EntitySchema
+  )[],
+>(options: Partial<Options<D, EM, Entities>>): Partial<Options<D, EM, Entities>>;
 /**
  * Connection configuration options for database connections.
  * @see https://mikro-orm.io/docs/configuration#connection
  */
 export interface ConnectionOptions {
-    /** Name of the database to connect to. */
-    dbName?: string;
-    /** Default database schema to use. */
-    schema?: string;
-    /** Name of the connection (used for logging when replicas are used). */
-    name?: string;
-    /** Full client connection URL. Overrides individual connection options. */
-    clientUrl?: string;
-    /** Database server hostname. */
-    host?: string;
-    /** Database server port number. */
-    port?: number;
-    /** Database user name. */
-    user?: string;
-    /**
-     * Database password. Can be a string or a callback function that returns the password.
-     * The callback is useful for short-lived tokens from cloud providers.
-     * @example
-     * password: async () => someCallToGetTheToken()
-     */
-    password?: string | (() => MaybePromise<string>);
-    /** Character set for the connection. */
-    charset?: string;
-    /** Collation for the connection. */
-    collate?: string;
-    /**
-     * Enable multiple statements in a single query.
-     * Required for importing database dump files.
-     * Should be disabled in production for security.
-     * @default false
-     */
-    multipleStatements?: boolean;
-    /** Connection pool configuration. */
-    pool?: PoolConfig;
-    /**
-     * Additional driver-specific options.
-     * The object will be deeply merged with internal driver options.
-     */
-    driverOptions?: Dictionary;
-    /** Callback to execute when a new connection is created. */
-    onCreateConnection?: (connection: unknown) => Promise<void>;
-    /**
-     * SQLite/libSQL: databases to attach on connection.
-     * Each attached database acts as a schema, accessible via `schema.table` syntax.
-     * Entities can reference attached databases via `@Entity({ schema: 'db_name' })`.
-     * Note: Not supported for remote libSQL connections.
-     * @example
-     * attachDatabases: [
-     *   { name: 'users_db', path: './users.db' },
-     *   { name: 'logs_db', path: '/var/data/logs.db' },
-     * ]
-     */
-    attachDatabases?: {
-        name: string;
-        path: string;
-    }[];
+  /** Name of the database to connect to. */
+  dbName?: string;
+  /** Default database schema to use. */
+  schema?: string;
+  /** Name of the connection (used for logging when replicas are used). */
+  name?: string;
+  /** Full client connection URL. Overrides individual connection options. */
+  clientUrl?: string;
+  /** Database server hostname. */
+  host?: string;
+  /** Database server port number. */
+  port?: number;
+  /** Database user name. */
+  user?: string;
+  /**
+   * Database password. Can be a string or a callback function that returns the password.
+   * The callback is useful for short-lived tokens from cloud providers.
+   * @example
+   * password: async () => someCallToGetTheToken()
+   */
+  password?: string | (() => MaybePromise<string>);
+  /** Character set for the connection. */
+  charset?: string;
+  /** Collation for the connection. */
+  collate?: string;
+  /**
+   * Enable multiple statements in a single query.
+   * Required for importing database dump files.
+   * Should be disabled in production for security.
+   * @default false
+   */
+  multipleStatements?: boolean;
+  /** Connection pool configuration. */
+  pool?: PoolConfig;
+  /**
+   * Additional driver-specific options.
+   * The object will be deeply merged with internal driver options.
+   */
+  driverOptions?: Dictionary;
+  /** Callback to execute when a new connection is created. */
+  onCreateConnection?: (connection: unknown) => Promise<void>;
+  /**
+   * SQLite/libSQL: databases to attach on connection.
+   * Each attached database acts as a schema, accessible via `schema.table` syntax.
+   * Entities can reference attached databases via `@Entity({ schema: 'db_name' })`.
+   * Note: Not supported for remote libSQL connections.
+   * @example
+   * attachDatabases: [
+   *   { name: 'users_db', path: './users.db' },
+   *   { name: 'logs_db', path: '/var/data/logs.db' },
+   * ]
+   */
+  attachDatabases?: {
+    name: string;
+    path: string;
+  }[];
 }
 /**
  * Configuration options for database migrations.
  * @see https://mikro-orm.io/docs/migrations
  */
 export type MigrationsOptions = {
-    /**
-     * Name of the migrations table.
-     * @default 'mikro_orm_migrations'
-     */
-    tableName?: string;
-    /**
-     * Path to the folder with migration files (for compiled JavaScript files).
-     * @default './migrations'
-     */
-    path?: string;
-    /**
-     * Path to the folder with migration files (for TypeScript source files).
-     * Used when running in TypeScript mode.
-     */
-    pathTs?: string;
-    /**
-     * Glob pattern to match migration files.
-     * @default '!(*.d).{js,ts,cjs}'
-     */
-    glob?: string;
-    /**
-     * Disable logging for migration operations.
-     * @default false
-     */
-    silent?: boolean;
-    /**
-     * Run each migration inside a transaction.
-     * @default true
-     */
-    transactional?: boolean;
-    /**
-     * Try to disable foreign key checks during migrations.
-     * @default false
-     */
-    disableForeignKeys?: boolean;
-    /**
-     * Run all migrations in the current batch in a master transaction.
-     * @default true
-     */
-    allOrNothing?: boolean;
-    /**
-     * Allow dropping tables during schema diff.
-     * @default true
-     */
-    dropTables?: boolean;
-    /**
-     * Safe mode - only allow adding new tables and columns, never dropping existing ones.
-     * @default false
-     */
-    safe?: boolean;
-    /**
-     * Create a snapshot of the current schema after migration generation.
-     * @default true
-     */
-    snapshot?: boolean;
-    /** Custom name for the snapshot file. */
-    snapshotName?: string;
-    /**
-     * File extension for generated migration files.
-     * @default 'ts'
-     */
-    emit?: 'js' | 'ts' | 'cjs';
-    /** Custom migration generator class. */
-    generator?: Constructor<IMigrationGenerator>;
-    /**
-     * Custom function to generate migration file names.
-     * @default (timestamp, name) => `Migration${timestamp}${name ? '_' + name : ''}`
-     */
-    fileName?: (timestamp: string, name?: string) => string;
-    /** List of migration classes or objects to use instead of file-based discovery. */
-    migrationsList?: (MigrationObject | Constructor<Migration>)[];
+  /**
+   * Name of the migrations table.
+   * @default 'mikro_orm_migrations'
+   */
+  tableName?: string;
+  /**
+   * Path to the folder with migration files (for compiled JavaScript files).
+   * @default './migrations'
+   */
+  path?: string;
+  /**
+   * Path to the folder with migration files (for TypeScript source files).
+   * Used when running in TypeScript mode.
+   */
+  pathTs?: string;
+  /**
+   * Glob pattern to match migration files.
+   * @default '!(*.d).{js,ts,cjs}'
+   */
+  glob?: string;
+  /**
+   * Disable logging for migration operations.
+   * @default false
+   */
+  silent?: boolean;
+  /**
+   * Run each migration inside a transaction.
+   * @default true
+   */
+  transactional?: boolean;
+  /**
+   * Try to disable foreign key checks during migrations.
+   * @default false
+   */
+  disableForeignKeys?: boolean;
+  /**
+   * Run all migrations in the current batch in a master transaction.
+   * @default true
+   */
+  allOrNothing?: boolean;
+  /**
+   * Allow dropping tables during schema diff.
+   * @default true
+   */
+  dropTables?: boolean;
+  /**
+   * Safe mode - only allow adding new tables and columns, never dropping existing ones.
+   * @default false
+   */
+  safe?: boolean;
+  /**
+   * Create a snapshot of the current schema after migration generation.
+   * @default true
+   */
+  snapshot?: boolean;
+  /** Custom name for the snapshot file. */
+  snapshotName?: string;
+  /**
+   * File extension for generated migration files.
+   * @default 'ts'
+   */
+  emit?: 'js' | 'ts' | 'cjs';
+  /** Custom migration generator class. */
+  generator?: Constructor<IMigrationGenerator>;
+  /**
+   * Custom function to generate migration file names.
+   * @default (timestamp, name) => `Migration${timestamp}${name ? '_' + name : ''}`
+   */
+  fileName?: (timestamp: string, name?: string) => string;
+  /** List of migration classes or objects to use instead of file-based discovery. */
+  migrationsList?: (MigrationObject | Constructor<Migration>)[];
 };
 /**
  * Configuration options for database seeders.
  * @see https://mikro-orm.io/docs/seeding
  */
 export interface SeederOptions {
-    /**
-     * Path to the folder with seeder files (for compiled JavaScript files).
-     * @default './seeders'
-     */
-    path?: string;
-    /**
-     * Path to the folder with seeder files (for TypeScript source files).
-     * Used when running in TypeScript mode.
-     */
-    pathTs?: string;
-    /**
-     * Glob pattern to match seeder files.
-     * @default '!(*.d).{js,ts}'
-     */
-    glob?: string;
-    /**
-     * Name of the default seeder class to run.
-     * @default 'DatabaseSeeder'
-     */
-    defaultSeeder?: string;
-    /**
-     * File extension for generated seeder files.
-     * @default 'ts'
-     */
-    emit?: 'js' | 'ts';
-    /**
-     * Custom function to generate seeder file names.
-     * @default (className) => className
-     */
-    fileName?: (className: string) => string;
-    /** List of seeder classes or objects to use instead of file-based discovery. */
-    seedersList?: (SeederObject | Constructor<Seeder>)[];
+  /**
+   * Path to the folder with seeder files (for compiled JavaScript files).
+   * @default './seeders'
+   */
+  path?: string;
+  /**
+   * Path to the folder with seeder files (for TypeScript source files).
+   * Used when running in TypeScript mode.
+   */
+  pathTs?: string;
+  /**
+   * Glob pattern to match seeder files.
+   * @default '!(*.d).{js,ts}'
+   */
+  glob?: string;
+  /**
+   * Name of the default seeder class to run.
+   * @default 'DatabaseSeeder'
+   */
+  defaultSeeder?: string;
+  /**
+   * File extension for generated seeder files.
+   * @default 'ts'
+   */
+  emit?: 'js' | 'ts';
+  /**
+   * Custom function to generate seeder file names.
+   * @default (className) => className
+   */
+  fileName?: (className: string) => string;
+  /** List of seeder classes or objects to use instead of file-based discovery. */
+  seedersList?: (SeederObject | Constructor<Seeder>)[];
 }
 /**
  * Connection pool configuration.
  * @see https://mikro-orm.io/docs/configuration#connection
  */
 export interface PoolConfig {
-    /** Minimum number of connections to keep in the pool. */
-    min?: number;
-    /** Maximum number of connections allowed in the pool. */
-    max?: number;
-    /** Time in milliseconds before an idle connection is closed. */
-    idleTimeoutMillis?: number;
+  /** Minimum number of connections to keep in the pool. */
+  min?: number;
+  /** Maximum number of connections allowed in the pool. */
+  max?: number;
+  /** Time in milliseconds before an idle connection is closed. */
+  idleTimeoutMillis?: number;
 }
 /**
  * Configuration options for metadata discovery.
  * @see https://mikro-orm.io/docs/configuration#entity-discovery
  */
 export interface MetadataDiscoveryOptions {
-    /**
-     * Throw an error when no entities are discovered.
-     * @default true
-     */
-    warnWhenNoEntities?: boolean;
-    /**
-     * Check for duplicate table names and throw an error if found.
-     * @default true
-     */
-    checkDuplicateTableNames?: boolean;
-    /**
-     * Check for duplicate field names and throw an error if found.
-     * @default true
-     */
-    checkDuplicateFieldNames?: boolean;
-    /**
-     * Check for composite primary keys marked as `persist: false` and throw an error if found.
-     * @default true
-     */
-    checkNonPersistentCompositeProps?: boolean;
-    /**
-     * Infer default values from property initializers when possible
-     * (if the constructor can be invoked without parameters).
-     * @default true
-     */
-    inferDefaultValues?: boolean;
-    /**
-     * Custom callback to override default type mapping.
-     * Allows customizing how property types are mapped to database column types.
-     * @example
-     * getMappedType(type, platform) {
-     *   if (type === 'string') {
-     *     return Type.getType(TextType);
-     *   }
-     *   return platform.getDefaultMappedType(type);
-     * }
-     */
-    getMappedType?: (type: string, platform: Platform) => Type<unknown> | undefined;
-    /**
-     * Hook called for each entity metadata during discovery.
-     * Can be used to modify metadata dynamically before defaults are filled in.
-     * The hook can be async when using `MikroORM.init()`.
-     */
-    onMetadata?: (meta: EntityMetadata, platform: Platform) => MaybePromise<void>;
-    /**
-     * Hook called after all entities are discovered.
-     * Can be used to access and modify all metadata at once.
-     */
-    afterDiscovered?: (storage: MetadataStorage, platform: Platform) => MaybePromise<void>;
-    /** Path to the TypeScript configuration file for ts-morph metadata provider. */
-    tsConfigPath?: string;
-    /** @internal */
-    skipSyncDiscovery?: boolean;
+  /**
+   * Throw an error when no entities are discovered.
+   * @default true
+   */
+  warnWhenNoEntities?: boolean;
+  /**
+   * Check for duplicate table names and throw an error if found.
+   * @default true
+   */
+  checkDuplicateTableNames?: boolean;
+  /**
+   * Check for duplicate field names and throw an error if found.
+   * @default true
+   */
+  checkDuplicateFieldNames?: boolean;
+  /**
+   * Check for composite primary keys marked as `persist: false` and throw an error if found.
+   * @default true
+   */
+  checkNonPersistentCompositeProps?: boolean;
+  /**
+   * Infer default values from property initializers when possible
+   * (if the constructor can be invoked without parameters).
+   * @default true
+   */
+  inferDefaultValues?: boolean;
+  /**
+   * Custom callback to override default type mapping.
+   * Allows customizing how property types are mapped to database column types.
+   * @example
+   * getMappedType(type, platform) {
+   *   if (type === 'string') {
+   *     return Type.getType(TextType);
+   *   }
+   *   return platform.getDefaultMappedType(type);
+   * }
+   */
+  getMappedType?: (type: string, platform: Platform) => Type<unknown> | undefined;
+  /**
+   * Hook called for each entity metadata during discovery.
+   * Can be used to modify metadata dynamically before defaults are filled in.
+   * The hook can be async when using `MikroORM.init()`.
+   */
+  onMetadata?: (meta: EntityMetadata, platform: Platform) => MaybePromise<void>;
+  /**
+   * Hook called after all entities are discovered.
+   * Can be used to access and modify all metadata at once.
+   */
+  afterDiscovered?: (storage: MetadataStorage, platform: Platform) => MaybePromise<void>;
+  /** Path to the TypeScript configuration file for ts-morph metadata provider. */
+  tsConfigPath?: string;
+  /** @internal */
+  skipSyncDiscovery?: boolean;
 }
 /**
  * MikroORM configuration options.
  * @see https://mikro-orm.io/docs/configuration
  */
-export interface Options<Driver extends IDatabaseDriver = IDatabaseDriver, EM extends EntityManager<Driver> & Driver[typeof EntityManagerType] = EntityManager<Driver> & Driver[typeof EntityManagerType], Entities extends (string | EntityClass<AnyEntity> | EntitySchema)[] = (string | EntityClass<AnyEntity> | EntitySchema)[]> extends ConnectionOptions {
-    /** Connection pool configuration. */
-    pool: PoolConfig;
-    /**
-     * Additional driver-specific options.
-     * The object will be deeply merged with internal driver options.
-     */
-    driverOptions: Dictionary;
-    /**
-     * Array of entity classes or paths to entity modules.
-     * Paths support glob patterns for automatic discovery.
-     * @example
-     * entities: [Author, Book, Publisher] // class references
-     * entities: ['./dist/entities'] // folder paths
-     */
-    entities: Entities;
-    /**
-     * Array of TypeScript entity source paths.
-     * Used when running in TypeScript mode (e.g., via `tsx` or `swc`).
-     * Should always be specified when using folder-based discovery.
-     * @example
-     * entitiesTs: ['./src/entities']
-     */
-    entitiesTs: Entities;
-    /**
-     * ORM extensions to register (e.g., Migrator, EntityGenerator, SeedManager).
-     * Extensions registered here are available via shortcuts like `orm.migrator`.
-     * @example
-     * extensions: [Migrator, EntityGenerator, SeedManager]
-     */
-    extensions: {
-        register: (orm: MikroORM) => void;
-    }[];
-    /**
-     * Event subscribers to register.
-     * Can be class references or instances.
-     */
-    subscribers: Iterable<EventSubscriber | Constructor<EventSubscriber>>;
-    /**
-     * Global entity filters to apply.
-     * Filters are applied by default unless explicitly disabled.
-     * @see https://mikro-orm.io/docs/filters
-     */
-    filters: Dictionary<{
-        name?: string;
-    } & Omit<FilterDef, 'name'>>;
-    /**
-     * Metadata discovery configuration options.
-     * Controls how entities are discovered and validated.
-     */
-    discovery: MetadataDiscoveryOptions;
-    /**
-     * Database driver class to use.
-     * Should be imported from the specific driver package (e.g. `@mikro-orm/mysql`, `@mikro-orm/postgresql`).
-     * Alternatively, use the `defineConfig` helper or `MikroORM` class exported from the driver package.
-     * @example
-     * import { MySqlDriver } from '@mikro-orm/mysql';
-     *
-     * MikroORM.init({
-     *   driver: MySqlDriver,
-     *   dbName: 'my_db',
-     * });
-     */
-    driver?: {
-        new (config: Configuration): Driver;
-    };
-    /**
-     * Custom naming strategy class for mapping entity/property names to database table/column names.
-     * Built-in options: `UnderscoreNamingStrategy`, `MongoNamingStrategy`, `EntityCaseNamingStrategy`.
-     * @see https://mikro-orm.io/docs/naming-strategy
-     */
-    namingStrategy?: {
-        new (): NamingStrategy;
-    };
-    /**
-     * Enable implicit transactions for all write operations.
-     * When enabled, all queries will be wrapped in a transaction.
-     * Disabled for MongoDB driver by default.
-     */
-    implicitTransactions?: boolean;
-    /**
-     * Disable all transactions.
-     * When enabled, no queries will be wrapped in transactions, even when explicitly requested.
-     * @default false
-     */
-    disableTransactions?: boolean;
-    /**
-     * Enable verbose logging of internal operations.
-     * @default false
-     */
-    verbose: boolean;
-    /**
-     * Ignore `undefined` values in find queries instead of treating them as `null`.
-     * @default false
-     * @example
-     * // With ignoreUndefinedInQuery: true
-     * em.find(User, { email: undefined }) // resolves to em.find(User, {})
-     */
-    ignoreUndefinedInQuery: boolean;
-    /**
-     * Hook to modify SQL queries before execution.
-     * Useful for adding observability hints or query modifications.
-     * @param sql - The generated SQL query
-     * @param params - Query parameters
-     * @returns Modified SQL query
-     */
-    onQuery: (sql: string, params: readonly unknown[]) => string;
-    /**
-     * Automatically join the owning side of 1:1 relations when querying the inverse side.
-     * @default true
-     */
-    autoJoinOneToOneOwner: boolean;
-    /**
-     * Automatically join M:1 and 1:1 relations when filters are defined on them.
-     * Important for implementing soft deletes via filters.
-     * @default true
-     */
-    autoJoinRefsForFilters: boolean;
-    /**
-     * Apply filters to relations in queries.
-     * @default true
-     */
-    filtersOnRelations: boolean;
-    /**
-     * Enable propagation of changes on entity prototypes.
+export interface Options<
+  Driver extends IDatabaseDriver = IDatabaseDriver,
+  EM extends EntityManager<Driver> & Driver[typeof EntityManagerType] = EntityManager<Driver> &
+    Driver[typeof EntityManagerType],
+  Entities extends (string | EntityClass<AnyEntity> | EntitySchema)[] = (
+    | string
+    | EntityClass<AnyEntity>
+    | EntitySchema
+  )[],
+> extends ConnectionOptions {
+  /** Connection pool configuration. */
+  pool: PoolConfig;
+  /**
+   * Additional driver-specific options.
+   * The object will be deeply merged with internal driver options.
+   */
+  driverOptions: Dictionary;
+  /**
+   * Array of entity classes or paths to entity modules.
+   * Paths support glob patterns for automatic discovery.
+   * @example
+   * entities: [Author, Book, Publisher] // class references
+   * entities: ['./dist/entities'] // folder paths
+   */
+  entities: Entities;
+  /**
+   * Array of TypeScript entity source paths.
+   * Used when running in TypeScript mode (e.g., via `tsx` or `swc`).
+   * Should always be specified when using folder-based discovery.
+   * @example
+   * entitiesTs: ['./src/entities']
+   */
+  entitiesTs: Entities;
+  /**
+   * ORM extensions to register (e.g., Migrator, EntityGenerator, SeedManager).
+   * Extensions registered here are available via shortcuts like `orm.migrator`.
+   * @example
+   * extensions: [Migrator, EntityGenerator, SeedManager]
+   */
+  extensions: {
+    register: (orm: MikroORM) => void;
+  }[];
+  /**
+   * Event subscribers to register.
+   * Can be class references or instances.
+   */
+  subscribers: Iterable<EventSubscriber | Constructor<EventSubscriber>>;
+  /**
+   * Global entity filters to apply.
+   * Filters are applied by default unless explicitly disabled.
+   * @see https://mikro-orm.io/docs/filters
+   */
+  filters: Dictionary<
+    {
+      name?: string;
+    } & Omit<FilterDef, 'name'>
+  >;
+  /**
+   * Metadata discovery configuration options.
+   * Controls how entities are discovered and validated.
+   */
+  discovery: MetadataDiscoveryOptions;
+  /**
+   * Database driver class to use.
+   * Should be imported from the specific driver package (e.g. `@mikro-orm/mysql`, `@mikro-orm/postgresql`).
+   * Alternatively, use the `defineConfig` helper or `MikroORM` class exported from the driver package.
+   * @example
+   * import { MySqlDriver } from '@mikro-orm/mysql';
+   *
+   * MikroORM.init({
+   *   driver: MySqlDriver,
+   *   dbName: 'my_db',
+   * });
+   */
+  driver?: {
+    new (config: Configuration): Driver;
+  };
+  /**
+   * Custom naming strategy class for mapping entity/property names to database table/column names.
+   * Built-in options: `UnderscoreNamingStrategy`, `MongoNamingStrategy`, `EntityCaseNamingStrategy`.
+   * @see https://mikro-orm.io/docs/naming-strategy
+   */
+  namingStrategy?: {
+    new (): NamingStrategy;
+  };
+  /**
+   * Enable implicit transactions for all write operations.
+   * When enabled, all queries will be wrapped in a transaction.
+   * Disabled for MongoDB driver by default.
+   */
+  implicitTransactions?: boolean;
+  /**
+   * Disable all transactions.
+   * When enabled, no queries will be wrapped in transactions, even when explicitly requested.
+   * @default false
+   */
+  disableTransactions?: boolean;
+  /**
+   * Enable verbose logging of internal operations.
+   * @default false
+   */
+  verbose: boolean;
+  /**
+   * Ignore `undefined` values in find queries instead of treating them as `null`.
+   * @default false
+   * @example
+   * // With ignoreUndefinedInQuery: true
+   * em.find(User, { email: undefined }) // resolves to em.find(User, {})
+   */
+  ignoreUndefinedInQuery: boolean;
+  /**
+   * Hook to modify SQL queries before execution.
+   * Useful for adding observability hints or query modifications.
+   * @param sql - The generated SQL query
+   * @param params - Query parameters
+   * @returns Modified SQL query
+   */
+  onQuery: (sql: string, params: readonly unknown[]) => string;
+  /**
+   * Automatically join the owning side of 1:1 relations when querying the inverse side.
+   * @default true
+   */
+  autoJoinOneToOneOwner: boolean;
+  /**
+   * Automatically join M:1 and 1:1 relations when filters are defined on them.
+   * Important for implementing soft deletes via filters.
+   * @default true
+   */
+  autoJoinRefsForFilters: boolean;
+  /**
+   * Apply filters to relations in queries.
+   * @default true
+   */
+  filtersOnRelations: boolean;
+  /**
+   * Enable propagation of changes on entity prototypes.
+   * @default true
+   */
+  propagationOnPrototype: boolean;
+  /**
+   * Mark all relations as populated after flush for new entities.
+   * This aligns serialized output of loaded entities and just-inserted ones.
+   * @default true
+   */
+  populateAfterFlush: boolean;
+  /**
+   * Serialization options for `toJSON()` and `serialize()` methods.
+   */
+  serialization: {
+    /**
+     * Include primary keys in serialized output.
      * @default true
      */
-    propagationOnPrototype: boolean;
+    includePrimaryKeys?: boolean;
     /**
-     * Mark all relations as populated after flush for new entities.
-     * This aligns serialized output of loaded entities and just-inserted ones.
-     * @default true
-     */
-    populateAfterFlush: boolean;
-    /**
-     * Serialization options for `toJSON()` and `serialize()` methods.
-     */
-    serialization: {
-        /**
-         * Include primary keys in serialized output.
-         * @default true
-         */
-        includePrimaryKeys?: boolean;
-        /**
-         * Enforce unpopulated references to be returned as objects.
-         * When enabled, references are serialized as `{ author: { id: 1 } }` instead of `{ author: 1 }`.
-         * @default false
-         */
-        forceObject?: boolean;
-    };
-    /**
-     * Default options for entity assignment via `em.assign()`.
-     * @see https://mikro-orm.io/docs/entity-helper
-     */
-    assign: AssignOptions<boolean>;
-    /**
-     * Automatically call `em.persist()` on entities created via `em.create()`.
-     * @default true
-     */
-    persistOnCreate: boolean;
-    /**
-     * When upsert creates a new entity, mark it as managed in the identity map.
-     * @default true
-     */
-    upsertManaged: boolean;
-    /**
-     * Force use of entity constructors when creating entity instances.
-     * Required when using native private properties inside entities.
-     * Can be `true` for all entities or an array of specific entity classes/names.
+     * Enforce unpopulated references to be returned as objects.
+     * When enabled, references are serialized as `{ author: { id: 1 } }` instead of `{ author: 1 }`.
      * @default false
      */
-    forceEntityConstructor: boolean | (Constructor<AnyEntity> | string)[];
-    /**
-     * Convert `null` values from database to `undefined` when hydrating entities.
-     * @default false
-     */
-    forceUndefined: boolean;
-    /**
-     * Property `onCreate` hooks are normally executed during `flush` operation.
-     * With this option, they will be processed early inside `em.create()` method.
-     * @default true
-     */
-    processOnCreateHooksEarly: boolean;
-    /**
-     * Force `Date` values to be stored in UTC for datetime columns without timezone.
-     * Works for MySQL (`datetime` type), PostgreSQL (`timestamp` type), and MSSQL (`datetime`/`datetime2` types).
-     * SQLite does this by default.
-     * @default true
-     */
-    forceUtcTimezone: boolean;
-    /**
-     * Timezone to use for date operations.
-     * @example '+02:00'
-     */
-    timezone?: string;
-    /**
-     * Ensure the database exists when initializing the ORM.
-     * When `true`, will create the database if it doesn't exist.
-     * @default true
-     */
-    ensureDatabase: boolean | EnsureDatabaseOptions;
-    /**
-     * Ensure database indexes exist on startup. This option works only with the MongoDB driver.
-     * When enabled, indexes will be created based on entity metadata.
+    forceObject?: boolean;
+  };
+  /**
+   * Default options for entity assignment via `em.assign()`.
+   * @see https://mikro-orm.io/docs/entity-helper
+   */
+  assign: AssignOptions<boolean>;
+  /**
+   * Automatically call `em.persist()` on entities created via `em.create()`.
+   * @default true
+   */
+  persistOnCreate: boolean;
+  /**
+   * When upsert creates a new entity, mark it as managed in the identity map.
+   * @default true
+   */
+  upsertManaged: boolean;
+  /**
+   * Force use of entity constructors when creating entity instances.
+   * Required when using native private properties inside entities.
+   * Can be `true` for all entities or an array of specific entity classes/names.
+   * @default false
+   */
+  forceEntityConstructor: boolean | (Constructor<AnyEntity> | string)[];
+  /**
+   * Convert `null` values from database to `undefined` when hydrating entities.
+   * @default false
+   */
+  forceUndefined: boolean;
+  /**
+   * Property `onCreate` hooks are normally executed during `flush` operation.
+   * With this option, they will be processed early inside `em.create()` method.
+   * @default true
+   */
+  processOnCreateHooksEarly: boolean;
+  /**
+   * Force `Date` values to be stored in UTC for datetime columns without timezone.
+   * Works for MySQL (`datetime` type), PostgreSQL (`timestamp` type), and MSSQL (`datetime`/`datetime2` types).
+   * SQLite does this by default.
+   * @default true
+   */
+  forceUtcTimezone: boolean;
+  /**
+   * Timezone to use for date operations.
+   * @example '+02:00'
+   */
+  timezone?: string;
+  /**
+   * Ensure the database exists when initializing the ORM.
+   * When `true`, will create the database if it doesn't exist.
+   * @default true
+   */
+  ensureDatabase: boolean | EnsureDatabaseOptions;
+  /**
+   * Ensure database indexes exist on startup. This option works only with the MongoDB driver.
+   * When enabled, indexes will be created based on entity metadata.
+   * @default false
+   */
+  ensureIndexes: boolean;
+  /**
+   * Use batch insert queries for better performance.
+   * @default true
+   */
+  useBatchInserts?: boolean;
+  /**
+   * Use batch update queries for better performance.
+   * @default true
+   */
+  useBatchUpdates?: boolean;
+  /**
+   * Number of entities to process in each batch for batch inserts/updates.
+   * @default 300
+   */
+  batchSize: number;
+  /**
+   * Custom hydrator class for assigning database values to entities.
+   * @default ObjectHydrator
+   */
+  hydrator: HydratorConstructor;
+  /**
+   * Pre-generated compiled functions for hydration and comparison.
+   * Use the `compile` CLI command to create these functions.
+   * Enables deployment to runtimes that prohibit `new Function`/eval (e.g. Cloudflare Workers).
+   */
+  compiledFunctions?: CompiledFunctions;
+  /**
+   * Default loading strategy for relations.
+   * - `'joined'`: Use SQL JOINs (single query, may cause cartesian product)
+   * - `'select-in'`: Use separate SELECT IN queries (multiple queries)
+   * - `'balanced'`: Decides based on relation type and context.
+   * @default 'balanced'
+   */
+  loadStrategy: LoadStrategy | `${LoadStrategy}`;
+  /**
+   * Enable dataloader for batching reference loading.
+   * - `true` or `DataloaderType.ALL`: Enable for all relation types
+   * - `false` or `DataloaderType.NONE`: Disable dataloader
+   * - `DataloaderType.REFERENCE`: Enable only for scalar references
+   * - `DataloaderType.COLLECTION`: Enable only for collections
+   * @default DataloaderType.NONE
+   */
+  dataloader: DataloaderType | boolean;
+  /**
+   * Determines how where conditions are applied during population.
+   * - `'all'`: Populate all matching relations (default in v5+)
+   * - `'infer'`: Infer conditions from the original query (v4 behavior)
+   * @default 'all'
+   */
+  populateWhere: PopulateHint | `${PopulateHint}`;
+  /**
+   * Default flush mode for the entity manager.
+   * - `'commit'`: Flush only on explicit commit
+   * - `'auto'`: Flush before queries when needed
+   * - `'always'`: Always flush before queries
+   * @default 'auto'
+   */
+  flushMode: FlushMode | `${FlushMode}`;
+  /**
+   * Custom base repository class for all entities.
+   * Entity-specific repositories can still be defined and will take precedence.
+   * @see https://mikro-orm.io/docs/repositories
+   */
+  entityRepository?: EntityClass<EntityRepository<any>>;
+  /**
+   * Custom entity manager class to use.
+   */
+  entityManager?: Constructor<EM>;
+  /**
+   * Read replica connection configurations.
+   * Each replica can override parts of the main connection options.
+   * @see https://mikro-orm.io/docs/read-connections
+   */
+  replicas?: ConnectionOptions[];
+  /**
+   * Validate that required properties are set on new entities before insert.
+   * @default true
+   */
+  validateRequired: boolean;
+  /**
+   * Callback to get the current request context's EntityManager.
+   * Used for automatic context propagation in web frameworks.
+   * @default RequestContext.getEntityManager
+   */
+  context: (name: string) => EntityManager | undefined;
+  /**
+   * Name of the context for multi-ORM setups.
+   * @default 'default'
+   */
+  contextName: string;
+  /**
+   * Allow using the global EntityManager without a request context.
+   * Not recommended for production - each request should have its own context.
+   * Can also be set via `MIKRO_ORM_ALLOW_GLOBAL_CONTEXT` environment variable.
+   * @default false
+   */
+  allowGlobalContext: boolean;
+  /**
+   * When enabled, environment variables take precedence over explicitly provided config options.
+   * By default, explicit options win over env vars.
+   * @default false
+   */
+  preferEnvVars?: boolean;
+  /**
+   * Disable the identity map.
+   * When disabled, each query returns new entity instances.
+   * Not recommended for most use cases.
+   * @default false
+   */
+  disableIdentityMap?: boolean;
+  /**
+   * Custom logger function for ORM output.
+   * @default console.log
+   */
+  logger: (message: string) => void;
+  /**
+   * Enable colored output in logs.
+   * @default true
+   */
+  colors: boolean;
+  /**
+   * Factory function to create a custom logger instance.
+   * @default DefaultLogger.create
+   */
+  loggerFactory?: (options: LoggerOptions) => Logger;
+  /**
+   * Threshold in milliseconds for logging slow queries.
+   * Queries taking at least this long will be logged via the 'slow-query' namespace at warning level.
+   * Slow query logs are always emitted when the threshold is met, regardless of the `debug` setting.
+   * Set to `0` to log every query as slow.
+   * @default undefined (slow query logging disabled)
+   */
+  slowQueryThreshold?: number;
+  /**
+   * Factory function to create a custom logger instance for slow queries.
+   * Has the same shape as `loggerFactory`. When not provided, the main logger instance is used.
+   *
+   * Note: slow query log entries are emitted with `context.enabled = true` to bypass the
+   * debug-mode check. Custom logger implementations must respect `context.enabled` in their
+   * `isEnabled()` method (as `DefaultLogger` does) to ensure slow query logs are always emitted.
+   * @default undefined (falls back to main logger)
+   */
+  slowQueryLoggerFactory?: (options: LoggerOptions) => Logger;
+  /**
+   * Custom error handler for `em.findOneOrFail()` when no entity is found.
+   * @param entityName - Name of the entity being queried
+   * @param where - Query conditions
+   * @returns Error instance to throw
+   */
+  findOneOrFailHandler: (entityName: string, where: Dictionary | IPrimaryKey) => Error;
+  /**
+   * Custom error handler for `em.findExactlyOneOrFail()` when entity count is not exactly one.
+   * Used when strict mode is enabled.
+   * @param entityName - Name of the entity being queried
+   * @param where - Query conditions
+   * @returns Error instance to throw
+   */
+  findExactlyOneOrFailHandler: (entityName: string, where: Dictionary | IPrimaryKey) => Error;
+  /**
+   * Enable debug logging.
+   * Can be `true` for all namespaces or an array of specific namespaces.
+   * Available namespaces: `'query'`, `'query-params'`, `'discovery'`, `'info'`.
+   * @default false
+   * @see https://mikro-orm.io/docs/logging
+   */
+  debug: boolean | LoggerNamespace[];
+  /**
+   * Ignore deprecation warnings.
+   * Can be `true` to ignore all or an array of specific deprecation labels.
+   * @default false
+   * @see https://mikro-orm.io/docs/logging#deprecation-warnings
+   */
+  ignoreDeprecations: boolean | string[];
+  /**
+   * Syntax highlighter for SQL queries in logs.
+   * @default NullHighlighter
+   */
+  highlighter: Highlighter;
+  /**
+   * Force the ORM to use TypeScript options regardless of detection.
+   * Uses `entitiesTs` for discovery and `pathTs` for migrations/seeders.
+   * Should only be used for tests, not production builds.
+   * @default false
+   */
+  preferTs?: boolean;
+  /**
+   * Base directory for resolving relative paths.
+   * @default process.cwd()
+   */
+  baseDir: string;
+  /**
+   * Migration configuration options.
+   * @see https://mikro-orm.io/docs/migrations
+   */
+  migrations: MigrationsOptions;
+  /**
+   * Schema generator configuration options.
+   */
+  schemaGenerator: {
+    /**
+     * Try to disable foreign key checks during schema operations.
      * @default false
      */
-    ensureIndexes: boolean;
-    /**
-     * Use batch insert queries for better performance.
-     * @default true
-     */
-    useBatchInserts?: boolean;
-    /**
-     * Use batch update queries for better performance.
-     * @default true
-     */
-    useBatchUpdates?: boolean;
-    /**
-     * Number of entities to process in each batch for batch inserts/updates.
-     * @default 300
-     */
-    batchSize: number;
-    /**
-     * Custom hydrator class for assigning database values to entities.
-     * @default ObjectHydrator
-     */
-    hydrator: HydratorConstructor;
-    /**
-     * Pre-generated compiled functions for hydration and comparison.
-     * Use the `compile` CLI command to create these functions.
-     * Enables deployment to runtimes that prohibit `new Function`/eval (e.g. Cloudflare Workers).
-     */
-    compiledFunctions?: CompiledFunctions;
-    /**
-     * Default loading strategy for relations.
-     * - `'joined'`: Use SQL JOINs (single query, may cause cartesian product)
-     * - `'select-in'`: Use separate SELECT IN queries (multiple queries)
-     * - `'balanced'`: Decides based on relation type and context.
-     * @default 'balanced'
-     */
-    loadStrategy: LoadStrategy | `${LoadStrategy}`;
-    /**
-     * Enable dataloader for batching reference loading.
-     * - `true` or `DataloaderType.ALL`: Enable for all relation types
-     * - `false` or `DataloaderType.NONE`: Disable dataloader
-     * - `DataloaderType.REFERENCE`: Enable only for scalar references
-     * - `DataloaderType.COLLECTION`: Enable only for collections
-     * @default DataloaderType.NONE
-     */
-    dataloader: DataloaderType | boolean;
-    /**
-     * Determines how where conditions are applied during population.
-     * - `'all'`: Populate all matching relations (default in v5+)
-     * - `'infer'`: Infer conditions from the original query (v4 behavior)
-     * @default 'all'
-     */
-    populateWhere: PopulateHint | `${PopulateHint}`;
-    /**
-     * Default flush mode for the entity manager.
-     * - `'commit'`: Flush only on explicit commit
-     * - `'auto'`: Flush before queries when needed
-     * - `'always'`: Always flush before queries
-     * @default 'auto'
-     */
-    flushMode: FlushMode | `${FlushMode}`;
-    /**
-     * Custom base repository class for all entities.
-     * Entity-specific repositories can still be defined and will take precedence.
-     * @see https://mikro-orm.io/docs/repositories
-     */
-    entityRepository?: EntityClass<EntityRepository<any>>;
-    /**
-     * Custom entity manager class to use.
-     */
-    entityManager?: Constructor<EM>;
+    disableForeignKeys?: boolean;
     /**
-     * Read replica connection configurations.
-     * Each replica can override parts of the main connection options.
-     * @see https://mikro-orm.io/docs/read-connections
+     * Try to disable foreign key checks during `schema.clear()`. Enabled by default for MySQL/MariaDB.
      */
-    replicas?: ConnectionOptions[];
+    disableForeignKeysForClear?: boolean;
     /**
-     * Validate that required properties are set on new entities before insert.
+     * Generate foreign key constraints.
      * @default true
      */
-    validateRequired: boolean;
-    /**
-     * Callback to get the current request context's EntityManager.
-     * Used for automatic context propagation in web frameworks.
-     * @default RequestContext.getEntityManager
-     */
-    context: (name: string) => EntityManager | undefined;
-    /**
-     * Name of the context for multi-ORM setups.
-     * @default 'default'
-     */
-    contextName: string;
+    createForeignKeyConstraints?: boolean;
     /**
-     * Allow using the global EntityManager without a request context.
-     * Not recommended for production - each request should have its own context.
-     * Can also be set via `MIKRO_ORM_ALLOW_GLOBAL_CONTEXT` environment variable.
-     * @default false
-     */
-    allowGlobalContext: boolean;
-    /**
-     * When enabled, environment variables take precedence over explicitly provided config options.
-     * By default, explicit options win over env vars.
-     * @default false
+     * Schema names to ignore when comparing schemas.
+     * @default []
      */
-    preferEnvVars?: boolean;
+    ignoreSchema?: string[];
     /**
-     * Disable the identity map.
-     * When disabled, each query returns new entity instances.
-     * Not recommended for most use cases.
-     * @default false
+     * Table names or patterns to skip during schema generation.
+     * @default []
      */
-    disableIdentityMap?: boolean;
+    skipTables?: (string | RegExp)[];
     /**
-     * Custom logger function for ORM output.
-     * @default console.log
+     * View names or patterns to skip during schema generation (e.g. PostGIS system views).
+     * @default []
      */
-    logger: (message: string) => void;
+    skipViews?: (string | RegExp)[];
     /**
-     * Enable colored output in logs.
-     * @default true
+     * Column names or patterns to skip during schema generation, keyed by table name.
+     * @default {}
      */
-    colors: boolean;
+    skipColumns?: Dictionary<(string | RegExp)[]>;
     /**
-     * Factory function to create a custom logger instance.
-     * @default DefaultLogger.create
+     * Database name to use for management operations (e.g., creating/dropping databases).
      */
-    loggerFactory?: (options: LoggerOptions) => Logger;
+    managementDbName?: string;
     /**
-     * Threshold in milliseconds for logging slow queries.
-     * Queries taking at least this long will be logged via the 'slow-query' namespace at warning level.
-     * Slow query logs are always emitted when the threshold is met, regardless of the `debug` setting.
-     * Set to `0` to log every query as slow.
-     * @default undefined (slow query logging disabled)
+     * Default ON UPDATE rule for foreign keys.
+     * When not set, no rule is emitted and the database uses its native default (NO ACTION/RESTRICT).
      */
-    slowQueryThreshold?: number;
+    defaultUpdateRule?: 'cascade' | 'no action' | 'set null' | 'set default' | 'restrict';
     /**
-     * Factory function to create a custom logger instance for slow queries.
-     * Has the same shape as `loggerFactory`. When not provided, the main logger instance is used.
-     *
-     * Note: slow query log entries are emitted with `context.enabled = true` to bypass the
-     * debug-mode check. Custom logger implementations must respect `context.enabled` in their
-     * `isEnabled()` method (as `DefaultLogger` does) to ensure slow query logs are always emitted.
-     * @default undefined (falls back to main logger)
+     * Default ON DELETE rule for foreign keys.
+     * When not set, no rule is emitted and the database uses its native default (NO ACTION/RESTRICT).
      */
-    slowQueryLoggerFactory?: (options: LoggerOptions) => Logger;
+    defaultDeleteRule?: 'cascade' | 'no action' | 'set null' | 'set default' | 'restrict';
+    tableSpace?: string;
+  };
+  /**
+   * Embeddable entity configuration options.
+   */
+  embeddables: {
     /**
-     * Custom error handler for `em.findOneOrFail()` when no entity is found.
-     * @param entityName - Name of the entity being queried
-     * @param where - Query conditions
-     * @returns Error instance to throw
+     * Mode for generating column prefixes for embedded properties.
+     * @default 'relative'
      */
-    findOneOrFailHandler: (entityName: string, where: Dictionary | IPrimaryKey) => Error;
+    prefixMode: EmbeddedPrefixMode;
+  };
+  /**
+   * Entity generator (code generation) configuration options.
+   * @see https://mikro-orm.io/docs/entity-generator
+   */
+  entityGenerator: GenerateOptions;
+  /**
+   * Metadata cache configuration for improved startup performance.
+   * @see https://mikro-orm.io/docs/metadata-cache
+   */
+  metadataCache: {
     /**
-     * Custom error handler for `em.findExactlyOneOrFail()` when entity count is not exactly one.
-     * Used when strict mode is enabled.
-     * @param entityName - Name of the entity being queried
-     * @param where - Query conditions
-     * @returns Error instance to throw
+     * Enable metadata caching.
+     * Defaults based on the metadata provider's `useCache()` method.
      */
-    findExactlyOneOrFailHandler: (entityName: string, where: Dictionary | IPrimaryKey) => Error;
+    enabled?: boolean;
     /**
-     * Enable debug logging.
-     * Can be `true` for all namespaces or an array of specific namespaces.
-     * Available namespaces: `'query'`, `'query-params'`, `'discovery'`, `'info'`.
-     * @default false
-     * @see https://mikro-orm.io/docs/logging
+     * Combine all metadata into a single cache file.
+     * Can be `true` for default path or a custom path string.
      */
-    debug: boolean | LoggerNamespace[];
+    combined?: boolean | string;
     /**
-     * Ignore deprecation warnings.
-     * Can be `true` to ignore all or an array of specific deprecation labels.
+     * Pretty print JSON cache files.
      * @default false
-     * @see https://mikro-orm.io/docs/logging#deprecation-warnings
      */
-    ignoreDeprecations: boolean | string[];
+    pretty?: boolean;
     /**
-     * Syntax highlighter for SQL queries in logs.
-     * @default NullHighlighter
+     * Cache adapter class to use. When cache is enabled, and no adapter is provided explicitly, {@link FileCacheAdapter} is used automatically - but only if you use the async `MikroORM.init()` method.
      */
-    highlighter: Highlighter;
-    /**
-     * Force the ORM to use TypeScript options regardless of detection.
-     * Uses `entitiesTs` for discovery and `pathTs` for migrations/seeders.
-     * Should only be used for tests, not production builds.
-     * @default false
-     */
-    preferTs?: boolean;
-    /**
-     * Base directory for resolving relative paths.
-     * @default process.cwd()
-     */
-    baseDir: string;
-    /**
-     * Migration configuration options.
-     * @see https://mikro-orm.io/docs/migrations
-     */
-    migrations: MigrationsOptions;
-    /**
-     * Schema generator configuration options.
-     */
-    schemaGenerator: {
-        /**
-         * Try to disable foreign key checks during schema operations.
-         * @default false
-         */
-        disableForeignKeys?: boolean;
-        /**
-         * Try to disable foreign key checks during `schema.clear()`. Enabled by default for MySQL/MariaDB.
-         */
-        disableForeignKeysForClear?: boolean;
-        /**
-         * Generate foreign key constraints.
-         * @default true
-         */
-        createForeignKeyConstraints?: boolean;
-        /**
-         * Schema names to ignore when comparing schemas.
-         * @default []
-         */
-        ignoreSchema?: string[];
-        /**
-         * Table names or patterns to skip during schema generation.
-         * @default []
-         */
-        skipTables?: (string | RegExp)[];
-        /**
-         * View names or patterns to skip during schema generation (e.g. PostGIS system views).
-         * @default []
-         */
-        skipViews?: (string | RegExp)[];
-        /**
-         * Column names or patterns to skip during schema generation, keyed by table name.
-         * @default {}
-         */
-        skipColumns?: Dictionary<(string | RegExp)[]>;
-        /**
-         * Database name to use for management operations (e.g., creating/dropping databases).
-         */
-        managementDbName?: string;
-        /**
-         * Default ON UPDATE rule for foreign keys.
-         * When not set, no rule is emitted and the database uses its native default (NO ACTION/RESTRICT).
-         */
-        defaultUpdateRule?: 'cascade' | 'no action' | 'set null' | 'set default' | 'restrict';
-        /**
-         * Default ON DELETE rule for foreign keys.
-         * When not set, no rule is emitted and the database uses its native default (NO ACTION/RESTRICT).
-         */
-        defaultDeleteRule?: 'cascade' | 'no action' | 'set null' | 'set default' | 'restrict';
-        tableSpace?: string;
-    };
-    /**
-     * Embeddable entity configuration options.
-     */
-    embeddables: {
-        /**
-         * Mode for generating column prefixes for embedded properties.
-         * @default 'relative'
-         */
-        prefixMode: EmbeddedPrefixMode;
+    adapter?: {
+      new (...params: any[]): SyncCacheAdapter;
     };
     /**
-     * Entity generator (code generation) configuration options.
-     * @see https://mikro-orm.io/docs/entity-generator
+     * Options passed to the cache adapter constructor.
+     * @default { cacheDir: process.cwd() + '/temp' }
      */
-    entityGenerator: GenerateOptions;
-    /**
-     * Metadata cache configuration for improved startup performance.
-     * @see https://mikro-orm.io/docs/metadata-cache
-     */
-    metadataCache: {
-        /**
-         * Enable metadata caching.
-         * Defaults based on the metadata provider's `useCache()` method.
-         */
-        enabled?: boolean;
-        /**
-         * Combine all metadata into a single cache file.
-         * Can be `true` for default path or a custom path string.
-         */
-        combined?: boolean | string;
-        /**
-         * Pretty print JSON cache files.
-         * @default false
-         */
-        pretty?: boolean;
-        /**
-         * Cache adapter class to use. When cache is enabled, and no adapter is provided explicitly, {@link FileCacheAdapter} is used automatically - but only if you use the async `MikroORM.init()` method.
-         */
-        adapter?: {
-            new (...params: any[]): SyncCacheAdapter;
-        };
-        /**
-         * Options passed to the cache adapter constructor.
-         * @default { cacheDir: process.cwd() + '/temp' }
-         */
-        options?: Dictionary;
-    };
+    options?: Dictionary;
+  };
+  /**
+   * Result cache configuration for query result caching.
+   */
+  resultCache: {
     /**
-     * Result cache configuration for query result caching.
+     * Default cache expiration time in milliseconds.
+     * @default 1000
      */
-    resultCache: {
-        /**
-         * Default cache expiration time in milliseconds.
-         * @default 1000
-         */
-        expiration?: number;
-        /**
-         * Cache adapter class to use.
-         * @default MemoryCacheAdapter
-         */
-        adapter?: {
-            new (...params: any[]): CacheAdapter;
-        };
-        /**
-         * Options passed to the cache adapter constructor.
-         * @default {}
-         */
-        options?: Dictionary;
-        /**
-         * Enable global result caching for all queries.
-         * Can be `true`, an expiration number, or a tuple of `[key, expiration]`.
-         */
-        global?: boolean | number | [string, number];
-    };
+    expiration?: number;
     /**
-     * Metadata provider class for entity discovery.
-     * Built-in options: `ReflectMetadataProvider` (default), `TsMorphMetadataProvider`.
-     * @default ReflectMetadataProvider
-     * @see https://mikro-orm.io/docs/metadata-providers
+     * Cache adapter class to use.
+     * @default MemoryCacheAdapter
      */
-    metadataProvider: {
-        new (config: Configuration): MetadataProvider;
-        useCache?: MetadataProvider['useCache'];
+    adapter?: {
+      new (...params: any[]): CacheAdapter;
     };
     /**
-     * Seeder configuration options.
-     * @see https://mikro-orm.io/docs/seeding
-     */
-    seeder: SeederOptions;
-    /**
-     * Prefer read replicas for read operations when available.
-     * @default true
-     */
-    preferReadReplicas: boolean;
-    /**
-     * Custom dynamic import provider for loading modules.
-     * @default (id) => import(id)
-     */
-    dynamicImportProvider: (id: string) => Promise<unknown>;
+     * Options passed to the cache adapter constructor.
+     * @default {}
+     */
+    options?: Dictionary;
+    /**
+     * Enable global result caching for all queries.
+     * Can be `true`, an expiration number, or a tuple of `[key, expiration]`.
+     */
+    global?: boolean | number | [string, number];
+  };
+  /**
+   * Metadata provider class for entity discovery.
+   * Built-in options: `ReflectMetadataProvider` (default), `TsMorphMetadataProvider`.
+   * @default ReflectMetadataProvider
+   * @see https://mikro-orm.io/docs/metadata-providers
+   */
+  metadataProvider: {
+    new (config: Configuration): MetadataProvider;
+    useCache?: MetadataProvider['useCache'];
+  };
+  /**
+   * Seeder configuration options.
+   * @see https://mikro-orm.io/docs/seeding
+   */
+  seeder: SeederOptions;
+  /**
+   * Prefer read replicas for read operations when available.
+   * @default true
+   */
+  preferReadReplicas: boolean;
+  /**
+   * Custom dynamic import provider for loading modules.
+   * @default (id) => import(id)
+   */
+  dynamicImportProvider: (id: string) => Promise<unknown>;
 }