@elsikora/nestjs-crud-automator 1.24.0-dev.1 → 2.0.0-dev.1

package/dist/cjs/utility/api/controller/serialize-route-response.utility.d.ts

@@ -0,0 +1,14 @@
+import type { EApiRouteType } from '../../../enum/decorator/api/index';
+import type { IApiBaseEntity } from '../../../interface/api-base-entity.interface';
+import type { Type } from "@nestjs/common";
+import type { TApiControllerPropertiesRoute } from '../../../type/decorator/api/controller/index';
+/**
+ * Serializes a generated route response with the route DTO and serialization settings.
+ * @template E - Entity type owned by the route.
+ * @template R - Response value type.
+ * @param {TApiControllerPropertiesRoute<E, EApiRouteType>} routeConfig - Route configuration containing response serialization settings.
+ * @param {Type<unknown> | undefined} dto - DTO type used for response serialization.
+ * @param {R} response - Response value to serialize.
+ * @returns {R} Serialized response value.
+ */
+export declare function ApiControllerSerializeRouteResponse<E extends IApiBaseEntity, R>(routeConfig: TApiControllerPropertiesRoute<E, EApiRouteType>, dto: Type<unknown> | undefined, response: R): R;

package/dist/cjs/utility/api/controller/serialize-route-response.utility.js

@@ -0,0 +1,29 @@
+'use strict';
+
+var common = require('@nestjs/common');
+var serialize_utility = require('../route/response/serialize.utility.js');
+
+/**
+ * Serializes a generated route response with the route DTO and serialization settings.
+ * @template E - Entity type owned by the route.
+ * @template R - Response value type.
+ * @param {TApiControllerPropertiesRoute<E, EApiRouteType>} routeConfig - Route configuration containing response serialization settings.
+ * @param {Type<unknown> | undefined} dto - DTO type used for response serialization.
+ * @param {R} response - Response value to serialize.
+ * @returns {R} Serialized response value.
+ */
+function ApiControllerSerializeRouteResponse(routeConfig, dto, response) {
+    const serialization = routeConfig.response?.serialization ?? {
+        isEnabled: true,
+    };
+    return serialize_utility.ApiRouteSerializeResponse({
+        response: {
+            serialization,
+            status: common.HttpStatus.OK,
+            type: dto,
+        },
+    }, response);
+}
+
+exports.ApiControllerSerializeRouteResponse = ApiControllerSerializeRouteResponse;
+//# sourceMappingURL=serialize-route-response.utility.js.map

package/dist/cjs/utility/api/controller/serialize-route-response.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize-route-response.utility.js","sources":["../../../../../../src/utility/api/controller/serialize-route-response.utility.ts"],"sourcesContent":[null],"names":["ApiRouteSerializeResponse","HttpStatus"],"mappings":";;;;;AASA;;;;;;;;AAQG;SACa,mCAAmC,CAA8B,WAA4D,EAAE,GAA8B,EAAE,QAAW,EAAA;AACzL,IAAA,MAAM,aAAa,GAA6C,WAAW,CAAC,QAAQ,EAAE,aAAa,IAAI;AACtG,QAAA,SAAS,EAAE,IAAI;KACf;AAED,IAAA,OAAOA,2CAAyB,CAC/B;AACC,QAAA,QAAQ,EAAE;YACT,aAAa;YACb,MAAM,EAAEC,iBAAU,CAAC,EAAE;AACrB,YAAA,IAAI,EAAE,GAAG;AACT,SAAA;KACD,EACD,QAAQ,CACR;AACF;;;;"}

package/dist/cjs/utility/api/controller/transform-data.utility.d.ts

@@ -1,17 +1,18 @@
-import type { EApiRouteType } from '../../../enum/decorator/api/index';
 import type { IApiBaseEntity } from '../../../interface/api-base-entity.interface';
 import type { IApiControllerProperties } from '../../../interface/decorator/api/index';
-import type { TApiControllerPropertiesRouteBaseRequestTransformers, TApiControllerPropertiesRouteBaseResponseTransformers } from '../../../type/decorator/api/controller/index';
+import type { TApiRequestTransformer } from '../../../type/api-request-transformer.type';
 import type { TApiControllerTransformDataData, TApiControllerTransformDataObjectToTransform } from '../../../type/utility/index';
+import { EApiControllerRequestTarget, EApiControllerResponseTarget } from '../../../enum/decorator/api/index';
 /**
  * Transforms data between request/response objects and entity objects.
- * Handles both static and dynamic transformations for body, query, request, and response data.
- * @param {TApiControllerPropertiesRouteBaseRequestTransformers<E, R> | TApiControllerPropertiesRouteBaseResponseTransformers<E, R> | undefined} transformers - Configuration for data transformations
+ * Handles both static and dynamic transformations for body, query, parameters, and response data.
+ * @template E - The entity type.
+ * @param {object | undefined} targets - Target-specific transformer configuration.
  * @param {IApiControllerProperties<E>} properties - Controller configuration properties
  * @param {TApiControllerTransformDataObjectToTransform<E>} objectToTransform - The object to apply transformations to
  * @param {TApiControllerTransformDataData} data - Data sources to use for transformations including headers, IP address, and authentication
  * @returns {void}
- * @template E - The entity type
- * @template R - The route type
  */
