@elsikora/nestjs-crud-automator 3.0.2 → 4.0.0-dev.2

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

@@ -1,4 +1,4 @@
 import { EApiRouteType } from '../../../../enum/decorator/api';
-import { IApiControllerPropertiesRouteWithAutoDto, IApiControllerPropertiesRouteWithDto } from '../../../../interface/decorator/api';
-import { TApiControllerGetListQueryDtoContract } from './get-list/query';
-export type TApiControllerPropertiesRoute<E, R extends EApiRouteType> = IApiControllerPropertiesRouteWithAutoDto<E, R> | (R extends EApiRouteType.GET_LIST ? TApiControllerGetListQueryDtoContract<E> : IApiControllerPropertiesRouteWithDto<E, R>);
+import { TApiControllerPropertiesRouteContract } from './properties/route/contract.type';
+import { TApiControllerPropertiesRouteWithIdentity, TApiControllerPropertiesRouteWithoutIdentity } from './properties/route/identity';
+export type TApiControllerPropertiesRoute<E, R extends EApiRouteType> = (R extends EApiRouteType.GET ? TApiControllerPropertiesRouteWithIdentity<E, TApiControllerPropertiesRouteContract<E, R>> : never) | TApiControllerPropertiesRouteWithoutIdentity<TApiControllerPropertiesRouteContract<E, R>>;

package/dist/cjs/type/decorator/api/controller/read/direct-scalar-field.type.d.ts

@@ -0,0 +1,2 @@
+import { TApiControllerGetListQueryDirectScalarPath } from '../get-list/query/path';
+export type TApiControllerReadDirectScalarField<E> = TApiControllerGetListQueryDirectScalarPath<E>;

package/dist/cjs/type/decorator/api/controller/read/index.d.ts

@@ -0,0 +1,2 @@
+export { type TApiControllerReadDirectScalarField } from './direct-scalar-field.type';
+export { type TApiControllerReadParameterTransformer } from './parameter-transformer';

package/dist/cjs/type/decorator/api/controller/read/parameter-transformer/index.d.ts

@@ -0,0 +1 @@
+export { type TApiControllerReadParameterTransformer } from './type';

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

@@ -0,0 +1,3 @@
+import { TApiRequestTransformer } from '../../../../../api-request-transformer.type';
+import { TApiControllerReadParameterTransformerWithStringKey } from './with-string-key.type';
+export type TApiControllerReadParameterTransformer<E> = TApiControllerReadParameterTransformerWithStringKey<TApiRequestTransformer<E>>;

package/dist/cjs/type/decorator/api/controller/read/parameter-transformer/with-string-key.type.d.ts

@@ -0,0 +1,5 @@
+export type TApiControllerReadParameterTransformerWithStringKey<T> = T extends {
+    key: unknown;
+} ? {
+    key: string;
+} & Omit<T, "key"> : never;

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

