@tsed/mikro-orm 7.0.0-beta.2 → 7.0.0-beta.20

package/lib/esm/services/MikroOrmRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"MikroOrmRegistry.js","sourceRoot":"","sources":["../../../src/services/MikroOrmRegistry.ts"],"names":[],"mappings":";AAAA,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAC,MAAM,EAAE,UAAU,EAAC,MAAM,UAAU,CAAC;AAE5C,OAAO,EAAC,eAAe,EAAE,QAAQ,EAAC,MAAM,YAAY,CAAC;AACrD,OAAO,EAAC,MAAM,EAAC,MAAM,cAAc,CAAC;AAGpC,IAAa,gBAAgB,GAA7B,MAAa,gBAAgB;IAG3B,YAAuC,MAAc,EAA6B,eAAgC;QAA3E,WAAM,GAAN,MAAM,CAAQ;QAA6B,oBAAe,GAAf,eAAe,CAAiB;QAFjG,gBAAW,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE0D,CAAC;IAE/G,KAAK,CAAC,gBAAgB,CAA2B,iBAA6B;QACnF,MAAM,cAAc,GAAG,QAAQ,CAAS,iBAAiB,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;QAErF,IAAI,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE;YAC5B,OAAO,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;SACjC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iDAAiD,EAAE,cAAc,CAAC,CAAC;QACpF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC;QAEpD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAExE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;QAEjD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,yCAAyC,EAAE,cAAc,CAAC,CAAC;QAE5E,OAAO,UAAU,CAAC;IACpB,CAAC;IAEM,GAAG,CAAC,KAAa,SAAS;QAC/B,oEAAoE;QACpE,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC;IACnC,CAAC;IAEM,GAAG,CAAC,KAAa,SAAS;QAC/B,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;IAEM,KAAK,CAAC,gBAAgB;QAC3B,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QAEnD,MAAM,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAoB,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QAE9G,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,UAAoB;QACxC,IAAI,MAAM,UAAU,CAAC,WAAW,EAAE,EAAE;YAClC,MAAM,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;SAC/B;IACH,CAAC;CACF,CAAA;AA9CY,gBAAgB;IAD5B,UAAU,EAAE;IAIE,WAAA,MAAM,EAAE,CAAA;IAAmC,WAAA,MAAM,EAAE,CAAA;qCAAjB,MAAM,EAA8C,eAAe;GAHvG,gBAAgB,CA8C5B;SA9CY,gBAAgB","sourcesContent":["import {MikroOrmFactory} from \"./MikroOrmFactory\";\nimport {Inject, Injectable} from \"@tsed/di\";\nimport {IDatabaseDriver as DatabaseDriver, MikroORM, Options} from \"@mikro-orm/core\";\nimport {catchAsyncError, getValue} from \"@tsed/core\";\nimport {Logger} from \"@tsed/logger\";\n\n@Injectable()\nexport class MikroOrmRegistry {\n  private readonly connections = new Map<string, MikroORM>();\n\n  constructor(@Inject() private readonly logger: Logger, @Inject() private readonly mikroOrmFactory: MikroOrmFactory) {}\n\n  public async createConnection<T extends DatabaseDriver>(connectionOptions: Options<T>): Promise<MikroORM> {\n    const connectionName = getValue<string>(connectionOptions, \"contextName\", \"default\");\n\n    if (this.has(connectionName)) {\n      return this.get(connectionName);\n    }\n\n    this.logger.info(`Create connection with MikroOrm to database: %s`, connectionName);\n    this.logger.debug(`options: %j`, connectionOptions);\n\n    const connection = await this.mikroOrmFactory.create(connectionOptions);\n\n    this.connections.set(connectionName, connection);\n\n    this.logger.info(`Connected with MikroOrm to database: %s`, connectionName);\n\n    return connection;\n  }\n\n  public get(id: string = \"default\"): MikroORM {\n    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n    return this.connections.get(id)!;\n  }\n\n  public has(id: string = \"default\"): boolean {\n    return this.connections.has(id);\n  }\n\n  public async closeConnections(): Promise<void> {\n    const connections = [...this.connections.values()];\n\n    await Promise.all(connections.map((connection: MikroORM) => catchAsyncError(() => this.dispose(connection))));\n\n    this.connections.clear();\n  }\n\n  private async dispose(connection: MikroORM): Promise<void> {\n    if (await connection.isConnected()) {\n      await connection.close(false);\n    }\n  }\n}\n"]}
+{"version":3,"file":"MikroOrmRegistry.js","sourceRoot":"","sources":["../../../src/services/MikroOrmRegistry.ts"],"names":[],"mappings":";AAAA,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAC,MAAM,EAAE,UAAU,EAAC,MAAM,UAAU,CAAC;AAE5C,OAAO,EAAC,eAAe,EAAE,QAAQ,EAAC,MAAM,YAAY,CAAC;AACrD,OAAO,EAAC,MAAM,EAAC,MAAM,cAAc,CAAC;AAGpC,IAAa,gBAAgB,GAA7B,MAAa,gBAAgB;IAIY;IAA2C;IAHjE,oBAAoB,GAAG,SAAS,CAAC;IACjC,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;IAEzD,YAAuC,MAAc,EAA6B,eAAgC;QAA3E,WAAM,GAAN,MAAM,CAAQ;QAA6B,oBAAe,GAAf,eAAe,CAAiB;IAAG,CAAC;IAE/G,KAAK,CAAC,QAAQ,CAA2B,OAAmB;QACjE,MAAM,WAAW,GAAG,QAAQ,CAAS,OAAO,EAAE,aAAa,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAExF,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE;YACzB,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAE,CAAC;SAC/B;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iDAAiD,EAAE,WAAW,CAAC,CAAC;QACjF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAE1C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAE5D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAE1C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,yCAAyC,EAAE,WAAW,CAAC,CAAC;QAEzE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEM,GAAG,CAAC,WAAoB;QAC7B,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACtE,CAAC;IAEM,GAAG,CAAC,WAAoB;QAC7B,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACtE,CAAC;IAEM,MAAM;QACX,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;IACjC,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;QAE/C,MAAM,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAkB,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAExG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,QAAkB;QACtC,IAAI,MAAM,QAAQ,CAAC,WAAW,EAAE,EAAE;YAChC,MAAM,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;SAC7B;IACH,CAAC;CACF,CAAA;AAlDY,gBAAgB;IAD5B,UAAU,EAAE;IAKE,WAAA,MAAM,EAAE,CAAA;IAAmC,WAAA,MAAM,EAAE,CAAA;qCAAjB,MAAM,EAA8C,eAAe;GAJvG,gBAAgB,CAkD5B;SAlDY,gBAAgB","sourcesContent":["import {MikroOrmFactory} from \"./MikroOrmFactory\";\nimport {Inject, Injectable} from \"@tsed/di\";\nimport {IDatabaseDriver as DatabaseDriver, MikroORM, Options} from \"@mikro-orm/core\";\nimport {catchAsyncError, getValue} from \"@tsed/core\";\nimport {Logger} from \"@tsed/logger\";\n\n@Injectable()\nexport class MikroOrmRegistry {\n  private readonly DEFAULT_CONTEXT_NAME = \"default\";\n  private readonly instances = new Map<string, MikroORM>();\n\n  constructor(@Inject() private readonly logger: Logger, @Inject() private readonly mikroOrmFactory: MikroOrmFactory) {}\n\n  public async register<T extends DatabaseDriver>(options: Options<T>): Promise<MikroORM> {\n    const contextName = getValue<string>(options, \"contextName\", this.DEFAULT_CONTEXT_NAME);\n\n    if (this.has(contextName)) {\n      return this.get(contextName)!;\n    }\n\n    this.logger.info(`Create connection with MikroOrm to database: %s`, contextName);\n    this.logger.debug(`options: %j`, options);\n\n    const instance = await this.mikroOrmFactory.create(options);\n\n    this.instances.set(contextName, instance);\n\n    this.logger.info(`Connected with MikroOrm to database: %s`, contextName);\n\n    return instance;\n  }\n\n  public get(contextName?: string): MikroORM | undefined {\n    return this.instances.get(contextName ?? this.DEFAULT_CONTEXT_NAME);\n  }\n\n  public has(contextName?: string): boolean {\n    return this.instances.has(contextName ?? this.DEFAULT_CONTEXT_NAME);\n  }\n\n  public values(): IterableIterator<MikroORM> {\n    return this.instances.values();\n  }\n\n  public async clear(): Promise<void> {\n    const instances = [...this.instances.values()];\n\n    await Promise.all(instances.map((instance: MikroORM) => catchAsyncError(() => this.dispose(instance))));\n\n    this.instances.clear();\n  }\n\n  private async dispose(instance: MikroORM): Promise<void> {\n    if (await instance.isConnected()) {\n      await instance.close(false);\n    }\n  }\n}\n"]}

