@nestplatform/transactional 1.0.0

package/README.md

@@ -0,0 +1,94 @@
+# @nestplatform/transactional
+
+A powerful, ORM-agnostic transaction management module for NestJS, inspired by Spring Framework's `@Transactional` annotation.
+
+## Features
+
+- 🚀 **Declarative Transactions**: Use `@Transactional()` decorator on classes or methods.
+- 🔗 **ORM Agnostic**: Support for any ORM via a plugin-based architecture (TypeORM, etc.).
+- 🌊 **Propagation Support**: Manage transaction boundaries with `REQUIRED`, `REQUIRES_NEW`, and `NESTED`.
+- 🛡️ **Opt-out Support**: Easily exclude methods from class-level transactions with `@NoTransactional()`.
+- 📝 **Transaction Context**: Access the active transaction/store anywhere in the call chain.
+- 📜 **Logging**: Built-in logging for transaction lifecycles.
+
+## Installation
+
+```bash
+npm install @nestplatform/transactional
+```
+
+## Usage
+
+### 1. Register the module
+
+You need to provide a transaction adapter for your chosen ORM (e.g., `@nestplatform/transactional-typeorm`).
+
+```typescript
+import { TransactionalModule } from '@nestplatform/transactional';
+import { TypeOrmTransactionAdapter } from '@nestplatform/transactional-typeorm';
+
+@Module({
+  imports: [
+    TransactionalModule.registerAsync({
+      inject: [DataSource],
+      useFactory: (dataSource: DataSource) => ({
+        adapters: new TypeOrmTransactionAdapter(dataSource),
+        logging: true,
+      }),
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+### 2. Apply the decorator
+
+Apply `@Transactional()` to your service classes or individual methods.
+
+```typescript
+import { Injectable } from '@nestjs/common';
+import { Transactional, TransactionPropagation, NoTransactional } from '@nestplatform/transactional';
+
+@Injectable()
+@Transactional() // Class-level: all methods will run in a transaction
+export class OrderService {
+  constructor(private readonly orderRepo: Repository<Order>) {}
+
+  // Defaults to REQUIRED propagation
+  async createOrder(data: any) {
+    return this.orderRepo.save(data);
+  }
+
+  @Transactional({ propagation: TransactionPropagation.REQUIRES_NEW })
+  async createAuditLog(log: any) {
+    // This runs in a SEPARATE transaction
+    return this.auditRepo.save(log);
+  }
+
+  @NoTransactional() // Opt-out from class-level transaction
+  async findById(id: string) {
+    return this.orderRepo.findOne(id);
+  }
+}
+```
+
+## Propagation Levels
+
+- **REQUIRED** (Default): Support a current transaction, create a new one if none exists.
+- **REQUIRES_NEW**: Create a new transaction, suspending the current transaction if one exists.
+- **NESTED**: Execute within a nested transaction if a current transaction exists (via Savepoints).
+
+## Accessing Transaction Context
+
+You can access the current transaction store (e.g., TypeORM QueryRunner) anywhere using `TransactionContext`.
+
+```typescript
+import { TransactionContext } from '@nestplatform/transactional';
+
+const store = TransactionContext.getStore();
+const queryRunner = store?.transaction;
+```
+
+## License
+
+MIT

package/dist/decorators/index.d.ts

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

package/dist/decorators/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./transactional.decorator"), exports);
+//# sourceMappingURL=index.js.map

package/dist/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4DAA0C"}

package/dist/decorators/transactional.decorator.d.ts

@@ -0,0 +1,3 @@
+import { TransactionalOptions } from "../types";
+export declare const Transactional: (options?: TransactionalOptions) => ClassDecorator & MethodDecorator;
+export declare const NoTransactional: () => MethodDecorator;

package/dist/decorators/transactional.decorator.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoTransactional = exports.Transactional = void 0;
+const common_1 = require("@nestjs/common");
+const transactional_constant_1 = require("../transactional.constant");
+const types_1 = require("../types");
+const TRANSACTIONAL_DEFAULTS = {
+    propagation: types_1.TransactionPropagation.REQUIRED,
+    logging: false,
+};
+const Transactional = (options) => {
+    const mergedOptions = {
+        ...TRANSACTIONAL_DEFAULTS,
+        ...options,
+    };
+    return (0, common_1.applyDecorators)((0, common_1.SetMetadata)(transactional_constant_1.TRANSACTIONAL_METADATA, mergedOptions));
+};
+exports.Transactional = Transactional;
+const NoTransactional = () => {
+    return (0, common_1.applyDecorators)((0, common_1.SetMetadata)(transactional_constant_1.NO_TRANSACTIONAL_METADATA, true));
+};
+exports.NoTransactional = NoTransactional;
+//# sourceMappingURL=transactional.decorator.js.map

package/dist/decorators/transactional.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactional.decorator.js","sourceRoot":"","sources":["../../src/decorators/transactional.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAA8D;AAE9D,sEAA8F;AAC9F,oCAAwE;AAExE,MAAM,sBAAsB,GAAkE;IAC5F,WAAW,EAAE,8BAAsB,CAAC,QAAQ;IAC5C,OAAO,EAAE,KAAK;CACf,CAAC;AAuBK,MAAM,aAAa,GAAG,CAAC,OAA8B,EAAoC,EAAE;IAChG,MAAM,aAAa,GAAyB;QAC1C,GAAG,sBAAsB;QACzB,GAAG,OAAO;KACX,CAAC;IAEF,OAAO,IAAA,wBAAe,EAAC,IAAA,oBAAW,EAAC,+CAAsB,EAAE,aAAa,CAAC,CAAC,CAAC;AAC7E,CAAC,CAAC;AAPW,QAAA,aAAa,iBAOxB;AAaK,MAAM,eAAe,GAAG,GAAoB,EAAE;IACnD,OAAO,IAAA,wBAAe,EAAC,IAAA,oBAAW,EAAC,kDAAyB,EAAE,IAAI,CAAC,CAAC,CAAC;AACvE,CAAC,CAAC;AAFW,QAAA,eAAe,mBAE1B"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./interfaces";
+export * from "./decorators";
+export * from "./transactional.module";
+export * from "./transactional.constant";
+export * from "./transaction-context";
+export * from "./types";

package/dist/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./interfaces"), exports);
+__exportStar(require("./decorators"), exports);
+__exportStar(require("./transactional.module"), exports);
+__exportStar(require("./transactional.constant"), exports);
+__exportStar(require("./transaction-context"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,+CAA6B;AAC7B,yDAAuC;AACvC,2DAAyC;AACzC,wDAAsC;AACtC,0CAAwB"}

package/dist/interfaces/index.d.ts

@@ -0,0 +1 @@
+export * from "./transaction-adapter.interface";

package/dist/interfaces/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./transaction-adapter.interface"), exports);
+//# sourceMappingURL=index.js.map

package/dist/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kEAAgD"}

package/dist/interfaces/transaction-adapter.interface.d.ts

@@ -0,0 +1,6 @@
+import { TransactionExecuteOptions } from "../types";
+export interface ITransactionAdapter {
+    proxyInstance?<T extends object>(instance: T): T;
+    execute<T>(callback: () => Promise<T>, options: TransactionExecuteOptions): Promise<T>;
+    getActiveTransaction(): any | undefined;
+}

package/dist/interfaces/transaction-adapter.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=transaction-adapter.interface.js.map

package/dist/interfaces/transaction-adapter.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-adapter.interface.js","sourceRoot":"","sources":["../../src/interfaces/transaction-adapter.interface.ts"],"names":[],"mappings":""}

package/dist/providers/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./transaction-adapter.provider";
+export * from "./transaction-adapter-async.provider";

package/dist/providers/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./transaction-adapter.provider"), exports);
+__exportStar(require("./transaction-adapter-async.provider"), exports);
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iEAA+C;AAC/C,uEAAqD"}

package/dist/providers/transaction-adapter-async.provider.d.ts

@@ -0,0 +1,3 @@
+import { FactoryProvider } from "@nestjs/common";
+import { TransactionalModuleConfigAsync } from "../types";
+export declare const TransactionAdapterAsyncProvider: (config: TransactionalModuleConfigAsync) => FactoryProvider;

package/dist/providers/transaction-adapter-async.provider.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionAdapterAsyncProvider = void 0;
+const transactional_constant_1 = require("../transactional.constant");
+const TransactionAdapterAsyncProvider = (config) => {
+    return {
+        provide: transactional_constant_1.TRANSACTION_ADAPTERS,
+        inject: config.inject,
+        useFactory: async (...args) => {
+            const { adapters } = await config.useFactory(...args);
+            return !!adapters["execute"] ? { [transactional_constant_1.DEFAULT_TRANSACTION_ADAPTER]: adapters } : adapters;
+        },
+    };
+};
+exports.TransactionAdapterAsyncProvider = TransactionAdapterAsyncProvider;
+//# sourceMappingURL=transaction-adapter-async.provider.js.map

package/dist/providers/transaction-adapter-async.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-adapter-async.provider.js","sourceRoot":"","sources":["../../src/providers/transaction-adapter-async.provider.ts"],"names":[],"mappings":";;;AAEA,sEAA8F;AAGvF,MAAM,+BAA+B,GAAG,CAAC,MAAsC,EAAmB,EAAE;IACzG,OAAO;QACL,OAAO,EAAE,6CAAoB;QAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,UAAU,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE;YAC5B,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;YAGtD,OAAO,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,oDAA2B,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QACxF,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AAXW,QAAA,+BAA+B,mCAW1C"}

package/dist/providers/transaction-adapter.provider.d.ts

@@ -0,0 +1,3 @@
+import { FactoryProvider } from "@nestjs/common";
+import { TransactionalModuleConfigSync } from "../types";
+export declare const TransactionAdapterProvider: (config: TransactionalModuleConfigSync) => FactoryProvider;

package/dist/providers/transaction-adapter.provider.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionAdapterProvider = void 0;
+const transactional_constant_1 = require("../transactional.constant");
+const TransactionAdapterProvider = (config) => {
+    return {
+        provide: transactional_constant_1.TRANSACTION_ADAPTERS,
+        useFactory: async () => {
+            const adapters = config.adapters;
+            return !!adapters["execute"] ? { [transactional_constant_1.DEFAULT_TRANSACTION_ADAPTER]: adapters } : adapters;
+        },
+    };
+};
+exports.TransactionAdapterProvider = TransactionAdapterProvider;
+//# sourceMappingURL=transaction-adapter.provider.js.map

package/dist/providers/transaction-adapter.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-adapter.provider.js","sourceRoot":"","sources":["../../src/providers/transaction-adapter.provider.ts"],"names":[],"mappings":";;;AAEA,sEAA8F;AAGvF,MAAM,0BAA0B,GAAG,CAAC,MAAqC,EAAmB,EAAE;IACnG,OAAO;QACL,OAAO,EAAE,6CAAoB;QAC7B,UAAU,EAAE,KAAK,IAAI,EAAE;YACrB,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;YAGjC,OAAO,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,oDAA2B,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QACxF,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AAVW,QAAA,0BAA0B,8BAUrC"}

package/dist/transaction-context.d.ts

@@ -0,0 +1,10 @@
+export type TransactionStore = {
+    transaction: any;
+    adapterKey: string;
+};
+export declare class TransactionContext {
+    private static readonly storage;
+    static run<T>(store: TransactionStore, fn: () => Promise<T>): Promise<T>;
+    static getStore(): TransactionStore | undefined;
+    static getTransaction<T = any>(): T | undefined;
+}

package/dist/transaction-context.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionContext = void 0;
+const node_async_hooks_1 = require("node:async_hooks");
+class TransactionContext {
+    static run(store, fn) {
+        return this.storage.run(store, fn);
+    }
+    static getStore() {
+        return this.storage.getStore();
+    }
+    static getTransaction() {
+        return this.storage.getStore()?.transaction;
+    }
+}
+exports.TransactionContext = TransactionContext;
+TransactionContext.storage = new node_async_hooks_1.AsyncLocalStorage();
+//# sourceMappingURL=transaction-context.js.map

package/dist/transaction-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-context.js","sourceRoot":"","sources":["../src/transaction-context.ts"],"names":[],"mappings":";;;AAAA,uDAAqD;AAoBrD,MAAa,kBAAkB;IAO7B,MAAM,CAAC,GAAG,CAAI,KAAuB,EAAE,EAAoB;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACrC,CAAC;IAMD,MAAM,CAAC,QAAQ;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;IACjC,CAAC;IAMD,MAAM,CAAC,cAAc;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,WAAW,CAAC;IAC9C,CAAC;;AAzBH,gDA0BC;AAzByB,0BAAO,GAAG,IAAI,oCAAiB,EAAoB,CAAC"}

package/dist/transactional-feature.decoration.d.ts

@@ -0,0 +1,7 @@
+import { FeatureDecoration } from "@nestplatform/common";
+import { TransactionalOptions, TransactionAdapters } from "./types";
+export declare class TransactionalFeatureDecoration extends FeatureDecoration {
+    private readonly adapters;
+    constructor(adapters: TransactionAdapters);
+    wrapMethodWithTransaction(instance: any, methodName: string, originalMethod: Function, options: TransactionalOptions): void;
+}

package/dist/transactional-feature.decoration.js

@@ -0,0 +1,67 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionalFeatureDecoration = void 0;
+const common_1 = require("@nestjs/common");
+const common_2 = require("@nestplatform/common");
+const transactional_constant_1 = require("./transactional.constant");
+const types_1 = require("./types");
+const LOGGING_CONTEXT = "TransactionalModule";
+let TransactionalFeatureDecoration = class TransactionalFeatureDecoration extends common_2.FeatureDecoration {
+    constructor(adapters) {
+        super();
+        this.adapters = adapters;
+    }
+    wrapMethodWithTransaction(instance, methodName, originalMethod, options) {
+        const adapterKey = options.adapter || transactional_constant_1.DEFAULT_TRANSACTION_ADAPTER;
+        const fallbackAdapter = Object.values(this.adapters)[0];
+        const adapter = this.adapters[adapterKey] || fallbackAdapter;
+        if (!adapter) {
+            if (options.logging) {
+                common_1.Logger.warn(`Transaction adapter "${adapterKey}" not found. Skip wrapping for method ${methodName}.`, LOGGING_CONTEXT);
+            }
+            return;
+        }
+        instance[methodName] = async (...args) => {
+            const methodString = (0, common_2.stringifyMethod)(methodName, ...args);
+            if (options.logging) {
+                common_1.Logger.log(`Starting transaction for \`${methodString}\` [${options.propagation || types_1.TransactionPropagation.REQUIRED}]`, LOGGING_CONTEXT);
+            }
+            try {
+                const proxiedInstance = adapter.proxyInstance?.(instance);
+                const result = await adapter.execute(() => originalMethod.apply(proxiedInstance || instance, args), {
+                    propagation: options.propagation || types_1.TransactionPropagation.REQUIRED,
+                    isolation: options.isolation,
+                });
+                if (options.logging) {
+                    common_1.Logger.log(`Transaction committed for \`${methodString}\``, LOGGING_CONTEXT);
+                }
+                return result;
+            }
+            catch (error) {
+                if (options.logging) {
+                    common_1.Logger.error(`Transaction rolled back for \`${methodString}\`: ${error}`, LOGGING_CONTEXT);
+                }
+                throw error;
+            }
+        };
+    }
+};
+exports.TransactionalFeatureDecoration = TransactionalFeatureDecoration;
+exports.TransactionalFeatureDecoration = TransactionalFeatureDecoration = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(transactional_constant_1.TRANSACTION_ADAPTERS)),
+    __metadata("design:paramtypes", [Object])
+], TransactionalFeatureDecoration);
+//# sourceMappingURL=transactional-feature.decoration.js.map

