@elsikora/nestjs-crud-automator 2.10.0 → 3.0.0-dev.1

package/dist/cjs/class/api/function/transaction/registry.class.js

@@ -0,0 +1,119 @@
+'use strict';
+
+require('../../../../enum/decorator/api/action.enum.js');
+require('../../../../enum/decorator/api/authentication-type.enum.js');
+require('../../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js');
+require('../../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js');
+require('../../../../enum/decorator/api/controller/relation-reference-shape.enum.js');
+require('../../../../enum/decorator/api/controller/request/target.enum.js');
+require('../../../../enum/decorator/api/controller/request/transformer-type.enum.js');
+require('../../../../enum/decorator/api/controller/response-target.enum.js');
+require('../../../../enum/decorator/api/dto-type.enum.js');
+require('../../../../enum/decorator/api/function/context-storage-kind.enum.js');
+require('../../../../enum/decorator/api/function/subscriber-transaction-expectation.enum.js');
+var eventStatus_enum = require('../../../../enum/decorator/api/function/transaction/event-status.enum.js');
+require('../../../../enum/decorator/api/function/transaction/failure-stage.enum.js');
+require('../../../../enum/decorator/api/function/transaction/mode.enum.js');
+require('../../../../enum/decorator/api/function/transaction/outcome.enum.js');
+require('../../../../enum/decorator/api/function/transaction/owner-kind.enum.js');
+var traceType_enum = require('../../../../enum/decorator/api/function/transaction/trace-type.enum.js');
+require('../../../../enum/decorator/api/function/type.enum.js');
+require('../../../../enum/decorator/api/on-type.enum.js');
+require('../../../../enum/decorator/api/property/data-type.enum.js');
+require('../../../../enum/decorator/api/property/date/identifier.enum.js');
+require('../../../../enum/decorator/api/property/date/type.enum.js');
+require('../../../../enum/decorator/api/property/desribe-type.enum.js');
+require('../../../../enum/decorator/api/property/number-type.enum.js');
+require('../../../../enum/decorator/api/property/string-type.enum.js');
+require('../../../../enum/decorator/api/route/subscriber-authorization-expectation.enum.js');
+require('../../../../enum/decorator/api/route/type.enum.js');
+var exception_utility = require('../../../../utility/error/exception.utility.js');
+
+class ApiFunctionTransactionRegistry {
+    EVENTS = [];
+    eventSnapshot;
+    TRANSACTION;
+    constructor(id, owner) {
+        this.TRANSACTION = Object.freeze({
+            id,
+            owner: Object.freeze({ ...owner }),
+        });
+    }
+    beginEvent(options) {
+        if (this.eventSnapshot) {
+            throw exception_utility.ErrorException("Cannot register an event after transaction lifecycle dispatch has started");
+        }
+        const sequence = this.EVENTS.length + 1;
+        this.EVENTS.push({
+            ...options,
+            sequence,
+        });
+        return sequence;
+    }
+    createContext(matchedEvents) {
+        const events = this.getEvents();
+        return Object.freeze({
+            DATA: Object.freeze({
+                events,
+                matchedEvents: Object.freeze([...matchedEvents]),
+                transaction: this.TRANSACTION,
+            }),
+        });
+    }
+    failEvent(sequence, error) {
+        const event = this.getPendingEvent(sequence);
+        event.error = error;
+        event.status = eventStatus_enum.EApiFunctionTransactionEventStatus.FAILED;
+    }
+    getEvents() {
+        this.eventSnapshot ??= Object.freeze(this.EVENTS.map((event) => {
+            if (event.status === eventStatus_enum.EApiFunctionTransactionEventStatus.FAILED) {
+                return Object.freeze({
+                    action: event.action,
+                    entityName: event.entityName,
+                    error: event.error,
+                    functionType: event.functionType,
+                    methodName: event.methodName,
+                    sequence: event.sequence,
+                    status: event.status,
+                });
+            }
+            if (event.status === eventStatus_enum.EApiFunctionTransactionEventStatus.SUCCEEDED) {
+                return Object.freeze({
+                    action: event.action,
+                    entityName: event.entityName,
+                    functionType: event.functionType,
+                    methodName: event.methodName,
+                    sequence: event.sequence,
+                    status: event.status,
+                });
+            }
+            throw exception_utility.ErrorException(`Transaction event ${event.sequence} has not completed`);
+        }));
+        return this.eventSnapshot;
+    }
+    getObservableEvents() {
+        const observableSequences = new Set(this.EVENTS.filter((event) => event.isSubscriberObservable && event.functionType !== traceType_enum.EApiFunctionTransactionTraceType.STEP).map((event) => event.sequence));
+        return Object.freeze(this.getEvents().filter((event) => observableSequences.has(event.sequence)));
+    }
+    getTransaction() {
+        return this.TRANSACTION;
+    }
+    succeedEvent(sequence) {
+        const event = this.getPendingEvent(sequence);
+        event.status = eventStatus_enum.EApiFunctionTransactionEventStatus.SUCCEEDED;
+    }
+    getPendingEvent(sequence) {
+        const event = this.EVENTS[sequence - 1];
+        if (event?.sequence !== sequence) {
+            throw exception_utility.ErrorException(`Transaction event ${sequence} is not registered`);
+        }
+        if (event.status) {
+            throw exception_utility.ErrorException(`Transaction event ${sequence} has already completed`);
+        }
+        return event;
+    }
+}
+
+exports.ApiFunctionTransactionRegistry = ApiFunctionTransactionRegistry;
+//# sourceMappingURL=registry.class.js.map