@@ -3,7 +3,7 @@ import { TApiPropertyDescribePropertiesBaseDtoProperties } from '../../..';
 export type TApiPropertyDescribePropertiesBaseProperties = {
     [EApiRouteType.CREATE]?: Pick<TApiPropertyDescribePropertiesBaseDtoProperties, EApiDtoType.BODY | EApiDtoType.RESPONSE>;
     [EApiRouteType.DELETE]?: Pick<TApiPropertyDescribePropertiesBaseDtoProperties, EApiDtoType.PARAMETERS>;
-    [EApiRouteType.GET_LIST]?: Pick<TApiPropertyDescribePropertiesBaseDtoProperties, EApiDtoType.QUERY | EApiDtoType.RESPONSE>;
+    [EApiRouteType.GET_LIST]?: Pick<TApiPropertyDescribePropertiesBaseDtoProperties, EApiDtoType.PARAMETERS | EApiDtoType.QUERY | 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/factory/api/controller/method/map.type.d.ts

@@ -1,12 +1,11 @@
-import { EApiRouteType } from '../../../../../enum/decorator/api';
+import { EApiControllerGetListQueryPaginationMode, EApiRouteType } from '../../../../../enum/decorator/api';
 import { IApiAuthenticationRequest } from '../../../../../interface/api/authentication-request.interface';
-import { IApiGetListResponseResult } from '../../../../../interface/decorator/api';
-import { TApiControllerGetListQuery } from '../../../../decorator/api/controller';
+import { TApiControllerGetListQuery, TApiControllerGetListResponse } from '../../../../decorator/api/controller';
 import { DeepPartial } from 'typeorm';
-export type TApiControllerMethodMap<E> = {
+export type TApiControllerMethodMap<E, M extends EApiControllerGetListQueryPaginationMode = EApiControllerGetListQueryPaginationMode.PAGE> = {
     [EApiRouteType.CREATE]: (body: DeepPartial<E>, headers: Record<string, string>, ip: string, authenticationRequest?: IApiAuthenticationRequest) => Promise<E>;
     [EApiRouteType.DELETE]: (parameters: Partial<E>, headers: Record<string, string>, ip: string, authenticationRequest?: IApiAuthenticationRequest) => Promise<void>;
-    [EApiRouteType.GET_LIST]: (query: TApiControllerGetListQuery<E>, headers: Record<string, string>, ip: string, authenticationRequest?: IApiAuthenticationRequest) => Promise<IApiGetListResponseResult<E>>;
+    [EApiRouteType.GET_LIST]: (query: TApiControllerGetListQuery<E, M>, headers: Record<string, string>, ip: string, authenticationRequest?: IApiAuthenticationRequest) => Promise<TApiControllerGetListResponse<E, M>>;
     [EApiRouteType.GET]: (parameters: Partial<E>, headers: Record<string, string>, ip: string, authenticationRequest?: IApiAuthenticationRequest) => Promise<E>;
     [EApiRouteType.PARTIAL_UPDATE]: (parameters: Partial<E>, body: DeepPartial<E>, headers: Record<string, string>, ip: string, authenticationRequest?: IApiAuthenticationRequest) => Promise<E>;
     [EApiRouteType.UPDATE]: (parameters: Partial<E>, body: DeepPartial<E>, headers: Record<string, string>, ip: string, authenticationRequest?: IApiAuthenticationRequest) => Promise<E>;

package/dist/cjs/type/factory/api/controller/target-methods.type.d.ts

@@ -1,8 +1,8 @@
 import { ApiServiceBase } from '../../../../class/api';
-import { EApiRouteType } from '../../../../enum/decorator/api';
+import { EApiControllerGetListQueryPaginationMode, EApiRouteType } from '../../../../enum/decorator/api';
 import { TApiControllerMethodMap, TApiControllerMethodName } from './method';
-export type TApiControllerTargetMethod<E> = new (...arguments_: Array<any>) => {
-    [K in EApiRouteType as TApiControllerMethodName<K>]: TApiControllerMethodMap<E>[K];
+export type TApiControllerTargetMethod<E, M extends EApiControllerGetListQueryPaginationMode = EApiControllerGetListQueryPaginationMode.PAGE> = new (...arguments_: Array<any>) => {
+    [K in EApiRouteType as TApiControllerMethodName<K>]: TApiControllerMethodMap<E, M>[K];
 } & {
     service: ApiServiceBase<E>;
 };

package/dist/cjs/type/utility/api/controller/transform-data/is-validation-properties.type.d.ts

@@ -1,3 +1,4 @@
-import { IApiGetListResponseResult } from '../../../../../interface/decorator/api';
+import { EApiControllerGetListQueryPaginationMode } from '../../../../../enum/decorator/api';
+import { IApiGetListCursorResponseResult, IApiGetListResponseResult } from '../../../../../interface/decorator/api';
 import { TApiControllerGetListQuery } from '../../../../decorator/api/controller';
-export type TApiTransformDataIsValidationProperties<E> = IApiGetListResponseResult<E> | Partial<E> | TApiControllerGetListQuery<E>;
+export type TApiTransformDataIsValidationProperties<E> = IApiGetListCursorResponseResult<E> | IApiGetListResponseResult<E> | Partial<E> | TApiControllerGetListQuery<E, EApiControllerGetListQueryPaginationMode>;

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

@@ -1,9 +1,10 @@
-import { IApiGetListResponseResult } from '../../../../../interface/decorator/api';
+import { EApiControllerGetListQueryPaginationMode } from '../../../../../enum/decorator/api';
+import { IApiGetListCursorResponseResult, IApiGetListResponseResult } from '../../../../../interface/decorator/api';
 import { TApiControllerGetListQuery } from '../../../../decorator/api/controller';
 import { DeepPartial } from 'typeorm';
 export type TApiControllerTransformDataObjectToTransform<E> = {
     body?: DeepPartial<E>;
     parameters?: Partial<E>;
-    query?: TApiControllerGetListQuery<E>;
-    response?: IApiGetListResponseResult<E> | Partial<E>;
+    query?: TApiControllerGetListQuery<E, EApiControllerGetListQueryPaginationMode>;
+    response?: IApiGetListCursorResponseResult<E> | IApiGetListResponseResult<E> | Partial<E>;
 };

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

@@ -0,0 +1,3 @@
+import { TApiRequestTransformer } from '../../../../api-request-transformer.type';
+import { TApiControllerReadParameterTransformer } from '../../../../decorator/api/controller';
+export type TApiControllerRuntimeTransformer<E> = TApiControllerReadParameterTransformer<E> | TApiRequestTransformer<E>;

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

@@ -0,0 +1,17 @@
+import { EApiControllerRequestTarget, EApiControllerResponseTarget } from '../../../../../enum/decorator/api';
+import { TApiRequestTransformer } from '../../../../api-request-transformer.type';
+import { TApiControllerRuntimeTransformer } from './runtime-transformer.type';
+export type TApiControllerTransformDataTargets<E> = {
+    [EApiControllerRequestTarget.BODY]?: {
+        transformers?: Array<TApiRequestTransformer<E>>;
+    };
+    [EApiControllerRequestTarget.PARAMETERS]?: {
+        transformers?: Array<TApiControllerRuntimeTransformer<E>>;
+    };
+    [EApiControllerRequestTarget.QUERY]?: {
+        transformers?: Array<TApiRequestTransformer<E>>;
+    };
+    [EApiControllerResponseTarget.RESPONSE]?: {
+        transformers?: Array<TApiRequestTransformer<E>>;
+    };
+};

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

@@ -2,7 +2,7 @@ import { EApiDtoType, EApiRouteType } from '../../../../enum/decorator/api';
 export type TDtoGenerateAllowedCombinations = {
     [EApiRouteType.CREATE]: EApiDtoType.BODY | EApiDtoType.RESPONSE;
     [EApiRouteType.DELETE]: EApiDtoType.PARAMETERS;
-    [EApiRouteType.GET_LIST]: EApiDtoType.QUERY | EApiDtoType.RESPONSE;
+    [EApiRouteType.GET_LIST]: EApiDtoType.PARAMETERS | EApiDtoType.QUERY | 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.d.ts

@@ -1,10 +1,11 @@
+import { EApiControllerGetListQueryPaginationMode, EApiRouteType } from '../../../../enum/decorator/api';
 import { IApiBaseEntity } from '../../../../interface/api-base-entity.interface';
 import { IApiControllerGetListQueryPlan } from '../../../../interface/class/api/controller/get-list/query';
+import { IApiControllerIdentityPlan } from '../../../../interface/class/api/controller/identity-plan.interface';
 import { IApiControllerProperties } from '../../../../interface/decorator/api';
 import { IApiEntity } from '../../../../interface/entity';
 import { TApiControllerPropertiesRoute } from '../../../../type/decorator/api/controller';
 import { TApiControllerMethodMap } from '../../../../type/factory/api/controller';
-import { EApiRouteType } from '../../../../enum/decorator/api';
 /**
  * Applies appropriate decorators to controller methods based on the route type.
  * Configures HTTP methods, status codes, paths, and response types for API endpoints.
@@ -20,4 +21,19 @@ import { EApiRouteType } from '../../../../enum/decorator/api';
  * @throws {Error} If the method type is not implemented
  * @template E - The entity type
  */
-export declare function ApiControllerApplyDecorators<E extends IApiBaseEntity>(targetMethod: TApiControllerMethodMap<E>[typeof method], entity: IApiEntity<E>, properties: IApiControllerProperties<E>, method: EApiRouteType, methodName: string, routeConfig: TApiControllerPropertiesRoute<E, typeof method>, decorators: Array<MethodDecorator> | Array<PropertyDecorator>, queryPlan?: IApiControllerGetListQueryPlan): void;
+export declare function ApiControllerApplyDecorators<E extends IApiBaseEntity, M extends EApiControllerGetListQueryPaginationMode = EApiControllerGetListQueryPaginationMode.PAGE>(targetMethod: TApiControllerMethodMap<E, M>[typeof method], entity: IApiEntity<E>, properties: IApiControllerProperties<E>, method: EApiRouteType, methodName: string, routeConfig: TApiControllerPropertiesRoute<E, typeof method>, decorators: Array<MethodDecorator> | Array<PropertyDecorator>, queryPlan?: IApiControllerGetListQueryPlan): void;
+/**
+ * Applies generated route decorators with an internal compiled identity plan.
+ * @template E - Entity type owned by the generated route.
+ * @param {TApiControllerMethodMap<E>[typeof method]} targetMethod - Generated controller method.
+ * @param {IApiEntity<E>} entity - Entity metadata.
+ * @param {IApiControllerProperties<E>} properties - Controller configuration.
+ * @param {EApiRouteType} method - Generated route type.
+ * @param {string} methodName - Generated controller method name.
+ * @param {TApiControllerPropertiesRoute<E, typeof method>} routeConfig - Route configuration.
+ * @param {Array<MethodDecorator> | Array<PropertyDecorator>} decorators - Additional decorators.
+ * @param {IApiControllerGetListQueryPlan} [queryPlan] - Internal compiled GET_LIST query plan.
+ * @param {IApiControllerIdentityPlan} [identityPlan] - Internal compiled GET identity alias plan.
+ * @returns {void}
+ */
+export declare function ApiControllerApplyDecoratorsWithIdentityPlan<E extends IApiBaseEntity, M extends EApiControllerGetListQueryPaginationMode = EApiControllerGetListQueryPaginationMode.PAGE>(targetMethod: TApiControllerMethodMap<E, M>[typeof method], entity: IApiEntity<E>, properties: IApiControllerProperties<E>, method: EApiRouteType, methodName: string, routeConfig: TApiControllerPropertiesRoute<E, typeof method>, decorators: Array<MethodDecorator> | Array<PropertyDecorator>, queryPlan?: IApiControllerGetListQueryPlan, identityPlan?: IApiControllerIdentityPlan): void;

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

@@ -4,6 +4,7 @@ var method_decorator = require('../../../../decorator/api/method.decorator.js');
 require('../../../../enum/decorator/api/action.enum.js');
 require('../../../../enum/decorator/api/authentication-type.enum.js');
 require('../../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js');
+require('../../../../enum/decorator/api/controller/get-list/query/pagination-mode.enum.js');
 require('../../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js');
 require('../../../../enum/decorator/api/controller/relation-reference-shape.enum.js');
 require('../../../../enum/decorator/api/controller/request/target.enum.js');
@@ -34,6 +35,7 @@ var decorators_utility = require('../get-list/query/open-api/decorators.utility.
 var exception_utility = require('../../../error/exception.utility.js');
 require('../../../../constant/decorator/api/function.constant.js');
 var dto_utility = require('../get/dto.utility.js');
+var assertPlan_utility = require('../read/assert-plan.utility.js');
 
 /**
  * Applies appropriate decorators to controller methods based on the route type.
@@ -51,7 +53,25 @@ var dto_utility = require('../get/dto.utility.js');
  * @template E - The entity type
  */
 function ApiControllerApplyDecorators(targetMethod, entity, properties, method, methodName, routeConfig, decorators, queryPlan) {
-    const responseDto = dto_utility.ApiControllerGetDto(properties, entity, method, dtoType_enum.EApiDtoType.RESPONSE, routeConfig);
+    assertPlan_utility.ApiControllerReadPlanAssert(routeConfig);
+    ApiControllerApplyDecoratorsWithIdentityPlan(targetMethod, entity, properties, method, methodName, routeConfig, decorators, queryPlan);
+}
+/**
+ * Applies generated route decorators with an internal compiled identity plan.
+ * @template E - Entity type owned by the generated route.
+ * @param {TApiControllerMethodMap<E>[typeof method]} targetMethod - Generated controller method.
+ * @param {IApiEntity<E>} entity - Entity metadata.
+ * @param {IApiControllerProperties<E>} properties - Controller configuration.
+ * @param {EApiRouteType} method - Generated route type.
+ * @param {string} methodName - Generated controller method name.
+ * @param {TApiControllerPropertiesRoute<E, typeof method>} routeConfig - Route configuration.
+ * @param {Array<MethodDecorator> | Array<PropertyDecorator>} decorators - Additional decorators.
+ * @param {IApiControllerGetListQueryPlan} [queryPlan] - Internal compiled GET_LIST query plan.
+ * @param {IApiControllerIdentityPlan} [identityPlan] - Internal compiled GET identity alias plan.
+ * @returns {void}
+ */
+function ApiControllerApplyDecoratorsWithIdentityPlan(targetMethod, entity, properties, method, methodName, routeConfig, decorators, queryPlan, identityPlan) {
+    const responseDto = dto_utility.ApiControllerGetDtoWithReadPlan(properties, entity, method, dtoType_enum.EApiDtoType.RESPONSE, routeConfig, queryPlan, undefined, identityPlan);
     const customDecorators = [...decorators];
     switch (method) {
         case type_enum.EApiRouteType.CREATE: {
@@ -63,8 +83,9 @@ function ApiControllerApplyDecorators(targetMethod, entity, properties, method,
             break;
         }
         case type_enum.EApiRouteType.GET: {
+            const path = `:${identityPlan?.parameter ?? String(entity.primaryKey?.name)}`;
             customDecorators.push(method_decorator.ApiMethod({
-                metadata: createRouteMetadata(properties, routeConfig, method, common.RequestMethod.GET, `:${String(entity.primaryKey?.name)}`, common.HttpStatus.OK, responseDto, { hasInternalServerError: true, hasNotFound: true, hasUnauthorized: true }),
+                metadata: createRouteMetadata(properties, routeConfig, method, common.RequestMethod.GET, path, common.HttpStatus.OK, responseDto, { hasInternalServerError: true, hasNotFound: true, hasUnauthorized: true }),
             }));
             break;
         }
@@ -142,4 +163,5 @@ function createRouteMetadata(properties, routeConfig, routeType, requestMethod,
 }
 
 exports.ApiControllerApplyDecorators = ApiControllerApplyDecorators;
+exports.ApiControllerApplyDecoratorsWithIdentityPlan = ApiControllerApplyDecoratorsWithIdentityPlan;
 //# 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","EApiRouteType","ApiMethod","RequestMethod","HttpStatus","ApiControllerGetListQueryOpenApiDecorators","ErrorException","ApiControllerBuildRouteDocumentation"],"mappings":"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"}
+{"version":3,"file":"decorators.utility.js","sources":["../../../../../../../src/utility/api/controller/apply/decorators.utility.ts"],"sourcesContent":[null],"names":["ApiControllerReadPlanAssert","ApiControllerGetDtoWithReadPlan","EApiDtoType","EApiRouteType","ApiMethod","RequestMethod","HttpStatus","ApiControllerGetListQueryOpenApiDecorators","ErrorException","ApiControllerBuildRouteDocumentation"],"mappings":"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"}

package/dist/cjs/utility/api/controller/apply/metadata.utility.d.ts

@@ -1,6 +1,8 @@
 import { EApiRouteType } from '../../../../enum/decorator/api';
 import { IApiBaseEntity } from '../../../../interface/api-base-entity.interface';
 import { IApiControllerGetListQueryPlan } from '../../../../interface/class/api/controller/get-list/query';
+import { IApiControllerIdentityPlan } from '../../../../interface/class/api/controller/identity-plan.interface';
+import { IApiControllerReadPlan } from '../../../../interface/class/api/controller/read';
 import { IApiControllerProperties } from '../../../../interface/decorator/api';
 import { IApiEntity } from '../../../../interface/entity';
 import { TApiControllerPropertiesRoute } from '../../../../type/decorator/api/controller';
@@ -19,3 +21,19 @@ import { TApiControllerPropertiesRoute } from '../../../../type/decorator/api/co
  * @template E - The entity type
  */
 export declare function ApiControllerApplyMetadata<E extends IApiBaseEntity>(target: object, targetPrototype: object, entity: IApiEntity<E>, properties: IApiControllerProperties<E>, method: EApiRouteType, methodName: string, routeConfig: TApiControllerPropertiesRoute<E, typeof method>, queryPlan?: IApiControllerGetListQueryPlan): void;
+/**
+ * Applies generated route metadata with an internal compiled read plan.
+ * @template E - Entity type
+ * @param {object} target - Controller class receiving Swagger metadata.
+ * @param {object} targetPrototype - Controller prototype receiving Nest route arguments.
+ * @param {IApiEntity<E>} entity - Entity metadata.
+ * @param {IApiControllerProperties<E>} properties - Controller configuration.
+ * @param {EApiRouteType} method - Generated route type.
+ * @param {string} methodName - Generated controller method name.
+ * @param {TApiControllerPropertiesRoute<E, typeof method>} routeConfig - Route configuration.
+ * @param {IApiControllerGetListQueryPlan} [queryPlan] - Internal compiled QUERY plan.
+ * @param {IApiControllerReadPlan} [readPlan] - Internal compiled PARAMETERS plan.
+ * @param {IApiControllerIdentityPlan} [identityPlan] - Internal GET identity alias plan.
+ * @returns {void}
+ */
+export declare function ApiControllerApplyMetadataWithReadPlan<E extends IApiBaseEntity>(target: object, targetPrototype: object, entity: IApiEntity<E>, properties: IApiControllerProperties<E>, method: EApiRouteType, methodName: string, routeConfig: TApiControllerPropertiesRoute<E, typeof method>, queryPlan?: IApiControllerGetListQueryPlan, readPlan?: IApiControllerReadPlan, identityPlan?: IApiControllerIdentityPlan): void;

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

@@ -3,6 +3,7 @@
 require('../../../../enum/decorator/api/action.enum.js');
 require('../../../../enum/decorator/api/authentication-type.enum.js');
 require('../../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js');
+require('../../../../enum/decorator/api/controller/get-list/query/pagination-mode.enum.js');
 require('../../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js');
 require('../../../../enum/decorator/api/controller/relation-reference-shape.enum.js');
 require('../../../../enum/decorator/api/controller/request/target.enum.js');
@@ -47,12 +48,30 @@ var dto_utility = require('../get/dto.utility.js');
  * @template E - The entity type
  */
 function ApiControllerApplyMetadata(target, targetPrototype, entity, properties, method, methodName, routeConfig, queryPlan) {
+    ApiControllerApplyMetadataWithReadPlan(target, targetPrototype, entity, properties, method, methodName, routeConfig, queryPlan);
+}
+/**
+ * Applies generated route metadata with an internal compiled read plan.
+ * @template E - Entity type
+ * @param {object} target - Controller class receiving Swagger metadata.
+ * @param {object} targetPrototype - Controller prototype receiving Nest route arguments.
+ * @param {IApiEntity<E>} entity - Entity metadata.
+ * @param {IApiControllerProperties<E>} properties - Controller configuration.
+ * @param {EApiRouteType} method - Generated route type.
+ * @param {string} methodName - Generated controller method name.
+ * @param {TApiControllerPropertiesRoute<E, typeof method>} routeConfig - Route configuration.
+ * @param {IApiControllerGetListQueryPlan} [queryPlan] - Internal compiled QUERY plan.
+ * @param {IApiControllerReadPlan} [readPlan] - Internal compiled PARAMETERS plan.
+ * @param {IApiControllerIdentityPlan} [identityPlan] - Internal GET identity alias plan.
+ * @returns {void}
+ */
+function ApiControllerApplyMetadataWithReadPlan(target, targetPrototype, entity, properties, method, methodName, routeConfig, queryPlan, readPlan, identityPlan) {
     let parameterIndex = 0;
     let routeArgumentsMetadata = {};
     const parameterTypes = [];
-    const requestDto = dto_utility.ApiControllerGetDto(properties, entity, method, dtoType_enum.EApiDtoType.PARAMETERS, routeConfig, queryPlan);
-    const queryDto = dto_utility.ApiControllerGetDto(properties, entity, method, dtoType_enum.EApiDtoType.QUERY, routeConfig, queryPlan);
-    const bodyDto = dto_utility.ApiControllerGetDto(properties, entity, method, dtoType_enum.EApiDtoType.BODY, routeConfig, queryPlan);
+    const requestDto = dto_utility.ApiControllerGetDtoWithReadPlan(properties, entity, method, dtoType_enum.EApiDtoType.PARAMETERS, routeConfig, queryPlan, readPlan, identityPlan);
+    const queryDto = dto_utility.ApiControllerGetDtoWithReadPlan(properties, entity, method, dtoType_enum.EApiDtoType.QUERY, routeConfig, queryPlan, readPlan, identityPlan);
+    const bodyDto = dto_utility.ApiControllerGetDtoWithReadPlan(properties, entity, method, dtoType_enum.EApiDtoType.BODY, routeConfig, queryPlan, readPlan, identityPlan);
     if (requestDto) {
         routeArgumentsMetadata = common.assignMetadata(routeArgumentsMetadata, routeParamtypes_enum_js.RouteParamtypes.PARAM, parameterIndex);
         parameterTypes.push(requestDto);
@@ -81,4 +100,5 @@ function ApiControllerApplyMetadata(target, targetPrototype, entity, properties,
 }
 
 exports.ApiControllerApplyMetadata = ApiControllerApplyMetadata;
+exports.ApiControllerApplyMetadataWithReadPlan = ApiControllerApplyMetadataWithReadPlan;
 //# sourceMappingURL=metadata.utility.js.map

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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcA;;;;;;;;;;;;;AAaG;SACa,0BAA0B,CAA2B,MAAc,EAAE,eAAuB,EAAE,MAAqB,EAAE,UAAuC,EAAE,MAAqB,EAAE,UAAkB,EAAE,WAA4D,EAAE,SAA0C,EAAA;IAChU,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,EAAE,SAAS,CAAC;AAC7I,IAAA,MAAM,QAAQ,GAA8BD,+BAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAEC,wBAAW,CAAC,KAAK,EAAE,WAAW,EAAE,SAAS,CAAC;AACtI,IAAA,MAAM,OAAO,GAA8BD,+BAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAEC,wBAAW,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC;IAEpI,IAAI,UAAU,EAAE;QACf,sBAAsB,GAAGC,qBAAc,CAAC,sBAAsB,EAAEC,uCAAe,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,uCAAe,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,uCAAe,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,uCAAe,CAAC,OAAO,EAAE,cAAc,CAAC;AACxG,IAAA,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;AAC3B,IAAA,cAAc,EAAE;IAEhB,sBAAsB,GAAGD,qBAAc,CAAC,sBAAsB,EAAEC,uCAAe,CAAC,EAAE,EAAE,cAAc,CAAC;AACnG,IAAA,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;AAC3B,IAAA,cAAc,EAAE;IAEhB,sBAAsB,GAAGD,qBAAc,CAAC,sBAAsB,EAAEC,uCAAe,CAAC,OAAO,EAAE,cAAc,CAAC;AACxG,IAAA,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;IAE3B,OAAO,CAAC,cAAc,CAACC,gCAAmB,EAAE,sBAAsB,EAAE,MAAM,EAAE,UAAU,CAAC;IACvF,OAAO,CAAC,cAAc,CAACC,gCAAmB,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":["ApiControllerGetDtoWithReadPlan","EApiDtoType","assignMetadata","RouteParamtypes","ROUTE_ARGS_METADATA","PARAMTYPES_METADATA"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgBA;;;;;;;;;;;;;AAaG;SACa,0BAA0B,CAA2B,MAAc,EAAE,eAAuB,EAAE,MAAqB,EAAE,UAAuC,EAAE,MAAqB,EAAE,UAAkB,EAAE,WAA4D,EAAE,SAA0C,EAAA;AAChU,IAAA,sCAAsC,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,CAAC;AAChI;AAEA;;;;;;;;;;;;;;AAcG;AACG,SAAU,sCAAsC,CAA2B,MAAc,EAAE,eAAuB,EAAE,MAAqB,EAAE,UAAuC,EAAE,MAAqB,EAAE,UAAkB,EAAE,WAA4D,EAAE,SAA0C,EAAE,QAAiC,EAAE,YAAyC,EAAA;IAC1Z,IAAI,cAAc,GAAW,CAAC;IAC9B,IAAI,sBAAsB,GAAY,EAAE;IACxC,MAAM,cAAc,GAAmB,EAAE;IAEzC,MAAM,UAAU,GAA8BA,2CAA+B,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAEC,wBAAW,CAAC,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC;IACjL,MAAM,QAAQ,GAA8BD,2CAA+B,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAEC,wBAAW,CAAC,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC;IAC1K,MAAM,OAAO,GAA8BD,2CAA+B,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAEC,wBAAW,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC;IAExK,IAAI,UAAU,EAAE;QACf,sBAAsB,GAAGC,qBAAc,CAAC,sBAAsB,EAAEC,uCAAe,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,uCAAe,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,uCAAe,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,uCAAe,CAAC,OAAO,EAAE,cAAc,CAAC;AACxG,IAAA,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;AAC3B,IAAA,cAAc,EAAE;IAEhB,sBAAsB,GAAGD,qBAAc,CAAC,sBAAsB,EAAEC,uCAAe,CAAC,EAAE,EAAE,cAAc,CAAC;AACnG,IAAA,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;AAC3B,IAAA,cAAc,EAAE;IAEhB,sBAAsB,GAAGD,qBAAc,CAAC,sBAAsB,EAAEC,uCAAe,CAAC,OAAO,EAAE,cAAc,CAAC;AACxG,IAAA,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;IAE3B,OAAO,CAAC,cAAc,CAACC,gCAAmB,EAAE,sBAAsB,EAAE,MAAM,EAAE,UAAU,CAAC;IACvF,OAAO,CAAC,cAAc,CAACC,gCAAmB,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,CAAC;AACzF;;;;;"}

package/dist/cjs/utility/api/controller/build-route-documentation.utility.js

@@ -4,6 +4,7 @@ var pluralizer = require('@elsikora/pluralizer');
 require('../../../enum/decorator/api/action.enum.js');
 require('../../../enum/decorator/api/authentication-type.enum.js');
 require('../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js');
+require('../../../enum/decorator/api/controller/get-list/query/pagination-mode.enum.js');
 require('../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js');
 require('../../../enum/decorator/api/controller/relation-reference-shape.enum.js');
 require('../../../enum/decorator/api/controller/request/target.enum.js');

package/dist/cjs/utility/api/controller/build-route-documentation.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"build-route-documentation.utility.js","sources":["../../../../../../src/utility/api/controller/build-route-documentation.utility.ts"],"sourcesContent":[null],"names":["pluralizer","EApiRouteTypeValue"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA;;;;;;;AAOG;AACG,SAAU,oCAAoC,CAAC,OAA6G,EAAA;IACjK,MAAM,kBAAkB,GAAWA,qBAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC;IAC5E,MAAM,oBAAoB,GAAWA,qBAAU,CAAC,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC;AAChF,IAAA,IAAI,OAAe;AACnB,IAAA,IAAI,WAAmB;AAEvB,IAAA,QAAQ,OAAO,CAAC,SAAS;AACxB,QAAA,KAAKC,uBAAkB,CAAC,MAAM,EAAE;AAC/B,YAAA,OAAO,GAAG,CAAA,SAAA,EAAY,oBAAoB,CAAA,EAAA,CAAI;AAC9C,YAAA,WAAW,GAAG,CAAA,gBAAA,EAAmB,oBAAoB,CAAA,YAAA,CAAc;YAEnE;QACD;AAEA,QAAA,KAAKA,uBAAkB,CAAC,MAAM,EAAE;AAC/B,YAAA,OAAO,GAAG,CAAA,SAAA,EAAY,oBAAoB,CAAA,EAAA,CAAI;AAC9C,YAAA,WAAW,GAAG,CAAA,sBAAA,EAAyB,oBAAoB,CAAA,YAAA,CAAc;YAEzE;QACD;AAEA,QAAA,KAAKA,uBAAkB,CAAC,GAAG,EAAE;AAC5B,YAAA,OAAO,GAAG,CAAA,MAAA,EAAS,oBAAoB,CAAA,EAAA,CAAI;AAC3C,YAAA,WAAW,GAAG,CAAA,mBAAA,EAAsB,oBAAoB,CAAA,8BAAA,CAAgC;YAExF;QACD;AAEA,QAAA,KAAKA,uBAAkB,CAAC,QAAQ,EAAE;AACjC,YAAA,OAAO,GAAG,CAAA,OAAA,EAAU,kBAAkB,CAAA,EAAA,CAAI;AAC1C,YAAA,WAAW,GAAG,CAAA,8BAAA,EAAiC,kBAAkB,CAAA,aAAA,CAAe;YAEhF;QACD;AAEA,QAAA,KAAKA,uBAAkB,CAAC,cAAc,EAAE;AACvC,YAAA,OAAO,GAAG,CAAA,mBAAA,EAAsB,oBAAoB,CAAA,EAAA,CAAI;AACxD,YAAA,WAAW,GAAG,CAAA,gCAAA,EAAmC,oBAAoB,CAAA,YAAA,CAAc;YAEnF;QACD;AAEA,QAAA,KAAKA,uBAAkB,CAAC,MAAM,EAAE;AAC/B,YAAA,OAAO,GAAG,CAAA,SAAA,EAAY,oBAAoB,CAAA,EAAA,CAAI;AAC9C,YAAA,WAAW,GAAG,CAAA,uBAAA,EAA0B,oBAAoB,CAAA,YAAA,CAAc;YAE1E;QACD;;IAGD,OAAO;AACN,QAAA,WAAW,EAAE,OAAO,CAAC,aAAa,EAAE,WAAW,IAAI,WAAW;AAC9D,QAAA,WAAW,EAAE,OAAO,CAAC,aAAa,EAAE,WAAW;AAC/C,QAAA,OAAO,EAAE,OAAO,CAAC,aAAa,EAAE,OAAO,IAAI,OAAO;KAClD;AACF;;;;"}
+{"version":3,"file":"build-route-documentation.utility.js","sources":["../../../../../../src/utility/api/controller/build-route-documentation.utility.ts"],"sourcesContent":[null],"names":["pluralizer","EApiRouteTypeValue"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA;;;;;;;AAOG;AACG,SAAU,oCAAoC,CAAC,OAA6G,EAAA;IACjK,MAAM,kBAAkB,GAAWA,qBAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC;IAC5E,MAAM,oBAAoB,GAAWA,qBAAU,CAAC,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC;AAChF,IAAA,IAAI,OAAe;AACnB,IAAA,IAAI,WAAmB;AAEvB,IAAA,QAAQ,OAAO,CAAC,SAAS;AACxB,QAAA,KAAKC,uBAAkB,CAAC,MAAM,EAAE;AAC/B,YAAA,OAAO,GAAG,CAAA,SAAA,EAAY,oBAAoB,CAAA,EAAA,CAAI;AAC9C,YAAA,WAAW,GAAG,CAAA,gBAAA,EAAmB,oBAAoB,CAAA,YAAA,CAAc;YAEnE;QACD;AAEA,QAAA,KAAKA,uBAAkB,CAAC,MAAM,EAAE;AAC/B,YAAA,OAAO,GAAG,CAAA,SAAA,EAAY,oBAAoB,CAAA,EAAA,CAAI;AAC9C,YAAA,WAAW,GAAG,CAAA,sBAAA,EAAyB,oBAAoB,CAAA,YAAA,CAAc;YAEzE;QACD;AAEA,QAAA,KAAKA,uBAAkB,CAAC,GAAG,EAAE;AAC5B,YAAA,OAAO,GAAG,CAAA,MAAA,EAAS,oBAAoB,CAAA,EAAA,CAAI;AAC3C,YAAA,WAAW,GAAG,CAAA,mBAAA,EAAsB,oBAAoB,CAAA,8BAAA,CAAgC;YAExF;QACD;AAEA,QAAA,KAAKA,uBAAkB,CAAC,QAAQ,EAAE;AACjC,YAAA,OAAO,GAAG,CAAA,OAAA,EAAU,kBAAkB,CAAA,EAAA,CAAI;AAC1C,YAAA,WAAW,GAAG,CAAA,8BAAA,EAAiC,kBAAkB,CAAA,aAAA,CAAe;YAEhF;QACD;AAEA,QAAA,KAAKA,uBAAkB,CAAC,cAAc,EAAE;AACvC,YAAA,OAAO,GAAG,CAAA,mBAAA,EAAsB,oBAAoB,CAAA,EAAA,CAAI;AACxD,YAAA,WAAW,GAAG,CAAA,gCAAA,EAAmC,oBAAoB,CAAA,YAAA,CAAc;YAEnF;QACD;AAEA,QAAA,KAAKA,uBAAkB,CAAC,MAAM,EAAE;AAC/B,YAAA,OAAO,GAAG,CAAA,SAAA,EAAY,oBAAoB,CAAA,EAAA,CAAI;AAC9C,YAAA,WAAW,GAAG,CAAA,uBAAA,EAA0B,oBAAoB,CAAA,YAAA,CAAc;YAE1E;QACD;;IAGD,OAAO;AACN,QAAA,WAAW,EAAE,OAAO,CAAC,aAAa,EAAE,WAAW,IAAI,WAAW;AAC9D,QAAA,WAAW,EAAE,OAAO,CAAC,aAAa,EAAE,WAAW;AAC/C,QAAA,OAAO,EAAE,OAAO,CAAC,aAAa,EAAE,OAAO,IAAI,OAAO;KAClD;AACF;;;;"}

package/dist/cjs/utility/api/controller/get/dto.utility.d.ts

@@ -1,6 +1,8 @@
 import { EApiDtoType, EApiRouteType } from '../../../../enum/decorator/api';
 import { IApiBaseEntity } from '../../../../interface/api-base-entity.interface';
 import { IApiControllerGetListQueryPlan } from '../../../../interface/class/api/controller/get-list/query';
+import { IApiControllerIdentityPlan } from '../../../../interface/class/api/controller/identity-plan.interface';
+import { IApiControllerReadPlan } from '../../../../interface/class/api/controller/read';
 import { IApiControllerProperties } from '../../../../interface/decorator/api';
 import { IApiEntity } from '../../../../interface/entity';
 import { Type } from '@nestjs/common';
@@ -19,3 +21,18 @@ import { TApiControllerPropertiesRoute } from '../../../../type/decorator/api/co
  * @template R - Route type
  */
 export declare function ApiControllerGetDto<E extends IApiBaseEntity, R extends EApiRouteType>(properties: IApiControllerProperties<E>, entity: IApiEntity<E>, method: R, dtoType: EApiDtoType, routeConfig: TApiControllerPropertiesRoute<E, R>, queryPlan?: IApiControllerGetListQueryPlan): Type<unknown> | undefined;
+/**
+ * Resolves a route DTO while applying an internal compiled read plan.
+ * @template E - Entity type
+ * @template R - Route type
+ * @param {IApiControllerProperties<E>} properties - Controller properties
+ * @param {IApiEntity<E>} entity - Entity metadata
+ * @param {R} method - Route method
+ * @param {EApiDtoType} dtoType - DTO kind to resolve
+ * @param {TApiControllerPropertiesRoute<E, R>} routeConfig - Route-specific configuration
+ * @param {IApiControllerGetListQueryPlan} [queryPlan] - Route-scoped GET_LIST QUERY plan.
+ * @param {IApiControllerReadPlan} [readPlan] - Internal route-scoped PARAMETERS plan.
+ * @param {IApiControllerIdentityPlan} [identityPlan] - Internal GET identity alias plan.
+ * @returns {Type<unknown> | undefined} Resolved DTO class or undefined.
+ */
+export declare function ApiControllerGetDtoWithReadPlan<E extends IApiBaseEntity, R extends EApiRouteType>(properties: IApiControllerProperties<E>, entity: IApiEntity<E>, method: R, dtoType: EApiDtoType, routeConfig: TApiControllerPropertiesRoute<E, R>, queryPlan?: IApiControllerGetListQueryPlan, readPlan?: IApiControllerReadPlan, identityPlan?: IApiControllerIdentityPlan): Type<unknown> | undefined;

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

@@ -3,6 +3,7 @@
 require('../../../../enum/decorator/api/action.enum.js');
 require('../../../../enum/decorator/api/authentication-type.enum.js');
 require('../../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js');
+var paginationMode_enum = require('../../../../enum/decorator/api/controller/get-list/query/pagination-mode.enum.js');
 require('../../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js');
 require('../../../../enum/decorator/api/controller/relation-reference-shape.enum.js');
 require('../../../../enum/decorator/api/controller/request/target.enum.js');
@@ -27,15 +28,19 @@ require('../../../../enum/decorator/api/property/number-type.enum.js');
 require('../../../../enum/decorator/api/property/string-type.enum.js');
 require('../../../../enum/decorator/api/route/subscriber-authorization-expectation.enum.js');
 var type_enum = require('../../../../enum/decorator/api/route/type.enum.js');
+var getPaginationMode_utility = require('../get-list/query/get-pagination-mode.utility.js');
+var assertPlan_utility = require('../identity/assert-plan.utility.js');
+var assertPlan_utility$1 = require('../read/assert-plan.utility.js');
+require('@nestjs/common');
 var camelCaseString_utility = require('../../../camel-case-string.utility.js');
 require('../../../../constant/utility/dto/constant.js');
+var exception_utility = require('../../../error/exception.utility.js');
 var core_utility = require('../../../dto/generate/core.utility.js');
 require('@nestjs/swagger');
 require('../../../../external/tslib/tslib.es6.js');
 require('../../../../class/utility/dto/exception/details/foreign-key-violation.class.js');
 require('../../../../class/utility/dto/exception/details/unique-violation.class.js');
 require('../../../../enum/utility/manual-dto-property-metadata-decorator.enum.js');
-require('@nestjs/common');
 require('class-transformer');
 require('class-validator');
 require('lodash/random.js');
@@ -48,13 +53,19 @@ require('../../../../enum/utility/exception-details-type.enum.js');
 require('../../../../enum/filter/operand.enum.js');
 require('../../../../enum/filter/operation.enum.js');
 require('../../../../enum/filter/order-direction.enum.js');
-var getListResponse_utility = require('../../../dto/generate/get-list-response.utility.js');
+var cursorResponse_utility = require('../../../dto/generate/get-list/cursor-response.utility.js');
 require('../../../../constant/decorator/api/function.constant.js');
+require('../../../../class/metadata-storage.class.js');
 require('typeorm');
+var response_utility = require('../../../dto/generate/get-list/response.utility.js');
 require('reflect-metadata');
 require('../../../../validator/all-or-none-of-listed-properties.validator.js');
+var identityReadParameters_utility = require('../../../dto/generate/identity-read-parameters.utility.js');
+var readParameters_utility = require('../../../dto/generate/read-parameters.utility.js');
 
 const getListItemResponseDtoCache = new Map();
+const getListCursorItemResponseDtoCache = new WeakMap();
+const getListCursorItemResponseDtoNameOwnerCache = new WeakMap();
 /**
  * Resolves a DTO class for a generated controller route.
  * Prefers an explicitly configured DTO and falls back to auto-generation.
@@ -69,14 +80,45 @@ const getListItemResponseDtoCache = new Map();
  * @template R - Route type
  */
 function ApiControllerGetDto(properties, entity, method, dtoType, routeConfig, queryPlan) {
+    assertPlan_utility$1.ApiControllerReadPlanAssert(routeConfig);
+    return ApiControllerGetDtoWithReadPlan(properties, entity, method, dtoType, routeConfig, queryPlan);
+}
+/**
+ * Resolves a route DTO while applying an internal compiled read plan.
+ * @template E - Entity type
+ * @template R - Route type
+ * @param {IApiControllerProperties<E>} properties - Controller properties
+ * @param {IApiEntity<E>} entity - Entity metadata
+ * @param {R} method - Route method
+ * @param {EApiDtoType} dtoType - DTO kind to resolve
+ * @param {TApiControllerPropertiesRoute<E, R>} routeConfig - Route-specific configuration
+ * @param {IApiControllerGetListQueryPlan} [queryPlan] - Route-scoped GET_LIST QUERY plan.
+ * @param {IApiControllerReadPlan} [readPlan] - Internal route-scoped PARAMETERS plan.
+ * @param {IApiControllerIdentityPlan} [identityPlan] - Internal GET identity alias plan.
+ * @returns {Type<unknown> | undefined} Resolved DTO class or undefined.
+ */
+function ApiControllerGetDtoWithReadPlan(properties, entity, method, dtoType, routeConfig, queryPlan, readPlan, identityPlan) {
+    assertPlan_utility.ApiControllerIdentityPlanAssert(routeConfig, identityPlan);
+    if (dtoType === dtoType_enum.EApiDtoType.PARAMETERS) {
+        assertPlan_utility$1.ApiControllerReadPlanAssert(routeConfig, readPlan);
+    }
     const configuredDto = routeConfig.dto?.[dtoType];
     if (configuredDto) {
         if (method === type_enum.EApiRouteType.GET_LIST && dtoType === dtoType_enum.EApiDtoType.RESPONSE && isGetListResponseDtoConfig(configuredDto)) {
-            return getGetListItemResponseDto(properties.entity, entity, configuredDto, method, dtoType);
+            return getGetListItemResponseDto(properties.entity, entity, configuredDto, method, dtoType, queryPlan);
         }
         return configuredDto;
     }
-    const effectiveQueryPlan = method === type_enum.EApiRouteType.GET_LIST && dtoType === dtoType_enum.EApiDtoType.QUERY ? queryPlan : undefined;
+    if (dtoType === dtoType_enum.EApiDtoType.PARAMETERS) {
+        if (identityPlan) {
+            return identityReadParameters_utility.DtoGenerateIdentityReadParameters(entity, identityPlan, readPlan, routeConfig.autoDto?.[dtoType], routeConfig.security?.authentication?.guard);
+        }
+        if (readPlan) {
+            return readParameters_utility.DtoGenerateReadParameters(entity, method, readPlan, routeConfig.autoDto?.[dtoType], routeConfig.security?.authentication?.guard);
+        }
+    }
+    const isCursorGetListResponse = method === type_enum.EApiRouteType.GET_LIST && dtoType === dtoType_enum.EApiDtoType.RESPONSE && getPaginationMode_utility.ApiControllerGetListQueryGetPaginationMode(queryPlan) === paginationMode_enum.EApiControllerGetListQueryPaginationMode.CURSOR;
+    const effectiveQueryPlan = method === type_enum.EApiRouteType.GET_LIST && (dtoType === dtoType_enum.EApiDtoType.QUERY || isCursorGetListResponse) ? queryPlan : undefined;
     return core_utility.DtoGenerate(properties.entity, entity, method, dtoType, routeConfig.autoDto?.[dtoType], routeConfig.security?.authentication?.guard, effectiveQueryPlan);
 }
 /**
@@ -98,19 +140,55 @@ function buildGetListItemResponseDtoName(entity, config, method, dtoType) {
  * @param {IApiControllerPropertiesRouteGetListResponseDtoConfig} config - Custom item response DTO config.
  * @param {EApiRouteType} method - Current route type.
  * @param {EApiDtoType} dtoType - Current DTO type.
+ * @param {IApiControllerGetListQueryPlan} [queryPlan] - Compiled pagination plan selecting the page or cursor wrapper.
  * @returns {Type<unknown>} Generated list wrapper DTO class.
  * @template E - Entity type.
  */
-function getGetListItemResponseDto(resourceClass, entity, config, method, dtoType) {
-    const name = buildGetListItemResponseDtoName(entity, config, method, dtoType);
-    const cacheKey = `${entity.name ?? "UnknownResource"}_${config.itemType.name}_${name}`;
-    const cached = getListItemResponseDtoCache.get(cacheKey);
+function getGetListItemResponseDto(resourceClass, entity, config, method, dtoType, queryPlan) {
+    const isCursor = getPaginationMode_utility.ApiControllerGetListQueryGetPaginationMode(queryPlan) === paginationMode_enum.EApiControllerGetListQueryPaginationMode.CURSOR;
+    const defaultName = buildGetListItemResponseDtoName(entity, config, method, dtoType);
+    if (!isCursor) {
+        const cacheKey = `${entity.name ?? "UnknownResource"}_${config.itemType.name}_${defaultName}`;
+        const cached = getListItemResponseDtoCache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        // @ts-ignore The existing list wrapper generator accepts the entity constructor at runtime.
+        const dto = response_utility.DtoGenerateGetListResponse(resourceClass, config.itemType, defaultName);
+        getListItemResponseDtoCache.set(cacheKey, dto);
+        return dto;
+    }
+    const name = config.name ?? `${defaultName}Cursor`;
+    const cacheKey = `${entity.name ?? "UnknownResource"}_${name}_cursor`;
+    const nameOwnerKey = `${entity.name ?? "UnknownResource"}_${name}`;
+    let nameOwnerCache = getListCursorItemResponseDtoNameOwnerCache.get(resourceClass);
+    if (!nameOwnerCache) {
+        nameOwnerCache = new Map();
+        getListCursorItemResponseDtoNameOwnerCache.set(resourceClass, nameOwnerCache);
+    }
+    const currentNameOwner = nameOwnerCache.get(nameOwnerKey);
+    const hasPageConflict = [...getListItemResponseDtoCache.values()].some((dto) => dto.name === name);
+    if (hasPageConflict || (currentNameOwner && currentNameOwner !== config.itemType)) {
+        throw exception_utility.ErrorException(`GET_LIST item response DTO wrapper name "${name}" is already used by another item constructor or pagination mode; configure a unique response DTO name`);
+    }
+    nameOwnerCache.set(nameOwnerKey, config.itemType);
+    let resourceCache = getListCursorItemResponseDtoCache.get(resourceClass);
+    if (!resourceCache) {
+        resourceCache = new WeakMap();
+        getListCursorItemResponseDtoCache.set(resourceClass, resourceCache);
+    }
+    let itemCache = resourceCache.get(config.itemType);
+    if (!itemCache) {
+        itemCache = new Map();
+        resourceCache.set(config.itemType, itemCache);
+    }
+    const cached = itemCache.get(cacheKey);
     if (cached) {
         return cached;
     }
-    // @ts-ignore The existing list wrapper generator accepts the entity constructor at runtime.
-    const dto = getListResponse_utility.DtoGenerateGetListResponse(resourceClass, config.itemType, name);
-    getListItemResponseDtoCache.set(cacheKey, dto);
+    // @ts-ignore The existing list wrapper generators accept the entity constructor at runtime.
+    const dto = cursorResponse_utility.DtoGenerateGetListCursorResponse(resourceClass, config.itemType, name);
+    itemCache.set(cacheKey, dto);
     return dto;
 }
 /**
@@ -123,4 +201,5 @@ function isGetListResponseDtoConfig(value) {
 }
 
 exports.ApiControllerGetDto = ApiControllerGetDto;
+exports.ApiControllerGetDtoWithReadPlan = ApiControllerGetDtoWithReadPlan;
 //# sourceMappingURL=dto.utility.js.map

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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcA,MAAM,2BAA2B,GAA+B,IAAI,GAAG,EAAyB;AAEhG;;;;;;;;;;;;AAYG;AACG,SAAU,mBAAmB,CAAoD,UAAuC,EAAE,MAAqB,EAAE,MAAS,EAAE,OAAoB,EAAE,WAAgD,EAAE,SAA0C,EAAA;IACnR,MAAM,aAAa,GAAsF,WAAW,CAAC,GAAG,GAAG,OAAO,CAAC;IAEnI,IAAI,aAAa,EAAE;AAClB,QAAA,IAAI,MAAM,KAAKA,uBAAkB,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,MAAM,kBAAkB,GAA+C,MAAM,KAAKD,uBAAkB,CAAC,QAAQ,IAAI,OAAO,KAAKC,wBAAgB,CAAC,KAAK,GAAG,SAAS,GAAG,SAAS;AAE3K,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,EAAE,kBAAkB,CAAC;AAChK;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":["ApiControllerReadPlanAssert","ApiControllerIdentityPlanAssert","EApiDtoTypeValue","EApiRouteTypeValue","DtoGenerateIdentityReadParameters","DtoGenerateReadParameters","ApiControllerGetListQueryGetPaginationMode","EApiControllerGetListQueryPaginationMode","DtoGenerate","CamelCaseString","DtoGenerateGetListResponse","ErrorException","DtoGenerateGetListCursorResponse"],"mappings":"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"}

package/dist/cjs/utility/api/controller/get-list/query/get-pagination-mode.utility.d.ts

@@ -0,0 +1,8 @@
+import { IApiControllerGetListQueryPlan } from '../../../../../interface/class/api/controller/get-list/query';
+import { EApiControllerGetListQueryPaginationMode } from '../../../../../enum/decorator/api';
+/**
+ * Reads the internal pagination mode while treating legacy public plans as PAGE.
+ * @param {IApiControllerGetListQueryPlan} [plan] - Public or internally compiled query plan.
+ * @returns {EApiControllerGetListQueryPaginationMode} Effective pagination mode.
+ */
+export declare function ApiControllerGetListQueryGetPaginationMode(plan?: IApiControllerGetListQueryPlan): EApiControllerGetListQueryPaginationMode;