package/dist/transactional-feature.decoration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactional-feature.decoration.js","sourceRoot":"","sources":["../src/transactional-feature.decoration.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAA4D;AAE5D,iDAA0E;AAE1E,qEAA6F;AAE7F,mCAA4F;AAE5F,MAAM,eAAe,GAAG,qBAAqB,CAAC;AAGvC,IAAM,8BAA8B,GAApC,MAAM,8BAA+B,SAAQ,0BAAiB;IACnE,YAA2D,QAA6B;QACtF,KAAK,EAAE,CAAC;QADiD,aAAQ,GAAR,QAAQ,CAAqB;IAExF,CAAC;IAOM,yBAAyB,CAAC,QAAa,EAAE,UAAkB,EAAE,cAAwB,EAAE,OAA6B;QACzH,MAAM,UAAU,GAAW,OAAO,CAAC,OAAO,IAAI,oDAA2B,CAAC;QAC1E,MAAM,eAAe,GAAoC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAEzF,MAAM,OAAO,GAAoC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,eAAe,CAAC;QAE9F,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACpB,eAAM,CAAC,IAAI,CAAC,wBAAwB,UAAU,yCAAyC,UAAU,GAAG,EAAE,eAAe,CAAC,CAAC;YACzH,CAAC;YAED,OAAO;QACT,CAAC;QAED,QAAQ,CAAC,UAAU,CAAC,GAAG,KAAK,EAAE,GAAG,IAAW,EAAgB,EAAE;YAC5D,MAAM,YAAY,GAAW,IAAA,wBAAe,EAAC,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;YAElE,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACpB,eAAM,CAAC,GAAG,CAAC,8BAA8B,YAAY,OAAO,OAAO,CAAC,WAAW,IAAI,8BAAsB,CAAC,QAAQ,GAAG,EAAE,eAAe,CAAC,CAAC;YAC1I,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,eAAe,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,QAAQ,CAAC,CAAC;gBAC1D,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,eAAe,IAAI,QAAQ,EAAE,IAAI,CAAC,EAAE;oBAClG,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,8BAAsB,CAAC,QAAQ;oBACnE,SAAS,EAAE,OAAO,CAAC,SAAS;iBAC7B,CAAC,CAAC;gBAEH,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;oBACpB,eAAM,CAAC,GAAG,CAAC,+BAA+B,YAAY,IAAI,EAAE,eAAe,CAAC,CAAC;gBAC/E,CAAC;gBAED,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;oBACpB,eAAM,CAAC,KAAK,CAAC,iCAAiC,YAAY,OAAO,KAAK,EAAE,EAAE,eAAe,CAAC,CAAC;gBAC7F,CAAC;gBAED,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;CACF,CAAA;AApDY,wEAA8B;yCAA9B,8BAA8B;IAD1C,IAAA,mBAAU,GAAE;IAEE,WAAA,IAAA,eAAM,EAAC,6CAAoB,CAAC,CAAA;;GAD9B,8BAA8B,CAoD1C"}

