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

package/dist/cjs/type/class/api/subscriber/route/before/get/context.type.d.ts

@@ -1,7 +1,7 @@
 import type { IApiBaseEntity } from '../../../../../../../interface/api-base-entity.interface';
 import type { IApiAuthenticationRequest } from '../../../../../../../interface/api/authentication-request.interface';
-import type { IApiSubscriberRouteExecutionContextData } from '../../../../../../../interface/class/api/subscriber/route/execution/context-data.interface';
-import type { IApiSubscriberRouteExecutionContext } from '../../../../../../../interface/class/api/subscriber/route/execution/context.interface';
+import type { IApiSubscriberRouteExecutionContextData } from '../../../../../../../interface/class/api/subscriber/route/execution/context/index';
+import type { IApiSubscriberRouteExecutionContext } from '../../../../../../../interface/class/api/subscriber/route/execution/context/index';
 export type TApiSubscriberRouteBeforeGetContext<E extends IApiBaseEntity> = IApiSubscriberRouteExecutionContext<E, {
     authenticationRequest?: IApiAuthenticationRequest;
     headers: Record<string, string>;

package/dist/cjs/type/class/api/subscriber/route/before/get/list-context.type.d.ts

@@ -1,7 +1,7 @@
 import type { IApiBaseEntity } from '../../../../../../../interface/api-base-entity.interface';
 import type { IApiAuthenticationRequest } from '../../../../../../../interface/api/authentication-request.interface';
-import type { IApiSubscriberRouteExecutionContextData } from '../../../../../../../interface/class/api/subscriber/route/execution/context-data.interface';
-import type { IApiSubscriberRouteExecutionContext } from '../../../../../../../interface/class/api/subscriber/route/execution/context.interface';
+import type { IApiSubscriberRouteExecutionContextData } from '../../../../../../../interface/class/api/subscriber/route/execution/context/index';
+import type { IApiSubscriberRouteExecutionContext } from '../../../../../../../interface/class/api/subscriber/route/execution/context/index';
 import type { IApiGetListResponseResult } from '../../../../../../../interface/decorator/api/index';
 import type { TApiControllerGetListQuery } from '../../../../../../decorator/api/controller/index';
 export type TApiSubscriberRouteBeforeGetListContext<E extends IApiBaseEntity> = IApiSubscriberRouteExecutionContext<E, {

package/dist/cjs/type/class/api/subscriber/route/before/partial-update-context.type.d.ts

@@ -1,7 +1,7 @@
 import type { IApiBaseEntity } from '../../../../../../interface/api-base-entity.interface';
 import type { IApiAuthenticationRequest } from '../../../../../../interface/api/authentication-request.interface';
-import type { IApiSubscriberRouteExecutionContextData } from '../../../../../../interface/class/api/subscriber/route/execution/context-data.interface';
-import type { IApiSubscriberRouteExecutionContext } from '../../../../../../interface/class/api/subscriber/route/execution/context.interface';
+import type { IApiSubscriberRouteExecutionContextData } from '../../../../../../interface/class/api/subscriber/route/execution/context/index';
+import type { IApiSubscriberRouteExecutionContext } from '../../../../../../interface/class/api/subscriber/route/execution/context/index';
 import type { DeepPartial } from "typeorm";
 export type TApiSubscriberRouteBeforePartialUpdateContext<E extends IApiBaseEntity> = IApiSubscriberRouteExecutionContext<E, {
     authenticationRequest?: IApiAuthenticationRequest;

package/dist/cjs/type/class/api/subscriber/route/before/update-context.type.d.ts

@@ -1,7 +1,7 @@
 import type { IApiBaseEntity } from '../../../../../../interface/api-base-entity.interface';
 import type { IApiAuthenticationRequest } from '../../../../../../interface/api/authentication-request.interface';
-import type { IApiSubscriberRouteExecutionContextData } from '../../../../../../interface/class/api/subscriber/route/execution/context-data.interface';
-import type { IApiSubscriberRouteExecutionContext } from '../../../../../../interface/class/api/subscriber/route/execution/context.interface';
+import type { IApiSubscriberRouteExecutionContextData } from '../../../../../../interface/class/api/subscriber/route/execution/context/index';
+import type { IApiSubscriberRouteExecutionContext } from '../../../../../../interface/class/api/subscriber/route/execution/context/index';
 import type { DeepPartial } from "typeorm";
 export type TApiSubscriberRouteBeforeUpdateContext<E extends IApiBaseEntity> = IApiSubscriberRouteExecutionContext<E, {
     authenticationRequest?: IApiAuthenticationRequest;

package/dist/cjs/type/decorator/api/controller/properties/route/base/request/allowed-target.type.d.ts

@@ -0,0 +1,9 @@
+import type { EApiControllerRequestTarget, EApiRouteType } from '../../../../../../../../enum/decorator/api/index';
+export type TApiControllerAllowedRequestTarget<R extends EApiRouteType> = {
+    [EApiRouteType.CREATE]: EApiControllerRequestTarget.BODY;
+    [EApiRouteType.DELETE]: EApiControllerRequestTarget.PARAMETERS;
+    [EApiRouteType.GET_LIST]: EApiControllerRequestTarget.QUERY;
+    [EApiRouteType.GET]: EApiControllerRequestTarget.PARAMETERS;
+    [EApiRouteType.PARTIAL_UPDATE]: EApiControllerRequestTarget.BODY | EApiControllerRequestTarget.PARAMETERS;
+    [EApiRouteType.UPDATE]: EApiControllerRequestTarget.BODY | EApiControllerRequestTarget.PARAMETERS;
+}[R];

package/dist/cjs/type/decorator/api/controller/properties/route/base/request/index.d.ts

@@ -1,2 +1,2 @@
-export { type TApiControllerPropertiesRouteBaseRequestRelations } from './relations.type';
+export { type TApiControllerAllowedRequestTarget } from './allowed-target.type';
 export { type TApiControllerPropertiesRouteBaseRequestTransformers } from './transformers.type';

package/dist/cjs/type/decorator/api/controller/properties/route/base/request/transformers.type.d.ts

@@ -1,10 +1,10 @@
-import type { EApiDtoType, EApiRouteType } from '../../../../../../../../enum/decorator/api/index';
+import type { EApiControllerRequestTarget, EApiRouteType } from '../../../../../../../../enum/decorator/api/index';
 import type { TApiControllerTransformerConfig } from '../../../../index';
 export type TApiControllerPropertiesRouteBaseRequestTransformers<E, R extends EApiRouteType> = R extends EApiRouteType ? {
-    [EApiRouteType.CREATE]: Pick<TApiControllerTransformerConfig<E>, EApiDtoType.BODY>;
-    [EApiRouteType.DELETE]: Pick<TApiControllerTransformerConfig<E>, EApiDtoType.REQUEST>;
-    [EApiRouteType.GET_LIST]: Pick<TApiControllerTransformerConfig<E>, EApiDtoType.QUERY>;
-    [EApiRouteType.GET]: Pick<TApiControllerTransformerConfig<E>, EApiDtoType.REQUEST>;
-    [EApiRouteType.PARTIAL_UPDATE]: Pick<TApiControllerTransformerConfig<E>, EApiDtoType.BODY | EApiDtoType.REQUEST>;
-    [EApiRouteType.UPDATE]: Pick<TApiControllerTransformerConfig<E>, EApiDtoType.BODY | EApiDtoType.REQUEST>;
+    [EApiRouteType.CREATE]: Pick<TApiControllerTransformerConfig<E>, EApiControllerRequestTarget.BODY>;
+    [EApiRouteType.DELETE]: Pick<TApiControllerTransformerConfig<E>, EApiControllerRequestTarget.PARAMETERS>;
+    [EApiRouteType.GET_LIST]: Pick<TApiControllerTransformerConfig<E>, EApiControllerRequestTarget.QUERY>;
+    [EApiRouteType.GET]: Pick<TApiControllerTransformerConfig<E>, EApiControllerRequestTarget.PARAMETERS>;
+    [EApiRouteType.PARTIAL_UPDATE]: Pick<TApiControllerTransformerConfig<E>, EApiControllerRequestTarget.BODY | EApiControllerRequestTarget.PARAMETERS>;
+    [EApiRouteType.UPDATE]: Pick<TApiControllerTransformerConfig<E>, EApiControllerRequestTarget.BODY | EApiControllerRequestTarget.PARAMETERS>;
 }[R] : never;

package/dist/cjs/type/decorator/api/controller/properties/route/base/response-transformers.type.d.ts

@@ -1,10 +1,10 @@
-import type { EApiDtoType, EApiRouteType } from '../../../../../../../enum/decorator/api/index';
+import type { EApiControllerResponseTarget, EApiRouteType } from '../../../../../../../enum/decorator/api/index';
 import type { TApiControllerTransformerConfig } from '../../../index';
 export type TApiControllerPropertiesRouteBaseResponseTransformers<E, R extends EApiRouteType> = R extends EApiRouteType ? {
-    [EApiRouteType.CREATE]: Pick<TApiControllerTransformerConfig<E>, EApiDtoType.RESPONSE>;
+    [EApiRouteType.CREATE]: Pick<TApiControllerTransformerConfig<E>, EApiControllerResponseTarget.RESPONSE>;
     [EApiRouteType.DELETE]: never;
-    [EApiRouteType.GET_LIST]: Pick<TApiControllerTransformerConfig<E>, EApiDtoType.RESPONSE>;
-    [EApiRouteType.GET]: Pick<TApiControllerTransformerConfig<E>, EApiDtoType.RESPONSE>;
-    [EApiRouteType.PARTIAL_UPDATE]: Pick<TApiControllerTransformerConfig<E>, EApiDtoType.RESPONSE>;
-    [EApiRouteType.UPDATE]: Pick<TApiControllerTransformerConfig<E>, EApiDtoType.RESPONSE>;
+    [EApiRouteType.GET_LIST]: Pick<TApiControllerTransformerConfig<E>, EApiControllerResponseTarget.RESPONSE>;
+    [EApiRouteType.GET]: Pick<TApiControllerTransformerConfig<E>, EApiControllerResponseTarget.RESPONSE>;
+    [EApiRouteType.PARTIAL_UPDATE]: Pick<TApiControllerTransformerConfig<E>, EApiControllerResponseTarget.RESPONSE>;
+    [EApiRouteType.UPDATE]: Pick<TApiControllerTransformerConfig<E>, EApiControllerResponseTarget.RESPONSE>;
 }[R] : never;

package/dist/cjs/type/decorator/api/controller/transformer-config.type.d.ts

@@ -1,8 +1,8 @@
-import type { EApiDtoType } from '../../../../enum/decorator/api/index';
+import type { EApiControllerRequestTarget, EApiControllerResponseTarget } from '../../../../enum/decorator/api/index';
 import type { TApiRequestTransformer } from '../../../api-request-transformer.type';
 export type TApiControllerTransformerConfig<E> = {
-    [EApiDtoType.BODY]?: Array<TApiRequestTransformer<E>>;
-    [EApiDtoType.QUERY]?: Array<TApiRequestTransformer<E>>;
-    [EApiDtoType.REQUEST]?: Array<TApiRequestTransformer<E>>;
-    [EApiDtoType.RESPONSE]?: Array<TApiRequestTransformer<E>>;
+    [EApiControllerRequestTarget.BODY]?: Array<TApiRequestTransformer<E>>;
+    [EApiControllerRequestTarget.PARAMETERS]?: Array<TApiRequestTransformer<E>>;
+    [EApiControllerRequestTarget.QUERY]?: Array<TApiRequestTransformer<E>>;
+    [EApiControllerResponseTarget.RESPONSE]?: Array<TApiRequestTransformer<E>>;
 };

package/dist/cjs/type/decorator/api/function/properties.type.d.ts

@@ -1,7 +1,9 @@
-import type { EApiFunctionType } from '../../../../enum/decorator/api/index';
-import type { FindOptionsRelations } from "typeorm";
+import type { EApiFunctionTransactionMode, EApiFunctionType } from '../../../../enum/decorator/api/index';
 export type TApiFunctionProperties<E> = {
+    action?: string;
     entity: new () => E;
-    relations?: FindOptionsRelations<E>;
+    transaction?: {
+        mode: EApiFunctionTransactionMode;
+    };
     type: EApiFunctionType;
 };

package/dist/cjs/type/decorator/api/property/describe/dto/request-properties.type.d.ts

@@ -1,5 +1,5 @@
 import type { EApiDtoType } from '../../../../../../enum/decorator/api/index';
 import type { TApiPropertyDescribeDtoProperties } from '../../index';
 export type TApiPropertyDescribeDtoRequestProperties = {
-    [EApiDtoType.REQUEST]?: TApiPropertyDescribeDtoProperties;
+    [EApiDtoType.PARAMETERS]?: TApiPropertyDescribeDtoProperties;
 };

package/dist/cjs/type/decorator/api/property/describe/properties/base/properties.type.d.ts

@@ -2,9 +2,9 @@ import type { EApiDtoType, EApiRouteType } from '../../../../../../../enum/decor
 import type { TApiPropertyDescribePropertiesBaseDtoProperties } from '../../../index';
 export type TApiPropertyDescribePropertiesBaseProperties = {
     [EApiRouteType.CREATE]?: Pick<TApiPropertyDescribePropertiesBaseDtoProperties, EApiDtoType.BODY | EApiDtoType.RESPONSE>;
-    [EApiRouteType.DELETE]?: Pick<TApiPropertyDescribePropertiesBaseDtoProperties, EApiDtoType.REQUEST>;
+    [EApiRouteType.DELETE]?: Pick<TApiPropertyDescribePropertiesBaseDtoProperties, EApiDtoType.PARAMETERS>;
     [EApiRouteType.GET_LIST]?: Pick<TApiPropertyDescribePropertiesBaseDtoProperties, EApiDtoType.QUERY | EApiDtoType.RESPONSE>;
-    [EApiRouteType.GET]?: Pick<TApiPropertyDescribePropertiesBaseDtoProperties, EApiDtoType.REQUEST | EApiDtoType.RESPONSE>;
-    [EApiRouteType.PARTIAL_UPDATE]?: Pick<TApiPropertyDescribePropertiesBaseDtoProperties, EApiDtoType.BODY | EApiDtoType.REQUEST | EApiDtoType.RESPONSE>;
-    [EApiRouteType.UPDATE]?: Pick<TApiPropertyDescribePropertiesBaseDtoProperties, EApiDtoType.BODY | EApiDtoType.REQUEST | EApiDtoType.RESPONSE>;
+    [EApiRouteType.GET]?: Pick<TApiPropertyDescribePropertiesBaseDtoProperties, EApiDtoType.PARAMETERS | EApiDtoType.RESPONSE>;
+    [EApiRouteType.PARTIAL_UPDATE]?: Pick<TApiPropertyDescribePropertiesBaseDtoProperties, EApiDtoType.BODY | EApiDtoType.PARAMETERS | EApiDtoType.RESPONSE>;
+    [EApiRouteType.UPDATE]?: Pick<TApiPropertyDescribePropertiesBaseDtoProperties, EApiDtoType.BODY | EApiDtoType.PARAMETERS | EApiDtoType.RESPONSE>;
 };

package/dist/cjs/type/utility/dto/generate/allowed-combination.type.d.ts

@@ -1,9 +1,9 @@
 import type { EApiDtoType, EApiRouteType } from '../../../../enum/decorator/api/index';
 export type TDtoGenerateAllowedCombinations = {
     [EApiRouteType.CREATE]: EApiDtoType.BODY | EApiDtoType.RESPONSE;
-    [EApiRouteType.DELETE]: EApiDtoType.REQUEST;
+    [EApiRouteType.DELETE]: EApiDtoType.PARAMETERS;
     [EApiRouteType.GET_LIST]: EApiDtoType.QUERY | EApiDtoType.RESPONSE;
-    [EApiRouteType.GET]: EApiDtoType.REQUEST | EApiDtoType.RESPONSE;
-    [EApiRouteType.PARTIAL_UPDATE]: EApiDtoType.BODY | EApiDtoType.REQUEST | EApiDtoType.RESPONSE;
-    [EApiRouteType.UPDATE]: EApiDtoType.BODY | EApiDtoType.REQUEST | EApiDtoType.RESPONSE;
+    [EApiRouteType.GET]: EApiDtoType.PARAMETERS | EApiDtoType.RESPONSE;
+    [EApiRouteType.PARTIAL_UPDATE]: EApiDtoType.BODY | EApiDtoType.PARAMETERS | EApiDtoType.RESPONSE;
+    [EApiRouteType.UPDATE]: EApiDtoType.BODY | EApiDtoType.PARAMETERS | EApiDtoType.RESPONSE;
 };

package/dist/cjs/utility/api/controller/apply/decorators.utility.js

@@ -1,13 +1,15 @@
 'use strict';
 
-require('../../../../constant/decorator/api/function.constant.js');
-var method_constant = require('../../../../constant/decorator/api/method.constant.js');
 var method_decorator = require('../../../../decorator/api/method.decorator.js');
 var action_enum = 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');
@@ -37,50 +39,34 @@ var exception_utility = require('../../../error/exception.utility.js');
  */
 function ApiControllerApplyDecorators(targetMethod, entity, properties, method, methodName, routeConfig, decorators) {
     const responseDto = dto_utility.ApiControllerGetDto(properties, entity, method, dtoType_enum.EApiDtoType.RESPONSE, routeConfig);
-    const customDecorators = [...decorators, common.SetMetadata(method_constant.METHOD_API_DECORATOR_CONSTANT.ROUTE_TYPE_METADATA_KEY, method)];
+    const customDecorators = [...decorators];
     switch (method) {
         case routeType_enum.EApiRouteType.CREATE: {
-            customDecorators.push(method_decorator.ApiMethod({ action: action_enum.EApiAction.CREATE, authentication: routeConfig.authentication, authorization: { action: "create" }, entity: properties.entity, httpCode: common.HttpStatus.CREATED, method: common.RequestMethod.POST, path: "", responses: { hasConflict: true, hasInternalServerError: true, hasUnauthorized: true }, responseType: responseDto }));
+            customDecorators.push(method_decorator.ApiMethod({ metadata: createRouteMetadata(properties, routeConfig, method, common.RequestMethod.POST, "", common.HttpStatus.CREATED, responseDto, { hasConflict: true, hasInternalServerError: true, hasUnauthorized: true }, action_enum.EApiAction.CREATE) }));
             break;
         }
         case routeType_enum.EApiRouteType.DELETE: {
-            customDecorators.push(method_decorator.ApiMethod({ action: action_enum.EApiAction.DELETE, authentication: routeConfig.authentication, authorization: { action: "delete" }, entity: properties.entity, httpCode: common.HttpStatus.NO_CONTENT, method: common.RequestMethod.DELETE, path: `:${String(entity.primaryKey?.name)}`, responses: { hasInternalServerError: true, hasNotFound: true, hasUnauthorized: true }, responseType: undefined }));
+            customDecorators.push(method_decorator.ApiMethod({ metadata: createRouteMetadata(properties, routeConfig, method, common.RequestMethod.DELETE, `:${String(entity.primaryKey?.name)}`, common.HttpStatus.NO_CONTENT, undefined, { hasInternalServerError: true, hasNotFound: true, hasUnauthorized: true }, action_enum.EApiAction.DELETE) }));
             break;
         }
         case routeType_enum.EApiRouteType.GET: {
             customDecorators.push(method_decorator.ApiMethod({
-                action: action_enum.EApiAction.FETCH,
-                authentication: routeConfig.authentication,
-                authorization: { action: "get" },
-                entity: properties.entity,
-                httpCode: common.HttpStatus.OK,
-                method: common.RequestMethod.GET,
-                path: `:${String(entity.primaryKey?.name)}`,
-                responses: { hasInternalServerError: true, hasNotFound: true, hasUnauthorized: true },
-                responseType: responseDto,
+                metadata: createRouteMetadata(properties, routeConfig, method, common.RequestMethod.GET, `:${String(entity.primaryKey?.name)}`, common.HttpStatus.OK, responseDto, { hasInternalServerError: true, hasNotFound: true, hasUnauthorized: true }, action_enum.EApiAction.FETCH),
             }));
             break;
         }
         case routeType_enum.EApiRouteType.GET_LIST: {
             customDecorators.push(method_decorator.ApiMethod({
-                action: action_enum.EApiAction.FETCH_LIST,
-                authentication: routeConfig.authentication,
-                authorization: { action: "getList" },
-                entity: properties.entity,
-                httpCode: common.HttpStatus.OK,
-                method: common.RequestMethod.GET,
-                path: "",
-                responses: { hasInternalServerError: true, hasNotFound: true, hasUnauthorized: true },
-                responseType: responseDto,
+                metadata: createRouteMetadata(properties, routeConfig, method, common.RequestMethod.GET, "", common.HttpStatus.OK, responseDto, { hasInternalServerError: true, hasNotFound: true, hasUnauthorized: true }, action_enum.EApiAction.FETCH_LIST),
             }));
             break;
         }
         case routeType_enum.EApiRouteType.PARTIAL_UPDATE: {
-            customDecorators.push(method_decorator.ApiMethod({ action: action_enum.EApiAction.UPDATE, authentication: routeConfig.authentication, authorization: { action: "partialUpdate" }, entity: properties.entity, httpCode: common.HttpStatus.OK, method: common.RequestMethod.PATCH, path: `:${String(entity.primaryKey?.name)}`, responses: { hasBadRequest: true, hasConflict: true, hasInternalServerError: true, hasNotFound: true, hasUnauthorized: true }, responseType: responseDto }));
+            customDecorators.push(method_decorator.ApiMethod({ metadata: createRouteMetadata(properties, routeConfig, method, common.RequestMethod.PATCH, `:${String(entity.primaryKey?.name)}`, common.HttpStatus.OK, responseDto, { hasBadRequest: true, hasConflict: true, hasInternalServerError: true, hasNotFound: true, hasUnauthorized: true }, action_enum.EApiAction.UPDATE) }));
             break;
         }
         case routeType_enum.EApiRouteType.UPDATE: {
-            customDecorators.push(method_decorator.ApiMethod({ action: action_enum.EApiAction.UPDATE, authentication: routeConfig.authentication, authorization: { action: "update" }, entity: properties.entity, httpCode: common.HttpStatus.OK, method: common.RequestMethod.PUT, path: `:${String(entity.primaryKey?.name)}`, responses: { hasBadRequest: true, hasConflict: true, hasInternalServerError: true, hasNotFound: true, hasUnauthorized: true }, responseType: responseDto }));
+            customDecorators.push(method_decorator.ApiMethod({ metadata: createRouteMetadata(properties, routeConfig, method, common.RequestMethod.PUT, `:${String(entity.primaryKey?.name)}`, common.HttpStatus.OK, responseDto, { hasBadRequest: true, hasConflict: true, hasInternalServerError: true, hasNotFound: true, hasUnauthorized: true }, action_enum.EApiAction.UPDATE) }));
             break;
         }
         default: {
@@ -94,6 +80,52 @@ function ApiControllerApplyDecorators(targetMethod, entity, properties, method,
         }
     }
 }
+/**
+ * Creates unified route metadata for a generated controller route.
+ * @template E - Entity type owned by the controller.
+ * @param {IApiControllerProperties<E>} properties - Controller configuration that owns the generated route.
+ * @param {TApiControllerPropertiesRoute<E, EApiRouteType>} routeConfig - Route-specific configuration.
+ * @param {EApiRouteType} routeType - CRUD route type being generated.
+ * @param {RequestMethod} requestMethod - Nest request method for the route.
+ * @param {string} path - Route path segment.
+ * @param {HttpStatus} status - Successful HTTP status code.
+ * @param {Type<unknown> | undefined} responseType - Swagger and serialization response DTO type.
+ * @param {NonNullable<IApiRouteMetadata<E>["response"]>["errors"]} errors - Standard error response flags.
+ * @param {EApiAction} documentationAction - Action label used for generated documentation.
+ * @returns {IApiRouteMetadata<E>} Route metadata consumed by ApiMethod and the route runtime.
+ */
+function createRouteMetadata(properties, routeConfig, routeType, requestMethod, path, status, responseType, errors, documentationAction) {
+    return {
+        documentation: {
+            summary: documentationAction,
+        },
+        resource: {
+            action: routeType,
+            entity: properties.entity,
+        },
+        response: {
+            errors,
+            serialization: routeConfig.response?.serialization ?? {
+                isEnabled: responseType !== undefined && status !== common.HttpStatus.NO_CONTENT,
+            },
+            status,
+            type: responseType,
+        },
+        route: {
+            method: requestMethod,
+            path,
+            type: routeType,
+        },
+        security: {
+            authentication: routeConfig.security?.authentication,
+            authorization: properties.authorization
+                ? {
+                    mode: routeConfig.security?.authorization?.mode ?? properties.authorization.defaultMode,
+                }
+                : undefined,
+        },
+    };
+}
 
 exports.ApiControllerApplyDecorators = ApiControllerApplyDecorators;
 //# sourceMappingURL=decorators.utility.js.map

package/dist/cjs/utility/api/controller/apply/decorators.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.utility.js","sources":["../../../../../../../src/utility/api/controller/apply/decorators.utility.ts"],"sourcesContent":[null],"names":["ApiControllerGetDto","EApiDtoType","SetMetadata","METHOD_API_DECORATOR_CONSTANT","EApiRouteType","ApiMethod","EApiAction","HttpStatus","RequestMethod","ErrorException"],"mappings":"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"}
+{"version":3,"file":"decorators.utility.js","sources":["../../../../../../../src/utility/api/controller/apply/decorators.utility.ts"],"sourcesContent":[null],"names":["ApiControllerGetDto","EApiDtoType","EApiRouteType","ApiMethod","RequestMethod","HttpStatus","EApiAction","ErrorException"],"mappings":"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"}

package/dist/cjs/utility/api/controller/apply/metadata.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');
@@ -36,7 +40,7 @@ function ApiControllerApplyMetadata(target, targetPrototype, entity, properties,
     let parameterIndex = 0;
     let routeArgumentsMetadata = {};
     const parameterTypes = [];
-    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);
     if (requestDto) {

package/dist/cjs/utility/api/controller/apply/metadata.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.utility.js","sources":["../../../../../../../src/utility/api/controller/apply/metadata.utility.ts"],"sourcesContent":[null],"names":["ApiControllerGetDto","EApiDtoType","assignMetadata","RouteParamtypes","ROUTE_ARGS_METADATA","PARAMTYPES_METADATA"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAaA;;;;;;;;;;;;AAYG;AACG,SAAU,0BAA0B,CAA2B,MAAc,EAAE,eAAuB,EAAE,MAAqB,EAAE,UAAuC,EAAE,MAAqB,EAAE,UAAkB,EAAE,WAA4D,EAAA;IACpR,IAAI,cAAc,GAAW,CAAC;IAC9B,IAAI,sBAAsB,GAAY,EAAE;IACxC,MAAM,cAAc,GAAmB,EAAE;AAEzC,IAAA,MAAM,UAAU,GAA8BA,+BAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAEC,wBAAW,CAAC,OAAO,EAAE,WAAW,CAAC;AAC/H,IAAA,MAAM,QAAQ,GAA8BD,+BAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAEC,wBAAW,CAAC,KAAK,EAAE,WAAW,CAAC;AAC3H,IAAA,MAAM,OAAO,GAA8BD,+BAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAEC,wBAAW,CAAC,IAAI,EAAE,WAAW,CAAC;IAEzH,IAAI,UAAU,EAAE;QACf,sBAAsB,GAAGC,qBAAc,CAAC,sBAAsB,EAAEC,oCAAe,CAAC,KAAK,EAAE,cAAc,CAAC;AACtG,QAAA,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC;AAC/B,QAAA,cAAc,EAAE;IACjB;IAEA,IAAI,QAAQ,EAAE;QACb,sBAAsB,GAAGD,qBAAc,CAAC,sBAAsB,EAAEC,oCAAe,CAAC,KAAK,EAAE,cAAc,CAAC;AACtG,QAAA,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC;AAC7B,QAAA,cAAc,EAAE;IACjB;IAEA,IAAI,OAAO,EAAE;QACZ,sBAAsB,GAAGD,qBAAc,CAAC,sBAAsB,EAAEC,oCAAe,CAAC,IAAI,EAAE,cAAc,CAAC;AACrG,QAAA,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;AAC5B,QAAA,cAAc,EAAE;IACjB;IAEA,sBAAsB,GAAGD,qBAAc,CAAC,sBAAsB,EAAEC,oCAAe,CAAC,OAAO,EAAE,cAAc,CAAC;AACxG,IAAA,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;AAC3B,IAAA,cAAc,EAAE;IAEhB,sBAAsB,GAAGD,qBAAc,CAAC,sBAAsB,EAAEC,oCAAe,CAAC,EAAE,EAAE,cAAc,CAAC;AACnG,IAAA,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;AAC3B,IAAA,cAAc,EAAE;IAEhB,sBAAsB,GAAGD,qBAAc,CAAC,sBAAsB,EAAEC,oCAAe,CAAC,OAAO,EAAE,cAAc,CAAC;AACxG,IAAA,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;AAC3B,IAAA,cAAc,EAAE;IAEhB,OAAO,CAAC,cAAc,CAACC,6BAAmB,EAAE,sBAAsB,EAAE,MAAM,EAAE,UAAU,CAAC;IACvF,OAAO,CAAC,cAAc,CAACC,6BAAmB,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,CAAC;AACzF;;;;"}
+{"version":3,"file":"metadata.utility.js","sources":["../../../../../../../src/utility/api/controller/apply/metadata.utility.ts"],"sourcesContent":[null],"names":["ApiControllerGetDto","EApiDtoType","assignMetadata","RouteParamtypes","ROUTE_ARGS_METADATA","PARAMTYPES_METADATA"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAaA;;;;;;;;;;;;AAYG;AACG,SAAU,0BAA0B,CAA2B,MAAc,EAAE,eAAuB,EAAE,MAAqB,EAAE,UAAuC,EAAE,MAAqB,EAAE,UAAkB,EAAE,WAA4D,EAAA;IACpR,IAAI,cAAc,GAAW,CAAC;IAC9B,IAAI,sBAAsB,GAAY,EAAE;IACxC,MAAM,cAAc,GAAmB,EAAE;AAEzC,IAAA,MAAM,UAAU,GAA8BA,+BAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAEC,wBAAW,CAAC,UAAU,EAAE,WAAW,CAAC;AAClI,IAAA,MAAM,QAAQ,GAA8BD,+BAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAEC,wBAAW,CAAC,KAAK,EAAE,WAAW,CAAC;AAC3H,IAAA,MAAM,OAAO,GAA8BD,+BAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAEC,wBAAW,CAAC,IAAI,EAAE,WAAW,CAAC;IAEzH,IAAI,UAAU,EAAE;QACf,sBAAsB,GAAGC,qBAAc,CAAC,sBAAsB,EAAEC,oCAAe,CAAC,KAAK,EAAE,cAAc,CAAC;AACtG,QAAA,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC;AAC/B,QAAA,cAAc,EAAE;IACjB;IAEA,IAAI,QAAQ,EAAE;QACb,sBAAsB,GAAGD,qBAAc,CAAC,sBAAsB,EAAEC,oCAAe,CAAC,KAAK,EAAE,cAAc,CAAC;AACtG,QAAA,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC;AAC7B,QAAA,cAAc,EAAE;IACjB;IAEA,IAAI,OAAO,EAAE;QACZ,sBAAsB,GAAGD,qBAAc,CAAC,sBAAsB,EAAEC,oCAAe,CAAC,IAAI,EAAE,cAAc,CAAC;AACrG,QAAA,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;AAC5B,QAAA,cAAc,EAAE;IACjB;IAEA,sBAAsB,GAAGD,qBAAc,CAAC,sBAAsB,EAAEC,oCAAe,CAAC,OAAO,EAAE,cAAc,CAAC;AACxG,IAAA,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;AAC3B,IAAA,cAAc,EAAE;IAEhB,sBAAsB,GAAGD,qBAAc,CAAC,sBAAsB,EAAEC,oCAAe,CAAC,EAAE,EAAE,cAAc,CAAC;AACnG,IAAA,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;AAC3B,IAAA,cAAc,EAAE;IAEhB,sBAAsB,GAAGD,qBAAc,CAAC,sBAAsB,EAAEC,oCAAe,CAAC,OAAO,EAAE,cAAc,CAAC;AACxG,IAAA,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;AAC3B,IAAA,cAAc,EAAE;IAEhB,OAAO,CAAC,cAAc,CAACC,6BAAmB,EAAE,sBAAsB,EAAE,MAAM,EAAE,UAAU,CAAC;IACvF,OAAO,CAAC,cAAc,CAACC,6BAAmB,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,CAAC;AACzF;;;;"}

package/dist/cjs/utility/api/controller/get/dto.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');
@@ -60,7 +64,7 @@ function ApiControllerGetDto(properties, entity, method, dtoType, routeConfig) {
         }
         return configuredDto;
     }
-    return core_utility.DtoGenerate(properties.entity, entity, method, dtoType, routeConfig.autoDto?.[dtoType], routeConfig.authentication?.guard);
+    return core_utility.DtoGenerate(properties.entity, entity, method, dtoType, routeConfig.autoDto?.[dtoType], routeConfig.security?.authentication?.guard);
 }
 /**
  * Builds a stable generated wrapper class name for GET_LIST custom item response DTOs.

package/dist/cjs/utility/api/controller/get/dto.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"dto.utility.js","sources":["../../../../../../../src/utility/api/controller/get/dto.utility.ts"],"sourcesContent":[null],"names":["EApiRouteTypeValue","EApiDtoTypeValue","DtoGenerate","CamelCaseString","DtoGenerateGetListResponse"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAaA,MAAM,2BAA2B,GAA+B,IAAI,GAAG,EAAyB;AAEhG;;;;;;;;;;;AAWG;AACG,SAAU,mBAAmB,CAAoD,UAAuC,EAAE,MAAqB,EAAE,MAAS,EAAE,OAAoB,EAAE,WAAgD,EAAA;IACvO,MAAM,aAAa,GAAsF,WAAW,CAAC,GAAG,GAAG,OAAO,CAAC;IAEnI,IAAI,aAAa,EAAE;AAClB,QAAA,IAAI,MAAM,KAAKA,4BAAkB,CAAC,QAAQ,IAAI,OAAO,KAAKC,wBAAgB,CAAC,QAAQ,IAAI,0BAA0B,CAAC,aAAa,CAAC,EAAE;AACjI,YAAA,OAAO,yBAAyB,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC;QAC5F;AAEA,QAAA,OAAO,aAA8B;IACtC;IAEA,OAAOC,wBAAW,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,OAAO,GAAG,OAAO,CAAC,EAAE,WAAW,CAAC,cAAc,EAAE,KAAK,CAAC;AAClI;AAEA;;;;;;;;AAQG;AACH,SAAS,+BAA+B,CAA2B,MAAqB,EAAE,MAA6D,EAAE,MAAqB,EAAE,OAAoB,EAAA;IACnM,OAAO,MAAM,CAAC,IAAI,IAAI,CAAA,EAAG,MAAM,CAAC,IAAI,IAAI,iBAAiB,CAAA,EAAGC,uCAAe,CAAC,MAAM,CAAC,CAAA,EAAGA,uCAAe,CAAC,OAAO,CAAC,CAAA,EAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAA,CAAE;AACxI;AAEA;;;;;;;;;AASG;AACH,SAAS,yBAAyB,CAA2B,aAA4B,EAAE,MAAqB,EAAE,MAA6D,EAAE,MAAqB,EAAE,OAAoB,EAAA;AAC3N,IAAA,MAAM,IAAI,GAAW,+BAA+B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;AACrF,IAAA,MAAM,QAAQ,GAAW,CAAA,EAAG,MAAM,CAAC,IAAI,IAAI,iBAAiB,CAAA,CAAA,EAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAA,CAAA,EAAI,IAAI,EAAE;IAC9F,MAAM,MAAM,GAA8B,2BAA2B,CAAC,GAAG,CAAC,QAAQ,CAAC;IAEnF,IAAI,MAAM,EAAE;AACX,QAAA,OAAO,MAAM;IACd;;AAGA,IAAA,MAAM,GAAG,GAAkBC,kDAA0B,CAAC,aAAa,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC;AAC3F,IAAA,2BAA2B,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC;AAE9C,IAAA,OAAO,GAAG;AACX;AAEA;;;;AAIG;AACH,SAAS,0BAA0B,CAAC,KAA4E,EAAA;AAC/G,IAAA,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,UAAU,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,UAAU;AAChG;;;;"}
+{"version":3,"file":"dto.utility.js","sources":["../../../../../../../src/utility/api/controller/get/dto.utility.ts"],"sourcesContent":[null],"names":["EApiRouteTypeValue","EApiDtoTypeValue","DtoGenerate","CamelCaseString","DtoGenerateGetListResponse"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAaA,MAAM,2BAA2B,GAA+B,IAAI,GAAG,EAAyB;AAEhG;;;;;;;;;;;AAWG;AACG,SAAU,mBAAmB,CAAoD,UAAuC,EAAE,MAAqB,EAAE,MAAS,EAAE,OAAoB,EAAE,WAAgD,EAAA;IACvO,MAAM,aAAa,GAAsF,WAAW,CAAC,GAAG,GAAG,OAAO,CAAC;IAEnI,IAAI,aAAa,EAAE;AAClB,QAAA,IAAI,MAAM,KAAKA,4BAAkB,CAAC,QAAQ,IAAI,OAAO,KAAKC,wBAAgB,CAAC,QAAQ,IAAI,0BAA0B,CAAC,aAAa,CAAC,EAAE;AACjI,YAAA,OAAO,yBAAyB,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC;QAC5F;AAEA,QAAA,OAAO,aAA8B;IACtC;AAEA,IAAA,OAAOC,wBAAW,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,OAAO,GAAG,OAAO,CAAC,EAAE,WAAW,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,CAAC;AAC5I;AAEA;;;;;;;;AAQG;AACH,SAAS,+BAA+B,CAA2B,MAAqB,EAAE,MAA6D,EAAE,MAAqB,EAAE,OAAoB,EAAA;IACnM,OAAO,MAAM,CAAC,IAAI,IAAI,CAAA,EAAG,MAAM,CAAC,IAAI,IAAI,iBAAiB,CAAA,EAAGC,uCAAe,CAAC,MAAM,CAAC,CAAA,EAAGA,uCAAe,CAAC,OAAO,CAAC,CAAA,EAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAA,CAAE;AACxI;AAEA;;;;;;;;;AASG;AACH,SAAS,yBAAyB,CAA2B,aAA4B,EAAE,MAAqB,EAAE,MAA6D,EAAE,MAAqB,EAAE,OAAoB,EAAA;AAC3N,IAAA,MAAM,IAAI,GAAW,+BAA+B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;AACrF,IAAA,MAAM,QAAQ,GAAW,CAAA,EAAG,MAAM,CAAC,IAAI,IAAI,iBAAiB,CAAA,CAAA,EAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAA,CAAA,EAAI,IAAI,EAAE;IAC9F,MAAM,MAAM,GAA8B,2BAA2B,CAAC,GAAG,CAAC,QAAQ,CAAC;IAEnF,IAAI,MAAM,EAAE;AACX,QAAA,OAAO,MAAM;IACd;;AAGA,IAAA,MAAM,GAAG,GAAkBC,kDAA0B,CAAC,aAAa,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC;AAC3F,IAAA,2BAA2B,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC;AAE9C,IAAA,OAAO,GAAG;AACX;AAEA;;;;AAIG;AACH,SAAS,0BAA0B,CAAC,KAA4E,EAAA;AAC/G,IAAA,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,UAAU,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,UAAU;AAChG;;;;"}

package/dist/cjs/utility/api/controller/get-list/transform/filter.utility.js

@@ -5,8 +5,12 @@ var propertyDescribe_constant = require('../../../../../constant/decorator/api/p
 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');
 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/api/controller/get-list/transform/filter.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"filter.utility.js","sources":["../../../../../../../../src/utility/api/controller/get-list/transform/filter.utility.ts"],"sourcesContent":[null],"names":["PROPERTY_DESCRIBE_DECORATOR_API_CONSTANT","EApiPropertyDescribeType","ApiControllerGetListTransformOperation"],"mappings":";;;;;;;;;;;;;;;;;;;;AASA;;;;;;;;AAQG;AACG,SAAU,mCAAmC,CAAI,KAA8B,EAAE,cAA6B,EAAA;IACnH,MAAM,MAAM,GAAwB,EAAE;IAEtC,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;AACzC,QAAA,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE;AAE5B,QAAA,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,GAAkB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC;AAEtD,QAAA,IAAI,CAAC,KAAK;YAAE;QAEZ,MAAM,UAAU,GAAW,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC;QAEjD,IAAI,UAAU,KAAK,OAAO,IAAI,UAAU,KAAK,QAAQ,EAAE;YACtD,MAAM,SAAS,GAAqB,KAAK,CAAC,CAAA,EAAG,MAAM,CAAC,GAAG,CAAC,CAAA,UAAA,CAAY,CAAqB;AAEzF,YAAA,MAAM,KAAK,GAAY,KAAK,CAAC,OAAO,CAAC;AAErC,YAAA,IAAI,CAAC,SAAS,IAAI,CAAC,GAAG,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;gBAAE;AAEjE,YAAA,MAAM,MAAM,GAAoC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAA2B,KAAK,MAAM,CAAC,IAAI,IAAI,GAAG,CAAC;;AAGhI,YAAA,IAAI,MAAM,EAAE,QAAQ,CAACA,kEAAwC,CAAC,YAAY,CAAC,CAAC,IAAI,KAAKC,yCAAwB,CAAC,QAAQ,EAAE;;AAEvH,gBAAA,MAAM,CAAC,GAAc,CAAC,GAAG,EAAE,EAAE,EAAEC,wDAAsC,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE;YAC1F;iBAAO;;gBAEN,MAAM,CAAC,GAAc,CAAC,GAAGA,wDAAsC,CAAC,SAAS,EAAE,KAAK,CAAC;YAClF;QACD;IACD;AAEA,IAAA,OAAO,MAAM;AACd;;;;"}
+{"version":3,"file":"filter.utility.js","sources":["../../../../../../../../src/utility/api/controller/get-list/transform/filter.utility.ts"],"sourcesContent":[null],"names":["PROPERTY_DESCRIBE_DECORATOR_API_CONSTANT","EApiPropertyDescribeType","ApiControllerGetListTransformOperation"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AASA;;;;;;;;AAQG;AACG,SAAU,mCAAmC,CAAI,KAA8B,EAAE,cAA6B,EAAA;IACnH,MAAM,MAAM,GAAwB,EAAE;IAEtC,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;AACzC,QAAA,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE;AAE5B,QAAA,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,GAAkB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC;AAEtD,QAAA,IAAI,CAAC,KAAK;YAAE;QAEZ,MAAM,UAAU,GAAW,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC;QAEjD,IAAI,UAAU,KAAK,OAAO,IAAI,UAAU,KAAK,QAAQ,EAAE;YACtD,MAAM,SAAS,GAAqB,KAAK,CAAC,CAAA,EAAG,MAAM,CAAC,GAAG,CAAC,CAAA,UAAA,CAAY,CAAqB;AAEzF,YAAA,MAAM,KAAK,GAAY,KAAK,CAAC,OAAO,CAAC;AAErC,YAAA,IAAI,CAAC,SAAS,IAAI,CAAC,GAAG,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;gBAAE;AAEjE,YAAA,MAAM,MAAM,GAAoC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAA2B,KAAK,MAAM,CAAC,IAAI,IAAI,GAAG,CAAC;;AAGhI,YAAA,IAAI,MAAM,EAAE,QAAQ,CAACA,kEAAwC,CAAC,YAAY,CAAC,CAAC,IAAI,KAAKC,yCAAwB,CAAC,QAAQ,EAAE;;AAEvH,gBAAA,MAAM,CAAC,GAAc,CAAC,GAAG,EAAE,EAAE,EAAEC,wDAAsC,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE;YAC1F;iBAAO;;gBAEN,MAAM,CAAC,GAAc,CAAC,GAAGA,wDAAsC,CAAC,SAAS,EAAE,KAAK,CAAC;YAClF;QACD;IACD;AAEA,IAAA,OAAO,MAAM;AACd;;;;"}

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

@@ -1,7 +1,7 @@
 import type { IApiBaseEntity } from '../../../interface/api-base-entity.interface';
-import type { IApiControllerProperties } from '../../../interface/decorator/api/index';
+import type { IApiControllerProperties, IApiControllerPropertiesRouteBaseRelationsRequest } from '../../../interface/decorator/api/index';
 import type { TApiControllerMethod } from '../../../type/class/index';
-import type { TApiControllerGetListQuery, TApiControllerPropertiesRouteBaseRequestRelations } from '../../../type/decorator/api/controller/index';
+import type { TApiControllerGetListQuery } from '../../../type/decorator/api/controller/index';
 import type { DeepPartial } from "typeorm";
 /**
  * Manages loading related entities when processing API requests.
@@ -9,7 +9,7 @@ import type { DeepPartial } from "typeorm";
  * finds the appropriate service for each relation, and loads the related entities.
  * @param {TApiControllerMethod<E>} controllerMethod - The controller method with access to service instances
  * @param {IApiControllerProperties<E>} properties - Controller configuration properties
- * @param {TApiControllerPropertiesRouteBaseRequestRelations<E> | undefined} relationConfig - Configuration for relation loading
+ * @param {IApiControllerPropertiesRouteBaseRelationsRequest<E> | undefined} relationConfig - Configuration for relation loading
  * @param {DeepPartial<E> | Partial<E> | TApiControllerGetListQuery<E>} parameters - The request parameters containing relation IDs
  * @returns {Promise<void>} A promise that resolves when all relations are loaded
  * @throws {BadRequestException} When an invalid relation ID is provided
@@ -17,4 +17,4 @@ import type { DeepPartial } from "typeorm";
  * @template E - The entity type
  * @template R - The route type
  */
-export declare function ApiControllerHandleRequestRelations<E extends IApiBaseEntity>(controllerMethod: TApiControllerMethod<E>, properties: IApiControllerProperties<E>, relationConfig: TApiControllerPropertiesRouteBaseRequestRelations<E> | undefined, parameters: DeepPartial<E> | Partial<E> | TApiControllerGetListQuery<E>): Promise<void>;
+export declare function ApiControllerHandleRequestRelations<E extends IApiBaseEntity>(controllerMethod: TApiControllerMethod<E>, properties: IApiControllerProperties<E>, relationConfig: IApiControllerPropertiesRouteBaseRelationsRequest<E> | undefined, parameters: DeepPartial<E> | Partial<E> | TApiControllerGetListQuery<E>): Promise<void>;

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

@@ -1,14 +1,15 @@
 'use strict';
 
 var serviceBase_class = require('../../../class/api/service-base.class.js');
-require('../../../class/api/subscriber/discovery-service.class.js');
-require('../../../class/api/subscriber/executor.class.js');
-require('../../../class/api/subscriber/registry.class.js');
 require('../../../enum/decorator/api/action.enum.js');
 require('../../../enum/decorator/api/authentication-type.enum.js');
 var loadRelationsStrategy_enum = require('../../../enum/decorator/api/controller/load-relations-strategy.enum.js');
-require('../../../enum/decorator/api/controller/request-transformer-type.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');
@@ -28,7 +29,7 @@ var entityColumns_utility = require('../../get/entity-columns.utility.js');
  * finds the appropriate service for each relation, and loads the related entities.
  * @param {TApiControllerMethod<E>} controllerMethod - The controller method with access to service instances
  * @param {IApiControllerProperties<E>} properties - Controller configuration properties
- * @param {TApiControllerPropertiesRouteBaseRequestRelations<E> | undefined} relationConfig - Configuration for relation loading
+ * @param {IApiControllerPropertiesRouteBaseRelationsRequest<E> | undefined} relationConfig - Configuration for relation loading
  * @param {DeepPartial<E> | Partial<E> | TApiControllerGetListQuery<E>} parameters - The request parameters containing relation IDs
  * @returns {Promise<void>} A promise that resolves when all relations are loaded
  * @throws {BadRequestException} When an invalid relation ID is provided
@@ -37,16 +38,18 @@ var entityColumns_utility = require('../../get/entity-columns.utility.js');
  * @template R - The route type
  */
 async function ApiControllerHandleRequestRelations(controllerMethod, properties, relationConfig, parameters) {
-    if (relationConfig?.shouldLoadRelations) {
+    const loadConfig = relationConfig?.load;
+    const referenceConfig = relationConfig?.reference;
+    if (loadConfig?.shouldLoad && referenceConfig) {
         for (const propertyName of entityColumns_utility.GetEntityColumns({ entity: properties.entity, shouldTakeRelationsOnly: true })) {
             // @ts-expect-error
             if (parameters[propertyName] !== undefined && typeof propertyName === "string") {
-                if (relationConfig.relationsLoadStrategy === loadRelationsStrategy_enum.EApiControllerLoadRelationsStrategy.MANUAL && !relationConfig.relationsToLoad.includes(propertyName)) {
+                if (loadConfig.relationStrategy === loadRelationsStrategy_enum.EApiControllerLoadRelationsStrategy.MANUAL && !loadConfig.relations?.includes(propertyName)) {
                     continue;
                 }
                 let serviceName;
-                if (relationConfig.servicesLoadStrategy === loadRelationsStrategy_enum.EApiControllerLoadRelationsStrategy.MANUAL) {
-                    const manualServiceName = relationConfig.relationsServices[propertyName];
+                if (loadConfig.serviceStrategy === loadRelationsStrategy_enum.EApiControllerLoadRelationsStrategy.MANUAL) {
+                    const manualServiceName = loadConfig.services?.[propertyName];
                     if (manualServiceName === undefined) {
                         throw exception_utility.ErrorException(`Service name not specified for property ${propertyName} in manual mode`);
                     }
@@ -60,7 +63,7 @@ async function ApiControllerHandleRequestRelations(controllerMethod, properties,
                 }
                 const service = controllerMethod[serviceName];
                 if (!service) {
-                    if ((relationConfig.servicesLoadStrategy === loadRelationsStrategy_enum.EApiControllerLoadRelationsStrategy.AUTO && relationConfig.shouldForceAllServicesToBeSpecified) || relationConfig.servicesLoadStrategy === loadRelationsStrategy_enum.EApiControllerLoadRelationsStrategy.MANUAL) {
+                    if ((loadConfig.serviceStrategy === loadRelationsStrategy_enum.EApiControllerLoadRelationsStrategy.AUTO && loadConfig.shouldForceAllServicesToBeSpecified) || loadConfig.serviceStrategy === loadRelationsStrategy_enum.EApiControllerLoadRelationsStrategy.MANUAL) {
                         throw exception_utility.ErrorException(`Service ${serviceName} not found in controller`);
                     }
                     continue;
@@ -68,9 +71,12 @@ async function ApiControllerHandleRequestRelations(controllerMethod, properties,
                 if (!(service instanceof serviceBase_class.ApiServiceBase)) {
                     throw exception_utility.ErrorException(`Service ${serviceName} is not an instance of BaseApiService`);
                 }
+                const referenceKey = referenceConfig.key ?? "id";
+                const relationValue = parameters[propertyName];
+                const referenceValue = resolveRelationReferenceValue(propertyName, relationValue, referenceConfig.shape, referenceKey);
                 const requestProperties = {
                     where: {
-                        id: parameters[propertyName],
+                        [referenceKey]: referenceValue,
                     },
                 };
                 const entity = (await service.get(requestProperties));
@@ -83,6 +89,26 @@ async function ApiControllerHandleRequestRelations(controllerMethod, properties,
         }
     }
 }
+/**
+ * Resolves the relation reference value according to the configured request shape.
+ * @param {string} propertyName - Relation property name used in validation messages.
+ * @param {unknown} value - Incoming scalar or object reference value.
+ * @param {EApiControllerRelationReferenceShape} shape - Expected relation reference shape.
+ * @param {string} referenceKey - Property key to read from object references.
+ * @returns {unknown} Reference value used to load the related entity.
+ */
+function resolveRelationReferenceValue(propertyName, value, shape, referenceKey) {
+    if (shape === relationReferenceShape_enum.EApiControllerRelationReferenceShape.SCALAR) {
+        if (value !== null && typeof value === "object") {
+            throw new common.BadRequestException(`Relation ${propertyName} must be a scalar reference`);
+        }
+        return value;
+    }
+    if (value === null || typeof value !== "object" || !(referenceKey in value)) {
+        throw new common.BadRequestException(`Relation ${propertyName} must be an object reference with "${referenceKey}"`);
+    }
+    return value[referenceKey];
+}
 
 exports.ApiControllerHandleRequestRelations = ApiControllerHandleRequestRelations;
 //# sourceMappingURL=handle-request-relations.utility.js.map

package/dist/cjs/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":["GetEntityColumns","EApiControllerLoadRelationsStrategy","ErrorException","ApiServiceBase","BadRequestException"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAcA;;;;;;;;;;;;;AAaG;AACI,eAAe,mCAAmC,CAA2B,gBAAyC,EAAE,UAAuC,EAAE,cAAgF,EAAE,UAAuE,EAAA;AAChU,IAAA,IAAI,cAAc,EAAE,mBAAmB,EAAE;AACxC,QAAA,KAAK,MAAM,YAAY,IAAIA,sCAAgB,CAAI,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,uBAAuB,EAAE,IAAI,EAAE,CAAC,EAAE;;AAE7G,YAAA,IAAI,UAAU,CAAC,YAAY,CAAC,KAAK,SAAS,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE;AAC/E,gBAAA,IAAI,cAAc,CAAC,qBAAqB,KAAKC,8DAAmC,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE;oBAClJ;gBACD;AAEA,gBAAA,IAAI,WAAiD;gBAErD,IAAI,cAAc,CAAC,oBAAoB,KAAKA,8DAAmC,CAAC,MAAM,EAAE;oBACvF,MAAM,iBAAiB,GAAY,cAAc,CAAC,iBAAiB,CAAC,YAAY,CAAC;AAEjF,oBAAA,IAAI,iBAAiB,KAAK,SAAS,EAAE;AACpC,wBAAA,MAAMC,gCAAc,CAAC,CAAA,wCAAA,EAA2C,YAAY,CAAA,eAAA,CAAiB,CAAC;oBAC/F;oBACA,WAAW,GAAG,iBAA6C;gBAC5D;qBAAO;AACN,oBAAA,WAAW,GAAG,CAAA,EAAG,YAAY,CAAA,OAAA,CAAqC;gBACnE;gBAEA,IAAI,CAAC,WAAW,EAAE;AACjB,oBAAA,MAAMA,gCAAc,CAAC,CAAA,wCAAA,EAA2C,YAAY,CAAA,CAAE,CAAC;gBAChF;AAEA,gBAAA,MAAM,OAAO,GAAY,gBAAgB,CAAC,WAAW,CAAC;gBAEtD,IAAI,CAAC,OAAO,EAAE;oBACb,IAAI,CAAC,cAAc,CAAC,oBAAoB,KAAKD,8DAAmC,CAAC,IAAI,IAAI,cAAc,CAAC,mCAAmC,KAAK,cAAc,CAAC,oBAAoB,KAAKA,8DAAmC,CAAC,MAAM,EAAE;AACnO,wBAAA,MAAMC,gCAAc,CAAC,CAAA,QAAA,EAAW,WAAqB,CAAA,wBAAA,CAA0B,CAAC;oBACjF;oBACA;gBACD;AAEA,gBAAA,IAAI,EAAE,OAAO,YAAYC,gCAAc,CAAC,EAAE;AACzC,oBAAA,MAAMD,gCAAc,CAAC,CAAA,QAAA,EAAW,WAAqB,CAAA,qCAAA,CAAuC,CAAC;gBAC9F;AAEA,gBAAA,MAAM,iBAAiB,GAAiC;AACvD,oBAAA,KAAK,EAAE;AACN,wBAAA,EAAE,EAAG,UAAsC,CAAC,YAAY,CAAC;AAClC,qBAAA;iBACxB;gBAED,MAAM,MAAM,IAAyB,MAAM,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAwB;gBAEjG,IAAI,CAAC,MAAM,EAAE;AACZ,oBAAA,MAAM,IAAIE,0BAAmB,CAAC,WAAW,YAAY,CAAA,GAAA,CAAK,CAAC;gBAC5D;;AAGA,gBAAA,UAAU,CAAC,YAAY,CAAC,GAAG,MAAM;YAClC;QACD;IACD;AACD;;;;"}
+{"version":3,"file":"handle-request-relations.utility.js","sources":["../../../../../../src/utility/api/controller/handle-request-relations.utility.ts"],"sourcesContent":[null],"names":["GetEntityColumns","EApiControllerLoadRelationsStrategy","ErrorException","ApiServiceBase","BadRequestException","EApiControllerRelationReferenceShape"],"mappings":"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"}

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

@@ -2,6 +2,7 @@ export * from './apply/index';
 export * from './get/index';
 export * from './get-list/index';
 export { ApiControllerHandleRequestRelations } from './handle-request-relations.utility';
+export { ApiControllerSerializeRouteResponse } from './serialize-route-response.utility';
 export { ApiControllerTransformData } from './transform-data.utility';
 export { ApiControllerValidateRequest } from './validate-request.utility';
 export * from './write/index';