-export declare function ApiControllerTransformData<E extends IApiBaseEntity, R extends EApiRouteType>(transformers: TApiControllerPropertiesRouteBaseRequestTransformers<E, R> | TApiControllerPropertiesRouteBaseResponseTransformers<E, R> | undefined, properties: IApiControllerProperties<E>, objectToTransform: TApiControllerTransformDataObjectToTransform<E>, data: TApiControllerTransformDataData): void;
+export declare function ApiControllerTransformData<E extends IApiBaseEntity>(targets: Partial<Record<EApiControllerRequestTarget | EApiControllerResponseTarget, {
+    transformers?: Array<TApiRequestTransformer<E>>;
+}>> | undefined, properties: IApiControllerProperties<E>, objectToTransform: TApiControllerTransformDataObjectToTransform<E>, data: TApiControllerTransformDataData): void;

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

@@ -4,8 +4,12 @@ var transformerValue_constant = require('../../../constant/dto/transformer-value
 require('../../../enum/decorator/api/action.enum.js');
 require('../../../enum/decorator/api/authentication-type.enum.js');
 require('../../../enum/decorator/api/controller/load-relations-strategy.enum.js');
-var requestTransformerType_enum = require('../../../enum/decorator/api/controller/request-transformer-type.enum.js');
-var dtoType_enum = require('../../../enum/decorator/api/dto-type.enum.js');
+require('../../../enum/decorator/api/controller/relation-reference-shape.enum.js');
+var target_enum = require('../../../enum/decorator/api/controller/request/target.enum.js');
+var transformerType_enum = require('../../../enum/decorator/api/controller/request/transformer-type.enum.js');
+var responseTarget_enum = require('../../../enum/decorator/api/controller/response-target.enum.js');
+require('../../../enum/decorator/api/dto-type.enum.js');
+require('../../../enum/decorator/api/function-transaction-mode.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');
@@ -24,38 +28,37 @@ var string_utility = require('../../error/string.utility.js');
 
 /**
  * Transforms data between request/response objects and entity objects.
- * Handles both static and dynamic transformations for body, query, request, and response data.
- * @param {TApiControllerPropertiesRouteBaseRequestTransformers<E, R> | TApiControllerPropertiesRouteBaseResponseTransformers<E, R> | undefined} transformers - Configuration for data transformations
+ * Handles both static and dynamic transformations for body, query, parameters, and response data.
+ * @template E - The entity type.
+ * @param {object | undefined} targets - Target-specific transformer configuration.
  * @param {IApiControllerProperties<E>} properties - Controller configuration properties
  * @param {TApiControllerTransformDataObjectToTransform<E>} objectToTransform - The object to apply transformations to
  * @param {TApiControllerTransformDataData} data - Data sources to use for transformations including headers, IP address, and authentication
  * @returns {void}
- * @template E - The entity type
- * @template R - The route type
  */
-function ApiControllerTransformData(transformers, properties, objectToTransform, data) {
-    if (!transformers)
+function ApiControllerTransformData(targets, properties, objectToTransform, data) {
+    if (!targets)
         return;
-    if (dtoType_enum.EApiDtoType.BODY in transformers && transformers[dtoType_enum.EApiDtoType.BODY]) {
-        for (const transformer of transformers[dtoType_enum.EApiDtoType.BODY]) {
+    if (target_enum.EApiControllerRequestTarget.BODY in targets && targets[target_enum.EApiControllerRequestTarget.BODY]?.transformers) {
+        for (const transformer of targets[target_enum.EApiControllerRequestTarget.BODY].transformers) {
             if (objectToTransform.body)
                 processTransformer(transformer, objectToTransform.body, properties, data);
         }
     }
-    if (dtoType_enum.EApiDtoType.QUERY in transformers && transformers[dtoType_enum.EApiDtoType.QUERY]) {
-        for (const transformer of transformers[dtoType_enum.EApiDtoType.QUERY]) {
+    if (target_enum.EApiControllerRequestTarget.QUERY in targets && targets[target_enum.EApiControllerRequestTarget.QUERY]?.transformers) {
+        for (const transformer of targets[target_enum.EApiControllerRequestTarget.QUERY].transformers) {
             if (objectToTransform.query)
                 processTransformer(transformer, objectToTransform.query, properties, data);
         }
     }
-    if (dtoType_enum.EApiDtoType.REQUEST in transformers && transformers[dtoType_enum.EApiDtoType.REQUEST]) {
-        for (const transformer of transformers[dtoType_enum.EApiDtoType.REQUEST]) {
+    if (target_enum.EApiControllerRequestTarget.PARAMETERS in targets && targets[target_enum.EApiControllerRequestTarget.PARAMETERS]?.transformers) {
+        for (const transformer of targets[target_enum.EApiControllerRequestTarget.PARAMETERS].transformers) {
             if (objectToTransform.parameters)
                 processTransformer(transformer, objectToTransform.parameters, properties, data);
         }
     }
-    if (dtoType_enum.EApiDtoType.RESPONSE in transformers && transformers[dtoType_enum.EApiDtoType.RESPONSE]) {
-        for (const transformer of transformers[dtoType_enum.EApiDtoType.RESPONSE]) {
+    if (responseTarget_enum.EApiControllerResponseTarget.RESPONSE in targets && targets[responseTarget_enum.EApiControllerResponseTarget.RESPONSE]?.transformers) {
+        for (const transformer of targets[responseTarget_enum.EApiControllerResponseTarget.RESPONSE].transformers) {
             if (objectToTransform.response)
                 processTransformer(transformer, objectToTransform.response, properties, data);
         }
@@ -136,7 +139,7 @@ function isPartialE(object) {
  */
 function processTransformer(transformer, objectToTransform, properties, data) {
     switch (transformer.type) {
-        case requestTransformerType_enum.EApiControllerRequestTransformerType.DYNAMIC: {
+        case transformerType_enum.EApiControllerRequestTransformerType.DYNAMIC: {
             if (Object.values(transformerValue_constant.TRANSFORMER_VALUE_DTO_CONSTANT).includes(transformer.value)) {
                 switch (transformer.value) {
                     case transformerValue_constant.TRANSFORMER_VALUE_DTO_CONSTANT.AUTHORIZED_ENTITY: {
@@ -199,7 +202,7 @@ function processTransformer(transformer, objectToTransform, properties, data) {
             }
             break;
         }
-        case requestTransformerType_enum.EApiControllerRequestTransformerType.STATIC: {
+        case transformerType_enum.EApiControllerRequestTransformerType.STATIC: {
             const staticValue = transformer.value;
             handleTransformation(objectToTransform, transformer.key, staticValue, properties.entity, transformer.shouldSetValueEvenIfMissing);
             break;

package/dist/cjs/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":["EApiDtoType","InternalServerErrorException","ErrorString","EErrorStringAction","EApiControllerRequestTransformerType","TRANSFORMER_VALUE_DTO_CONSTANT"],"mappings":"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"}
+{"version":3,"file":"transform-data.utility.js","sources":["../../../../../../src/utility/api/controller/transform-data.utility.ts"],"sourcesContent":[null],"names":["EApiControllerRequestTarget","EApiControllerResponseTarget","InternalServerErrorException","ErrorString","EErrorStringAction","EApiControllerRequestTransformerType","TRANSFORMER_VALUE_DTO_CONSTANT"],"mappings":"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"}

package/dist/cjs/utility/api/controller/validate-request.utility.d.ts

@@ -1,14 +1,14 @@
 import type { IApiBaseEntity } from '../../../interface/api-base-entity.interface';
-import type { IApiRequestValidator } from '../../../interface/api/request-validator.interface';
 import type { IApiControllerProperties } from '../../../interface/decorator/api/index';
+import type { IApiControllerPropertiesRouteBaseRequestTarget } from '../../../interface/decorator/api/controller/properties/route/base/index';
 import type { TApiControllerGetListQuery } from '../../../type/decorator/api/controller/index';
 /**
  * Validates incoming request parameters against defined validators.
  * Sequentially applies validation functions and throws appropriate exceptions with error messages when validation fails.
- * @param {Array<IApiRequestValidator<E>> | undefined} validators - List of request validators to apply
+ * @param {IApiControllerPropertiesRouteBaseRequestTarget<E> | undefined} target - Target request pipeline configuration
  * @param {IApiControllerProperties<E>} properties - Controller configuration properties
  * @param {Partial<E> | TApiControllerGetListQuery<E>} parameters - The request parameters to validate
  * @returns {Promise<void>} A promise that resolves when validation passes
  * @template E - The entity type
  */
-export declare function ApiControllerValidateRequest<E extends IApiBaseEntity>(validators: Array<IApiRequestValidator<E>> | undefined, properties: IApiControllerProperties<E>, parameters: Partial<E> | TApiControllerGetListQuery<E>): Promise<void>;
+export declare function ApiControllerValidateRequest<E extends IApiBaseEntity>(target: IApiControllerPropertiesRouteBaseRequestTarget<E> | undefined, properties: IApiControllerProperties<E>, parameters: Partial<E> | TApiControllerGetListQuery<E>): Promise<void>;

package/dist/cjs/utility/api/controller/validate-request.utility.js

@@ -5,20 +5,21 @@ var string_utility = require('../../error/string.utility.js');
 /**
  * Validates incoming request parameters against defined validators.
  * Sequentially applies validation functions and throws appropriate exceptions with error messages when validation fails.
- * @param {Array<IApiRequestValidator<E>> | undefined} validators - List of request validators to apply
+ * @param {IApiControllerPropertiesRouteBaseRequestTarget<E> | undefined} target - Target request pipeline configuration
  * @param {IApiControllerProperties<E>} properties - Controller configuration properties
  * @param {Partial<E> | TApiControllerGetListQuery<E>} parameters - The request parameters to validate
  * @returns {Promise<void>} A promise that resolves when validation passes
  * @template E - The entity type
  */
-async function ApiControllerValidateRequest(validators, properties, parameters) {
-    if (validators) {
-        for (const validator of validators) {
-            const result = validator.validationFunction(parameters);
-            const isValid = result instanceof Promise ? await result : result;
-            if (!isValid) {
-                throw new validator.exception(string_utility.ErrorString({ entity: properties.entity, type: validator.errorType }));
-            }
+async function ApiControllerValidateRequest(target, properties, parameters) {
+    if (!target?.validators) {
+        return;
+    }
+    for (const validator of target.validators) {
+        const result = validator.validationFunction(parameters);
+        const isValid = result instanceof Promise ? await result : result;
+        if (!isValid) {
+            throw new validator.exception(string_utility.ErrorString({ entity: properties.entity, type: validator.errorType }));
         }
     }
 }

package/dist/cjs/utility/api/controller/validate-request.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate-request.utility.js","sources":["../../../../../../src/utility/api/controller/validate-request.utility.ts"],"sourcesContent":[null],"names":["ErrorString"],"mappings":";;;;AAOA;;;;;;;;AAQG;AACI,eAAe,4BAA4B,CAA2B,UAAsD,EAAE,UAAuC,EAAE,UAAsD,EAAA;IACnO,IAAI,UAAU,EAAE;AACf,QAAA,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE;YACnC,MAAM,MAAM,GAA+B,SAAS,CAAC,kBAAkB,CAAC,UAAU,CAAC;AACnF,YAAA,MAAM,OAAO,GAAY,MAAM,YAAY,OAAO,GAAG,MAAM,MAAM,GAAG,MAAM;YAE1E,IAAI,CAAC,OAAO,EAAE;gBACb,MAAM,IAAI,SAAS,CAAC,SAAS,CAACA,0BAAW,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC;YACrG;QACD;IACD;AACD;;;;"}
+{"version":3,"file":"validate-request.utility.js","sources":["../../../../../../src/utility/api/controller/validate-request.utility.ts"],"sourcesContent":[null],"names":["ErrorString"],"mappings":";;;;AAOA;;;;;;;;AAQG;AACI,eAAe,4BAA4B,CAA2B,MAAqE,EAAE,UAAuC,EAAE,UAAsD,EAAA;AAClP,IAAA,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE;QACxB;IACD;AAEA,IAAA,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,UAAU,EAAE;QAC1C,MAAM,MAAM,GAA+B,SAAS,CAAC,kBAAkB,CAAC,UAAU,CAAC;AACnF,QAAA,MAAM,OAAO,GAAY,MAAM,YAAY,OAAO,GAAG,MAAM,MAAM,GAAG,MAAM;QAE1E,IAAI,CAAC,OAAO,EAAE;YACb,MAAM,IAAI,SAAS,CAAC,SAAS,CAACA,0BAAW,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC;QACrG;IACD;AACD;;;;"}

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

@@ -6,8 +6,12 @@ var propertyDescribe_constant = require('../../../../constant/decorator/api/prop
 require('../../../../enum/decorator/api/action.enum.js');
 require('../../../../enum/decorator/api/authentication-type.enum.js');
 require('../../../../enum/decorator/api/controller/load-relations-strategy.enum.js');
-require('../../../../enum/decorator/api/controller/request-transformer-type.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');
 var dtoType_enum = require('../../../../enum/decorator/api/dto-type.enum.js');
+require('../../../../enum/decorator/api/function-transaction-mode.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');
@@ -53,7 +57,7 @@ function ApiControllerWriteDtoSwagger(target, entity, properties, method, routeC
     else if (properties.entity.name) {
         entityNames.push(properties.entity.name);
     }
-    const requestDto = dto_utility.ApiControllerGetDto(properties, entity, method, dtoType_enum.EApiDtoType.REQUEST, routeConfig);
+    const requestDto = dto_utility.ApiControllerGetDto(properties, entity, method, dtoType_enum.EApiDtoType.PARAMETERS, routeConfig);
     const queryDto = dto_utility.ApiControllerGetDto(properties, entity, method, dtoType_enum.EApiDtoType.QUERY, routeConfig);
     const bodyDto = dto_utility.ApiControllerGetDto(properties, entity, method, dtoType_enum.EApiDtoType.BODY, routeConfig);
     const responseDto = dto_utility.ApiControllerGetDto(properties, entity, method, dtoType_enum.EApiDtoType.RESPONSE, routeConfig);

package/dist/cjs/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":["DECORATORS","ApiControllerGetDto","EApiDtoType","MetadataStorage","PROPERTY_DESCRIBE_DECORATOR_API_CONSTANT","EApiPropertyDescribeType","CamelCaseString"],"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":["DECORATORS","ApiControllerGetDto","EApiDtoType","MetadataStorage","PROPERTY_DESCRIBE_DECORATOR_API_CONSTANT","EApiPropertyDescribeType","CamelCaseString"],"mappings":"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"}

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

@@ -0,0 +1,20 @@
+import type { IApiBaseEntity } from '../../interface/api-base-entity.interface';
+import type { EntityManager, Repository } from "typeorm";
+import { EApiFunctionTransactionMode } from '../../enum/decorator/api/index';
+/**
+ * Executes an ApiFunction callback according to its transaction mode.
+ * @template E - Entity type owned by the function repository.
+ * @template R - Callback result type.
+ * @param {object} options - Transaction execution options.
+ * @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 {EApiFunctionTransactionMode} options.mode - Transaction mode to enforce.
+ * @param {Repository<E>} options.repository - Repository used to open new transactions when required.
+ * @returns {Promise<R>} Callback result.
+ */
+export declare function ApiFunctionExecuteWithTransaction<E extends IApiBaseEntity, R>(options: {
+    callback: (eventManager: EntityManager | undefined) => Promise<R>;
+    entity: new (...arguments_: Array<unknown>) => E;
+    mode: EApiFunctionTransactionMode;
+    repository: Repository<E>;
+}): Promise<R>;

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

@@ -0,0 +1,52 @@
+'use strict';
+
+var contextStorage_class = require('../../class/api/function/context-storage.class.js');
+var transactionScope_class = require('../../class/api/function/transaction-scope.class.js');
+require('../../enum/decorator/api/action.enum.js');
+require('../../enum/decorator/api/authentication-type.enum.js');
+require('../../enum/decorator/api/controller/load-relations-strategy.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');
+var functionTransactionMode_enum = require('../../enum/decorator/api/function-transaction-mode.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-type.enum.js');
+var exception_utility = require('../error/exception.utility.js');
+
+/**
+ * Executes an ApiFunction callback according to its transaction mode.
+ * @template E - Entity type owned by the function repository.
+ * @template R - Callback result type.
+ * @param {object} options - Transaction execution options.
+ * @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 {EApiFunctionTransactionMode} options.mode - Transaction mode to enforce.
+ * @param {Repository<E>} options.repository - Repository used to open new transactions when required.
+ * @returns {Promise<R>} Callback result.
+ */
+async function ApiFunctionExecuteWithTransaction(options) {
+    const activeEventManager = contextStorage_class.ApiFunctionContextStorage.get()?.eventManager;
+    if (options.mode === functionTransactionMode_enum.EApiFunctionTransactionMode.NONE && activeEventManager) {
+        throw exception_utility.ErrorException("ApiFunction transaction mode NONE cannot run inside an active transaction");
+    }
+    if (options.mode === functionTransactionMode_enum.EApiFunctionTransactionMode.MANDATORY && !activeEventManager) {
+        throw exception_utility.ErrorException("ApiFunction transaction mode MANDATORY requires an active transaction");
+    }
+    const eventManager = options.mode === functionTransactionMode_enum.EApiFunctionTransactionMode.NONE ? undefined : activeEventManager;
+    if (options.mode === functionTransactionMode_enum.EApiFunctionTransactionMode.REQUIRED && !eventManager) {
+        return await options.repository.manager.transaction(async (transactionManager) => await transactionScope_class.ApiFunctionTransactionScope.runWithEntityManager(transactionManager, async () => await options.callback(transactionManager)));
+    }
+    return await options.callback(eventManager);
+}
+
+exports.ApiFunctionExecuteWithTransaction = ApiFunctionExecuteWithTransaction;
+//# sourceMappingURL=function-transaction.utility.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"function-transaction.utility.js","sources":["../../../../../src/utility/api/function-transaction.utility.ts"],"sourcesContent":[null],"names":["ApiFunctionContextStorage","EApiFunctionTransactionMode","ErrorException","ApiFunctionTransactionScope"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAQA;;;;;;;;;;AAUG;AACI,eAAe,iCAAiC,CAA8B,OAA8L,EAAA;IAClR,MAAM,kBAAkB,GAA8BA,8CAAyB,CAAC,GAAG,EAAK,EAAE,YAAY;IAEtG,IAAI,OAAO,CAAC,IAAI,KAAKC,wDAA2B,CAAC,IAAI,IAAI,kBAAkB,EAAE;AAC5E,QAAA,MAAMC,gCAAc,CAAC,2EAA2E,CAAC;IAClG;IAEA,IAAI,OAAO,CAAC,IAAI,KAAKD,wDAA2B,CAAC,SAAS,IAAI,CAAC,kBAAkB,EAAE;AAClF,QAAA,MAAMC,gCAAc,CAAC,uEAAuE,CAAC;IAC9F;AAEA,IAAA,MAAM,YAAY,GAA8B,OAAO,CAAC,IAAI,KAAKD,wDAA2B,CAAC,IAAI,GAAG,SAAS,GAAG,kBAAkB;IAElI,IAAI,OAAO,CAAC,IAAI,KAAKA,wDAA2B,CAAC,QAAQ,IAAI,CAAC,YAAY,EAAE;AAC3E,QAAA,OAAO,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,kBAAiC,KAAiB,MAAME,kDAA2B,CAAC,oBAAoB,CAAC,kBAAkB,EAAE,YAAwB,MAAM,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAC7P;AAEA,IAAA,OAAO,MAAM,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;AAC5C;;;;"}

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

@@ -1,3 +1,4 @@
 export * from './controller/index';
 export { FilterOrderByFromEntity } from './filter-order-by-from-entity.utility';
 export { GetDefaultStringFormatProperties } from './get-default-string-format-properties.utility';
+export * from './route/index';

package/dist/cjs/utility/api/route/index.d.ts

@@ -0,0 +1 @@
+export * from './response/index';

package/dist/cjs/utility/api/route/response/index.d.ts

@@ -0,0 +1,2 @@
+export { ApiRouteProjectRelationResponse } from './project-relation.utility';
+export { ApiRouteSerializeResponse } from './serialize.utility';

package/dist/cjs/utility/api/route/response/project-relation.utility.d.ts

@@ -0,0 +1,11 @@
+import type { IApiBaseEntity } from '../../../../interface/api-base-entity.interface';
+import type { IApiControllerPropertiesRouteBaseRelationsResponse } from '../../../../interface/decorator/api/index';
+/**
+ * Projects loaded relation objects into the configured response reference shape.
+ * @template E - Entity type that owns the relation configuration.
+ * @template R - Response value type.
+ * @param {IApiControllerPropertiesRouteBaseRelationsResponse<E> | undefined} relationConfig - Response relation projection configuration.
+ * @param {R} response - Response value to project.
+ * @returns {R} Response value with projected relation references.
+ */
+export declare function ApiRouteProjectRelationResponse<E extends IApiBaseEntity, R>(relationConfig: IApiControllerPropertiesRouteBaseRelationsResponse<E> | undefined, response: R): R;

package/dist/cjs/utility/api/route/response/project-relation.utility.js

@@ -0,0 +1,75 @@
+'use strict';
+
+require('../../../../enum/decorator/api/action.enum.js');
+require('../../../../enum/decorator/api/authentication-type.enum.js');
+require('../../../../enum/decorator/api/controller/load-relations-strategy.enum.js');
+var relationReferenceShape_enum = 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-transaction-mode.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-type.enum.js');
+
+/**
+ * Projects loaded relation objects into the configured response reference shape.
+ * @template E - Entity type that owns the relation configuration.
+ * @template R - Response value type.
+ * @param {IApiControllerPropertiesRouteBaseRelationsResponse<E> | undefined} relationConfig - Response relation projection configuration.
+ * @param {R} response - Response value to project.
+ * @returns {R} Response value with projected relation references.
+ */
+function ApiRouteProjectRelationResponse(relationConfig, response) {
+    if (!relationConfig?.load?.include) {
+        return response;
+    }
+    const relationNames = Object.keys(relationConfig.load.include);
+    const referenceKey = relationConfig.reference.key ?? "id";
+    const responses = [];
+    let projectedArray;
+    if (Array.isArray(response)) {
+        projectedArray = response.map((item) => {
+            if (item === null || typeof item !== "object") {
+                return item;
+            }
+            const projectedItem = { ...item };
+            responses.push(projectedItem);
+            return projectedItem;
+        });
+    }
+    else if (response !== null && typeof response === "object" && "items" in response && Array.isArray(response.items)) {
+        response.items = response.items.map((item) => {
+            if (item === null || typeof item !== "object") {
+                return item;
+            }
+            const projectedItem = { ...item };
+            responses.push(projectedItem);
+            return projectedItem;
+        });
+    }
+    else if (response !== null && typeof response === "object") {
+        responses.push(response);
+    }
+    for (const projectedResponse of responses) {
+        for (const relationName of relationNames) {
+            const relationValue = projectedResponse[relationName];
+            if (relationValue === null || relationValue === undefined || typeof relationValue !== "object") {
+                continue;
+            }
+            const referenceValue = relationValue[referenceKey];
+            projectedResponse[relationName] = relationConfig.reference.shape === relationReferenceShape_enum.EApiControllerRelationReferenceShape.SCALAR ? referenceValue : { [referenceKey]: referenceValue };
+        }
+    }
+    return projectedArray ? projectedArray : response;
+}
+
+exports.ApiRouteProjectRelationResponse = ApiRouteProjectRelationResponse;
+//# sourceMappingURL=project-relation.utility.js.map

package/dist/cjs/utility/api/route/response/project-relation.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-relation.utility.js","sources":["../../../../../../../src/utility/api/route/response/project-relation.utility.ts"],"sourcesContent":[null],"names":["EApiControllerRelationReferenceShape"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAKA;;;;;;;AAOG;AACG,SAAU,+BAA+B,CAA8B,cAAiF,EAAE,QAAW,EAAA;AAC1K,IAAA,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,OAAO,EAAE;AACnC,QAAA,OAAO,QAAQ;IAChB;AAEA,IAAA,MAAM,aAAa,GAAkB,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;IAC7E,MAAM,YAAY,GAAW,cAAc,CAAC,SAAS,CAAC,GAAG,IAAI,IAAI;IACjE,MAAM,SAAS,GAAmC,EAAE;AACpD,IAAA,IAAI,cAA0C;AAE9C,IAAA,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;QAC5B,cAAc,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAa,KAAa;YACxD,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;AAC9C,gBAAA,OAAO,IAAI;YACZ;AAEA,YAAA,MAAM,aAAa,GAA4B,EAAE,GAAI,IAAgC,EAAE;AACvF,YAAA,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC;AAE7B,YAAA,OAAO,aAAa;AACrB,QAAA,CAAC,CAAC;IACH;SAAO,IAAI,QAAQ,KAAK,IAAI,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,OAAO,IAAI,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAE,QAAgC,CAAC,KAAK,CAAC,EAAE;AAC7I,QAAA,QAAsC,CAAC,KAAK,GAAI,QAAsC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAa,KAAa;YAC5H,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;AAC9C,gBAAA,OAAO,IAAI;YACZ;AAEA,YAAA,MAAM,aAAa,GAA4B,EAAE,GAAI,IAAgC,EAAE;AACvF,YAAA,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC;AAE7B,YAAA,OAAO,aAAa;AACrB,QAAA,CAAC,CAAC;IACH;SAAO,IAAI,QAAQ,KAAK,IAAI,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE;AAC7D,QAAA,SAAS,CAAC,IAAI,CAAC,QAAmC,CAAC;IACpD;AAEA,IAAA,KAAK,MAAM,iBAAiB,IAAI,SAAS,EAAE;AAC1C,QAAA,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE;AACzC,YAAA,MAAM,aAAa,GAAY,iBAAiB,CAAC,YAAY,CAAC;AAE9D,YAAA,IAAI,aAAa,KAAK,IAAI,IAAI,aAAa,KAAK,SAAS,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE;gBAC/F;YACD;AAEA,YAAA,MAAM,cAAc,GAAa,aAAyC,CAAC,YAAY,CAAC;YACxF,iBAAiB,CAAC,YAAY,CAAC,GAAG,cAAc,CAAC,SAAS,CAAC,KAAK,KAAKA,gEAAoC,CAAC,MAAM,GAAG,cAAc,GAAG,EAAE,CAAC,YAAY,GAAG,cAAc,EAAE;QACvK;IACD;IAEA,OAAO,cAAc,GAAI,cAAoB,GAAG,QAAQ;AACzD;;;;"}

package/dist/cjs/utility/api/route/response/serialize.utility.d.ts

@@ -0,0 +1,11 @@
+import type { IApiBaseEntity } from '../../../../interface/api-base-entity.interface';
+import type { IApiRouteMetadata } from '../../../../interface/decorator/api/index';
+/**
+ * Serializes a route response using the route metadata response DTO configuration.
+ * @template E - Entity type represented by the route metadata.
+ * @template R - Response value type.
+ * @param {Pick<IApiRouteMetadata<E>, "response">} metadata - Route metadata containing response serialization settings.
+ * @param {R} response - Response value to serialize.
+ * @returns {R} Serialized response value.
+ */
+export declare function ApiRouteSerializeResponse<E extends IApiBaseEntity, R>(metadata: Pick<IApiRouteMetadata<E>, "response">, response: R): R;

package/dist/cjs/utility/api/route/response/serialize.utility.js

@@ -0,0 +1,26 @@
+'use strict';
+
+var common = require('@nestjs/common');
+var classTransformer = require('class-transformer');
+
+/**
+ * Serializes a route response using the route metadata response DTO configuration.
+ * @template E - Entity type represented by the route metadata.
+ * @template R - Response value type.
+ * @param {Pick<IApiRouteMetadata<E>, "response">} metadata - Route metadata containing response serialization settings.
+ * @param {R} response - Response value to serialize.
+ * @returns {R} Serialized response value.
+ */
+function ApiRouteSerializeResponse(metadata, response) {
+    if (!metadata.response?.serialization?.isEnabled || !metadata.response.type || metadata.response.status === common.HttpStatus.NO_CONTENT) {
+        return response;
+    }
+    return classTransformer.plainToInstance(metadata.response.type, response, {
+        // eslint-disable-next-line @elsikora/typescript/naming-convention
+        excludeExtraneousValues: true,
+        strategy: "excludeAll",
+    });
+}
+
+exports.ApiRouteSerializeResponse = ApiRouteSerializeResponse;
+//# sourceMappingURL=serialize.utility.js.map

package/dist/cjs/utility/api/route/response/serialize.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.utility.js","sources":["../../../../../../../src/utility/api/route/response/serialize.utility.ts"],"sourcesContent":[null],"names":["HttpStatus","plainToInstance"],"mappings":";;;;;AAOA;;;;;;;AAOG;AACG,SAAU,yBAAyB,CAA8B,QAAgD,EAAE,QAAW,EAAA;IACnI,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,SAAS,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,KAAKA,iBAAU,CAAC,UAAU,EAAE;AAClI,QAAA,OAAO,QAAQ;IAChB;IAEA,OAAOC,gCAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAA2B,EAAE,QAAQ,EAAE;;AAE/E,QAAA,uBAAuB,EAAE,IAAI;AAC7B,QAAA,QAAQ,EAAE,YAAY;AACtB,KAAA,CAAC;AACH;;;;"}

package/dist/cjs/utility/dto/build-decorator.utility.js

@@ -3,8 +3,12 @@
 require('../../enum/decorator/api/action.enum.js');
 require('../../enum/decorator/api/authentication-type.enum.js');
 require('../../enum/decorator/api/controller/load-relations-strategy.enum.js');
-require('../../enum/decorator/api/controller/request-transformer-type.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');
 var dtoType_enum = require('../../enum/decorator/api/dto-type.enum.js');
+require('../../enum/decorator/api/function-transaction-mode.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');

package/dist/cjs/utility/dto/build-decorator.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"build-decorator.utility.js","sources":["../../../../../src/utility/dto/build-decorator.utility.ts"],"sourcesContent":[null],"names":["DtoIsPropertyExposedForGuard","EApiPropertyDescribeType","EApiRouteType","EApiDtoType","DtoHandleDateProperty","DtoGetDecoratorConfig","DtoGenerateDecorator"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAaA;;;;;;;;;;;;;;AAcG;AACH;AACM,SAAU,iBAAiB,CAAoD,MAAS,EAAE,gBAAgD,EAAE,MAAqB,EAAE,OAAU,EAAE,YAAoB,EAAE,YAA+B,EAAE,aAA6C,EAAA;IAKxR,MAAM,UAAU,GAA2C,gBAAgB,CAAC,UAAU,GAAG,MAAM,CAA2C;AAE1I,IAAA,IAAI,UAAU,GAAG,OAAO,CAAC,EAAE,SAAS,KAAK,KAAK,KAAK,UAAU,GAAG,OAAO,CAAC,EAAE,UAAU,IAAI,UAAU,GAAG,OAAO,CAAC,EAAE,QAAQ,KAAK,KAAK,CAAC,EAAE;AACnI,QAAA,OAAO,SAAS;IACjB;AAEA,IAAA,IAAI,CAACA,oDAA4B,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE;AACnF,QAAA,OAAO,SAAS;IACjB;IAEA,IAAI,gBAAgB,CAAC,IAAI,KAAKC,yCAAwB,CAAC,IAAI,EAAE;QAC5D,MAAM,YAAY,GAAuC,gBAAgB;QAEzE,IAAI,CAAC,MAAM,KAAKC,4BAAa,CAAC,MAAM,IAAI,MAAM,KAAKA,4BAAa,CAAC,cAAc,KAAK,OAAO,KAAKC,wBAAW,CAAC,IAAI,EAAE;AACjH,YAAA,OAAO,SAAS;QACjB;AAEA,QAAA,IAAI,MAAM,KAAKD,4BAAa,CAAC,QAAQ,IAAI,OAAO,KAAKC,wBAAW,CAAC,KAAK,EAAE;YACvE,MAAM,cAAc,GAAoEC,gDAAqB,CAAC,YAAY,EAAE,YAAY,CAAC,UAAU,CAAC;AAEpJ,YAAA,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,QAAkE,KAAI;AAChG,gBAAA,MAAM,WAAW,GAAmC,EAAE,GAAG,YAAY,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE;AACxG,gBAAA,MAAM,MAAM,GAAsCC,6CAAqB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC;AAEpH,gBAAA,OAAOC,sCAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC;AACxF,YAAA,CAAC,CAAC;QACH;IACD;AAEA,IAAA,MAAM,MAAM,GAAsCD,6CAAqB,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAqB,CAAC;IAExH,MAAM,UAAU,GAA6B,EAAE;IAE/C,UAAU,CAAC,IAAI,CAACC,sCAAoB,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;AAErH,IAAA,OAAO,UAAU;AAClB;;;;"}
+{"version":3,"file":"build-decorator.utility.js","sources":["../../../../../src/utility/dto/build-decorator.utility.ts"],"sourcesContent":[null],"names":["DtoIsPropertyExposedForGuard","EApiPropertyDescribeType","EApiRouteType","EApiDtoType","DtoHandleDateProperty","DtoGetDecoratorConfig","DtoGenerateDecorator"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAaA;;;;;;;;;;;;;;AAcG;AACH;AACM,SAAU,iBAAiB,CAAoD,MAAS,EAAE,gBAAgD,EAAE,MAAqB,EAAE,OAAU,EAAE,YAAoB,EAAE,YAA+B,EAAE,aAA6C,EAAA;IAKxR,MAAM,UAAU,GAA2C,gBAAgB,CAAC,UAAU,GAAG,MAAM,CAA2C;AAE1I,IAAA,IAAI,UAAU,GAAG,OAAO,CAAC,EAAE,SAAS,KAAK,KAAK,KAAK,UAAU,GAAG,OAAO,CAAC,EAAE,UAAU,IAAI,UAAU,GAAG,OAAO,CAAC,EAAE,QAAQ,KAAK,KAAK,CAAC,EAAE;AACnI,QAAA,OAAO,SAAS;IACjB;AAEA,IAAA,IAAI,CAACA,oDAA4B,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE;AACnF,QAAA,OAAO,SAAS;IACjB;IAEA,IAAI,gBAAgB,CAAC,IAAI,KAAKC,yCAAwB,CAAC,IAAI,EAAE;QAC5D,MAAM,YAAY,GAAuC,gBAAgB;QAEzE,IAAI,CAAC,MAAM,KAAKC,4BAAa,CAAC,MAAM,IAAI,MAAM,KAAKA,4BAAa,CAAC,cAAc,KAAK,OAAO,KAAKC,wBAAW,CAAC,IAAI,EAAE;AACjH,YAAA,OAAO,SAAS;QACjB;AAEA,QAAA,IAAI,MAAM,KAAKD,4BAAa,CAAC,QAAQ,IAAI,OAAO,KAAKC,wBAAW,CAAC,KAAK,EAAE;YACvE,MAAM,cAAc,GAAoEC,gDAAqB,CAAC,YAAY,EAAE,YAAY,CAAC,UAAU,CAAC;AAEpJ,YAAA,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,QAAkE,KAAI;AAChG,gBAAA,MAAM,WAAW,GAAmC,EAAE,GAAG,YAAY,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE;AACxG,gBAAA,MAAM,MAAM,GAAsCC,6CAAqB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC;AAEpH,gBAAA,OAAOC,sCAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC;AACxF,YAAA,CAAC,CAAC;QACH;IACD;AAEA,IAAA,MAAM,MAAM,GAAsCD,6CAAqB,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAqB,CAAC;IAExH,MAAM,UAAU,GAA6B,EAAE;IAE/C,UAAU,CAAC,IAAI,CAACC,sCAAoB,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;AAErH,IAAA,OAAO,UAAU;AAClB;;;;"}

package/dist/cjs/utility/dto/generate/core.utility.js

@@ -6,8 +6,12 @@ var generate_constant = require('../../../constant/utility/dto/generate.constant
 require('../../../enum/decorator/api/action.enum.js');
 require('../../../enum/decorator/api/authentication-type.enum.js');
 require('../../../enum/decorator/api/controller/load-relations-strategy.enum.js');
-require('../../../enum/decorator/api/controller/request-transformer-type.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');
 var dtoType_enum = require('../../../enum/decorator/api/dto-type.enum.js');
+require('../../../enum/decorator/api/function-transaction-mode.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');