package/dist/transactional-metadata.accessor.d.ts

@@ -0,0 +1,9 @@
+import { Reflector } from "@nestjs/core";
+import { MetadataAccessor } from "@nestplatform/common";
+import { TransactionalOptions } from "./types";
+export declare class TransactionalMetadataAccessor extends MetadataAccessor {
+    protected readonly reflector: Reflector;
+    constructor(reflector: Reflector);
+    getTransactionalMetadata(target: Function): TransactionalOptions | undefined;
+    getNoTransactionalMetadata(target: Function): boolean | undefined;
+}

package/dist/transactional-metadata.accessor.js

@@ -0,0 +1,34 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionalMetadataAccessor = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const common_2 = require("@nestplatform/common");
+const transactional_constant_1 = require("./transactional.constant");
+let TransactionalMetadataAccessor = class TransactionalMetadataAccessor extends common_2.MetadataAccessor {
+    constructor(reflector) {
+        super();
+        this.reflector = reflector;
+    }
+    getTransactionalMetadata(target) {
+        return this.getMetadata(transactional_constant_1.TRANSACTIONAL_METADATA, target);
+    }
+    getNoTransactionalMetadata(target) {
+        return this.getMetadata(transactional_constant_1.NO_TRANSACTIONAL_METADATA, target);
+    }
+};
+exports.TransactionalMetadataAccessor = TransactionalMetadataAccessor;
+exports.TransactionalMetadataAccessor = TransactionalMetadataAccessor = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.Reflector])
+], TransactionalMetadataAccessor);
+//# sourceMappingURL=transactional-metadata.accessor.js.map