package/lib/types/MikroOrmModule.d.ts

@@ -1,4 +1,5 @@
-import { OnDestroy, OnInit } from "@tsed/di";
+import "./services/MikroOrmFactory";
+import { AlterRunInContext, OnDestroy, OnInit } from "@tsed/di";
 import { Options } from "@mikro-orm/core";
 declare global {
     namespace TsED {
@@ -11,9 +12,12 @@ declare global {
         }
     }
 }
-export declare class MikroOrmModule implements OnDestroy, OnInit {
+export declare class MikroOrmModule implements OnDestroy, OnInit, AlterRunInContext {
     private readonly settings;
-    private readonly mikroOrmRegistry;
+    private readonly registry;
+    private readonly context;
     $onInit(): Promise<void>;
     $onDestroy(): Promise<void>;
+    $alterRunInContext(next: (...args: unknown[]) => unknown): () => unknown | Promise<() => unknown>;
+    private createContext;
 }

package/lib/types/decorators/entityManager.d.ts

@@ -1,14 +1,14 @@
 /**
- * Get the entity manager for the given connection name.
- * @param connectionName
+ * Get the entity manager for the given context name.
+ * @param {String} contextName
  * @decorator
  * @mikroOrm
  */
-export declare const EntityManager: (connectionName?: string | undefined) => PropertyDecorator;
+export declare const EntityManager: (contextName?: string) => PropertyDecorator;
 /**
- * Get the entity manager for the given connection name.
- * @param connectionName
+ * Get the entity manager for the given context name.
+ * @param {String} connectionName
  * @decorator
  * @mikroOrm
  */
-export declare const Em: (connectionName?: string | undefined) => PropertyDecorator;
+export declare const Em: (contextName?: string) => PropertyDecorator;

package/lib/types/decorators/orm.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Get the ORM for the given context name.
+ * @param {String} contextName
+ */
+export declare const Orm: (contextName?: string) => PropertyDecorator;

package/lib/types/decorators/transactional.d.ts

@@ -1,2 +1,6 @@
-import { TransactionOptions } from "../interceptors";
-export declare const Transactional: (connectionOrOptions?: string | TransactionOptions | undefined) => MethodDecorator;
+import { TransactionOptions } from "../interceptors/TransactionalInterceptor";
+/**
+ * Register a new request context for your method and execute it inside the context.
+ * @param {String | TransactionOptions} contextNameOrOptions
+ */
+export declare const Transactional: (contextNameOrOptions?: string | TransactionOptions) => MethodDecorator;

package/lib/types/index.d.ts

@@ -1,5 +1,13 @@
-export * from "./decorators";
-export * from "./filters";
-export * from "./interceptors";
-export * from "./services";
+/**
+ * @file Automatically generated by barrelsby.
+ */
 export * from "./MikroOrmModule";
+export * from "./decorators/entityManager";
+export * from "./decorators/orm";
+export * from "./decorators/transactional";
+export * from "./filters/OptimisticLockErrorFilter";
+export * from "./interceptors/TransactionalInterceptor";
+export * from "./services/MikroOrmContext";
+export * from "./services/MikroOrmFactory";
+export * from "./services/MikroOrmRegistry";
+export * from "./services/RetryStrategy";

package/lib/types/interceptors/TransactionalInterceptor.d.ts

@@ -1,19 +1,25 @@
-import { DBContext, MikroOrmRegistry, RetryStrategy } from "../services";
 import { InterceptorContext, InterceptorMethods, InterceptorNext } from "@tsed/di";
 import { Logger } from "@tsed/logger";
+import { RetryStrategy } from "../services/RetryStrategy";
+import { MikroOrmContext } from "../services/MikroOrmContext";
+import { MikroOrmRegistry } from "../services/MikroOrmRegistry";
+import { FlushMode, IsolationLevel } from "@mikro-orm/core";
 export interface TransactionOptions {
-    connectionName?: string;
     retry?: boolean;
+    disabled?: boolean;
+    isolationLevel?: IsolationLevel;
+    flushMode?: FlushMode;
+    contextName?: string;
 }
 export declare class TransactionalInterceptor implements InterceptorMethods {
     private readonly registry;
     private readonly context;
     private readonly logger;
     private readonly retryStrategy?;
-    constructor(registry: MikroOrmRegistry, context: DBContext, logger: Logger, retryStrategy?: RetryStrategy | undefined);
+    constructor(registry: MikroOrmRegistry, context: MikroOrmContext, logger: Logger, retryStrategy?: RetryStrategy | undefined);
     intercept(context: InterceptorContext<unknown>, next: InterceptorNext): Promise<unknown>;
+    private runWithinCtx;
     private runWithinNewCtx;
-    private runUnderCtx;
     private extractContextName;
     private executeInTransaction;
 }

package/lib/types/services/MikroOrmContext.d.ts

@@ -0,0 +1,9 @@
+import { EntityManager } from "@mikro-orm/core";
+/**
+ * @internal Since 2022-06-20.
+ */
+export declare class MikroOrmContext {
+    run(managers: EntityManager[], task: (...args: unknown[]) => unknown): Promise<unknown>;
+    get(contextName?: string): EntityManager | undefined;
+    has(contextName?: string): boolean;
+}

package/lib/types/services/MikroOrmFactory.d.ts

@@ -1,5 +1,7 @@
 import { MikroORM, Options } from "@mikro-orm/core";
+import { MikroOrmContext } from "./MikroOrmContext";
 export declare class MikroOrmFactory {
-    private readonly dbContext;
-    create(connectionOptions: Options): Promise<MikroORM>;
+    private readonly context;
+    constructor(context: MikroOrmContext);
+    create(options: Options): Promise<MikroORM>;
 }

package/lib/types/services/MikroOrmRegistry.d.ts

@@ -4,11 +4,13 @@ import { Logger } from "@tsed/logger";
 export declare class MikroOrmRegistry {
     private readonly logger;
     private readonly mikroOrmFactory;
-    private readonly connections;
+    private readonly DEFAULT_CONTEXT_NAME;
+    private readonly instances;
     constructor(logger: Logger, mikroOrmFactory: MikroOrmFactory);
-    createConnection<T extends DatabaseDriver>(connectionOptions: Options<T>): Promise<MikroORM>;
-    get(id?: string): MikroORM;
-    has(id?: string): boolean;
-    closeConnections(): Promise<void>;
+    register<T extends DatabaseDriver>(options: Options<T>): Promise<MikroORM>;
+    get(contextName?: string): MikroORM | undefined;
+    has(contextName?: string): boolean;
+    values(): IterableIterator<MikroORM>;
+    clear(): Promise<void>;
     private dispose;
 }

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@tsed/mikro-orm",
-  "version": "7.0.0-beta.2",
+  "version": "7.0.0-beta.20",
   "description": "MikroORM package for Ts.ED framework",
   "private": false,
   "source": "./src/index.ts",
   "main": "./lib/cjs/index.js",
+  "module": "./lib/esm/index.js",
   "typings": "./lib/types/index.d.ts",
   "exports": {
     "types": "./lib/types/index.d.ts",
@@ -13,38 +14,42 @@
     "default": "./lib/esm/index.js"
   },
   "scripts": {
-    "build": "yarn run build:esm && yarn run build:cjs",
+    "build": "yarn barrels && yarn run build:esm && yarn run build:cjs",
     "build:cjs": "tsc --build tsconfig.compile.json",
     "build:esm": "tsc --build tsconfig.compile.esm.json",
+    "barrels": "yarn barrelsby --delete -d ./src -e \"\\.spec\\.ts\" -e \"__mock__\" -e \".benchmark.ts\"",
     "test": "cross-env NODE_ENV=test jest"
   },
   "dependencies": {
-    "tslib": "2.2.0"
+    "tslib": "2.4.0"
   },
   "devDependencies": {
-    "@mikro-orm/core": "^4.5.9",
-    "@mikro-orm/mongodb": "^4.5.9",
-    "@tsed/common": "7.0.0-beta.2",
-    "@tsed/core": "7.0.0-beta.2",
-    "@tsed/di": "7.0.0-beta.2",
-    "@tsed/json-mapper": "7.0.0-beta.2",
-    "@tsed/logger": "^6.0.0",
-    "@tsed/schema": "7.0.0-beta.2",
-    "@tsed/testing-mongoose": "7.0.0-beta.2",
+    "@mikro-orm/core": "^5.2.2",
+    "@mikro-orm/mongodb": "^5.2.2",
+    "@tsed/common": "7.0.0-beta.20",
+    "@tsed/core": "7.0.0-beta.20",
+    "@tsed/di": "7.0.0-beta.20",
+    "@tsed/json-mapper": "7.0.0-beta.20",
+    "@tsed/logger": ">=6.1.1",
+    "@tsed/schema": "7.0.0-beta.20",
+    "@tsed/testing-mongoose": "7.0.0-beta.20",
     "ts-mockito": "^2.6.1"
   },
   "peerDependencies": {
     "@mikro-orm/core": ">=4.5.9",
-    "@tsed/common": "^7.0.0-beta.2",
-    "@tsed/core": "^7.0.0-beta.2",
-    "@tsed/di": "^7.0.0-beta.2",
-    "@tsed/logger": "^6.0.0"
+    "@tsed/common": "^7.0.0-beta.20",
+    "@tsed/core": "^7.0.0-beta.20",
+    "@tsed/di": "^7.0.0-beta.20",
+    "@tsed/logger": ">=6.2.0"
   },
   "repository": "https://github.com/tsedio/tsed",
   "bugs": {
     "url": "https://github.com/tsedio/tsed/issues"
   },
-  "homepage": "https://github.com/tsedio/tsed/tree/alpha/packages/orm/mikro-orm",
+  "homepage": "https://github.com/tsedio/tsed/tree/beta/packages/orm/mikro-orm",
   "author": "Romain Lenzotti",
-  "license": "MIT"
+  "license": "MIT",
+  "publishConfig": {
+    "tag": "beta"
+  }
 }

