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

package/dist/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/utility/api/controller/apply/decorators.utility.js

@@ -1,11 +1,13 @@
-import '../../../../constant/decorator/api/function.constant.js';
-import { METHOD_API_DECORATOR_CONSTANT } from '../../../../constant/decorator/api/method.constant.js';
 import { ApiMethod } from '../../../../decorator/api/method.decorator.js';
 import { EApiAction } from '../../../../enum/decorator/api/action.enum.js';
 import '../../../../enum/decorator/api/authentication-type.enum.js';
 import '../../../../enum/decorator/api/controller/load-relations-strategy.enum.js';
-import '../../../../enum/decorator/api/controller/request-transformer-type.enum.js';
+import '../../../../enum/decorator/api/controller/relation-reference-shape.enum.js';
+import '../../../../enum/decorator/api/controller/request/target.enum.js';
+import '../../../../enum/decorator/api/controller/request/transformer-type.enum.js';
+import '../../../../enum/decorator/api/controller/response-target.enum.js';
 import { EApiDtoType } from '../../../../enum/decorator/api/dto-type.enum.js';
+import '../../../../enum/decorator/api/function-transaction-mode.enum.js';
 import '../../../../enum/decorator/api/function-type.enum.js';
 import '../../../../enum/decorator/api/on-type.enum.js';
 import '../../../../enum/decorator/api/property/data-type.enum.js';
@@ -15,7 +17,7 @@ import '../../../../enum/decorator/api/property/desribe-type.enum.js';
 import '../../../../enum/decorator/api/property/number-type.enum.js';
 import '../../../../enum/decorator/api/property/string-type.enum.js';
 import { EApiRouteType } from '../../../../enum/decorator/api/route-type.enum.js';
-import { SetMetadata, RequestMethod, HttpStatus } from '@nestjs/common';
+import { HttpStatus, RequestMethod } from '@nestjs/common';
 import { ApiControllerGetDto } from '../get/dto.utility.js';
 import { ErrorException } from '../../../error/exception.utility.js';
 