package/dist/transactional-metadata.accessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactional-metadata.accessor.js","sourceRoot":"","sources":["../src/transactional-metadata.accessor.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,uCAAyC;AAEzC,iDAAwD;AAExD,qEAA6F;AAItF,IAAM,6BAA6B,GAAnC,MAAM,6BAA8B,SAAQ,yBAAgB;IACjE,YAA+B,SAAoB;QACjD,KAAK,EAAE,CAAC;QADqB,cAAS,GAAT,SAAS,CAAW;IAEnD,CAAC;IAMM,wBAAwB,CAAC,MAAgB;QAC9C,OAAO,IAAI,CAAC,WAAW,CAAuB,+CAAsB,EAAE,MAAM,CAAC,CAAC;IAChF,CAAC;IAMM,0BAA0B,CAAC,MAAgB;QAChD,OAAO,IAAI,CAAC,WAAW,CAAU,kDAAyB,EAAE,MAAM,CAAC,CAAC;IACtE,CAAC;CACF,CAAA;AApBY,sEAA6B;wCAA7B,6BAA6B;IADzC,IAAA,mBAAU,GAAE;qCAE+B,gBAAS;GADxC,6BAA6B,CAoBzC"}

package/dist/transactional-metadata.explorer.d.ts

@@ -0,0 +1,11 @@
+import { IFeatureExplorer, MethodContext, ProviderContext } from "@nestplatform/common";
+import { TransactionalFeatureDecoration } from "./transactional-feature.decoration";
+import { TransactionalMetadataAccessor } from "./transactional-metadata.accessor";
+export declare class TransactionalMetadataExplorer implements IFeatureExplorer {
+    private readonly metadataAccessor;
+    private readonly featureDecoration;
+    private readonly classLevelOptions;
+    constructor(metadataAccessor: TransactionalMetadataAccessor, featureDecoration: TransactionalFeatureDecoration);
+    onProvider(ctx: ProviderContext): void;
+    onMethod(ctx: MethodContext): void;
+}

