@globalart/nestjs-unit-of-work 1.0.1

package/README.md

@@ -0,0 +1,11 @@
+# @globalart/nestjs-unit-of-work
+
+A NestJS module for working with Unit of Work pattern. Provides a convenient API for creating and managing unit of work.
+
+## Documentation
+
+For complete documentation, examples, and API reference, please visit the [official documentation](https://globalart.js.org/packages/nestjs-unit-of-work).
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,174 @@
+let _nestjs_common = require("@nestjs/common");
+let typeorm = require("typeorm");
+let async_hooks = require("async_hooks");
+let _nestjs_core = require("@nestjs/core");
+let rxjs = require("rxjs");
+
+//#region src/enums/uow.enums.ts
+let IsolationLevel = /* @__PURE__ */ function(IsolationLevel) {
+	IsolationLevel["READ_UNCOMMITTED"] = "READ UNCOMMITTED";
+	IsolationLevel["READ_COMMITTED"] = "READ COMMITTED";
+	IsolationLevel["REPEATABLE_READ"] = "REPEATABLE READ";
+	IsolationLevel["SERIALIZABLE"] = "SERIALIZABLE";
+	return IsolationLevel;
+}({});
+
+//#endregion
+//#region src/core/uow-typeorm.service.ts
+var TypeOrmUnitOfWork = class {
+	queryRunner;
+	transactionManager;
+	constructor(dataSource) {
+		this.dataSource = dataSource;
+	}
+	async begin(isolationLevel = IsolationLevel.READ_COMMITTED) {
+		this.queryRunner = this.dataSource.createQueryRunner();
+		await this.queryRunner.connect();
+		await this.queryRunner.startTransaction(isolationLevel);
+		this.transactionManager = this.queryRunner.manager;
+	}
+	async commit() {
+		if (!this.queryRunner) throw new Error("Unit of work is not started");
+		await this.queryRunner.commitTransaction();
+		await this.queryRunner.release();
+	}
+	async rollback() {
+		if (!this.queryRunner) return;
+		if (this.queryRunner.isTransactionActive) await this.queryRunner.rollbackTransaction();
+		if (!this.queryRunner.isReleased) await this.queryRunner.release();
+	}
+	conn() {
+		if (!this.transactionManager) throw new Error("Unit of work is not started or has been released");
+		return this.transactionManager;
+	}
+	get isActive() {
+		return !!this.queryRunner?.isTransactionActive;
+	}
+};
+
+//#endregion
+//#region \0@oxc-project+runtime@0.110.0/helpers/decorate.js
+function __decorate(decorators, target, key, desc) {
+	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+	return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+
+//#endregion
+//#region src/core/uow.context.ts
+let UnitOfWorkContext = class UnitOfWorkContext {
+	storage = new async_hooks.AsyncLocalStorage();
+	run(uow, callback) {
+		return this.storage.run(uow, callback);
+	}
+	get() {
+		return this.storage.getStore();
+	}
+};
+UnitOfWorkContext = __decorate([(0, _nestjs_common.Injectable)()], UnitOfWorkContext);
+
+//#endregion
+//#region \0@oxc-project+runtime@0.110.0/helpers/decorateMetadata.js
+function __decorateMetadata(k, v) {
+	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+
+//#endregion
+//#region src/core/uow.service.ts
+var _ref$1, _ref2$1;
+let UnitOfWorkManager = class UnitOfWorkManager {
+	constructor(dataSource, context) {
+		this.dataSource = dataSource;
+		this.context = context;
+	}
+	create() {
+		return new TypeOrmUnitOfWork(this.dataSource);
+	}
+	getEntityManager() {
+		const uow = this.context.get();
+		if (uow && uow.isActive) return uow.conn();
+		return this.dataSource.manager;
+	}
+	async runInTransaction(fn, isolationLevel = IsolationLevel.READ_COMMITTED) {
+		const uow = this.create();
+		return this.context.run(uow, async () => {
+			try {
+				await uow.begin(isolationLevel);
+				const result = await fn(uow);
+				await uow.commit();
+				return result;
+			} catch (error) {
+				await uow.rollback();
+				throw error;
+			}
+		});
+	}
+};
+UnitOfWorkManager = __decorate([(0, _nestjs_common.Injectable)(), __decorateMetadata("design:paramtypes", [typeof (_ref$1 = typeof typeorm.DataSource !== "undefined" && typeorm.DataSource) === "function" ? _ref$1 : Object, typeof (_ref2$1 = typeof UnitOfWorkContext !== "undefined" && UnitOfWorkContext) === "function" ? _ref2$1 : Object])], UnitOfWorkManager);
+
+//#endregion
+//#region src/decorators/uow.decorator.ts
+const UOW_METADATA_KEY = "UOW_METADATA_KEY";
+const UOW = (options) => (0, _nestjs_common.applyDecorators)((0, _nestjs_common.SetMetadata)(UOW_METADATA_KEY, options), (0, _nestjs_common.UseInterceptors)(UnitOfWorkInterceptor));
+
+//#endregion
+//#region src/interceptors/uow.interceptor.ts
+var _ref, _ref2;
+let UnitOfWorkInterceptor = class UnitOfWorkInterceptor {
+	constructor(reflector, uowManager) {
+		this.reflector = reflector;
+		this.uowManager = uowManager;
+	}
+	intercept(context, next) {
+		const uowMetadata = this.reflector.getAllAndOverride(UOW_METADATA_KEY, [context.getHandler(), context.getClass()]);
+		if (!uowMetadata) return next.handle();
+		return (0, rxjs.from)(this.uowManager.runInTransaction(async () => {
+			return await (0, rxjs.lastValueFrom)(next.handle());
+		}, uowMetadata.isolationLevel));
+	}
+};
+UnitOfWorkInterceptor = __decorate([(0, _nestjs_common.Injectable)(), __decorateMetadata("design:paramtypes", [typeof (_ref = typeof _nestjs_core.Reflector !== "undefined" && _nestjs_core.Reflector) === "function" ? _ref : Object, typeof (_ref2 = typeof UnitOfWorkManager !== "undefined" && UnitOfWorkManager) === "function" ? _ref2 : Object])], UnitOfWorkInterceptor);
+
+//#endregion
+//#region src/core/uow.module.ts
+var _UnitOfWorkModule;
+const providers = [
+	UnitOfWorkManager,
+	UnitOfWorkContext,
+	UnitOfWorkInterceptor
+];
+let UnitOfWorkModule = _UnitOfWorkModule = class UnitOfWorkModule {
+	static forRoot() {
+		return {
+			global: true,
+			module: _UnitOfWorkModule,
+			providers,
+			exports: [...providers]
+		};
+	}
+};
+UnitOfWorkModule = _UnitOfWorkModule = __decorate([(0, _nestjs_common.Global)(), (0, _nestjs_common.Module)({})], UnitOfWorkModule);
+
+//#endregion
+exports.IsolationLevel = IsolationLevel;
+exports.UOW = UOW;
+Object.defineProperty(exports, 'UnitOfWorkInterceptor', {
+  enumerable: true,
+  get: function () {
+    return UnitOfWorkInterceptor;
+  }
+});
+Object.defineProperty(exports, 'UnitOfWorkManager', {
+  enumerable: true,
+  get: function () {
+    return UnitOfWorkManager;
+  }
+});
+Object.defineProperty(exports, 'UnitOfWorkModule', {
+  enumerable: true,
+  get: function () {
+    return UnitOfWorkModule;
+  }
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["AsyncLocalStorage"],"sources":["../src/enums/uow.enums.ts","../src/core/uow-typeorm.service.ts","../src/core/uow.context.ts","../src/core/uow.service.ts","../src/decorators/uow.decorator.ts","../src/interceptors/uow.interceptor.ts","../src/core/uow.module.ts"],"sourcesContent":["export enum IsolationLevel {\n  READ_UNCOMMITTED = 'READ UNCOMMITTED',\n  READ_COMMITTED = 'READ COMMITTED',\n  REPEATABLE_READ = 'REPEATABLE READ',\n  SERIALIZABLE = 'SERIALIZABLE',\n}","import { IUnitOfWork } from '@globalart/ddd';\nimport { DataSource, EntityManager, QueryRunner } from 'typeorm';\nimport { IsolationLevel } from '../enums/uow.enums';\n\nexport class TypeOrmUnitOfWork implements IUnitOfWork<EntityManager> {\n  private queryRunner?: QueryRunner;\n  private transactionManager?: EntityManager;\n\n  constructor(private readonly dataSource: DataSource) {}\n\n  async begin(isolationLevel = IsolationLevel.READ_COMMITTED): Promise<void> {\n    this.queryRunner = this.dataSource.createQueryRunner();\n    await this.queryRunner.connect();\n    await this.queryRunner.startTransaction(isolationLevel);\n    this.transactionManager = this.queryRunner.manager;\n  }\n\n  async commit(): Promise<void> {\n    if (!this.queryRunner) {\n      throw new Error('Unit of work is not started');\n    }\n    await this.queryRunner.commitTransaction();\n    await this.queryRunner.release();\n  }\n\n  async rollback(): Promise<void> {\n    if (!this.queryRunner) {\n      return;\n    }\n    if (this.queryRunner.isTransactionActive) {\n      await this.queryRunner.rollbackTransaction();\n    }\n    if (!this.queryRunner.isReleased) {\n      await this.queryRunner.release();\n    }\n  }\n\n  conn(): EntityManager {\n    if (!this.transactionManager) {\n      throw new Error('Unit of work is not started or has been released');\n    }\n    return this.transactionManager;\n  }\n\n  get isActive(): boolean {\n    return !!this.queryRunner?.isTransactionActive;\n  }\n}\n","import { Injectable } from '@nestjs/common';\nimport { AsyncLocalStorage } from 'async_hooks';\nimport { TypeOrmUnitOfWork } from './uow-typeorm.service';\n\n@Injectable()\nexport class UnitOfWorkContext {\n  private readonly storage = new AsyncLocalStorage<TypeOrmUnitOfWork>();\n\n  run(uow: TypeOrmUnitOfWork, callback: () => any) {\n    return this.storage.run(uow, callback);\n  }\n\n  get(): TypeOrmUnitOfWork | undefined {\n    return this.storage.getStore();\n  }\n}\n\n","import { Injectable } from '@nestjs/common';\nimport { DataSource, EntityManager } from 'typeorm';\nimport { IsolationLevel } from '../enums/uow.enums';\nimport { TypeOrmUnitOfWork } from './uow-typeorm.service';\nimport { UnitOfWorkContext } from './uow.context';\n\n@Injectable()\nexport class UnitOfWorkManager {\n  constructor(\n    private readonly dataSource: DataSource,\n    private readonly context: UnitOfWorkContext,\n  ) {}\n\n  create(): TypeOrmUnitOfWork {\n    return new TypeOrmUnitOfWork(this.dataSource);\n  }\n\n  getEntityManager(): EntityManager {\n    const uow = this.context.get();\n    if (uow && uow.isActive) {\n      return uow.conn();\n    }\n    return this.dataSource.manager;\n  }\n\n  async runInTransaction<T>(\n    fn: (uow: TypeOrmUnitOfWork) => Promise<T>,\n    isolationLevel = IsolationLevel.READ_COMMITTED,\n  ): Promise<T> {\n    const uow = this.create();\n    return this.context.run(uow, async () => {\n      try {\n        await uow.begin(isolationLevel);\n        const result = await fn(uow);\n        await uow.commit();\n        return result;\n      } catch (error) {\n        await uow.rollback();\n        throw error;\n      }\n    });\n  }\n}\n","import { applyDecorators, SetMetadata, UseInterceptors } from '@nestjs/common';\nimport { IsolationLevel } from '../enums/uow.enums';\nimport { UnitOfWorkInterceptor } from '../interceptors/uow.interceptor';\n\nexport const UOW_METADATA_KEY = 'UOW_METADATA_KEY';\n\nexport interface UowOptions {\n  isolationLevel?: IsolationLevel;\n}\n\nexport const UOW = (options?: UowOptions) => applyDecorators(\n  SetMetadata(UOW_METADATA_KEY, options), \n  UseInterceptors(UnitOfWorkInterceptor)\n);\n\n","import {\n  CallHandler,\n  ExecutionContext,\n  Injectable,\n  NestInterceptor,\n} from '@nestjs/common';\nimport { Reflector } from '@nestjs/core';\nimport { Observable, from, lastValueFrom } from 'rxjs';\nimport { UOW_METADATA_KEY, UowOptions } from '../decorators/uow.decorator';\nimport { UnitOfWorkManager } from '../core/uow.service';\n\n@Injectable()\nexport class UnitOfWorkInterceptor implements NestInterceptor {\n  constructor(\n    private readonly reflector: Reflector,\n    private readonly uowManager: UnitOfWorkManager,\n  ) {}\n\n  intercept(context: ExecutionContext, next: CallHandler): Observable<any> {\n    const uowMetadata = this.reflector.getAllAndOverride<UowOptions>(\n      UOW_METADATA_KEY,\n      [context.getHandler(), context.getClass()],\n    );\n\n    if (!uowMetadata) {\n      return next.handle();\n    }\n\n    return from(\n      this.uowManager.runInTransaction(async () => {\n        return await lastValueFrom(next.handle());\n      }, uowMetadata.isolationLevel),\n    );\n  }\n}\n\n","import { DynamicModule, Module, Global } from \"@nestjs/common\";\nimport { UnitOfWorkManager } from \"./uow.service\";\nimport { UnitOfWorkContext } from \"./uow.context\";\nimport { UnitOfWorkInterceptor } from \"../interceptors/uow.interceptor\";\n\nconst providers = [\n  UnitOfWorkManager,\n  UnitOfWorkContext,\n  UnitOfWorkInterceptor\n]\n\n@Global()\n@Module({})\nexport class UnitOfWorkModule {\n  static forRoot(): DynamicModule {\n    return {\n      global: true,\n      module: UnitOfWorkModule,\n      providers,\n      exports: [...providers],\n    }\n  }\n}\n"],"mappings":";;;;;;;AAAA,IAAY,0DAAL;AACL;AACA;AACA;AACA;;;;;;ACAF,IAAa,oBAAb,MAAqE;CACnE,AAAQ;CACR,AAAQ;CAER,YAAY,AAAiB,YAAwB;EAAxB;;CAE7B,MAAM,MAAM,iBAAiB,eAAe,gBAA+B;AACzE,OAAK,cAAc,KAAK,WAAW,mBAAmB;AACtD,QAAM,KAAK,YAAY,SAAS;AAChC,QAAM,KAAK,YAAY,iBAAiB,eAAe;AACvD,OAAK,qBAAqB,KAAK,YAAY;;CAG7C,MAAM,SAAwB;AAC5B,MAAI,CAAC,KAAK,YACR,OAAM,IAAI,MAAM,8BAA8B;AAEhD,QAAM,KAAK,YAAY,mBAAmB;AAC1C,QAAM,KAAK,YAAY,SAAS;;CAGlC,MAAM,WAA0B;AAC9B,MAAI,CAAC,KAAK,YACR;AAEF,MAAI,KAAK,YAAY,oBACnB,OAAM,KAAK,YAAY,qBAAqB;AAE9C,MAAI,CAAC,KAAK,YAAY,WACpB,OAAM,KAAK,YAAY,SAAS;;CAIpC,OAAsB;AACpB,MAAI,CAAC,KAAK,mBACR,OAAM,IAAI,MAAM,mDAAmD;AAErE,SAAO,KAAK;;CAGd,IAAI,WAAoB;AACtB,SAAO,CAAC,CAAC,KAAK,aAAa;;;;;;;;;;;;;;;ACxCxB,8BAAM,kBAAkB;CAC7B,AAAiB,UAAU,IAAIA,+BAAsC;CAErE,IAAI,KAAwB,UAAqB;AAC/C,SAAO,KAAK,QAAQ,IAAI,KAAK,SAAS;;CAGxC,MAAqC;AACnC,SAAO,KAAK,QAAQ,UAAU;;;gEATrB;;;;;;;;;;;ACGN,8BAAM,kBAAkB;CAC7B,YACE,AAAiB,YACjB,AAAiB,SACjB;EAFiB;EACA;;CAGnB,SAA4B;AAC1B,SAAO,IAAI,kBAAkB,KAAK,WAAW;;CAG/C,mBAAkC;EAChC,MAAM,MAAM,KAAK,QAAQ,KAAK;AAC9B,MAAI,OAAO,IAAI,SACb,QAAO,IAAI,MAAM;AAEnB,SAAO,KAAK,WAAW;;CAGzB,MAAM,iBACJ,IACA,iBAAiB,eAAe,gBACpB;EACZ,MAAM,MAAM,KAAK,QAAQ;AACzB,SAAO,KAAK,QAAQ,IAAI,KAAK,YAAY;AACvC,OAAI;AACF,UAAM,IAAI,MAAM,eAAe;IAC/B,MAAM,SAAS,MAAM,GAAG,IAAI;AAC5B,UAAM,IAAI,QAAQ;AAClB,WAAO;YACA,OAAO;AACd,UAAM,IAAI,UAAU;AACpB,UAAM;;IAER;;;gEAlCO;;;;ACFb,MAAa,mBAAmB;AAMhC,MAAa,OAAO,gFACN,kBAAkB,QAAQ,sCACtB,sBAAsB,CACvC;;;;;ACDM,kCAAM,sBAAiD;CAC5D,YACE,AAAiB,WACjB,AAAiB,YACjB;EAFiB;EACA;;CAGnB,UAAU,SAA2B,MAAoC;EACvE,MAAM,cAAc,KAAK,UAAU,kBACjC,kBACA,CAAC,QAAQ,YAAY,EAAE,QAAQ,UAAU,CAAC,CAC3C;AAED,MAAI,CAAC,YACH,QAAO,KAAK,QAAQ;AAGtB,wBACE,KAAK,WAAW,iBAAiB,YAAY;AAC3C,UAAO,8BAAoB,KAAK,QAAQ,CAAC;KACxC,YAAY,eAAe,CAC/B;;;oEArBQ;;;;;ACNb,MAAM,YAAY;CAChB;CACA;CACA;CACD;AAIM,iDAAM,iBAAiB;CAC5B,OAAO,UAAyB;AAC9B,SAAO;GACL,QAAQ;GACR;GACA;GACA,SAAS,CAAC,GAAG,UAAU;GACxB;;;+EATI,6BACD,EAAE,CAAC"}

package/dist/index.d.cts

@@ -0,0 +1,65 @@
+import { DataSource, EntityManager } from "typeorm";
+import { IUnitOfWork } from "@globalart/ddd";
+import { CallHandler, DynamicModule, ExecutionContext, NestInterceptor } from "@nestjs/common";
+import { Reflector } from "@nestjs/core";
+import { Observable } from "rxjs";
+
+//#region src/enums/uow.enums.d.ts
+declare enum IsolationLevel {
+  READ_UNCOMMITTED = "READ UNCOMMITTED",
+  READ_COMMITTED = "READ COMMITTED",
+  REPEATABLE_READ = "REPEATABLE READ",
+  SERIALIZABLE = "SERIALIZABLE"
+}
+//#endregion
+//#region src/core/uow-typeorm.service.d.ts
+declare class TypeOrmUnitOfWork implements IUnitOfWork<EntityManager> {
+  private readonly dataSource;
+  private queryRunner?;
+  private transactionManager?;
+  constructor(dataSource: DataSource);
+  begin(isolationLevel?: IsolationLevel): Promise<void>;
+  commit(): Promise<void>;
+  rollback(): Promise<void>;
+  conn(): EntityManager;
+  get isActive(): boolean;
+}
+//#endregion
+//#region src/core/uow.context.d.ts
+declare class UnitOfWorkContext {
+  private readonly storage;
+  run(uow: TypeOrmUnitOfWork, callback: () => any): any;
+  get(): TypeOrmUnitOfWork | undefined;
+}
+//#endregion
+//#region src/core/uow.service.d.ts
+declare class UnitOfWorkManager {
+  private readonly dataSource;
+  private readonly context;
+  constructor(dataSource: DataSource, context: UnitOfWorkContext);
+  create(): TypeOrmUnitOfWork;
+  getEntityManager(): EntityManager;
+  runInTransaction<T>(fn: (uow: TypeOrmUnitOfWork) => Promise<T>, isolationLevel?: IsolationLevel): Promise<T>;
+}
+//#endregion
+//#region src/core/uow.module.d.ts
+declare class UnitOfWorkModule {
+  static forRoot(): DynamicModule;
+}
+//#endregion
+//#region src/decorators/uow.decorator.d.ts
+interface UowOptions {
+  isolationLevel?: IsolationLevel;
+}
+declare const UOW: (options?: UowOptions) => <TFunction extends Function, Y>(target: TFunction | object, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;
+//#endregion
+//#region src/interceptors/uow.interceptor.d.ts
+declare class UnitOfWorkInterceptor implements NestInterceptor {
+  private readonly reflector;
+  private readonly uowManager;
+  constructor(reflector: Reflector, uowManager: UnitOfWorkManager);
+  intercept(context: ExecutionContext, next: CallHandler): Observable<any>;
+}
+//#endregion
+export { IsolationLevel, UOW, UnitOfWorkInterceptor, UnitOfWorkManager, UnitOfWorkModule };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -0,0 +1,65 @@
+import { CallHandler, DynamicModule, ExecutionContext, NestInterceptor } from "@nestjs/common";
+import { DataSource, EntityManager } from "typeorm";
+import { Reflector } from "@nestjs/core";
+import { Observable } from "rxjs";
+import { IUnitOfWork } from "@globalart/ddd";
+
+//#region src/enums/uow.enums.d.ts
+declare enum IsolationLevel {
+  READ_UNCOMMITTED = "READ UNCOMMITTED",
+  READ_COMMITTED = "READ COMMITTED",
+  REPEATABLE_READ = "REPEATABLE READ",
+  SERIALIZABLE = "SERIALIZABLE"
+}
+//#endregion
+//#region src/core/uow-typeorm.service.d.ts
+declare class TypeOrmUnitOfWork implements IUnitOfWork<EntityManager> {
+  private readonly dataSource;
+  private queryRunner?;
+  private transactionManager?;
+  constructor(dataSource: DataSource);
+  begin(isolationLevel?: IsolationLevel): Promise<void>;
+  commit(): Promise<void>;
+  rollback(): Promise<void>;
+  conn(): EntityManager;
+  get isActive(): boolean;
+}
+//#endregion
+//#region src/core/uow.context.d.ts
+declare class UnitOfWorkContext {
+  private readonly storage;
+  run(uow: TypeOrmUnitOfWork, callback: () => any): any;
+  get(): TypeOrmUnitOfWork | undefined;
+}
+//#endregion
+//#region src/core/uow.service.d.ts
+declare class UnitOfWorkManager {
+  private readonly dataSource;
+  private readonly context;
+  constructor(dataSource: DataSource, context: UnitOfWorkContext);
+  create(): TypeOrmUnitOfWork;
+  getEntityManager(): EntityManager;
+  runInTransaction<T>(fn: (uow: TypeOrmUnitOfWork) => Promise<T>, isolationLevel?: IsolationLevel): Promise<T>;
+}
+//#endregion
+//#region src/core/uow.module.d.ts
+declare class UnitOfWorkModule {
+  static forRoot(): DynamicModule;
+}
+//#endregion
+//#region src/decorators/uow.decorator.d.ts
+interface UowOptions {
+  isolationLevel?: IsolationLevel;
+}
+declare const UOW: (options?: UowOptions) => <TFunction extends Function, Y>(target: TFunction | object, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;
+//#endregion
+//#region src/interceptors/uow.interceptor.d.ts
+declare class UnitOfWorkInterceptor implements NestInterceptor {
+  private readonly reflector;
+  private readonly uowManager;
+  constructor(reflector: Reflector, uowManager: UnitOfWorkManager);
+  intercept(context: ExecutionContext, next: CallHandler): Observable<any>;
+}
+//#endregion
+export { IsolationLevel, UOW, UnitOfWorkInterceptor, UnitOfWorkManager, UnitOfWorkModule };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,155 @@
+import { Global, Injectable, Module, SetMetadata, UseInterceptors, applyDecorators } from "@nestjs/common";
+import { DataSource } from "typeorm";
+import { AsyncLocalStorage } from "async_hooks";
+import { Reflector } from "@nestjs/core";
+import { from, lastValueFrom } from "rxjs";
+
+//#region src/enums/uow.enums.ts
+let IsolationLevel = /* @__PURE__ */ function(IsolationLevel) {
+	IsolationLevel["READ_UNCOMMITTED"] = "READ UNCOMMITTED";
+	IsolationLevel["READ_COMMITTED"] = "READ COMMITTED";
+	IsolationLevel["REPEATABLE_READ"] = "REPEATABLE READ";
+	IsolationLevel["SERIALIZABLE"] = "SERIALIZABLE";
+	return IsolationLevel;
+}({});
+
+//#endregion
+//#region src/core/uow-typeorm.service.ts
+var TypeOrmUnitOfWork = class {
+	queryRunner;
+	transactionManager;
+	constructor(dataSource) {
+		this.dataSource = dataSource;
+	}
+	async begin(isolationLevel = IsolationLevel.READ_COMMITTED) {
+		this.queryRunner = this.dataSource.createQueryRunner();
+		await this.queryRunner.connect();
+		await this.queryRunner.startTransaction(isolationLevel);
+		this.transactionManager = this.queryRunner.manager;
+	}
+	async commit() {
+		if (!this.queryRunner) throw new Error("Unit of work is not started");
+		await this.queryRunner.commitTransaction();
+		await this.queryRunner.release();
+	}
+	async rollback() {
+		if (!this.queryRunner) return;
+		if (this.queryRunner.isTransactionActive) await this.queryRunner.rollbackTransaction();
+		if (!this.queryRunner.isReleased) await this.queryRunner.release();
+	}
+	conn() {
+		if (!this.transactionManager) throw new Error("Unit of work is not started or has been released");
+		return this.transactionManager;
+	}
+	get isActive() {
+		return !!this.queryRunner?.isTransactionActive;
+	}
+};
+
+//#endregion
+//#region \0@oxc-project+runtime@0.110.0/helpers/decorate.js
+function __decorate(decorators, target, key, desc) {
+	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+	return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+
+//#endregion
+//#region src/core/uow.context.ts
+let UnitOfWorkContext = class UnitOfWorkContext {
+	storage = new AsyncLocalStorage();
+	run(uow, callback) {
+		return this.storage.run(uow, callback);
+	}
+	get() {
+		return this.storage.getStore();
+	}
+};
+UnitOfWorkContext = __decorate([Injectable()], UnitOfWorkContext);
+
+//#endregion
+//#region \0@oxc-project+runtime@0.110.0/helpers/decorateMetadata.js
+function __decorateMetadata(k, v) {
+	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+
+//#endregion
+//#region src/core/uow.service.ts
+var _ref$1, _ref2$1;
+let UnitOfWorkManager = class UnitOfWorkManager {
+	constructor(dataSource, context) {
+		this.dataSource = dataSource;
+		this.context = context;
+	}
+	create() {
+		return new TypeOrmUnitOfWork(this.dataSource);
+	}
+	getEntityManager() {
+		const uow = this.context.get();
+		if (uow && uow.isActive) return uow.conn();
+		return this.dataSource.manager;
+	}
+	async runInTransaction(fn, isolationLevel = IsolationLevel.READ_COMMITTED) {
+		const uow = this.create();
+		return this.context.run(uow, async () => {
+			try {
+				await uow.begin(isolationLevel);
+				const result = await fn(uow);
+				await uow.commit();
+				return result;
+			} catch (error) {
+				await uow.rollback();
+				throw error;
+			}
+		});
+	}
+};
+UnitOfWorkManager = __decorate([Injectable(), __decorateMetadata("design:paramtypes", [typeof (_ref$1 = typeof DataSource !== "undefined" && DataSource) === "function" ? _ref$1 : Object, typeof (_ref2$1 = typeof UnitOfWorkContext !== "undefined" && UnitOfWorkContext) === "function" ? _ref2$1 : Object])], UnitOfWorkManager);
+
+//#endregion
+//#region src/decorators/uow.decorator.ts
+const UOW_METADATA_KEY = "UOW_METADATA_KEY";
+const UOW = (options) => applyDecorators(SetMetadata(UOW_METADATA_KEY, options), UseInterceptors(UnitOfWorkInterceptor));
+
+//#endregion
+//#region src/interceptors/uow.interceptor.ts
+var _ref, _ref2;
+let UnitOfWorkInterceptor = class UnitOfWorkInterceptor {
+	constructor(reflector, uowManager) {
+		this.reflector = reflector;
+		this.uowManager = uowManager;
+	}
+	intercept(context, next) {
+		const uowMetadata = this.reflector.getAllAndOverride(UOW_METADATA_KEY, [context.getHandler(), context.getClass()]);
+		if (!uowMetadata) return next.handle();
+		return from(this.uowManager.runInTransaction(async () => {
+			return await lastValueFrom(next.handle());
+		}, uowMetadata.isolationLevel));
+	}
+};
+UnitOfWorkInterceptor = __decorate([Injectable(), __decorateMetadata("design:paramtypes", [typeof (_ref = typeof Reflector !== "undefined" && Reflector) === "function" ? _ref : Object, typeof (_ref2 = typeof UnitOfWorkManager !== "undefined" && UnitOfWorkManager) === "function" ? _ref2 : Object])], UnitOfWorkInterceptor);
+
+//#endregion
+//#region src/core/uow.module.ts
+var _UnitOfWorkModule;
+const providers = [
+	UnitOfWorkManager,
+	UnitOfWorkContext,
+	UnitOfWorkInterceptor
+];
+let UnitOfWorkModule = _UnitOfWorkModule = class UnitOfWorkModule {
+	static forRoot() {
+		return {
+			global: true,
+			module: _UnitOfWorkModule,
+			providers,
+			exports: [...providers]
+		};
+	}
+};
+UnitOfWorkModule = _UnitOfWorkModule = __decorate([Global(), Module({})], UnitOfWorkModule);
+
+//#endregion
+export { IsolationLevel, UOW, UnitOfWorkInterceptor, UnitOfWorkManager, UnitOfWorkModule };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/enums/uow.enums.ts","../src/core/uow-typeorm.service.ts","../src/core/uow.context.ts","../src/core/uow.service.ts","../src/decorators/uow.decorator.ts","../src/interceptors/uow.interceptor.ts","../src/core/uow.module.ts"],"sourcesContent":["export enum IsolationLevel {\n  READ_UNCOMMITTED = 'READ UNCOMMITTED',\n  READ_COMMITTED = 'READ COMMITTED',\n  REPEATABLE_READ = 'REPEATABLE READ',\n  SERIALIZABLE = 'SERIALIZABLE',\n}","import { IUnitOfWork } from '@globalart/ddd';\nimport { DataSource, EntityManager, QueryRunner } from 'typeorm';\nimport { IsolationLevel } from '../enums/uow.enums';\n\nexport class TypeOrmUnitOfWork implements IUnitOfWork<EntityManager> {\n  private queryRunner?: QueryRunner;\n  private transactionManager?: EntityManager;\n\n  constructor(private readonly dataSource: DataSource) {}\n\n  async begin(isolationLevel = IsolationLevel.READ_COMMITTED): Promise<void> {\n    this.queryRunner = this.dataSource.createQueryRunner();\n    await this.queryRunner.connect();\n    await this.queryRunner.startTransaction(isolationLevel);\n    this.transactionManager = this.queryRunner.manager;\n  }\n\n  async commit(): Promise<void> {\n    if (!this.queryRunner) {\n      throw new Error('Unit of work is not started');\n    }\n    await this.queryRunner.commitTransaction();\n    await this.queryRunner.release();\n  }\n\n  async rollback(): Promise<void> {\n    if (!this.queryRunner) {\n      return;\n    }\n    if (this.queryRunner.isTransactionActive) {\n      await this.queryRunner.rollbackTransaction();\n    }\n    if (!this.queryRunner.isReleased) {\n      await this.queryRunner.release();\n    }\n  }\n\n  conn(): EntityManager {\n    if (!this.transactionManager) {\n      throw new Error('Unit of work is not started or has been released');\n    }\n    return this.transactionManager;\n  }\n\n  get isActive(): boolean {\n    return !!this.queryRunner?.isTransactionActive;\n  }\n}\n","import { Injectable } from '@nestjs/common';\nimport { AsyncLocalStorage } from 'async_hooks';\nimport { TypeOrmUnitOfWork } from './uow-typeorm.service';\n\n@Injectable()\nexport class UnitOfWorkContext {\n  private readonly storage = new AsyncLocalStorage<TypeOrmUnitOfWork>();\n\n  run(uow: TypeOrmUnitOfWork, callback: () => any) {\n    return this.storage.run(uow, callback);\n  }\n\n  get(): TypeOrmUnitOfWork | undefined {\n    return this.storage.getStore();\n  }\n}\n\n","import { Injectable } from '@nestjs/common';\nimport { DataSource, EntityManager } from 'typeorm';\nimport { IsolationLevel } from '../enums/uow.enums';\nimport { TypeOrmUnitOfWork } from './uow-typeorm.service';\nimport { UnitOfWorkContext } from './uow.context';\n\n@Injectable()\nexport class UnitOfWorkManager {\n  constructor(\n    private readonly dataSource: DataSource,\n    private readonly context: UnitOfWorkContext,\n  ) {}\n\n  create(): TypeOrmUnitOfWork {\n    return new TypeOrmUnitOfWork(this.dataSource);\n  }\n\n  getEntityManager(): EntityManager {\n    const uow = this.context.get();\n    if (uow && uow.isActive) {\n      return uow.conn();\n    }\n    return this.dataSource.manager;\n  }\n\n  async runInTransaction<T>(\n    fn: (uow: TypeOrmUnitOfWork) => Promise<T>,\n    isolationLevel = IsolationLevel.READ_COMMITTED,\n  ): Promise<T> {\n    const uow = this.create();\n    return this.context.run(uow, async () => {\n      try {\n        await uow.begin(isolationLevel);\n        const result = await fn(uow);\n        await uow.commit();\n        return result;\n      } catch (error) {\n        await uow.rollback();\n        throw error;\n      }\n    });\n  }\n}\n","import { applyDecorators, SetMetadata, UseInterceptors } from '@nestjs/common';\nimport { IsolationLevel } from '../enums/uow.enums';\nimport { UnitOfWorkInterceptor } from '../interceptors/uow.interceptor';\n\nexport const UOW_METADATA_KEY = 'UOW_METADATA_KEY';\n\nexport interface UowOptions {\n  isolationLevel?: IsolationLevel;\n}\n\nexport const UOW = (options?: UowOptions) => applyDecorators(\n  SetMetadata(UOW_METADATA_KEY, options), \n  UseInterceptors(UnitOfWorkInterceptor)\n);\n\n","import {\n  CallHandler,\n  ExecutionContext,\n  Injectable,\n  NestInterceptor,\n} from '@nestjs/common';\nimport { Reflector } from '@nestjs/core';\nimport { Observable, from, lastValueFrom } from 'rxjs';\nimport { UOW_METADATA_KEY, UowOptions } from '../decorators/uow.decorator';\nimport { UnitOfWorkManager } from '../core/uow.service';\n\n@Injectable()\nexport class UnitOfWorkInterceptor implements NestInterceptor {\n  constructor(\n    private readonly reflector: Reflector,\n    private readonly uowManager: UnitOfWorkManager,\n  ) {}\n\n  intercept(context: ExecutionContext, next: CallHandler): Observable<any> {\n    const uowMetadata = this.reflector.getAllAndOverride<UowOptions>(\n      UOW_METADATA_KEY,\n      [context.getHandler(), context.getClass()],\n    );\n\n    if (!uowMetadata) {\n      return next.handle();\n    }\n\n    return from(\n      this.uowManager.runInTransaction(async () => {\n        return await lastValueFrom(next.handle());\n      }, uowMetadata.isolationLevel),\n    );\n  }\n}\n\n","import { DynamicModule, Module, Global } from \"@nestjs/common\";\nimport { UnitOfWorkManager } from \"./uow.service\";\nimport { UnitOfWorkContext } from \"./uow.context\";\nimport { UnitOfWorkInterceptor } from \"../interceptors/uow.interceptor\";\n\nconst providers = [\n  UnitOfWorkManager,\n  UnitOfWorkContext,\n  UnitOfWorkInterceptor\n]\n\n@Global()\n@Module({})\nexport class UnitOfWorkModule {\n  static forRoot(): DynamicModule {\n    return {\n      global: true,\n      module: UnitOfWorkModule,\n      providers,\n      exports: [...providers],\n    }\n  }\n}\n"],"mappings":";;;;;;;AAAA,IAAY,0DAAL;AACL;AACA;AACA;AACA;;;;;;ACAF,IAAa,oBAAb,MAAqE;CACnE,AAAQ;CACR,AAAQ;CAER,YAAY,AAAiB,YAAwB;EAAxB;;CAE7B,MAAM,MAAM,iBAAiB,eAAe,gBAA+B;AACzE,OAAK,cAAc,KAAK,WAAW,mBAAmB;AACtD,QAAM,KAAK,YAAY,SAAS;AAChC,QAAM,KAAK,YAAY,iBAAiB,eAAe;AACvD,OAAK,qBAAqB,KAAK,YAAY;;CAG7C,MAAM,SAAwB;AAC5B,MAAI,CAAC,KAAK,YACR,OAAM,IAAI,MAAM,8BAA8B;AAEhD,QAAM,KAAK,YAAY,mBAAmB;AAC1C,QAAM,KAAK,YAAY,SAAS;;CAGlC,MAAM,WAA0B;AAC9B,MAAI,CAAC,KAAK,YACR;AAEF,MAAI,KAAK,YAAY,oBACnB,OAAM,KAAK,YAAY,qBAAqB;AAE9C,MAAI,CAAC,KAAK,YAAY,WACpB,OAAM,KAAK,YAAY,SAAS;;CAIpC,OAAsB;AACpB,MAAI,CAAC,KAAK,mBACR,OAAM,IAAI,MAAM,mDAAmD;AAErE,SAAO,KAAK;;CAGd,IAAI,WAAoB;AACtB,SAAO,CAAC,CAAC,KAAK,aAAa;;;;;;;;;;;;;;;ACxCxB,8BAAM,kBAAkB;CAC7B,AAAiB,UAAU,IAAI,mBAAsC;CAErE,IAAI,KAAwB,UAAqB;AAC/C,SAAO,KAAK,QAAQ,IAAI,KAAK,SAAS;;CAGxC,MAAqC;AACnC,SAAO,KAAK,QAAQ,UAAU;;;gCATjC,YAAY;;;;;;;;;;;ACGN,8BAAM,kBAAkB;CAC7B,YACE,AAAiB,YACjB,AAAiB,SACjB;EAFiB;EACA;;CAGnB,SAA4B;AAC1B,SAAO,IAAI,kBAAkB,KAAK,WAAW;;CAG/C,mBAAkC;EAChC,MAAM,MAAM,KAAK,QAAQ,KAAK;AAC9B,MAAI,OAAO,IAAI,SACb,QAAO,IAAI,MAAM;AAEnB,SAAO,KAAK,WAAW;;CAGzB,MAAM,iBACJ,IACA,iBAAiB,eAAe,gBACpB;EACZ,MAAM,MAAM,KAAK,QAAQ;AACzB,SAAO,KAAK,QAAQ,IAAI,KAAK,YAAY;AACvC,OAAI;AACF,UAAM,IAAI,MAAM,eAAe;IAC/B,MAAM,SAAS,MAAM,GAAG,IAAI;AAC5B,UAAM,IAAI,QAAQ;AAClB,WAAO;YACA,OAAO;AACd,UAAM,IAAI,UAAU;AACpB,UAAM;;IAER;;;gCAlCL,YAAY;;;;ACFb,MAAa,mBAAmB;AAMhC,MAAa,OAAO,YAAyB,gBAC3C,YAAY,kBAAkB,QAAQ,EACtC,gBAAgB,sBAAsB,CACvC;;;;;ACDM,kCAAM,sBAAiD;CAC5D,YACE,AAAiB,WACjB,AAAiB,YACjB;EAFiB;EACA;;CAGnB,UAAU,SAA2B,MAAoC;EACvE,MAAM,cAAc,KAAK,UAAU,kBACjC,kBACA,CAAC,QAAQ,YAAY,EAAE,QAAQ,UAAU,CAAC,CAC3C;AAED,MAAI,CAAC,YACH,QAAO,KAAK,QAAQ;AAGtB,SAAO,KACL,KAAK,WAAW,iBAAiB,YAAY;AAC3C,UAAO,MAAM,cAAc,KAAK,QAAQ,CAAC;KACxC,YAAY,eAAe,CAC/B;;;oCArBJ,YAAY;;;;;ACNb,MAAM,YAAY;CAChB;CACA;CACA;CACD;AAIM,iDAAM,iBAAiB;CAC5B,OAAO,UAAyB;AAC9B,SAAO;GACL,QAAQ;GACR;GACA;GACA,SAAS,CAAC,GAAG,UAAU;GACxB;;;mDATJ,QAAQ,EACR,OAAO,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@globalart/nestjs-unit-of-work",
+  "description": "Transactional integration for NestJS",
+  "version": "1.0.1",
+  "type": "module",
+  "main": "dist/index.mjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.mts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/GlobalArtInc/ecosystem.git#main",
+    "directory": "packages/nestjs-unit-of-work"
+  },
+  "license": "MIT",
+  "author": "GlobalArt, Inc",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "nestjs",
+    "unit-of-work"
+  ],
+  "scripts": {
+    "format": "prettier --write \"**/*.ts\"",
+    "build": "tsdown",
+    "build:watch": "tsdown --watch",
+    "prepublishOnly": "npm run build",
+    "publish:dev": "npm publish --access public --tag dev",
+    "publish:npm": "release-it --config ../../.release-it.json"
+  },
+  "dependencies": {
+    "@globalart/text-utils": "^1.0.5",
+    "@nestjs/common": "11.1.12",
+    "@nestjs/core": "11.1.12",
+    "@nestjs/microservices": "^11.1.12",
+    "@nestjs/typeorm": "^11.0.0",
+    "@globalart/ddd": "^1.1.8",
+    "typeorm": "^0.3.28",
+    "rxjs": "^7.8.2"
+  },
+  "devDependencies": {
+    "@types/node": "25.1.0",
+    "prettier": "^3.8.1",
+    "reflect-metadata": "^0.2.2",
+    "release-it": "19.2.4",
+    "tsdown": "0.20.1",
+    "typescript": "^5.9.3"
+  }
+}