@@ -35,50 +37,34 @@ import { ErrorException } from '../../../error/exception.utility.js';
  */
 function ApiControllerApplyDecorators(targetMethod, entity, properties, method, methodName, routeConfig, decorators) {
     const responseDto = ApiControllerGetDto(properties, entity, method, EApiDtoType.RESPONSE, routeConfig);
-    const customDecorators = [...decorators, SetMetadata(METHOD_API_DECORATOR_CONSTANT.ROUTE_TYPE_METADATA_KEY, method)];
+    const customDecorators = [...decorators];
     switch (method) {
         case EApiRouteType.CREATE: {
-            customDecorators.push(ApiMethod({ action: EApiAction.CREATE, authentication: routeConfig.authentication, authorization: { action: "create" }, entity: properties.entity, httpCode: HttpStatus.CREATED, method: RequestMethod.POST, path: "", responses: { hasConflict: true, hasInternalServerError: true, hasUnauthorized: true }, responseType: responseDto }));
+            customDecorators.push(ApiMethod({ metadata: createRouteMetadata(properties, routeConfig, method, RequestMethod.POST, "", HttpStatus.CREATED, responseDto, { hasConflict: true, hasInternalServerError: true, hasUnauthorized: true }, EApiAction.CREATE) }));
             break;
         }
         case EApiRouteType.DELETE: {
-            customDecorators.push(ApiMethod({ action: EApiAction.DELETE, authentication: routeConfig.authentication, authorization: { action: "delete" }, entity: properties.entity, httpCode: HttpStatus.NO_CONTENT, method: RequestMethod.DELETE, path: `:${String(entity.primaryKey?.name)}`, responses: { hasInternalServerError: true, hasNotFound: true, hasUnauthorized: true }, responseType: undefined }));
+            customDecorators.push(ApiMethod({ metadata: createRouteMetadata(properties, routeConfig, method, RequestMethod.DELETE, `:${String(entity.primaryKey?.name)}`, HttpStatus.NO_CONTENT, undefined, { hasInternalServerError: true, hasNotFound: true, hasUnauthorized: true }, EApiAction.DELETE) }));
             break;
         }
         case EApiRouteType.GET: {
             customDecorators.push(ApiMethod({
-                action: EApiAction.FETCH,
-                authentication: routeConfig.authentication,
-                authorization: { action: "get" },
-                entity: properties.entity,
-                httpCode: HttpStatus.OK,
-                method: RequestMethod.GET,
-                path: `:${String(entity.primaryKey?.name)}`,
-                responses: { hasInternalServerError: true, hasNotFound: true, hasUnauthorized: true },
-                responseType: responseDto,
+                metadata: createRouteMetadata(properties, routeConfig, method, RequestMethod.GET, `:${String(entity.primaryKey?.name)}`, HttpStatus.OK, responseDto, { hasInternalServerError: true, hasNotFound: true, hasUnauthorized: true }, EApiAction.FETCH),
             }));
             break;
         }
         case EApiRouteType.GET_LIST: {
             customDecorators.push(ApiMethod({
-                action: EApiAction.FETCH_LIST,
-                authentication: routeConfig.authentication,
-                authorization: { action: "getList" },
-                entity: properties.entity,
-                httpCode: HttpStatus.OK,
-                method: RequestMethod.GET,
-                path: "",
-                responses: { hasInternalServerError: true, hasNotFound: true, hasUnauthorized: true },
-                responseType: responseDto,
+                metadata: createRouteMetadata(properties, routeConfig, method, RequestMethod.GET, "", HttpStatus.OK, responseDto, { hasInternalServerError: true, hasNotFound: true, hasUnauthorized: true }, EApiAction.FETCH_LIST),
             }));
             break;
         }
         case EApiRouteType.PARTIAL_UPDATE: {
-            customDecorators.push(ApiMethod({ action: EApiAction.UPDATE, authentication: routeConfig.authentication, authorization: { action: "partialUpdate" }, entity: properties.entity, httpCode: HttpStatus.OK, method: RequestMethod.PATCH, path: `:${String(entity.primaryKey?.name)}`, responses: { hasBadRequest: true, hasConflict: true, hasInternalServerError: true, hasNotFound: true, hasUnauthorized: true }, responseType: responseDto }));
+            customDecorators.push(ApiMethod({ metadata: createRouteMetadata(properties, routeConfig, method, RequestMethod.PATCH, `:${String(entity.primaryKey?.name)}`, HttpStatus.OK, responseDto, { hasBadRequest: true, hasConflict: true, hasInternalServerError: true, hasNotFound: true, hasUnauthorized: true }, EApiAction.UPDATE) }));
             break;
         }
         case EApiRouteType.UPDATE: {
-            customDecorators.push(ApiMethod({ action: EApiAction.UPDATE, authentication: routeConfig.authentication, authorization: { action: "update" }, entity: properties.entity, httpCode: HttpStatus.OK, method: RequestMethod.PUT, path: `:${String(entity.primaryKey?.name)}`, responses: { hasBadRequest: true, hasConflict: true, hasInternalServerError: true, hasNotFound: true, hasUnauthorized: true }, responseType: responseDto }));
+            customDecorators.push(ApiMethod({ metadata: createRouteMetadata(properties, routeConfig, method, RequestMethod.PUT, `:${String(entity.primaryKey?.name)}`, HttpStatus.OK, responseDto, { hasBadRequest: true, hasConflict: true, hasInternalServerError: true, hasNotFound: true, hasUnauthorized: true }, EApiAction.UPDATE) }));
             break;
         }
         default: {
@@ -92,6 +78,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 !== 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,
+        },
+    };
+}
 
 export { ApiControllerApplyDecorators };
 //# sourceMappingURL=decorators.utility.js.map