package/dist/transactional-metadata.explorer.js

@@ -0,0 +1,50 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionalMetadataExplorer = void 0;
+const common_1 = require("@nestjs/common");
+const common_2 = require("@nestplatform/common");
+const transactional_feature_decoration_1 = require("./transactional-feature.decoration");
+const transactional_metadata_accessor_1 = require("./transactional-metadata.accessor");
+let TransactionalMetadataExplorer = class TransactionalMetadataExplorer {
+    constructor(metadataAccessor, featureDecoration) {
+        this.metadataAccessor = metadataAccessor;
+        this.featureDecoration = featureDecoration;
+        this.classLevelOptions = new Map();
+    }
+    onProvider(ctx) {
+        const { metatype } = ctx;
+        const classOptions = this.metadataAccessor.getTransactionalMetadata(metatype);
+        if (classOptions) {
+            this.classLevelOptions.set(metatype, classOptions);
+        }
+    }
+    onMethod(ctx) {
+        const { instance, methodName, methodRef, metatype } = ctx;
+        const isExcluded = this.metadataAccessor.getNoTransactionalMetadata(methodRef);
+        if (isExcluded)
+            return;
+        const methodOptions = this.metadataAccessor.getTransactionalMetadata(methodRef);
+        const classOptions = this.classLevelOptions.get(metatype);
+        const resolvedOptions = methodOptions ? { ...classOptions, ...methodOptions } : classOptions;
+        if (!resolvedOptions)
+            return;
+        this.featureDecoration.wrapMethodWithTransaction(instance, methodName, methodRef, resolvedOptions);
+    }
+};
+exports.TransactionalMetadataExplorer = TransactionalMetadataExplorer;
+exports.TransactionalMetadataExplorer = TransactionalMetadataExplorer = __decorate([
+    (0, common_1.Injectable)(),
+    (0, common_2.FeatureExplorer)(),
+    __metadata("design:paramtypes", [transactional_metadata_accessor_1.TransactionalMetadataAccessor,
+        transactional_feature_decoration_1.TransactionalFeatureDecoration])
+], TransactionalMetadataExplorer);
+//# sourceMappingURL=transactional-metadata.explorer.js.map