package/dist/cjs/class/api/function/transaction/registry.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.class.js","sources":["../../../../../../../src/class/api/function/transaction/registry.class.ts"],"sourcesContent":[null],"names":["ErrorException","EApiFunctionTransactionEventStatus","EApiFunctionTransactionTraceType"],"mappings":"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"}

package/dist/cjs/class/api/function/transaction/runtime.class.d.ts

@@ -0,0 +1,11 @@
+import { TApiFunctionTransactionOwner } from '../../../../type/class/api/function';
+import { DataSource, EntityManager } from 'typeorm';
+export declare class ApiFunctionTransactionRuntime {
+    static execute<R>(options: {
+        callback: (entityManager: EntityManager) => Promise<R>;
+        dataSource: DataSource;
+        owner: TApiFunctionTransactionOwner;
+    }): Promise<R>;
+    private static releaseBestEffort;
+    private static rollbackBestEffort;
+}

package/dist/cjs/class/api/function/transaction/runtime.class.js

@@ -0,0 +1,116 @@
+'use strict';
+
+var node_crypto = require('node:crypto');
+var contextStorage_class = require('../context-storage.class.js');
+var lifecycle_class = require('./lifecycle.class.js');
+var registry_class = require('./registry.class.js');
+require('../../../../enum/decorator/api/action.enum.js');
+require('../../../../enum/decorator/api/authentication-type.enum.js');
+require('../../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js');
+require('../../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js');
+require('../../../../enum/decorator/api/controller/relation-reference-shape.enum.js');
+require('../../../../enum/decorator/api/controller/request/target.enum.js');
+require('../../../../enum/decorator/api/controller/request/transformer-type.enum.js');
+require('../../../../enum/decorator/api/controller/response-target.enum.js');
+require('../../../../enum/decorator/api/dto-type.enum.js');
+require('../../../../enum/decorator/api/function/context-storage-kind.enum.js');
+require('../../../../enum/decorator/api/function/subscriber-transaction-expectation.enum.js');
+require('../../../../enum/decorator/api/function/transaction/event-status.enum.js');
+var failureStage_enum = require('../../../../enum/decorator/api/function/transaction/failure-stage.enum.js');
+require('../../../../enum/decorator/api/function/transaction/mode.enum.js');
+require('../../../../enum/decorator/api/function/transaction/outcome.enum.js');
+require('../../../../enum/decorator/api/function/transaction/owner-kind.enum.js');
+require('../../../../enum/decorator/api/function/transaction/trace-type.enum.js');
+require('../../../../enum/decorator/api/function/type.enum.js');
+require('../../../../enum/decorator/api/on-type.enum.js');
+require('../../../../enum/decorator/api/property/data-type.enum.js');
+require('../../../../enum/decorator/api/property/date/identifier.enum.js');
+require('../../../../enum/decorator/api/property/date/type.enum.js');
+require('../../../../enum/decorator/api/property/desribe-type.enum.js');
+require('../../../../enum/decorator/api/property/number-type.enum.js');
+require('../../../../enum/decorator/api/property/string-type.enum.js');
+require('../../../../enum/decorator/api/route/subscriber-authorization-expectation.enum.js');
+require('../../../../enum/decorator/api/route/type.enum.js');
+var exception_utility = require('../../../../utility/error/exception.utility.js');
+var logger_utility = require('../../../../utility/logger.utility.js');
+
+const transactionLogger = logger_utility.LoggerUtility.getLogger("ApiFunctionTransactionRuntime");
+class ApiFunctionTransactionRuntime {
+    static async execute(options) {
+        if (contextStorage_class.ApiFunctionContextStorage.getTransactionRegistry()) {
+            throw exception_utility.ErrorException("Cannot open an owning transaction inside an active Automator transaction");
+        }
+        const queryRunner = options.dataSource.createQueryRunner();
+        try {
+            await queryRunner.connect();
+            await queryRunner.startTransaction();
+        }
+        catch (error) {
+            await ApiFunctionTransactionRuntime.releaseBestEffort(queryRunner);
+            throw error;
+        }
+        const registry = new registry_class.ApiFunctionTransactionRegistry(node_crypto.randomUUID(), options.owner);
+        const result = {};
+        let commitCleanupFailure;
+        let commitError;
+        let hasCommitError = false;
+        let hasOperationError = false;
+        let operationError;
+        let rollbackFailure;
+        await contextStorage_class.ApiFunctionContextStorage.runTransaction(queryRunner.manager, queryRunner, registry, async () => {
+            try {
+                result.value = await options.callback(queryRunner.manager);
+            }
+            catch (error) {
+                hasOperationError = true;
+                operationError = error;
+                rollbackFailure = await ApiFunctionTransactionRuntime.rollbackBestEffort(queryRunner);
+                await ApiFunctionTransactionRuntime.releaseBestEffort(queryRunner);
+                return;
+            }
+            try {
+                await queryRunner.commitTransaction();
+            }
+            catch (error) {
+                commitError = error;
+                hasCommitError = true;
+                commitCleanupFailure = await ApiFunctionTransactionRuntime.rollbackBestEffort(queryRunner);
+            }
+            await ApiFunctionTransactionRuntime.releaseBestEffort(queryRunner);
+        });
+        if (hasOperationError) {
+            return await lifecycle_class.ApiFunctionTransactionLifecycle.executeAfterRollback(registry, operationError, rollbackFailure);
+        }
+        if (hasCommitError) {
+            return await lifecycle_class.ApiFunctionTransactionLifecycle.executeCommitUnknown(registry, commitError, commitCleanupFailure);
+        }
+        if (!("value" in result)) {
+            throw exception_utility.ErrorException("Automator transaction completed without a committed result");
+        }
+        await lifecycle_class.ApiFunctionTransactionLifecycle.executeAfterCommit(registry);
+        return result.value;
+    }
+    static async releaseBestEffort(queryRunner) {
+        try {
+            await queryRunner.release();
+        }
+        catch (error) {
+            transactionLogger.error("Failed to release transaction query runner", error);
+        }
+    }
+    static async rollbackBestEffort(queryRunner) {
+        try {
+            await queryRunner.rollbackTransaction();
+            return undefined;
+        }
+        catch (error) {
+            return Object.freeze({
+                error,
+                stage: failureStage_enum.EApiFunctionTransactionFailureStage.ROLLBACK,
+            });
+        }
+    }
+}
+
+exports.ApiFunctionTransactionRuntime = ApiFunctionTransactionRuntime;
+//# sourceMappingURL=runtime.class.js.map

