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

package/dist/esm/utility/api/controller/handle-request-relations.utility.js

@@ -1,13 +1,22 @@
+import { ApiFunctionContextStorage } from '../../../class/api/function/context-storage.class.js';
 import { ApiServiceBase } from '../../../class/api/service-base.class.js';
 import '../../../enum/decorator/api/action.enum.js';
 import '../../../enum/decorator/api/authentication-type.enum.js';
+import '../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js';
+import '../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js';
 import { EApiControllerRelationReferenceShape } from '../../../enum/decorator/api/controller/relation-reference-shape.enum.js';
 import '../../../enum/decorator/api/controller/request/target.enum.js';
 import '../../../enum/decorator/api/controller/request/transformer-type.enum.js';
 import '../../../enum/decorator/api/controller/response-target.enum.js';
 import '../../../enum/decorator/api/dto-type.enum.js';
+import '../../../enum/decorator/api/function/context-storage-kind.enum.js';
 import '../../../enum/decorator/api/function/subscriber-transaction-expectation.enum.js';
-import '../../../enum/decorator/api/function/transaction-mode.enum.js';
+import '../../../enum/decorator/api/function/transaction/event-status.enum.js';
+import '../../../enum/decorator/api/function/transaction/failure-stage.enum.js';
+import '../../../enum/decorator/api/function/transaction/mode.enum.js';
+import '../../../enum/decorator/api/function/transaction/outcome.enum.js';
+import '../../../enum/decorator/api/function/transaction/owner-kind.enum.js';
+import '../../../enum/decorator/api/function/transaction/trace-type.enum.js';
 import '../../../enum/decorator/api/function/type.enum.js';
 import '../../../enum/decorator/api/on-type.enum.js';
 import '../../../enum/decorator/api/property/data-type.enum.js';
@@ -18,10 +27,11 @@ import '../../../enum/decorator/api/property/number-type.enum.js';
 import '../../../enum/decorator/api/property/string-type.enum.js';
 import '../../../enum/decorator/api/route/subscriber-authorization-expectation.enum.js';
 import '../../../enum/decorator/api/route/type.enum.js';
-import '../../../enum/utility/dto/manual/property-metadata/decorator.enum.js';
 import { EErrorStringAction } from '../../../enum/utility/error-string/action.enum.js';
 import '../../../enum/utility/error-string/composite-action.enum.js';
 import '../../../enum/utility/exception-details-type.enum.js';
+import '../../../enum/utility/get-default-string-format-properties-bigint-string-sign.enum.js';
+import '../../../enum/utility/manual-dto-property-metadata-decorator.enum.js';
 import { BadRequestException, HttpStatus } from '@nestjs/common';
 import { ErrorException } from '../../error/exception.utility.js';
 import { ErrorString } from '../../error/string.utility.js';