package/dist/transactional-metadata.explorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactional-metadata.explorer.js","sourceRoot":"","sources":["../src/transactional-metadata.explorer.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAE5C,iDAAyG;AAEzG,yFAAoF;AACpF,uFAAkF;AAK3E,IAAM,6BAA6B,GAAnC,MAAM,6BAA6B;IAQxC,YACmB,gBAA+C,EAC/C,iBAAiD;QADjD,qBAAgB,GAAhB,gBAAgB,CAA+B;QAC/C,sBAAiB,GAAjB,iBAAiB,CAAgC;QAJnD,sBAAiB,GAAG,IAAI,GAAG,EAAkC,CAAC;IAK5E,CAAC;IAKJ,UAAU,CAAC,GAAoB;QAC7B,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC;QAEzB,MAAM,YAAY,GAAqC,IAAI,CAAC,gBAAgB,CAAC,wBAAwB,CAAC,QAAQ,CAAC,CAAC;QAEhH,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAMD,QAAQ,CAAC,GAAkB;QACzB,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC;QAG1D,MAAM,UAAU,GAAwB,IAAI,CAAC,gBAAgB,CAAC,0BAA0B,CAAC,SAAS,CAAC,CAAC;QAEpG,IAAI,UAAU;YAAE,OAAO;QAGvB,MAAM,aAAa,GAAqC,IAAI,CAAC,gBAAgB,CAAC,wBAAwB,CAAC,SAAS,CAAC,CAAC;QAGlH,MAAM,YAAY,GAAqC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAG5F,MAAM,eAAe,GAAqC,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,YAAY,EAAE,GAAG,aAAa,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC;QAE/H,IAAI,CAAC,eAAe;YAAE,OAAO;QAE7B,IAAI,CAAC,iBAAiB,CAAC,yBAAyB,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;IACrG,CAAC;CACF,CAAA;AAnDY,sEAA6B;wCAA7B,6BAA6B;IAFzC,IAAA,mBAAU,GAAE;IACZ,IAAA,wBAAe,GAAE;qCAUqB,+DAA6B;QAC5B,iEAA8B;GAVzD,6BAA6B,CAmDzC"}