package/readme.md

@@ -11,7 +11,8 @@
 [![npm version](https://badge.fury.io/js/%40tsed%2Fcommon.svg)](https://badge.fury.io/js/%40tsed%2Fcommon)
 [![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)
 [![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier)
-[![backers](https://opencollective.com/tsed/tiers/badge.svg)](https://opencollective.com/tsed)
+[![github](https://img.shields.io/static/v1?label=Github%20sponsor&message=%E2%9D%A4&logo=GitHub&color=%23fe8e86)](https://github.com/sponsors/romakita)
+[![opencollective](https://img.shields.io/static/v1?label=OpenCollective%20sponsor&message=%E2%9D%A4&logo=OpenCollective&color=%23fe8e86)](https://opencollective.com/tsed)
 
 </div>
 
@@ -33,13 +34,13 @@ A package of Ts.ED framework. See website: https://tsed.io/tutorials/mikro-orm
 
 Currently, `@tsed/mikro-orm` allows you:
 
-- Configure one or more MikroOrm connections via the `@Configuration` decorator. All databases will be initialized
+- Configure one or more MikroORM instances via the `@Configuration` decorator. All databases will be initialized
   when the server starts during the server's `OnInit` phase.
-- Use the Entity MikroOrm as Model for Controllers, AJV Validation and Swagger.
+- Use the Entity MikroORM as Model for Controllers, AJV Validation and Swagger.
 
 ## Installation
 
-To begin, install the MikroOrm module for TS.ED:
+To begin, install the MikroORM module for TS.ED:
 
 <Tabs class="-code">
   <Tab label="NPM">
@@ -81,7 +82,7 @@ import {MikroOrmModule} from "@tsed/mikro-orm";
       ...,
 
       entities: [
-        `${__dirname}/entity/*{.ts,.js}`
+        `./entity/*{.ts,.js}`
       ]
     },
     {
@@ -96,32 +97,32 @@ export class Server {}
 
 The `mikroOrm` options accepts the same configuration object as `init()` from the MikroORM package. Check [this page](https://mikro-orm.io/docs/configuration) for the complete configuration documentation.
 
-## Obtain a connection
+## Obtain ORM instance
 
-`@Connection` decorator lets you retrieve an instance of MikroOrm Connection.
+`@Orm` decorator lets you retrieve an instance of MikroORM.
 
 ```typescript
 import {Injectable, AfterRoutesInit} from "@tsed/common";
-import {Connection} from "@tsed/mikro-orm";
+import {Orm} from "@tsed/mikro-orm";
 import {MikroORM} from "@mikro-orm/core";
 
 @Injectable()
 export class UsersService {
-  @Connection()
-  private readonly connection!: MikroORM;
+  @Orm()
+  private readonly orm!: MikroORM;
 
   async create(user: User): Promise<User> {
     // do something
     // ...
     // Then save
-    await this.connection.em.persistAndFlush(user);
+    await this.orm.em.persistAndFlush(user);
     console.log("Saved a new user with id: " + user.id);
 
     return user;
   }
 
   async find(): Promise<User[]> {
-    const users = await this.connection.em.find(User, {});
+    const users = await this.orm.em.find(User, {});
     console.log("Loaded users: ", users);
 
     return users;
@@ -129,15 +130,15 @@ export class UsersService {
 }
 ```
 
-It's also possible to inject a connection by his name:
+It's also possible to inject an ORM by its context name:
 
-```ts
+```typescript
 import {Injectable} from "@tsed/di";
 
 @Injectable()
 export class MyService {
-  @Connection("mongo")
-  private readonly connection!: MikroORM;
+  @Orm("mongo")
+  private readonly orm!: MikroORM;
 }
 ```
 
@@ -148,7 +149,7 @@ export class MyService {
 ```typescript
 import {Injectable, AfterRoutesInit} from "@tsed/common";
 import {Em} from "@tsed/mikro-orm";
-import {EntityManager} from '@mikro-orm/mysql'; // Import EntityManager from your driver package or `@mikro-orm/knex`
+import {EntityManager} from "@mikro-orm/mysql"; // Import EntityManager from your driver package or `@mikro-orm/knex`
 
 @Injectable()
 export class UsersService {
@@ -164,16 +165,16 @@ export class UsersService {
 }
 ```
 
-It's also possible to inject Entity manager by his connection name:
+It's also possible to inject Entity manager by his context name:
 
 ```typescript
 import {Injectable, AfterRoutesInit} from "@tsed/common";
 import {Em} from "@tsed/mikro-orm";
-import {EntityManager} from '@mikro-orm/mysql'; // Import EntityManager from your driver package or `@mikro-orm/knex`
+import {EntityManager} from "@mikro-orm/mysql"; // Import EntityManager from your driver package or `@mikro-orm/knex`
 
 @Injectable()
 export class UsersService {
-  @Em("connectionName")
+  @Em("contextName")
   private readonly em!: EntityManager;
 
   async create(user: User): Promise<User> {
@@ -187,7 +188,7 @@ export class UsersService {
 
 ## Use Entity with Controller
 
-To begin, we need to define an Entity MikroOrm like this and use Ts.ED Decorator to define the JSON Schema.
+To begin, we need to define an Entity MikroORM like this and use Ts.ED Decorator to define the JSON Schema.
 
 ```typescript
 import {Property, MaxLength, Required} from "@tsed/common";
@@ -195,31 +196,30 @@ import {Entity, Property, PrimaryKey, Property as Column} from "@mikro-orm/core"
 
 @Entity()
 export class User {
-
   @PrimaryKey()
   @Property()
-  id: number;
+  id!: number;
 
   @Column()
   @MaxLength(100)
   @Required()
-  firstName: string;
+  firstName!: string;
 
   @Column()
   @MaxLength(100)
   @Required()
-  lastName: string;
+  lastName!: string;
 
   @Column()
   @Mininum(0)
   @Maximum(100)
-  age: number;
+  age!: number;
 }
 ```
 
 Now, the model is correctly defined and can be used with a [Controller](https://tsed.io/docs/controllers.html)
 , [AJV validation](tutorials/ajv.md),
-[Swagger](tutorials/swagger.md) and [MikroOrm](https://mikro-orm.io/docs/defining-entities).
+[Swagger](tutorials/swagger.md) and [MikroORM](https://mikro-orm.io/docs/defining-entities).
 
 We can use this model with a Controller like that:
 
@@ -229,7 +229,7 @@ import {Controller, Post, BodyParams, Inject, Post, Get} from "@tsed/common";
 @Controller("/users")
 export class UsersCtrl {
   @Inject()
-  private usersService: UsersService;
+  private readonly usersService!: UsersService;
 
   @Post("/")
   create(@BodyParams() user: User): Promise<User> {
@@ -258,7 +258,7 @@ import {Transactional} from "@tsed/mikro-orm";
 @Controller("/users")
 export class UsersCtrl {
   @Inject()
-  private usersService: UsersService;
+  private readonly usersService!: UsersService;
 
   @Post("/")
   @Transactional()
@@ -273,13 +273,49 @@ export class UsersCtrl {
 }
 ```
 
+By default, `IsolationLevel.READ_COMMITTED` is used. You can override it, specifying the isolation level for the transaction by supplying it as the `isolationLevel` parameter in the `@Transactional` decorator:
+
+```typescript
+@Post("/")
+@Transactional({isolationLevel: IsolationLevel.SERIALIZABLE})
+create(@BodyParams() user: User): Promise<User> {
+  return this.usersService.create(user);
+}
+```
+
+The MikroORM supports the standard isolation levels such as `SERIALIZABLE` or `REPEATABLE READ`, the full list of available options see [here](https://mikro-orm.io/docs/transactions#isolation-levels).
+
+You can also set the [flushing strategy](https://mikro-orm.io/docs/unit-of-work#flush-modes) for the transaction by setting the `flushMode`:
+
+```typescript
+@Post("/")
+@Transactional({flushMode: FlushMode.AUTO})
+create(@BodyParams() user: User): Promise<User> {
+  return this.usersService.create(user);
+}
+```
+
+In some cases, you might need to avoid an explicit transaction, but preserve an async context to prevent the usage of the global identity map. For example, starting with v3.4, the MongoDB driver supports transactions. Yet, you have to use a replica set, otherwise, the driver will raise an exception.
+
+To prevent `@Transactional()` use of an explicit transaction, you just need to set the `disabled` field to `true`:
+
+```typescript
+@Post("/")
+@Transactional({disabled: true})
+create(@BodyParams() user: User): Promise<User> {
+  return this.usersService.create(user);
+}
+```
+
+## Retry policy
+
 By default, the automatic retry policy is disabled. You can implement your own to match the business requirements and the nature of the failure. For some noncritical operations, it is better to fail as soon as possible rather than retry a coupe of times. For example, in an interactive web application, it is better to fail right after a smaller number of retries with only a short delay between retry attempts, and display a message to the user (for example, "please try again later").
 
 The `@Transactional()` decorator allows you to enable a retry policy for the particular resources. You just need to implement the `RetryStrategy` interface and use `registerProvider()` or `@OverrideProvider()` to register it in the IoC container. Below you can find an example to handle occurred optimistic locks based on [an exponential backoff retry strategy](https://en.wikipedia.org/wiki/Exponential_backoff).
 
-```ts
-import { OptimisticLockError } from '@mikro-orm/core';
-import { RetryStrategy } from '@tsed/mikro-orm';
+```typescript
+import {OptimisticLockError} from "@mikro-orm/core";
+import {RetryStrategy} from "@tsed/mikro-orm";
 
 export interface ExponentialBackoffOptions {
   maxDepth: number;
@@ -290,16 +326,11 @@ export class ExponentialBackoff implements RetryStrategy {
 
   constructor(private readonly options: ExponentialBackoffOptions) {}
 
-  public async acquire<T extends (...args: unknown[]) => unknown>(
-    task: T
-  ): Promise<ReturnType<T>> {
+  public async acquire<T extends (...args: unknown[]) => unknown>(task: T): Promise<ReturnType<T>> {
     try {
       return (await task()) as ReturnType<T>;
     } catch (e) {
-      if (
-        this.shouldRetry(e as Error) &&
-        this.depth < this.options.maxDepth
-      ) {
+      if (this.shouldRetry(e as Error) && this.depth < this.options.maxDepth) {
         return this.retry(task);
       }
 
@@ -311,9 +342,7 @@ export class ExponentialBackoff implements RetryStrategy {
     return error instanceof OptimisticLockError;
   }
 
-  private async retry<T extends (...args: unknown[]) => unknown>(
-    task: T
-  ): Promise<ReturnType<T>> {
+  private async retry<T extends (...args: unknown[]) => unknown>(task: T): Promise<ReturnType<T>> {
     await this.sleep(2 ** this.depth * 50);
 
     this.depth += 1;
@@ -322,14 +351,14 @@ export class ExponentialBackoff implements RetryStrategy {
   }
 
   private sleep(milliseconds: number): Promise<void> {
-    return new Promise(resolve => setTimeout(resolve, milliseconds));
+    return new Promise((resolve) => setTimeout(resolve, milliseconds));
   }
 }
 
 registerProvider({
   provide: RetryStrategy,
   useFactory(): ExponentialBackoff {
-    return new ExponentialBackoff({maxDepth: 3})
+    return new ExponentialBackoff({maxDepth: 3});
   }
 });
 ```
@@ -345,7 +374,7 @@ import {Transactional} from "@tsed/mikro-orm";
 @Controller("/users")
 export class UsersCtrl {
   @Inject()
-  private usersService: UsersService;
+  private readonly usersService!: UsersService;
 
   @Post("/")
   @Transactional({retry: true})
@@ -381,7 +410,7 @@ website. [[Become a sponsor](https://opencollective.com/tsed#sponsor)]
 
 The MIT License (MIT)
 
-Copyright (c) 2016 - 2018 Romain Lenzotti
+Copyright (c) 2016 - 2022 Romain Lenzotti
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
 documentation files (the "Software"), to deal in the Software without restriction, including without limitation the

package/tsconfig.compile.esm.json

@@ -8,16 +8,5 @@
     "declaration": true,
     "declarationDir": "./lib/types"
   },
-  "exclude": [
-    "node_modules",
-    "test",
-    "lib",
-    "benchmark",
-    "coverage",
-    "spec",
-    "**/*.benchmark.ts",
-    "**/*.spec.ts",
-    "keys",
-    "jest.config.js"
-  ]
+  "exclude": ["node_modules", "test", "lib", "benchmark", "coverage", "spec", "**/*.benchmark.ts", "**/*.spec.ts", "keys", "jest.config.js"]
 }

package/lib/cjs/decorators/connection.d.ts

@@ -1 +0,0 @@
-export declare const Connection: (connectionName?: string | undefined) => PropertyDecorator;

package/lib/cjs/decorators/connection.js

@@ -1,8 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Connection = void 0;
-const services_1 = require("../services");
-const di_1 = require("@tsed/di");
-const Connection = (connectionName) => (0, di_1.Inject)(services_1.MikroOrmRegistry, (registry) => registry.get(connectionName));
-exports.Connection = Connection;
-//# sourceMappingURL=connection.js.map

package/lib/cjs/decorators/connection.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../../src/decorators/connection.ts"],"names":[],"mappings":";;;AAAA,0CAA6C;AAC7C,iCAAgC;AAEzB,MAAM,UAAU,GAAG,CAAC,cAAuB,EAAqB,EAAE,CACvE,IAAA,WAAM,EAAC,2BAAgB,EAAE,CAAC,QAA0B,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAsB,CAAC;AADjG,QAAA,UAAU,cACuF","sourcesContent":["import {MikroOrmRegistry} from \"../services\";\nimport {Inject} from \"@tsed/di\";\n\nexport const Connection = (connectionName?: string): PropertyDecorator =>\n  Inject(MikroOrmRegistry, (registry: MikroOrmRegistry) => registry.get(connectionName)) as PropertyDecorator;\n"]}

package/lib/cjs/decorators/index.d.ts

@@ -1,3 +0,0 @@
-export * from "./transactional";
-export * from "./connection";
-export * from "./entityManager";

package/lib/cjs/decorators/index.js

@@ -1,7 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-(0, tslib_1.__exportStar)(require("./transactional"), exports);
-(0, tslib_1.__exportStar)(require("./connection"), exports);
-(0, tslib_1.__exportStar)(require("./entityManager"), exports);
-//# sourceMappingURL=index.js.map

package/lib/cjs/decorators/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/decorators/index.ts"],"names":[],"mappings":";;;AAAA,+DAAgC;AAChC,4DAA6B;AAC7B,+DAAgC","sourcesContent":["export * from \"./transactional\";\nexport * from \"./connection\";\nexport * from \"./entityManager\";\n"]}

package/lib/cjs/filters/index.d.ts

@@ -1 +0,0 @@
-export * from "./OptimisticLockErrorFilter";

package/lib/cjs/filters/index.js

@@ -1,5 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-(0, tslib_1.__exportStar)(require("./OptimisticLockErrorFilter"), exports);
-//# sourceMappingURL=index.js.map

package/lib/cjs/filters/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/filters/index.ts"],"names":[],"mappings":";;;AAAA,2EAA4C","sourcesContent":["export * from \"./OptimisticLockErrorFilter\";\n"]}

package/lib/cjs/interceptors/index.d.ts

@@ -1 +0,0 @@
-export * from "./TransactionalInterceptor";

package/lib/cjs/interceptors/index.js

@@ -1,5 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-(0, tslib_1.__exportStar)(require("./TransactionalInterceptor"), exports);
-//# sourceMappingURL=index.js.map

package/lib/cjs/interceptors/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interceptors/index.ts"],"names":[],"mappings":";;;AAAA,0EAA2C","sourcesContent":["export * from \"./TransactionalInterceptor\";\n"]}