@@ -52,7 +62,38 @@ async function ApiControllerHandleRequestRelations(controllerMethod, properties,
     validateReferenceConfig(referenceConfig);
     const relationNames = new Set(GetEntityColumns({ entity: properties.entity, shouldTakeRelationsOnly: true }).filter((propertyName) => typeof propertyName === "string"));
     const parametersRecord = parameters;
-    for (const [propertyName, includeValue] of getIncludedRelationEntries(loadConfig.include)) {
+    const includedRelationEntries = getIncludedRelationEntries(loadConfig.include);
+    const relationLocks = loadConfig.locks;
+    let relationLockRecord;
+    if (relationLocks !== undefined) {
+        if (relationLocks === null || typeof relationLocks !== "object" || Array.isArray(relationLocks)) {
+            throw ErrorException("Request relation locks must be an object");
+        }
+        relationLockRecord = relationLocks;
+        const includeRecord = loadConfig.include;
+        const relationLockEntries = Object.entries(relationLockRecord);
+        for (const [propertyName, relationLock] of relationLockEntries) {
+            validateIncludedRelationKey(propertyName, relationNames);
+            if (!Object.prototype.hasOwnProperty.call(includeRecord, propertyName) || includeRecord[propertyName] === false) {
+                throw ErrorException(`Request relation lock ${propertyName} requires a matching enabled include`);
+            }
+            if (relationLock === null || typeof relationLock !== "object" || Array.isArray(relationLock)) {
+                throw ErrorException(`Request relation lock ${propertyName} must be an object`);
+            }
+            const relationLockMode = relationLock.mode;
+            if (relationLockMode !== "pessimistic_read" && relationLockMode !== "pessimistic_write") {
+                throw ErrorException(`Request relation lock ${propertyName} mode must be pessimistic_read or pessimistic_write`);
+            }
+            const includeValue = includeRecord[propertyName];
+            if (includeValue !== true && loadConfig.relationLoadStrategy !== "query") {
+                throw ErrorException(`Request relation lock ${propertyName} with nested relations requires relationLoadStrategy query`);
+            }
+        }
+        if (relationLockEntries.length > 0 && (!ApiFunctionContextStorage.getTransactionRegistry() || !ApiFunctionContextStorage.getEventManager())) {
+            throw ErrorException("Request relation locks require an active transaction");
+        }
+    }
+    for (const [propertyName, includeValue] of includedRelationEntries) {
         validateIncludedRelationKey(propertyName, relationNames);
         if (!Object.prototype.hasOwnProperty.call(parametersRecord, propertyName) || parametersRecord[propertyName] === undefined || parametersRecord[propertyName] === null || includeValue === false) {
             continue;
@@ -79,6 +120,11 @@ async function ApiControllerHandleRequestRelations(controllerMethod, properties,
         if (loadConfig.relationLoadStrategy) {
             requestProperties.relationLoadStrategy = loadConfig.relationLoadStrategy;
         }
+        const relationLock = relationLockRecord?.[propertyName];
+        if (relationLock) {
+            requestProperties.lock = relationLock;
+            requestProperties.loadEagerRelations = false;
+        }
         const entity = await service.get(requestProperties);
         if (!entity) {
             throw ErrorException(`Service ${serviceName} returned an empty relation entity`);

package/dist/esm/utility/api/controller/handle-request-relations.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"handle-request-relations.utility.js","sources":["../../../../../../src/utility/api/controller/handle-request-relations.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"handle-request-relations.utility.js","sources":["../../../../../../src/utility/api/controller/handle-request-relations.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/utility/api/controller/transform-data.utility.js

@@ -1,13 +1,21 @@
 import { TRANSFORMER_VALUE_DTO_CONSTANT } from '../../../constant/dto/transformer-value.constant.js';
 import '../../../enum/decorator/api/action.enum.js';
 import '../../../enum/decorator/api/authentication-type.enum.js';
+import '../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js';
+import '../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js';
 import '../../../enum/decorator/api/controller/relation-reference-shape.enum.js';
 import { EApiControllerRequestTarget } from '../../../enum/decorator/api/controller/request/target.enum.js';
 import { EApiControllerRequestTransformerType } from '../../../enum/decorator/api/controller/request/transformer-type.enum.js';
 import { EApiControllerResponseTarget } from '../../../enum/decorator/api/controller/response-target.enum.js';
 import '../../../enum/decorator/api/dto-type.enum.js';
+import '../../../enum/decorator/api/function/context-storage-kind.enum.js';
 import '../../../enum/decorator/api/function/subscriber-transaction-expectation.enum.js';
-import '../../../enum/decorator/api/function/transaction-mode.enum.js';
+import '../../../enum/decorator/api/function/transaction/event-status.enum.js';
+import '../../../enum/decorator/api/function/transaction/failure-stage.enum.js';
+import '../../../enum/decorator/api/function/transaction/mode.enum.js';
+import '../../../enum/decorator/api/function/transaction/outcome.enum.js';
+import '../../../enum/decorator/api/function/transaction/owner-kind.enum.js';
+import '../../../enum/decorator/api/function/transaction/trace-type.enum.js';
 import '../../../enum/decorator/api/function/type.enum.js';
 import '../../../enum/decorator/api/on-type.enum.js';
 import '../../../enum/decorator/api/property/data-type.enum.js';
@@ -18,10 +26,11 @@ import '../../../enum/decorator/api/property/number-type.enum.js';
 import '../../../enum/decorator/api/property/string-type.enum.js';
 import '../../../enum/decorator/api/route/subscriber-authorization-expectation.enum.js';
 import '../../../enum/decorator/api/route/type.enum.js';
-import '../../../enum/utility/dto/manual/property-metadata/decorator.enum.js';
 import { EErrorStringAction } from '../../../enum/utility/error-string/action.enum.js';
 import '../../../enum/utility/error-string/composite-action.enum.js';
 import '../../../enum/utility/exception-details-type.enum.js';
+import '../../../enum/utility/get-default-string-format-properties-bigint-string-sign.enum.js';
+import '../../../enum/utility/manual-dto-property-metadata-decorator.enum.js';
 import { InternalServerErrorException } from '@nestjs/common';
 import { ErrorString } from '../../error/string.utility.js';
 

package/dist/esm/utility/api/controller/transform-data.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"transform-data.utility.js","sources":["../../../../../../src/utility/api/controller/transform-data.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"transform-data.utility.js","sources":["../../../../../../src/utility/api/controller/transform-data.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/utility/api/controller/write/dto-swagger.utility.d.ts

@@ -1,5 +1,6 @@
 import { EApiRouteType } from '../../../../enum/decorator/api';
 import { IApiBaseEntity } from '../../../../interface/api-base-entity.interface';
+import { IApiControllerGetListQueryPlan } from '../../../../interface/class/api/controller/get-list/query';
 import { IApiControllerProperties } from '../../../../interface/decorator/api';
 import { IApiEntity } from '../../../../interface/entity';
 import { TApiControllerPropertiesRoute } from '../../../../type/decorator/api/controller';
@@ -13,7 +14,8 @@ import { TApiControllerPropertiesRoute } from '../../../../type/decorator/api/co
  * @param {EApiRouteType} method - The type of route (CREATE, DELETE, GET, etc.)
  * @param {TApiControllerPropertiesRoute<E, typeof method>} routeConfig - Route-specific configuration
  * @param {IApiEntity<E>} entityMetadata - The entity metadata containing column information
+ * @param {IApiControllerGetListQueryPlan} [queryPlan] - Route-scoped plan used by dynamic QUERY DTO generation.
  * @returns {void}
  * @template E - The entity type
  */
-export declare function ApiControllerWriteDtoSwagger<E extends IApiBaseEntity>(target: object, entity: IApiEntity<E>, properties: IApiControllerProperties<E>, method: EApiRouteType, routeConfig: TApiControllerPropertiesRoute<E, typeof method>, entityMetadata: IApiEntity<E>): void;
+export declare function ApiControllerWriteDtoSwagger<E extends IApiBaseEntity>(target: object, entity: IApiEntity<E>, properties: IApiControllerProperties<E>, method: EApiRouteType, routeConfig: TApiControllerPropertiesRoute<E, typeof method>, entityMetadata: IApiEntity<E>, queryPlan?: IApiControllerGetListQueryPlan): void;

package/dist/esm/utility/api/controller/write/dto-swagger.utility.js

@@ -3,13 +3,21 @@ import '../../../../constant/decorator/api/function.constant.js';
 import { PROPERTY_DESCRIBE_DECORATOR_API_CONSTANT } from '../../../../constant/decorator/api/property-describe.constant.js';
 import '../../../../enum/decorator/api/action.enum.js';
 import '../../../../enum/decorator/api/authentication-type.enum.js';
+import '../../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js';
+import '../../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js';
 import '../../../../enum/decorator/api/controller/relation-reference-shape.enum.js';
 import '../../../../enum/decorator/api/controller/request/target.enum.js';
 import '../../../../enum/decorator/api/controller/request/transformer-type.enum.js';
 import '../../../../enum/decorator/api/controller/response-target.enum.js';
 import { EApiDtoType } from '../../../../enum/decorator/api/dto-type.enum.js';
+import '../../../../enum/decorator/api/function/context-storage-kind.enum.js';
 import '../../../../enum/decorator/api/function/subscriber-transaction-expectation.enum.js';
-import '../../../../enum/decorator/api/function/transaction-mode.enum.js';
+import '../../../../enum/decorator/api/function/transaction/event-status.enum.js';
+import '../../../../enum/decorator/api/function/transaction/failure-stage.enum.js';
+import '../../../../enum/decorator/api/function/transaction/mode.enum.js';
+import '../../../../enum/decorator/api/function/transaction/outcome.enum.js';
+import '../../../../enum/decorator/api/function/transaction/owner-kind.enum.js';
+import '../../../../enum/decorator/api/function/transaction/trace-type.enum.js';
 import '../../../../enum/decorator/api/function/type.enum.js';
 import '../../../../enum/decorator/api/on-type.enum.js';
 import '../../../../enum/decorator/api/property/data-type.enum.js';
@@ -35,10 +43,11 @@ import { GetRegisteredAutoDtoChildrenRecursive } from '../../../register-auto-dt
  * @param {EApiRouteType} method - The type of route (CREATE, DELETE, GET, etc.)
  * @param {TApiControllerPropertiesRoute<E, typeof method>} routeConfig - Route-specific configuration
  * @param {IApiEntity<E>} entityMetadata - The entity metadata containing column information
+ * @param {IApiControllerGetListQueryPlan} [queryPlan] - Route-scoped plan used by dynamic QUERY DTO generation.
  * @returns {void}
  * @template E - The entity type
  */
-function ApiControllerWriteDtoSwagger(target, entity, properties, method, routeConfig, entityMetadata) {
+function ApiControllerWriteDtoSwagger(target, entity, properties, method, routeConfig, entityMetadata, queryPlan) {
     const swaggerModels = (Reflect.getMetadata(DECORATORS.API_EXTRA_MODELS, target) ?? []);
     const entityNames = [];
     if (typeof properties.entity === "function") {
@@ -57,10 +66,10 @@ function ApiControllerWriteDtoSwagger(target, entity, properties, method, routeC
     else if (properties.entity.name) {
         entityNames.push(properties.entity.name);
     }
-    const requestDto = ApiControllerGetDto(properties, entity, method, EApiDtoType.PARAMETERS, routeConfig);
-    const queryDto = ApiControllerGetDto(properties, entity, method, EApiDtoType.QUERY, routeConfig);
-    const bodyDto = ApiControllerGetDto(properties, entity, method, EApiDtoType.BODY, routeConfig);
-    const responseDto = ApiControllerGetDto(properties, entity, method, EApiDtoType.RESPONSE, routeConfig);
+    const requestDto = ApiControllerGetDto(properties, entity, method, EApiDtoType.PARAMETERS, routeConfig, queryPlan);
+    const queryDto = ApiControllerGetDto(properties, entity, method, EApiDtoType.QUERY, routeConfig, queryPlan);
+    const bodyDto = ApiControllerGetDto(properties, entity, method, EApiDtoType.BODY, routeConfig, queryPlan);
+    const responseDto = ApiControllerGetDto(properties, entity, method, EApiDtoType.RESPONSE, routeConfig, queryPlan);
     const dtoList = [requestDto, queryDto, bodyDto, responseDto];
     for (const dto of dtoList) {
         for (const swaggerDto of dto ? [dto, ...GetRegisteredAutoDtoChildrenRecursive(dto.prototype)] : []) {

package/dist/esm/utility/api/controller/write/dto-swagger.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"dto-swagger.utility.js","sources":["../../../../../../../src/utility/api/controller/write/dto-swagger.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"dto-swagger.utility.js","sources":["../../../../../../../src/utility/api/controller/write/dto-swagger.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/utility/api/{discriminator/validate/config.utility.d.ts → discriminator-validate-config.utility.d.ts}

@@ -1,4 +1,4 @@
-import { TApiDiscriminatorValidateConfigProperties } from '../../../../type/utility/api/discriminator';
+import { TApiDiscriminatorValidateConfigProperties } from '../../type/utility/api';
 /**
  * Validates discriminator config against the DTO variants used to build Swagger and runtime transforms.
  * @param {TApiDiscriminatorValidateConfigProperties} properties - Discriminator validation properties.

package/dist/esm/utility/api/{discriminator/validate/config.utility.js → discriminator-validate-config.utility.js}

@@ -1,5 +1,5 @@
 import { DECORATORS } from '@nestjs/swagger/dist/constants.js';
-import { ErrorException } from '../../../error/exception.utility.js';
+import { ErrorException } from '../error/exception.utility.js';
 
 /**
  * Validates discriminator config against the DTO variants used to build Swagger and runtime transforms.
@@ -49,4 +49,4 @@ function ApiDiscriminatorValidateConfig(properties) {
 }
 
 export { ApiDiscriminatorValidateConfig };
-//# sourceMappingURL=config.utility.js.map
+//# sourceMappingURL=discriminator-validate-config.utility.js.map

package/dist/esm/utility/api/discriminator-validate-config.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discriminator-validate-config.utility.js","sources":["../../../../../src/utility/api/discriminator-validate-config.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/utility/api/function-transaction.utility.d.ts

@@ -1,4 +1,5 @@
 import { IApiBaseEntity } from '../../interface/api-base-entity.interface';
+import { TApiFunctionTransactionTraceType } from '../../type/class/api/function/transaction';
 import { EntityManager, Repository } from 'typeorm';
 import { EApiFunctionTransactionMode } from '../../enum/decorator/api';
 /**
@@ -6,21 +7,27 @@ import { EApiFunctionTransactionMode } from '../../enum/decorator/api';
  * @template E - Entity type owned by the function repository.
  * @template R - Callback result type.
  * @param {object} options - Transaction execution options.
+ * @param {string} [options.action] - Custom function action used for subscriber matching.
  * @param {(eventManager: EntityManager | undefined) => Promise<R>} options.callback - Function body to run with the resolved transaction manager.
  * @param {new (...arguments_: Array<unknown>) => E} options.entity - Entity constructor associated with the function.
+ * @param {TApiFunctionTransactionTraceType} options.functionType - Function trace type.
  * @param {string} [options.label] - Error message label for the decorated function primitive.
+ * @param {string} options.methodName - Decorated service method name.
  * @param {EApiFunctionTransactionMode} options.mode - Transaction mode to enforce.
  * @param {(eventManager: EntityManager | undefined, error: Error) => Promise<void>} [options.onPreflightError] - Error hook for transaction mode conflicts before the function body starts.
  * @param {Repository<E>} [options.repository] - Repository used to open new transactions when required.
- * @param {boolean} [options.shouldBindTransactionScope] - Whether REQUIRED-created transactions should install an ApiFunctionTransactionScope context.
+ * @param {new (...arguments_: Array<unknown>) => unknown} [options.serviceConstructor] - Observable service constructor used for subscriber matching.
  * @returns {Promise<R>} Callback result.
  */
 export declare function ApiFunctionExecuteWithTransaction<E extends IApiBaseEntity, R>(options: {
+    action?: string;
     callback: (eventManager: EntityManager | undefined) => Promise<R>;
     entity: new (...arguments_: Array<unknown>) => E;
+    functionType: TApiFunctionTransactionTraceType;
     label?: string;
+    methodName: string;
     mode: EApiFunctionTransactionMode;
     onPreflightError?: (eventManager: EntityManager | undefined, error: Error) => Promise<void>;
     repository?: Repository<E>;
-    shouldBindTransactionScope?: boolean;
+    serviceConstructor?: new (...arguments_: Array<unknown>) => unknown;
 }): Promise<R>;

package/dist/esm/utility/api/function-transaction.utility.js

@@ -1,14 +1,23 @@
 import { ApiFunctionContextStorage } from '../../class/api/function/context-storage.class.js';
-import { ApiFunctionTransactionScope } from '../../class/api/function/transaction-scope.class.js';
+import { ApiFunctionTransactionRuntime } from '../../class/api/function/transaction/runtime.class.js';
+import { SERVICE_API_DECORATOR_CONSTANT } from '../../constant/decorator/api/service.constant.js';
 import '../../enum/decorator/api/action.enum.js';
 import '../../enum/decorator/api/authentication-type.enum.js';
+import '../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js';
+import '../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js';
 import '../../enum/decorator/api/controller/relation-reference-shape.enum.js';
 import '../../enum/decorator/api/controller/request/target.enum.js';
 import '../../enum/decorator/api/controller/request/transformer-type.enum.js';
 import '../../enum/decorator/api/controller/response-target.enum.js';
 import '../../enum/decorator/api/dto-type.enum.js';
+import '../../enum/decorator/api/function/context-storage-kind.enum.js';
 import '../../enum/decorator/api/function/subscriber-transaction-expectation.enum.js';
-import { EApiFunctionTransactionMode } from '../../enum/decorator/api/function/transaction-mode.enum.js';
+import '../../enum/decorator/api/function/transaction/event-status.enum.js';
+import '../../enum/decorator/api/function/transaction/failure-stage.enum.js';
+import { EApiFunctionTransactionMode } from '../../enum/decorator/api/function/transaction/mode.enum.js';
+import '../../enum/decorator/api/function/transaction/outcome.enum.js';
+import { EApiFunctionTransactionOwnerKind } from '../../enum/decorator/api/function/transaction/owner-kind.enum.js';
+import '../../enum/decorator/api/function/transaction/trace-type.enum.js';
 import '../../enum/decorator/api/function/type.enum.js';
 import '../../enum/decorator/api/on-type.enum.js';
 import '../../enum/decorator/api/property/data-type.enum.js';
@@ -26,21 +35,67 @@ import { ErrorException } from '../error/exception.utility.js';
  * @template E - Entity type owned by the function repository.
  * @template R - Callback result type.
  * @param {object} options - Transaction execution options.
+ * @param {string} [options.action] - Custom function action used for subscriber matching.
  * @param {(eventManager: EntityManager | undefined) => Promise<R>} options.callback - Function body to run with the resolved transaction manager.
  * @param {new (...arguments_: Array<unknown>) => E} options.entity - Entity constructor associated with the function.
+ * @param {TApiFunctionTransactionTraceType} options.functionType - Function trace type.
  * @param {string} [options.label] - Error message label for the decorated function primitive.
+ * @param {string} options.methodName - Decorated service method name.
  * @param {EApiFunctionTransactionMode} options.mode - Transaction mode to enforce.
  * @param {(eventManager: EntityManager | undefined, error: Error) => Promise<void>} [options.onPreflightError] - Error hook for transaction mode conflicts before the function body starts.
  * @param {Repository<E>} [options.repository] - Repository used to open new transactions when required.
- * @param {boolean} [options.shouldBindTransactionScope] - Whether REQUIRED-created transactions should install an ApiFunctionTransactionScope context.
+ * @param {new (...arguments_: Array<unknown>) => unknown} [options.serviceConstructor] - Observable service constructor used for subscriber matching.
  * @returns {Promise<R>} Callback result.
  */
 async function ApiFunctionExecuteWithTransaction(options) {
-    const activeEventManager = ApiFunctionContextStorage.getEventManager();
+    const activeRegistry = ApiFunctionContextStorage.getTransactionRegistry();
+    const activeEventManager = activeRegistry ? ApiFunctionContextStorage.getEventManager() : undefined;
     const label = options.label ?? "ApiFunction";
+    const isSubscriberObservable = Boolean(options.serviceConstructor && Reflect.hasMetadata(SERVICE_API_DECORATOR_CONSTANT.OBSERVABLE_METADATA_KEY, options.serviceConstructor));
+    const executeWithEventManager = async (eventManager) => {
+        const registry = ApiFunctionContextStorage.getTransactionRegistry();
+        const sequence = registry?.beginEvent({
+            action: options.action,
+            entityName: options.entity.name,
+            functionType: options.functionType,
+            isSubscriberObservable,
+            methodName: options.methodName,
+        });
+        try {
+            const result = await options.callback(eventManager);
+            if (sequence !== undefined) {
+                registry?.succeedEvent(sequence);
+            }
+            return result;
+        }
+        catch (error) {
+            if (sequence !== undefined) {
+                registry?.failEvent(sequence, error);
+            }
+            throw error;
+        }
+    };
     if (options.mode === EApiFunctionTransactionMode.NONE && activeEventManager) {
         const error = ErrorException(`${label} transaction mode NONE cannot run inside an active transaction`);
-        await options.onPreflightError?.(activeEventManager, error);
+        const sequence = activeRegistry?.beginEvent({
+            action: options.action,
+            entityName: options.entity.name,
+            functionType: options.functionType,
+            isSubscriberObservable,
+            methodName: options.methodName,
+        });
+        try {
+            await options.onPreflightError?.(activeEventManager, error);
+        }
+        catch (preflightError) {
+            if (sequence !== undefined) {
+                activeRegistry?.failEvent(sequence, preflightError);
+            }
+            throw preflightError;
+        }
+        if (sequence !== undefined) {
+            activeRegistry?.failEvent(sequence, error);
+        }
         throw error;
     }
     if (options.mode === EApiFunctionTransactionMode.MANDATORY && !activeEventManager) {
@@ -55,14 +110,19 @@ async function ApiFunctionExecuteWithTransaction(options) {
             await options.onPreflightError?.(undefined, error);
             throw error;
         }
-        return await options.repository.manager.transaction(async (transactionManager) => {
-            if (options.shouldBindTransactionScope === false) {
-                return await options.callback(transactionManager);
-            }
-            return await ApiFunctionTransactionScope.runWithEntityManager(transactionManager, async () => await options.callback(transactionManager));
+        return await ApiFunctionTransactionRuntime.execute({
+            callback: executeWithEventManager,
+            dataSource: options.repository.manager.connection,
+            owner: {
+                action: options.action,
+                entityName: options.entity.name,
+                functionType: options.functionType,
+                kind: EApiFunctionTransactionOwnerKind.FUNCTION,
+                methodName: options.methodName,
+            },
         });
     }
-    return await options.callback(eventManager);
+    return await executeWithEventManager(eventManager);
 }
 
 export { ApiFunctionExecuteWithTransaction };

package/dist/esm/utility/api/function-transaction.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"function-transaction.utility.js","sources":["../../../../../src/utility/api/function-transaction.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAQA;;;;;;;;;;;;;AAaG;AACI,eAAe,iCAAiC,CAA8B,OAAkV,EAAA;AACta,IAAA,MAAM,kBAAkB,GAA8B,yBAAyB,CAAC,eAAe,EAAE;AACjG,IAAA,MAAM,KAAK,GAAW,OAAO,CAAC,KAAK,IAAI,aAAa;IAEpD,IAAI,OAAO,CAAC,IAAI,KAAK,2BAA2B,CAAC,IAAI,IAAI,kBAAkB,EAAE;QAC5E,MAAM,KAAK,GAAU,cAAc,CAAC,GAAG,KAAK,CAAA,8DAAA,CAAgE,CAAC;QAE7G,MAAM,OAAO,CAAC,gBAAgB,GAAG,kBAAkB,EAAE,KAAK,CAAC;AAE3D,QAAA,MAAM,KAAK;IACZ;IAEA,IAAI,OAAO,CAAC,IAAI,KAAK,2BAA2B,CAAC,SAAS,IAAI,CAAC,kBAAkB,EAAE;QAClF,MAAM,KAAK,GAAU,cAAc,CAAC,GAAG,KAAK,CAAA,0DAAA,CAA4D,CAAC;QAEzG,MAAM,OAAO,CAAC,gBAAgB,GAAG,SAAS,EAAE,KAAK,CAAC;AAElD,QAAA,MAAM,KAAK;IACZ;AAEA,IAAA,MAAM,YAAY,GAA8B,OAAO,CAAC,IAAI,KAAK,2BAA2B,CAAC,IAAI,GAAG,SAAS,GAAG,kBAAkB;IAElI,IAAI,OAAO,CAAC,IAAI,KAAK,2BAA2B,CAAC,QAAQ,IAAI,CAAC,YAAY,EAAE;AAC3E,QAAA,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE;AACxB,YAAA,MAAM,KAAK,GAAU,cAAc,CAAC,6CAA6C,CAAC;YAElF,MAAM,OAAO,CAAC,gBAAgB,GAAG,SAAS,EAAE,KAAK,CAAC;AAElD,YAAA,MAAM,KAAK;QACZ;AAEA,QAAA,OAAO,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,kBAAiC,KAAgB;AAC3G,YAAA,IAAI,OAAO,CAAC,0BAA0B,KAAK,KAAK,EAAE;AACjD,gBAAA,OAAO,MAAM,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;YAClD;AAEA,YAAA,OAAO,MAAM,2BAA2B,CAAC,oBAAoB,CAAC,kBAAkB,EAAE,YAAwB,MAAM,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;AACtJ,QAAA,CAAC,CAAC;IACH;AAEA,IAAA,OAAO,MAAM,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;AAC5C;;;;"}
+{"version":3,"file":"function-transaction.utility.js","sources":["../../../../../src/utility/api/function-transaction.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/{cjs/utility/api/get-default-string-format-properties/bigint-string/apply-options.utility.d.ts → esm/utility/api/get-default-string-format-properties/bigint-string-apply-options.utility.d.ts}

@@ -1,5 +1,5 @@
-import { TApiPropertyDefaultStringFormatProperties } from '../../../../type/decorator/api/property';
-import { TApiGetDefaultStringFormatPropertiesBigIntStringOptions } from '../../../../type/utility/api';
+import { TApiPropertyDefaultStringFormatProperties } from '../../../type/decorator/api/property';
+import { TApiGetDefaultStringFormatPropertiesBigIntStringOptions } from '../../../type/utility/api';
 /**
  * Applies bigint string-specific options to default string format properties.
  * @param {TApiPropertyDefaultStringFormatProperties} properties - Base properties cloned from defaults.

package/dist/esm/utility/api/get-default-string-format-properties/{bigint-string/apply-options.utility.js → bigint-string-apply-options.utility.js}

@@ -1,4 +1,6 @@
-import { BIGINT_STRING_GET_DEFAULT_STRING_FORMAT_PROPERTIES_API_UTILITY_CONSTANT } from '../../../../constant/utility/api/get-default-string-format-properties/bigint-string/constant.js';
+import { BIGINT_STRING_GET_DEFAULT_STRING_FORMAT_PROPERTIES_API_UTILITY_CONSTANT } from '../../../constant/utility/api/get-default-string-format-properties/bigint-string/constant.js';
+import '../../../constant/utility/api/get-default-string-format-properties/bigint-string/sign/default.constant.js';
+import '../../../constant/utility/api/get-default-string-format-properties/bigint-string/sign/properties.constant.js';
 
 /**
  * Applies bigint string-specific options to default string format properties.
@@ -15,4 +17,4 @@ function ApplyBigIntStringGetDefaultStringFormatPropertiesOptions(properties, op
 }
 
 export { ApplyBigIntStringGetDefaultStringFormatPropertiesOptions };
-//# sourceMappingURL=apply-options.utility.js.map
+//# sourceMappingURL=bigint-string-apply-options.utility.js.map

package/dist/esm/utility/api/get-default-string-format-properties/bigint-string-apply-options.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bigint-string-apply-options.utility.js","sources":["../../../../../../src/utility/api/get-default-string-format-properties/bigint-string-apply-options.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAMA;;;;;AAKG;AACG,SAAU,wDAAwD,CAAC,UAAqD,EAAE,OAA4E,EAAA;IAC3M,MAAM,IAAI,GAAyD,OAAO,EAAE,IAAI,IAAI,uEAAuE,CAAC,YAAY;IAExK,OAAO;AACN,QAAA,GAAG,UAAU;AACb,QAAA,GAAG,uEAAuE,CAAC,eAAe,CAAC,IAAI,CAAC;KAChG;AACF;;;;"}

package/dist/{cjs/utility/api/get-default-string-format-properties/customizer/apply.utility.d.ts → esm/utility/api/get-default-string-format-properties/customizer-apply.utility.d.ts}

@@ -1,5 +1,5 @@
-import { TApiPropertyDefaultStringFormat, TApiPropertyDefaultStringFormatProperties } from '../../../../type/decorator/api/property';
-import { TApiGetDefaultStringFormatPropertiesParameters } from '../../../../type/utility/api';
+import { TApiPropertyDefaultStringFormat, TApiPropertyDefaultStringFormatProperties } from '../../../type/decorator/api/property';
+import { TApiGetDefaultStringFormatPropertiesParameters } from '../../../type/utility/api';
 /**
  * Applies format-specific customizations through the registered customizer map.
  * @param {TFormat} format - Default string format.

package/dist/esm/utility/api/get-default-string-format-properties/{customizer/apply.utility.js → customizer-apply.utility.js}

@@ -1,4 +1,5 @@
-import { GET_DEFAULT_STRING_FORMAT_PROPERTIES_API_UTILITY_CONSTANT } from '../../../../constant/utility/api/get-default-string-format-properties/constant.js';
+import { GET_DEFAULT_STRING_FORMAT_PROPERTIES_API_UTILITY_CONSTANT } from '../../../constant/utility/api/get-default-string-format-properties/constant.js';
+import '../../../constant/utility/api/get-default-string-format-properties/customizer-map.constant.js';
 
 /**
  * Applies format-specific customizations through the registered customizer map.
@@ -15,4 +16,4 @@ function ApplyGetDefaultStringFormatPropertiesCustomizer(format, properties, ...
 }
 
 export { ApplyGetDefaultStringFormatPropertiesCustomizer };
-//# sourceMappingURL=apply.utility.js.map
+//# sourceMappingURL=customizer-apply.utility.js.map

package/dist/esm/utility/api/get-default-string-format-properties/customizer-apply.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customizer-apply.utility.js","sources":["../../../../../../src/utility/api/get-default-string-format-properties/customizer-apply.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAMA;;;;;;;AAOG;AACG,SAAU,+CAA+C,CAAwD,MAAe,EAAE,UAAqD,EAAE,GAAG,UAAmE,EAAA;IACpQ,MAAM,UAAU,GAAwE,yDAAyD,CAAC,cAAc,CAAC,MAAM,CAAC;AACxK,IAAA,MAAM,CAAC,OAAO,CAAC,GAA4D,UAAU;IAErF,OAAO,UAAU,GAAG,UAAU,EAAE,OAAO,CAAC,IAAI,UAAU;AACvD;;;;"}

package/dist/esm/utility/api/get-default-string-format-properties/index.d.ts

@@ -1 +1,3 @@
+export { ApplyBigIntStringGetDefaultStringFormatPropertiesOptions } from './bigint-string-apply-options.utility';
+export { ApplyGetDefaultStringFormatPropertiesCustomizer } from './customizer-apply.utility';
 export { GetDefaultStringFormatProperties } from './utility';

package/dist/esm/utility/api/get-default-string-format-properties/utility.js

@@ -1,6 +1,6 @@
 import { DEFAULT_STRING_FORMAT_PROPERTY_API_INTERFACE_CONSTANT } from '../../../constant/interface/api/property/default-string-format.constant.js';
+import { ApplyGetDefaultStringFormatPropertiesCustomizer } from './customizer-apply.utility.js';
 import cloneDeep from 'lodash/cloneDeep.js';
-import { ApplyGetDefaultStringFormatPropertiesCustomizer } from './customizer/apply.utility.js';
 
 /**
  * Returns default format properties for supported string types (EMAIL, IP, URL, UUID).

package/dist/esm/utility/api/get-default-string-format-properties/utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"utility.js","sources":["../../../../../../src/utility/api/get-default-string-format-properties/utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAQA;;;;;;;;;;;;;;;;;;;;AAoBG;SACa,gCAAgC,CAAwD,MAAe,EAAE,GAAG,UAAmE,EAAA;IAC9L,MAAM,UAAU,GAA8C,SAAS,CAAC,qDAAqD,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAEhK,OAAO,+CAA+C,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,CAAC;AAC1F;;;;"}
+{"version":3,"file":"utility.js","sources":["../../../../../../src/utility/api/get-default-string-format-properties/utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAOA;;;;;;;;;;;;;;;;;;;;AAoBG;SACa,gCAAgC,CAAwD,MAAe,EAAE,GAAG,UAAmE,EAAA;IAC9L,MAAM,UAAU,GAA8C,SAAS,CAAC,qDAAqD,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAEhK,OAAO,+CAA+C,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,CAAC;AAC1F;;;;"}

package/dist/esm/utility/api/index.d.ts

@@ -1,5 +1,5 @@
 export * from './controller';
-export * from './discriminator';
+export { ApiDiscriminatorValidateConfig } from './discriminator-validate-config.utility';
 export { FilterOrderByFromEntity } from './filter-order-by-from-entity.utility';
-export * from './get-default-string-format-properties';
+export { GetDefaultStringFormatProperties } from './get-default-string-format-properties';
 export * from './route';

package/dist/esm/utility/api/route/apply-dto-metadata.utility.js

@@ -1,12 +1,20 @@
 import '../../../enum/decorator/api/action.enum.js';
 import '../../../enum/decorator/api/authentication-type.enum.js';
+import '../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js';
+import '../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js';
 import '../../../enum/decorator/api/controller/relation-reference-shape.enum.js';
 import '../../../enum/decorator/api/controller/request/target.enum.js';
 import '../../../enum/decorator/api/controller/request/transformer-type.enum.js';
 import '../../../enum/decorator/api/controller/response-target.enum.js';
 import { EApiDtoType } from '../../../enum/decorator/api/dto-type.enum.js';
+import '../../../enum/decorator/api/function/context-storage-kind.enum.js';
 import '../../../enum/decorator/api/function/subscriber-transaction-expectation.enum.js';
-import '../../../enum/decorator/api/function/transaction-mode.enum.js';
+import '../../../enum/decorator/api/function/transaction/event-status.enum.js';
+import '../../../enum/decorator/api/function/transaction/failure-stage.enum.js';
+import '../../../enum/decorator/api/function/transaction/mode.enum.js';
+import '../../../enum/decorator/api/function/transaction/outcome.enum.js';
+import '../../../enum/decorator/api/function/transaction/owner-kind.enum.js';
+import '../../../enum/decorator/api/function/transaction/trace-type.enum.js';
 import '../../../enum/decorator/api/function/type.enum.js';
 import '../../../enum/decorator/api/on-type.enum.js';
 import '../../../enum/decorator/api/property/data-type.enum.js';
@@ -25,7 +33,7 @@ import { ApiControllerGetDto } from '../controller/get/dto.utility.js';
 import { ApiRouteBuildDiscriminatedDtoOpenApiSchema } from './discriminator/build-open-api-schema.utility.js';
 import { ApiRouteIsDiscriminatedDtoProperties } from './discriminator/is-dto-properties.utility.js';
 import '@nestjs/swagger/dist/constants.js';
-import { ApiRouteCollectDtoWithRegisteredChildren } from './dto/collect-with-registered-children.utility.js';
+import { ApiRouteCollectDtoWithRegisteredChildren } from './dto-collect-with-registered-children.utility.js';
 import { GenerateEntityInformation } from '../../generate-entity-information.utility.js';
 
 /**