package/dist/transactional.constant.d.ts

@@ -0,0 +1,4 @@
+export declare const TRANSACTIONAL_METADATA: unique symbol;
+export declare const NO_TRANSACTIONAL_METADATA: unique symbol;
+export declare const TRANSACTION_ADAPTERS: unique symbol;
+export declare const DEFAULT_TRANSACTION_ADAPTER = "default";

package/dist/transactional.constant.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TRANSACTION_ADAPTER = exports.TRANSACTION_ADAPTERS = exports.NO_TRANSACTIONAL_METADATA = exports.TRANSACTIONAL_METADATA = void 0;
+exports.TRANSACTIONAL_METADATA = Symbol.for("metadata:transactional");
+exports.NO_TRANSACTIONAL_METADATA = Symbol.for("metadata:no_transactional");
+exports.TRANSACTION_ADAPTERS = Symbol.for("token:TRANSACTION_ADAPTERS");
+exports.DEFAULT_TRANSACTION_ADAPTER = "default";
+//# sourceMappingURL=transactional.constant.js.map

package/dist/transactional.constant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactional.constant.js","sourceRoot":"","sources":["../src/transactional.constant.ts"],"names":[],"mappings":";;;AAAa,QAAA,sBAAsB,GAAG,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;AAC9D,QAAA,yBAAyB,GAAG,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;AAEpE,QAAA,oBAAoB,GAAG,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;AAIhE,QAAA,2BAA2B,GAAG,SAAS,CAAC"}