package/dist/esm/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":[],"mappings":"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"}
+{"version":3,"file":"decorators.utility.js","sources":["../../../../../../../src/utility/api/controller/apply/decorators.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/utility/api/controller/apply/metadata.utility.js

@@ -1,8 +1,12 @@
 import '../../../../enum/decorator/api/action.enum.js';
 import '../../../../enum/decorator/api/authentication-type.enum.js';
 import '../../../../enum/decorator/api/controller/load-relations-strategy.enum.js';
-import '../../../../enum/decorator/api/controller/request-transformer-type.enum.js';
+import '../../../../enum/decorator/api/controller/relation-reference-shape.enum.js';
+import '../../../../enum/decorator/api/controller/request/target.enum.js';
+import '../../../../enum/decorator/api/controller/request/transformer-type.enum.js';
+import '../../../../enum/decorator/api/controller/response-target.enum.js';
 import { EApiDtoType } from '../../../../enum/decorator/api/dto-type.enum.js';
+import '../../../../enum/decorator/api/function-transaction-mode.enum.js';
 import '../../../../enum/decorator/api/function-type.enum.js';
 import '../../../../enum/decorator/api/on-type.enum.js';
 import '../../../../enum/decorator/api/property/data-type.enum.js';
@@ -34,7 +38,7 @@ function ApiControllerApplyMetadata(target, targetPrototype, entity, properties,
     let parameterIndex = 0;
     let routeArgumentsMetadata = {};
     const parameterTypes = [];
-    const requestDto = ApiControllerGetDto(properties, entity, method, EApiDtoType.REQUEST, routeConfig);
+    const requestDto = ApiControllerGetDto(properties, entity, method, EApiDtoType.PARAMETERS, routeConfig);
     const queryDto = ApiControllerGetDto(properties, entity, method, EApiDtoType.QUERY, routeConfig);
     const bodyDto = ApiControllerGetDto(properties, entity, method, EApiDtoType.BODY, routeConfig);
     if (requestDto) {

package/dist/esm/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":[],"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,GAA8B,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC;AAC/H,IAAA,MAAM,QAAQ,GAA8B,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC;AAC3H,IAAA,MAAM,OAAO,GAA8B,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC;IAEzH,IAAI,UAAU,EAAE;QACf,sBAAsB,GAAG,cAAc,CAAC,sBAAsB,EAAE,eAAe,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,GAAG,cAAc,CAAC,sBAAsB,EAAE,eAAe,CAAC,KAAK,EAAE,cAAc,CAAC;AACtG,QAAA,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC;AAC7B,QAAA,cAAc,EAAE;IACjB;IAEA,IAAI,OAAO,EAAE;QACZ,sBAAsB,GAAG,cAAc,CAAC,sBAAsB,EAAE,eAAe,CAAC,IAAI,EAAE,cAAc,CAAC;AACrG,QAAA,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;AAC5B,QAAA,cAAc,EAAE;IACjB;IAEA,sBAAsB,GAAG,cAAc,CAAC,sBAAsB,EAAE,eAAe,CAAC,OAAO,EAAE,cAAc,CAAC;AACxG,IAAA,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;AAC3B,IAAA,cAAc,EAAE;IAEhB,sBAAsB,GAAG,cAAc,CAAC,sBAAsB,EAAE,eAAe,CAAC,EAAE,EAAE,cAAc,CAAC;AACnG,IAAA,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;AAC3B,IAAA,cAAc,EAAE;IAEhB,sBAAsB,GAAG,cAAc,CAAC,sBAAsB,EAAE,eAAe,CAAC,OAAO,EAAE,cAAc,CAAC;AACxG,IAAA,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;AAC3B,IAAA,cAAc,EAAE;IAEhB,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,EAAE,UAAU,CAAC;IACvF,OAAO,CAAC,cAAc,CAAC,mBAAmB,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":[],"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,GAA8B,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,UAAU,EAAE,WAAW,CAAC;AAClI,IAAA,MAAM,QAAQ,GAA8B,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC;AAC3H,IAAA,MAAM,OAAO,GAA8B,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC;IAEzH,IAAI,UAAU,EAAE;QACf,sBAAsB,GAAG,cAAc,CAAC,sBAAsB,EAAE,eAAe,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,GAAG,cAAc,CAAC,sBAAsB,EAAE,eAAe,CAAC,KAAK,EAAE,cAAc,CAAC;AACtG,QAAA,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC;AAC7B,QAAA,cAAc,EAAE;IACjB;IAEA,IAAI,OAAO,EAAE;QACZ,sBAAsB,GAAG,cAAc,CAAC,sBAAsB,EAAE,eAAe,CAAC,IAAI,EAAE,cAAc,CAAC;AACrG,QAAA,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;AAC5B,QAAA,cAAc,EAAE;IACjB;IAEA,sBAAsB,GAAG,cAAc,CAAC,sBAAsB,EAAE,eAAe,CAAC,OAAO,EAAE,cAAc,CAAC;AACxG,IAAA,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;AAC3B,IAAA,cAAc,EAAE;IAEhB,sBAAsB,GAAG,cAAc,CAAC,sBAAsB,EAAE,eAAe,CAAC,EAAE,EAAE,cAAc,CAAC;AACnG,IAAA,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;AAC3B,IAAA,cAAc,EAAE;IAEhB,sBAAsB,GAAG,cAAc,CAAC,sBAAsB,EAAE,eAAe,CAAC,OAAO,EAAE,cAAc,CAAC;AACxG,IAAA,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;AAC3B,IAAA,cAAc,EAAE;IAEhB,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,EAAE,UAAU,CAAC;IACvF,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,CAAC;AACzF;;;;"}

package/dist/esm/utility/api/controller/get/dto.utility.js

@@ -1,8 +1,12 @@
 import '../../../../enum/decorator/api/action.enum.js';
 import '../../../../enum/decorator/api/authentication-type.enum.js';
 import '../../../../enum/decorator/api/controller/load-relations-strategy.enum.js';
-import '../../../../enum/decorator/api/controller/request-transformer-type.enum.js';
+import '../../../../enum/decorator/api/controller/relation-reference-shape.enum.js';
+import '../../../../enum/decorator/api/controller/request/target.enum.js';
+import '../../../../enum/decorator/api/controller/request/transformer-type.enum.js';
+import '../../../../enum/decorator/api/controller/response-target.enum.js';
 import { EApiDtoType } from '../../../../enum/decorator/api/dto-type.enum.js';
+import '../../../../enum/decorator/api/function-transaction-mode.enum.js';
 import '../../../../enum/decorator/api/function-type.enum.js';
 import '../../../../enum/decorator/api/on-type.enum.js';
 import '../../../../enum/decorator/api/property/data-type.enum.js';
@@ -58,7 +62,7 @@ function ApiControllerGetDto(properties, entity, method, dtoType, routeConfig) {
         }
         return configuredDto;
     }
-    return DtoGenerate(properties.entity, entity, method, dtoType, routeConfig.autoDto?.[dtoType], routeConfig.authentication?.guard);
+    return 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/esm/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"],"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,aAAkB,CAAC,QAAQ,IAAI,OAAO,KAAKC,WAAgB,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,OAAO,WAAW,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,EAAG,eAAe,CAAC,MAAM,CAAC,CAAA,EAAG,eAAe,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,GAAkB,0BAA0B,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"],"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,aAAkB,CAAC,QAAQ,IAAI,OAAO,KAAKC,WAAgB,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,OAAO,WAAW,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,EAAG,eAAe,CAAC,MAAM,CAAC,CAAA,EAAG,eAAe,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,GAAkB,0BAA0B,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/esm/utility/api/controller/get-list/transform/filter.utility.js

@@ -3,8 +3,12 @@ import { PROPERTY_DESCRIBE_DECORATOR_API_CONSTANT } from '../../../../../constan
 import '../../../../../enum/decorator/api/action.enum.js';
 import '../../../../../enum/decorator/api/authentication-type.enum.js';
 import '../../../../../enum/decorator/api/controller/load-relations-strategy.enum.js';
-import '../../../../../enum/decorator/api/controller/request-transformer-type.enum.js';
+import '../../../../../enum/decorator/api/controller/relation-reference-shape.enum.js';
+import '../../../../../enum/decorator/api/controller/request/target.enum.js';
+import '../../../../../enum/decorator/api/controller/request/transformer-type.enum.js';
+import '../../../../../enum/decorator/api/controller/response-target.enum.js';
 import '../../../../../enum/decorator/api/dto-type.enum.js';
+import '../../../../../enum/decorator/api/function-transaction-mode.enum.js';
 import '../../../../../enum/decorator/api/function-type.enum.js';
 import '../../../../../enum/decorator/api/on-type.enum.js';
 import '../../../../../enum/decorator/api/property/data-type.enum.js';

package/dist/esm/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":[],"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,CAAC,wCAAwC,CAAC,YAAY,CAAC,CAAC,IAAI,KAAK,wBAAwB,CAAC,QAAQ,EAAE;;AAEvH,gBAAA,MAAM,CAAC,GAAc,CAAC,GAAG,EAAE,EAAE,EAAE,sCAAsC,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE;YAC1F;iBAAO;;gBAEN,MAAM,CAAC,GAAc,CAAC,GAAG,sCAAsC,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":[],"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,CAAC,wCAAwC,CAAC,YAAY,CAAC,CAAC,IAAI,KAAK,wBAAwB,CAAC,QAAQ,EAAE;;AAEvH,gBAAA,MAAM,CAAC,GAAc,CAAC,GAAG,EAAE,EAAE,EAAE,sCAAsC,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE;YAC1F;iBAAO;;gBAEN,MAAM,CAAC,GAAc,CAAC,GAAG,sCAAsC,CAAC,SAAS,EAAE,KAAK,CAAC;YAClF;QACD;IACD;AAEA,IAAA,OAAO,MAAM;AACd;;;;"}

package/dist/esm/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/esm/utility/api/controller/handle-request-relations.utility.js

@@ -1,12 +1,13 @@
 import { ApiServiceBase } from '../../../class/api/service-base.class.js';
-import '../../../class/api/subscriber/discovery-service.class.js';
-import '../../../class/api/subscriber/executor.class.js';
-import '../../../class/api/subscriber/registry.class.js';
 import '../../../enum/decorator/api/action.enum.js';
 import '../../../enum/decorator/api/authentication-type.enum.js';
 import { EApiControllerLoadRelationsStrategy } from '../../../enum/decorator/api/controller/load-relations-strategy.enum.js';
-import '../../../enum/decorator/api/controller/request-transformer-type.enum.js';
+import { EApiControllerRelationReferenceShape } from '../../../enum/decorator/api/controller/relation-reference-shape.enum.js';
+import '../../../enum/decorator/api/controller/request/target.enum.js';
+import '../../../enum/decorator/api/controller/request/transformer-type.enum.js';
+import '../../../enum/decorator/api/controller/response-target.enum.js';
 import '../../../enum/decorator/api/dto-type.enum.js';
+import '../../../enum/decorator/api/function-transaction-mode.enum.js';
 import '../../../enum/decorator/api/function-type.enum.js';
 import '../../../enum/decorator/api/on-type.enum.js';
 import '../../../enum/decorator/api/property/data-type.enum.js';
@@ -26,7 +27,7 @@ import { GetEntityColumns } from '../../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
@@ -35,16 +36,18 @@ import { GetEntityColumns } from '../../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 GetEntityColumns({ entity: properties.entity, shouldTakeRelationsOnly: true })) {
             // @ts-expect-error
             if (parameters[propertyName] !== undefined && typeof propertyName === "string") {
-                if (relationConfig.relationsLoadStrategy === EApiControllerLoadRelationsStrategy.MANUAL && !relationConfig.relationsToLoad.includes(propertyName)) {
+                if (loadConfig.relationStrategy === EApiControllerLoadRelationsStrategy.MANUAL && !loadConfig.relations?.includes(propertyName)) {
                     continue;
                 }
                 let serviceName;
-                if (relationConfig.servicesLoadStrategy === EApiControllerLoadRelationsStrategy.MANUAL) {
-                    const manualServiceName = relationConfig.relationsServices[propertyName];
+                if (loadConfig.serviceStrategy === EApiControllerLoadRelationsStrategy.MANUAL) {
+                    const manualServiceName = loadConfig.services?.[propertyName];
                     if (manualServiceName === undefined) {
                         throw ErrorException(`Service name not specified for property ${propertyName} in manual mode`);
                     }
@@ -58,7 +61,7 @@ async function ApiControllerHandleRequestRelations(controllerMethod, properties,
                 }
                 const service = controllerMethod[serviceName];
                 if (!service) {
-                    if ((relationConfig.servicesLoadStrategy === EApiControllerLoadRelationsStrategy.AUTO && relationConfig.shouldForceAllServicesToBeSpecified) || relationConfig.servicesLoadStrategy === EApiControllerLoadRelationsStrategy.MANUAL) {
+                    if ((loadConfig.serviceStrategy === EApiControllerLoadRelationsStrategy.AUTO && loadConfig.shouldForceAllServicesToBeSpecified) || loadConfig.serviceStrategy === EApiControllerLoadRelationsStrategy.MANUAL) {
                         throw ErrorException(`Service ${serviceName} not found in controller`);
                     }
                     continue;
@@ -66,9 +69,12 @@ async function ApiControllerHandleRequestRelations(controllerMethod, properties,
                 if (!(service instanceof ApiServiceBase)) {
                     throw 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));
@@ -81,6 +87,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 === EApiControllerRelationReferenceShape.SCALAR) {
+        if (value !== null && typeof value === "object") {
+            throw new BadRequestException(`Relation ${propertyName} must be a scalar reference`);
+        }
+        return value;
+    }
+    if (value === null || typeof value !== "object" || !(referenceKey in value)) {
+        throw new BadRequestException(`Relation ${propertyName} must be an object reference with "${referenceKey}"`);
+    }
+    return value[referenceKey];
+}
 
 export { ApiControllerHandleRequestRelations };
 //# sourceMappingURL=handle-request-relations.utility.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"handle-request-relations.utility.js","sources":["../../../../../../src/utility/api/controller/handle-request-relations.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;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,IAAI,gBAAgB,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,KAAK,mCAAmC,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE;oBAClJ;gBACD;AAEA,gBAAA,IAAI,WAAiD;gBAErD,IAAI,cAAc,CAAC,oBAAoB,KAAK,mCAAmC,CAAC,MAAM,EAAE;oBACvF,MAAM,iBAAiB,GAAY,cAAc,CAAC,iBAAiB,CAAC,YAAY,CAAC;AAEjF,oBAAA,IAAI,iBAAiB,KAAK,SAAS,EAAE;AACpC,wBAAA,MAAM,cAAc,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,MAAM,cAAc,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,KAAK,mCAAmC,CAAC,IAAI,IAAI,cAAc,CAAC,mCAAmC,KAAK,cAAc,CAAC,oBAAoB,KAAK,mCAAmC,CAAC,MAAM,EAAE;AACnO,wBAAA,MAAM,cAAc,CAAC,CAAA,QAAA,EAAW,WAAqB,CAAA,wBAAA,CAA0B,CAAC;oBACjF;oBACA;gBACD;AAEA,gBAAA,IAAI,EAAE,OAAO,YAAY,cAAc,CAAC,EAAE;AACzC,oBAAA,MAAM,cAAc,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,IAAI,mBAAmB,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":[],"mappings":"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"}

package/dist/esm/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';

package/dist/esm/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/esm/utility/api/controller/serialize-route-response.utility.js

@@ -0,0 +1,27 @@
+import { HttpStatus } from '@nestjs/common';
+import { ApiRouteSerializeResponse } from '../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 ApiRouteSerializeResponse({
+        response: {
+            serialization,
+            status: HttpStatus.OK,
+            type: dto,
+        },
+    }, response);
+}
+
+export { ApiControllerSerializeRouteResponse };
+//# sourceMappingURL=serialize-route-response.utility.js.map

package/dist/esm/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":[],"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,OAAO,yBAAyB,CAC/B;AACC,QAAA,QAAQ,EAAE;YACT,aAAa;YACb,MAAM,EAAE,UAAU,CAAC,EAAE;AACrB,YAAA,IAAI,EAAE,GAAG;AACT,SAAA;KACD,EACD,QAAQ,CACR;AACF;;;;"}

package/dist/esm/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;