package/dist/cjs/class/api/function/transaction/runtime.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.class.js","sources":["../../../../../../../src/class/api/function/transaction/runtime.class.ts"],"sourcesContent":[null],"names":["LoggerUtility","ApiFunctionContextStorage","ErrorException","ApiFunctionTransactionRegistry","randomUUID","ApiFunctionTransactionLifecycle","EApiFunctionTransactionFailureStage"],"mappings":"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"}

package/dist/cjs/class/api/function/{transaction-scope.class.d.ts → transaction/scope.class.d.ts}

@@ -1,6 +1,8 @@
 import { DataSource, EntityManager } from 'typeorm';
 export declare class ApiFunctionTransactionScope {
-    static runWithDataSource<R>(dataSource: DataSource, callback: () => Promise<R>): Promise<R>;
+    static runWithDataSource<R>(dataSource: DataSource, properties: {
+        name: string;
+    }, callback: () => Promise<R>): Promise<R>;
     static runWithEntityManager<R>(entityManager: EntityManager, callback: () => Promise<R>): Promise<R>;
     private static createMissingServiceContextError;
 }

package/dist/cjs/class/api/function/transaction/scope.class.js

@@ -0,0 +1,78 @@
+'use strict';
+
+var contextStorage_class = require('../context-storage.class.js');
+var runtime_class = require('./runtime.class.js');
+require('../../../../enum/decorator/api/action.enum.js');
+require('../../../../enum/decorator/api/authentication-type.enum.js');
+require('../../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js');
+require('../../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js');
+require('../../../../enum/decorator/api/controller/relation-reference-shape.enum.js');
+require('../../../../enum/decorator/api/controller/request/target.enum.js');
+require('../../../../enum/decorator/api/controller/request/transformer-type.enum.js');
+require('../../../../enum/decorator/api/controller/response-target.enum.js');
+require('../../../../enum/decorator/api/dto-type.enum.js');
+require('../../../../enum/decorator/api/function/context-storage-kind.enum.js');
+require('../../../../enum/decorator/api/function/subscriber-transaction-expectation.enum.js');
+require('../../../../enum/decorator/api/function/transaction/event-status.enum.js');
+require('../../../../enum/decorator/api/function/transaction/failure-stage.enum.js');
+require('../../../../enum/decorator/api/function/transaction/mode.enum.js');
+require('../../../../enum/decorator/api/function/transaction/outcome.enum.js');
+var ownerKind_enum = require('../../../../enum/decorator/api/function/transaction/owner-kind.enum.js');
+require('../../../../enum/decorator/api/function/transaction/trace-type.enum.js');
+require('../../../../enum/decorator/api/function/type.enum.js');
+require('../../../../enum/decorator/api/on-type.enum.js');
+require('../../../../enum/decorator/api/property/data-type.enum.js');
+require('../../../../enum/decorator/api/property/date/identifier.enum.js');
+require('../../../../enum/decorator/api/property/date/type.enum.js');
+require('../../../../enum/decorator/api/property/desribe-type.enum.js');
+require('../../../../enum/decorator/api/property/number-type.enum.js');
+require('../../../../enum/decorator/api/property/string-type.enum.js');
+require('../../../../enum/decorator/api/route/subscriber-authorization-expectation.enum.js');
+require('../../../../enum/decorator/api/route/type.enum.js');
+var exception_utility = require('../../../../utility/error/exception.utility.js');
+
+class ApiFunctionTransactionScope {
+    static async runWithDataSource(dataSource, properties, callback) {
+        const name = properties.name.trim();
+        if (name.length === 0) {
+            throw exception_utility.ErrorException("ApiFunctionTransactionScope name must be a non-empty string");
+        }
+        return await runtime_class.ApiFunctionTransactionRuntime.execute({
+            callback: async (entityManager) => await ApiFunctionTransactionScope.runWithEntityManager(entityManager, callback),
+            dataSource,
+            owner: {
+                kind: ownerKind_enum.EApiFunctionTransactionOwnerKind.SCOPE,
+                name,
+            },
+        });
+    }
+    static async runWithEntityManager(entityManager, callback) {
+        const registry = contextStorage_class.ApiFunctionContextStorage.getTransactionRegistryForEntityManager(entityManager);
+        if (!registry || registry !== contextStorage_class.ApiFunctionContextStorage.getTransactionRegistry() || contextStorage_class.ApiFunctionContextStorage.getEventManager() !== entityManager || contextStorage_class.ApiFunctionContextStorage.getTransactionQueryRunner()?.manager !== entityManager) {
+            throw exception_utility.ErrorException("ApiFunctionTransactionScope.runWithEntityManager requires an existing Automator transaction owner registry");
+        }
+        const entity = Object;
+        const context = {
+            entity,
+            eventManager: entityManager,
+            getRepository: (repositoryEntity) => entityManager.getRepository(repositoryEntity),
+            operations: {
+                create: () => Promise.reject(ApiFunctionTransactionScope.createMissingServiceContextError()),
+                delete: () => Promise.reject(ApiFunctionTransactionScope.createMissingServiceContextError()),
+                get: () => Promise.reject(ApiFunctionTransactionScope.createMissingServiceContextError()),
+                getList: () => Promise.reject(ApiFunctionTransactionScope.createMissingServiceContextError()),
+                getMany: () => Promise.reject(ApiFunctionTransactionScope.createMissingServiceContextError()),
+                getRepository: (repositoryEntity) => entityManager.getRepository(repositoryEntity),
+                update: () => Promise.reject(ApiFunctionTransactionScope.createMissingServiceContextError()),
+            },
+            repository: entityManager.getRepository(entity),
+        };
+        return await contextStorage_class.ApiFunctionContextStorage.run(context, callback);
+    }
+    static createMissingServiceContextError() {
+        return exception_utility.ErrorException("ApiFunctionTransactionScope operations require a decorated service context");
+    }
+}
+
+exports.ApiFunctionTransactionScope = ApiFunctionTransactionScope;
+//# sourceMappingURL=scope.class.js.map