package/dist/transactional.module.d.ts

@@ -0,0 +1,7 @@
+import { DynamicModule } from "@nestjs/common";
+import { ConfigurableModule } from "@nestplatform/common";
+import { TransactionalModuleConfigAsync, TransactionalModuleConfigSync } from "./types";
+export declare class TransactionalModule extends ConfigurableModule {
+    static register(config: TransactionalModuleConfigSync): DynamicModule;
+    static registerAsync(config: TransactionalModuleConfigAsync): DynamicModule;
+}

package/dist/transactional.module.js

@@ -0,0 +1,44 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (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;
+};
+var TransactionalModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionalModule = void 0;
+const common_1 = require("@nestjs/common");
+const common_2 = require("@nestplatform/common");
+const providers_1 = require("./providers");
+const transactional_metadata_explorer_1 = require("./transactional-metadata.explorer");
+const transactional_feature_decoration_1 = require("./transactional-feature.decoration");
+const transactional_metadata_accessor_1 = require("./transactional-metadata.accessor");
+let TransactionalModule = TransactionalModule_1 = class TransactionalModule extends common_2.ConfigurableModule {
+    static register(config) {
+        return super.config(config, {
+            global: true,
+            module: TransactionalModule_1,
+            imports: [common_2.FeatureExplorerModule],
+            providers: [(0, providers_1.TransactionAdapterProvider)(config), transactional_metadata_explorer_1.TransactionalMetadataExplorer, transactional_metadata_accessor_1.TransactionalMetadataAccessor, transactional_feature_decoration_1.TransactionalFeatureDecoration],
+        });
+    }
+    static registerAsync(config) {
+        return super.config(config, {
+            global: true,
+            module: TransactionalModule_1,
+            imports: [common_2.FeatureExplorerModule],
+            providers: [
+                (0, providers_1.TransactionAdapterAsyncProvider)(config),
+                transactional_metadata_explorer_1.TransactionalMetadataExplorer,
+                transactional_metadata_accessor_1.TransactionalMetadataAccessor,
+                transactional_feature_decoration_1.TransactionalFeatureDecoration,
+            ],
+        });
+    }
+};
+exports.TransactionalModule = TransactionalModule;
+exports.TransactionalModule = TransactionalModule = TransactionalModule_1 = __decorate([
+    (0, common_1.Module)({})
+], TransactionalModule);
+//# sourceMappingURL=transactional.module.js.map

package/dist/transactional.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactional.module.js","sourceRoot":"","sources":["../src/transactional.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAuD;AAEvD,iDAAiF;AAEjF,2CAA0F;AAE1F,uFAAkF;AAClF,yFAAoF;AACpF,uFAAkF;AAG3E,IAAM,mBAAmB,2BAAzB,MAAM,mBAAoB,SAAQ,2BAAkB;IACzD,MAAM,CAAC,QAAQ,CAAC,MAAqC;QACnD,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE;YAC1B,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,qBAAmB;YAC3B,OAAO,EAAE,CAAC,8BAAqB,CAAC;YAChC,SAAS,EAAE,CAAC,IAAA,sCAA0B,EAAC,MAAM,CAAC,EAAE,+DAA6B,EAAE,+DAA6B,EAAE,iEAA8B,CAAC;SAC9I,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,aAAa,CAAC,MAAsC;QACzD,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE;YAC1B,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,qBAAmB;YAC3B,OAAO,EAAE,CAAC,8BAAqB,CAAC;YAChC,SAAS,EAAE;gBACT,IAAA,2CAA+B,EAAC,MAAM,CAAC;gBACvC,+DAA6B;gBAC7B,+DAA6B;gBAC7B,iEAA8B;aAC/B;SACF,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AAvBY,kDAAmB;8BAAnB,mBAAmB;IAD/B,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,mBAAmB,CAuB/B"}