import type { EntityClass, EntityRepository, GetRepository } from '@mikro-orm/core'; import { MikroORM, type EntityManager } from '@mikro-orm/sqlite'; import type Database from 'better-sqlite3'; import { ALL_ENTITIES } from '../../src/db/entities'; import { createBoundSqliteDriver } from '../../src/db/orm-driver'; export interface TestOrm { orm: MikroORM; /** The global, context-resolving EntityManager; `clear()` empties its identity map. */ em: EntityManager; repo(entity: EntityClass): GetRepository>; clear(): void; /** Closes the ORM only — the better-sqlite3 handle stays open for the caller. */ close(): Promise; } /** * An ORM over a test database the caller already opened (usually * `createTestDb()`), so factories can keep inserting with raw SQL through the * same handle and the ORM sees those rows. * * `allowGlobalContext` defaults to true here and only here: a test builds a * service with `t.repo(X)` and calls it without an HTTP request around it. * Production keeps the default (false), which is what `withRequestContext` in * `src/nest/database/request-context.ts` is for. * * `em` and `repo()` hand out the ORM's global EntityManager rather than a fork * on purpose: a forked EntityManager has `useContext: false`, so its * `getContext()` returns itself and ignores `TransactionContext`. A `t.repo(X)` * built on a fork and used inside `uow.transactional` would write outside the * open transaction, on a second connection the transaction is holding, and * deadlock on Kysely's connection mutex. The helper therefore hands out the * same context-resolving global EM that Nest injects into services, which * resolves the transactional fork the way production does. * * `close()` on the underlying MikroORM connection ignores the `force` flag and * always tears down its Kysely client — what actually keeps the handle open * is `NonClosingSqliteDriver` in `../../src/db/orm-driver.ts`, which * `createBoundSqliteDriver` hands MikroORM in place of Kysely's stock * `SqliteDriver`; its `destroy()` is a no-op, so this `close()` never reaches * the handle at all. */ export async function createTestOrm( db: Database.Database, options: { allowGlobalContext?: boolean } = {}, ): Promise { const orm = await MikroORM.init({ entities: [...ALL_ENTITIES], driver: createBoundSqliteDriver(() => db), dbName: ':memory:', allowGlobalContext: options.allowGlobalContext ?? true, discovery: { warnWhenNoEntities: false }, }); return { orm, em: orm.em, repo: (entity) => orm.em.getRepository(entity), clear: () => orm.em.clear(), close: async () => { // The `force` flag is irrelevant here — MikroORM's connection.close() // always destroys its Kysely client either way. It's the driver's // `destroy()` being a no-op (see the docstring above) that keeps the // handle open, not this call site. await orm.close(false); }, }; }