mikroorm-adapter

MikroORM adapter

@kavo/mikroorm adapts Kavo to a MikroORM EntityManager. Setup is closest to the TypeORM path — a decorated entity class is the identity, so nothing is declared twice — with the differences below.

npm install @kavo/core @kavo/nest @kavo/mikroorm

@mikro-orm/core (^7.0.0) is a peer dependency, plus whichever driver package your database needs (@mikro-orm/postgresql, @mikro-orm/mysql, @mikro-orm/sqlite, …), and @mikro-orm/decorators if you declare entities with decorators (below).

The entity class is the identity

Decorators moved out of @mikro-orm/core in v7. They live in @mikro-orm/decorators/legacy now; @mikro-orm/core still exports the runtime pieces (MikroORM, Collection, wrap, …). Importing Entity from @mikro-orm/core is the v6 spelling and no longer resolves.

// book.entity.ts
import { Entity, PrimaryKey, Property } from "@mikro-orm/decorators/legacy";

@Entity()
export class Book {
  @PrimaryKey({ type: "number" })
  id!: number;

  @Property({ type: "string" })
  title!: string;
}

@Kavo(Book)
@Controller("books")
export class BookController {}

Wiring — pass the ORM, not the EntityManager

// app.module.ts
import { Module } from "@nestjs/common";
import { KavoModule } from "@kavo/nest";
import { createInfrastructure } from "@kavo/mikroorm";
import { MikroORM } from "@mikro-orm/core";
import { defineConfig } from "@mikro-orm/postgresql";
import { Book } from "./book.entity.js";
import { BookController } from "./book.controller.js";

const orm = await MikroORM.init(defineConfig({ dbName: process.env.DB_NAME!, entities: [Book] }));

@Module({
  imports: [
    KavoModule.forRoot({
      infrastructure: createInfrastructure(orm),
    }),
  ],
  controllers: [BookController],
})
export class AppModule {}

createInfrastructure takes the MikroORM instance, not an EntityManager, on purpose. MikroORM is a Unit-of-Work ORM whose EntityManager holds an identity map, so every Kavo operation calls orm.em.fork() to get its own — the isolation a request-scoped RequestContext would give a hand-written app.