package/dist/cjs/class/api/function/transaction/scope.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.class.js","sources":["../../../../../../../src/class/api/function/transaction/scope.class.ts"],"sourcesContent":[null],"names":["ErrorException","ApiFunctionTransactionRuntime","EApiFunctionTransactionOwnerKind","ApiFunctionContextStorage"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAUa,2BAA2B,CAAA;IAChC,aAAa,iBAAiB,CAAI,UAAsB,EAAE,UAA4B,EAAE,QAA0B,EAAA;QACxH,MAAM,IAAI,GAAW,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE;AAE3C,QAAA,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;AACtB,YAAA,MAAMA,gCAAc,CAAC,6DAA6D,CAAC;QACpF;AAEA,QAAA,OAAO,MAAMC,2CAA6B,CAAC,OAAO,CAAC;AAClD,YAAA,QAAQ,EAAE,OAAO,aAA4B,KAAiB,MAAM,2BAA2B,CAAC,oBAAoB,CAAC,aAAa,EAAE,QAAQ,CAAC;YAC7I,UAAU;AACV,YAAA,KAAK,EAAE;gBACN,IAAI,EAAEC,+CAAgC,CAAC,KAAK;gBAC5C,IAAI;AACJ,aAAA;AACD,SAAA,CAAC;IACH;AAEO,IAAA,aAAa,oBAAoB,CAAI,aAA4B,EAAE,QAA0B,EAAA;QACnG,MAAM,QAAQ,GAA+CC,8CAAyB,CAAC,sCAAsC,CAAC,aAAa,CAAC;QAE5I,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAKA,8CAAyB,CAAC,sBAAsB,EAAE,IAAIA,8CAAyB,CAAC,eAAe,EAAE,KAAK,aAAa,IAAIA,8CAAyB,CAAC,yBAAyB,EAAE,EAAE,OAAO,KAAK,aAAa,EAAE;AACtO,YAAA,MAAMH,gCAAc,CAAC,4GAA4G,CAAC;QACnI;QAEA,MAAM,MAAM,GAA6B,MAAM;AAE/C,QAAA,MAAM,OAAO,GAAwC;YACpD,MAAM;AACN,YAAA,YAAY,EAAE,aAAa;YAC3B,aAAa,EAAE,CAA2B,gBAA6B,KAAoB,aAAa,CAAC,aAAa,CAAC,gBAAgB,CAAC;AACxI,YAAA,UAAU,EAAE;AACX,gBAAA,MAAM,EAAE,MAA+B,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;AACrH,gBAAA,MAAM,EAAE,MAAqB,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;AAC3G,gBAAA,GAAG,EAAE,MAA+B,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;AAClH,gBAAA,OAAO,EAAE,MAAsB,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;AAC7G,gBAAA,OAAO,EAAE,MAAsC,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;gBAC7H,aAAa,EAAE,CAA2B,gBAA6B,KAAoB,aAAa,CAAC,aAAa,CAAC,gBAAgB,CAAC;AACxI,gBAAA,MAAM,EAAE,MAA+B,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;AACrH,aAAA;AACD,YAAA,UAAU,EAAE,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC;SAC/C;QAED,OAAO,MAAMG,8CAAyB,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC9D;AAEQ,IAAA,OAAO,gCAAgC,GAAA;AAC9C,QAAA,OAAOH,gCAAc,CAAC,4EAA4E,CAAC;IACpG;AACA;;;;"}

package/dist/cjs/class/api/index.d.ts

@@ -1,4 +1,4 @@
 export * from './function';
 export { ApiRouteRuntime } from './route-runtime.class';
-export * from './service-base.class';
+export { ApiServiceBase } from './service-base.class';
 export * from './subscriber';

package/dist/cjs/class/api/route-runtime.class.d.ts

@@ -15,6 +15,7 @@ export declare class ApiRouteRuntime {
     private static executeGeneratedOperation;
     private static executeGeneratedRequestPipeline;
     private static executeGeneratedResponse;
+    private static executeGeneratedTransaction;
     private static executeGeneratedUpdateOperation;
     private static executeRequestTargets;
     /**