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

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

@@ -2,6 +2,7 @@ import { ApiMethod } from '../../../../decorator/api/method.decorator.js';
 import '../../../../enum/decorator/api/action.enum.js';
 import '../../../../enum/decorator/api/authentication-type.enum.js';
 import '../../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js';
+import '../../../../enum/decorator/api/controller/get-list/query/pagination-mode.enum.js';
 import '../../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js';
 import '../../../../enum/decorator/api/controller/relation-reference-shape.enum.js';
 import '../../../../enum/decorator/api/controller/request/target.enum.js';
@@ -31,7 +32,8 @@ import { ApiControllerBuildRouteDocumentation } from '../build-route-documentati
 import { ApiControllerGetListQueryOpenApiDecorators } from '../get-list/query/open-api/decorators.utility.js';
 import { ErrorException } from '../../../error/exception.utility.js';
 import '../../../../constant/decorator/api/function.constant.js';
-import { ApiControllerGetDto } from '../get/dto.utility.js';
+import { ApiControllerGetDtoWithReadPlan } from '../get/dto.utility.js';
+import { ApiControllerReadPlanAssert } from '../read/assert-plan.utility.js';
 
 /**
  * Applies appropriate decorators to controller methods based on the route type.
@@ -49,7 +51,25 @@ import { ApiControllerGetDto } from '../get/dto.utility.js';
  * @template E - The entity type
  */
 function ApiControllerApplyDecorators(targetMethod, entity, properties, method, methodName, routeConfig, decorators, queryPlan) {
-    const responseDto = ApiControllerGetDto(properties, entity, method, EApiDtoType.RESPONSE, routeConfig);
+    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 = ApiControllerGetDtoWithReadPlan(properties, entity, method, EApiDtoType.RESPONSE, routeConfig, queryPlan, undefined, identityPlan);
     const customDecorators = [...decorators];
     switch (method) {
         case EApiRouteType.CREATE: {
@@ -61,8 +81,9 @@ function ApiControllerApplyDecorators(targetMethod, entity, properties, method,
             break;
         }
         case EApiRouteType.GET: {
+            const path = `:${identityPlan?.parameter ?? String(entity.primaryKey?.name)}`;
             customDecorators.push(ApiMethod({
-                metadata: createRouteMetadata(properties, routeConfig, method, RequestMethod.GET, `:${String(entity.primaryKey?.name)}`, HttpStatus.OK, responseDto, { hasInternalServerError: true, hasNotFound: true, hasUnauthorized: true }),
+                metadata: createRouteMetadata(properties, routeConfig, method, RequestMethod.GET, path, HttpStatus.OK, responseDto, { hasInternalServerError: true, hasNotFound: true, hasUnauthorized: true }),
             }));
             break;
         }
@@ -139,5 +160,5 @@ function createRouteMetadata(properties, routeConfig, routeType, requestMethod,
     };
 }
 
-export { ApiControllerApplyDecorators };
+export { ApiControllerApplyDecorators, ApiControllerApplyDecoratorsWithIdentityPlan };
 //# 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.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/esm/utility/api/controller/apply/metadata.utility.js

@@ -1,6 +1,7 @@
 import '../../../../enum/decorator/api/action.enum.js';
 import '../../../../enum/decorator/api/authentication-type.enum.js';
 import '../../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js';
+import '../../../../enum/decorator/api/controller/get-list/query/pagination-mode.enum.js';
 import '../../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js';
 import '../../../../enum/decorator/api/controller/relation-reference-shape.enum.js';
 import '../../../../enum/decorator/api/controller/request/target.enum.js';
@@ -28,7 +29,7 @@ import '../../../../enum/decorator/api/route/type.enum.js';
 import { assignMetadata } from '@nestjs/common';
 import { ROUTE_ARGS_METADATA, PARAMTYPES_METADATA } from '@nestjs/common/constants.js';
 import { RouteParamtypes } from '@nestjs/common/enums/route-paramtypes.enum.js';
-import { ApiControllerGetDto } from '../get/dto.utility.js';
+import { ApiControllerGetDtoWithReadPlan } from '../get/dto.utility.js';
 
 /**
  * Applies metadata for NestJS controller methods to enable proper dependency injection.
@@ -45,12 +46,30 @@ import { ApiControllerGetDto } from '../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 = ApiControllerGetDto(properties, entity, method, EApiDtoType.PARAMETERS, routeConfig, queryPlan);
-    const queryDto = ApiControllerGetDto(properties, entity, method, EApiDtoType.QUERY, routeConfig, queryPlan);
-    const bodyDto = ApiControllerGetDto(properties, entity, method, EApiDtoType.BODY, routeConfig, queryPlan);
+    const requestDto = ApiControllerGetDtoWithReadPlan(properties, entity, method, EApiDtoType.PARAMETERS, routeConfig, queryPlan, readPlan, identityPlan);
+    const queryDto = ApiControllerGetDtoWithReadPlan(properties, entity, method, EApiDtoType.QUERY, routeConfig, queryPlan, readPlan, identityPlan);
+    const bodyDto = ApiControllerGetDtoWithReadPlan(properties, entity, method, EApiDtoType.BODY, routeConfig, queryPlan, readPlan, identityPlan);
     if (requestDto) {
         routeArgumentsMetadata = assignMetadata(routeArgumentsMetadata, RouteParamtypes.PARAM, parameterIndex);
         parameterTypes.push(requestDto);
@@ -78,5 +97,5 @@ function ApiControllerApplyMetadata(target, targetPrototype, entity, properties,
     Reflect.defineMetadata(PARAMTYPES_METADATA, parameterTypes, targetPrototype, methodName);
 }
 
-export { ApiControllerApplyMetadata };
+export { ApiControllerApplyMetadata, ApiControllerApplyMetadataWithReadPlan };
 //# sourceMappingURL=metadata.utility.js.map

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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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,GAA8B,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,UAAU,EAAE,WAAW,EAAE,SAAS,CAAC;AAC7I,IAAA,MAAM,QAAQ,GAA8B,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,SAAS,CAAC;AACtI,IAAA,MAAM,OAAO,GAA8B,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC;IAEpI,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;IAE3B,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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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,GAA8B,+BAA+B,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC;IACjL,MAAM,QAAQ,GAA8B,+BAA+B,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC;IAC1K,MAAM,OAAO,GAA8B,+BAA+B,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC;IAExK,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;IAE3B,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/build-route-documentation.utility.js

@@ -2,6 +2,7 @@ import { pluralizer } from '@elsikora/pluralizer';
 import '../../../enum/decorator/api/action.enum.js';
 import '../../../enum/decorator/api/authentication-type.enum.js';
 import '../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js';
+import '../../../enum/decorator/api/controller/get-list/query/pagination-mode.enum.js';
 import '../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js';
 import '../../../enum/decorator/api/controller/relation-reference-shape.enum.js';
 import '../../../enum/decorator/api/controller/request/target.enum.js';

package/dist/esm/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":["EApiRouteTypeValue"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA;;;;;;;AAOG;AACG,SAAU,oCAAoC,CAAC,OAA6G,EAAA;IACjK,MAAM,kBAAkB,GAAW,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC;IAC5E,MAAM,oBAAoB,GAAW,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC;AAChF,IAAA,IAAI,OAAe;AACnB,IAAA,IAAI,WAAmB;AAEvB,IAAA,QAAQ,OAAO,CAAC,SAAS;AACxB,QAAA,KAAKA,aAAkB,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,aAAkB,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,aAAkB,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,aAAkB,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,aAAkB,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,aAAkB,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":["EApiRouteTypeValue"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA;;;;;;;AAOG;AACG,SAAU,oCAAoC,CAAC,OAA6G,EAAA;IACjK,MAAM,kBAAkB,GAAW,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC;IAC5E,MAAM,oBAAoB,GAAW,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC;AAChF,IAAA,IAAI,OAAe;AACnB,IAAA,IAAI,WAAmB;AAEvB,IAAA,QAAQ,OAAO,CAAC,SAAS;AACxB,QAAA,KAAKA,aAAkB,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,aAAkB,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,aAAkB,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,aAAkB,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,aAAkB,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,aAAkB,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/esm/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/esm/utility/api/controller/get/dto.utility.js

@@ -1,6 +1,7 @@
 import '../../../../enum/decorator/api/action.enum.js';
 import '../../../../enum/decorator/api/authentication-type.enum.js';
 import '../../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js';
+import { EApiControllerGetListQueryPaginationMode } from '../../../../enum/decorator/api/controller/get-list/query/pagination-mode.enum.js';
 import '../../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js';
 import '../../../../enum/decorator/api/controller/relation-reference-shape.enum.js';
 import '../../../../enum/decorator/api/controller/request/target.enum.js';
@@ -25,15 +26,19 @@ import '../../../../enum/decorator/api/property/number-type.enum.js';
 import '../../../../enum/decorator/api/property/string-type.enum.js';
 import '../../../../enum/decorator/api/route/subscriber-authorization-expectation.enum.js';
 import { EApiRouteType } from '../../../../enum/decorator/api/route/type.enum.js';
+import { ApiControllerGetListQueryGetPaginationMode } from '../get-list/query/get-pagination-mode.utility.js';
+import { ApiControllerIdentityPlanAssert } from '../identity/assert-plan.utility.js';
+import { ApiControllerReadPlanAssert } from '../read/assert-plan.utility.js';
+import '@nestjs/common';
 import { CamelCaseString } from '../../../camel-case-string.utility.js';
 import '../../../../constant/utility/dto/constant.js';
+import { ErrorException } from '../../../error/exception.utility.js';
 import { DtoGenerate } from '../../../dto/generate/core.utility.js';
 import '@nestjs/swagger';
 import '../../../../external/tslib/tslib.es6.js';
 import '../../../../class/utility/dto/exception/details/foreign-key-violation.class.js';
 import '../../../../class/utility/dto/exception/details/unique-violation.class.js';
 import '../../../../enum/utility/manual-dto-property-metadata-decorator.enum.js';
-import '@nestjs/common';
 import 'class-transformer';
 import 'class-validator';
 import 'lodash/random.js';
@@ -46,13 +51,19 @@ import '../../../../enum/utility/exception-details-type.enum.js';
 import '../../../../enum/filter/operand.enum.js';
 import '../../../../enum/filter/operation.enum.js';
 import '../../../../enum/filter/order-direction.enum.js';
-import { DtoGenerateGetListResponse } from '../../../dto/generate/get-list-response.utility.js';
+import { DtoGenerateGetListCursorResponse } from '../../../dto/generate/get-list/cursor-response.utility.js';
 import '../../../../constant/decorator/api/function.constant.js';
+import '../../../../class/metadata-storage.class.js';
 import 'typeorm';
+import { DtoGenerateGetListResponse } from '../../../dto/generate/get-list/response.utility.js';
 import 'reflect-metadata';
 import '../../../../validator/all-or-none-of-listed-properties.validator.js';
+import { DtoGenerateIdentityReadParameters } from '../../../dto/generate/identity-read-parameters.utility.js';
+import { DtoGenerateReadParameters } from '../../../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.
@@ -67,14 +78,45 @@ const getListItemResponseDtoCache = new Map();
  * @template R - Route type
  */
 function ApiControllerGetDto(properties, entity, method, dtoType, routeConfig, queryPlan) {
+    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) {
+    ApiControllerIdentityPlanAssert(routeConfig, identityPlan);
+    if (dtoType === EApiDtoType.PARAMETERS) {
+        ApiControllerReadPlanAssert(routeConfig, readPlan);
+    }
     const configuredDto = routeConfig.dto?.[dtoType];
     if (configuredDto) {
         if (method === EApiRouteType.GET_LIST && dtoType === 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 === EApiRouteType.GET_LIST && dtoType === EApiDtoType.QUERY ? queryPlan : undefined;
+    if (dtoType === EApiDtoType.PARAMETERS) {
+        if (identityPlan) {
+            return DtoGenerateIdentityReadParameters(entity, identityPlan, readPlan, routeConfig.autoDto?.[dtoType], routeConfig.security?.authentication?.guard);
+        }
+        if (readPlan) {
+            return DtoGenerateReadParameters(entity, method, readPlan, routeConfig.autoDto?.[dtoType], routeConfig.security?.authentication?.guard);
+        }
+    }
+    const isCursorGetListResponse = method === EApiRouteType.GET_LIST && dtoType === EApiDtoType.RESPONSE && ApiControllerGetListQueryGetPaginationMode(queryPlan) === EApiControllerGetListQueryPaginationMode.CURSOR;
+    const effectiveQueryPlan = method === EApiRouteType.GET_LIST && (dtoType === EApiDtoType.QUERY || isCursorGetListResponse) ? queryPlan : undefined;
     return DtoGenerate(properties.entity, entity, method, dtoType, routeConfig.autoDto?.[dtoType], routeConfig.security?.authentication?.guard, effectiveQueryPlan);
 }
 /**
@@ -96,19 +138,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 = ApiControllerGetListQueryGetPaginationMode(queryPlan) === 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 = 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 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 = DtoGenerateGetListResponse(resourceClass, config.itemType, name);
-    getListItemResponseDtoCache.set(cacheKey, dto);
+    // @ts-ignore The existing list wrapper generators accept the entity constructor at runtime.
+    const dto = DtoGenerateGetListCursorResponse(resourceClass, config.itemType, name);
+    itemCache.set(cacheKey, dto);
     return dto;
 }
 /**
@@ -120,5 +198,5 @@ function isGetListResponseDtoConfig(value) {
     return typeof value === "object" && "itemType" in value && typeof value.itemType === "function";
 }
 
-export { ApiControllerGetDto };
+export { ApiControllerGetDto, ApiControllerGetDtoWithReadPlan };
 //# sourceMappingURL=dto.utility.js.map

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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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,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,MAAM,kBAAkB,GAA+C,MAAM,KAAKD,aAAkB,CAAC,QAAQ,IAAI,OAAO,KAAKC,WAAgB,CAAC,KAAK,GAAG,SAAS,GAAG,SAAS;AAE3K,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,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,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":["EApiDtoTypeValue","EApiRouteTypeValue"],"mappings":"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"}

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

package/dist/esm/utility/api/controller/get-list/query/get-pagination-mode.utility.js

@@ -0,0 +1,41 @@
+import '../../../../../enum/decorator/api/action.enum.js';
+import '../../../../../enum/decorator/api/authentication-type.enum.js';
+import '../../../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js';
+import { EApiControllerGetListQueryPaginationMode } from '../../../../../enum/decorator/api/controller/get-list/query/pagination-mode.enum.js';
+import '../../../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js';
+import '../../../../../enum/decorator/api/controller/relation-reference-shape.enum.js';
+import '../../../../../enum/decorator/api/controller/request/target.enum.js';
+import '../../../../../enum/decorator/api/controller/request/transformer-type.enum.js';
+import '../../../../../enum/decorator/api/controller/response-target.enum.js';
+import '../../../../../enum/decorator/api/dto-type.enum.js';
+import '../../../../../enum/decorator/api/function/context-storage-kind.enum.js';
+import '../../../../../enum/decorator/api/function/subscriber-transaction-expectation.enum.js';
+import '../../../../../enum/decorator/api/function/transaction/event-status.enum.js';
+import '../../../../../enum/decorator/api/function/transaction/failure-stage.enum.js';
+import '../../../../../enum/decorator/api/function/transaction/mode.enum.js';
+import '../../../../../enum/decorator/api/function/transaction/outcome.enum.js';
+import '../../../../../enum/decorator/api/function/transaction/owner-kind.enum.js';
+import '../../../../../enum/decorator/api/function/transaction/trace-type.enum.js';
+import '../../../../../enum/decorator/api/function/type.enum.js';
+import '../../../../../enum/decorator/api/on-type.enum.js';
+import '../../../../../enum/decorator/api/property/data-type.enum.js';
+import '../../../../../enum/decorator/api/property/date/identifier.enum.js';
+import '../../../../../enum/decorator/api/property/date/type.enum.js';
+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 '../../../../../enum/decorator/api/route/subscriber-authorization-expectation.enum.js';
+import '../../../../../enum/decorator/api/route/type.enum.js';
+
+/**
+ * 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.
+ */
+function ApiControllerGetListQueryGetPaginationMode(plan) {
+    const paginationMode = plan?.pagination?.mode;
+    return paginationMode === EApiControllerGetListQueryPaginationMode.CURSOR ? EApiControllerGetListQueryPaginationMode.CURSOR : EApiControllerGetListQueryPaginationMode.PAGE;
+}
+
+export { ApiControllerGetListQueryGetPaginationMode };
+//# sourceMappingURL=get-pagination-mode.utility.js.map

package/dist/esm/utility/api/controller/get-list/query/get-pagination-mode.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-pagination-mode.utility.js","sources":["../../../../../../../../src/utility/api/controller/get-list/query/get-pagination-mode.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKA;;;;AAIG;AACG,SAAU,0CAA0C,CAAC,IAAqC,EAAA;AAC/F,IAAA,MAAM,cAAc,GAAa,IAAoE,EAAE,UAAU,EAAE,IAAI;AAEvH,IAAA,OAAO,cAAc,KAAK,wCAAwC,CAAC,MAAM,GAAG,wCAAwC,CAAC,MAAM,GAAG,wCAAwC,CAAC,IAAI;AAC5K;;;;"}

package/dist/esm/utility/api/controller/get-list/query/open-api/decorators.utility.js

@@ -3,6 +3,7 @@ import { DTO_GENERATE_CONSTANT } from '../../../../../../constant/utility/dto/ge
 import '../../../../../../enum/decorator/api/action.enum.js';
 import '../../../../../../enum/decorator/api/authentication-type.enum.js';
 import { EApiControllerGetListQueryFilterMissingBehavior } from '../../../../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js';
+import '../../../../../../enum/decorator/api/controller/get-list/query/pagination-mode.enum.js';
 import '../../../../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js';
 import '../../../../../../enum/decorator/api/controller/relation-reference-shape.enum.js';
 import '../../../../../../enum/decorator/api/controller/request/target.enum.js';

package/dist/esm/utility/api/controller/get-list/query/open-api/decorators.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.utility.js","sources":["../../../../../../../../../src/utility/api/controller/get-list/query/open-api/decorators.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYA;;;;AAIG;AACG,SAAU,0CAA0C,CAAC,IAAoC,EAAA;AAC9F,IAAA,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE;AACzB,QAAA,OAAO,EAAE;IACV;IAEA,MAAM,UAAU,GAA2B,EAAE;AAE7C,IAAA,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;AACtD,QAAA,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE;YACrB;QACD;QAEA,MAAM,WAAW,GAAiB,2CAA2C,CAAC,KAAK,CAAC,QAAQ,CAAC;QAE7F,MAAM,QAAQ,GAAwB,KAAK,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,SAA2B,KAAkB;YAC/G,MAAM,OAAO,GAAmB,iCAAiC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,OAAO;AAE9F,YAAA,MAAM,UAAU,GAAiC;AAChD,gBAAA,QAAQ,EAAE;oBACT,IAAI,EAAE,CAAC,SAAS,CAAC;AACjB,oBAAA,IAAI,EAAE,QAAQ;AACd,iBAAA;aACD;AACD,YAAA,MAAM,QAAQ,GAAkB,CAAC,UAAU,CAAC;AAE5C,YAAA,IAAI,OAAO,KAAK,cAAc,CAAC,KAAK,EAAE;AACrC,gBAAA,UAAU,CAAC,KAAK,GAAG,WAAW;AAC9B,gBAAA,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC;YACvB;AAEA,YAAA,IAAI,OAAO,KAAK,cAAc,CAAC,MAAM,IAAI,OAAO,KAAK,cAAc,CAAC,IAAI,EAAE;gBACzE,UAAU,CAAC,MAAM,GAAG;AACnB,oBAAA,KAAK,EAAE,WAAW;AAClB,oBAAA,QAAQ,EAAE,OAAO,KAAK,cAAc,CAAC,IAAI,GAAG,iCAAiC,CAAC,kBAAkB,GAAG,qBAAqB,CAAC,yBAAyB;AAClJ,oBAAA,QAAQ,EAAE,OAAO,KAAK,cAAc,CAAC,IAAI,GAAG,iCAAiC,CAAC,kBAAkB,GAAG,iCAAiC,CAAC,4BAA4B;AACjK,oBAAA,IAAI,EAAE,OAAO;iBACb;AACD,gBAAA,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC;YACxB;YAEA,MAAM,uBAAuB,GAAuB,sBAAsB;AAE1E,YAAA,MAAM,MAAM,GAAiB;gBAC5B,CAAC,uBAAuB,GAAG,KAAK;gBAChC,UAAU;gBACV,QAAQ;AACR,gBAAA,IAAI,EAAE,QAAQ;aACd;AAED,YAAA,OAAO,MAAM;AACd,QAAA,CAAC,CAAC;QAEF,MAAM,UAAU,GAAyC,SAAS;QAClE,MAAM,WAAW,GAAyC,UAAU;AAEpE,QAAA,MAAM,OAAO,GAAmC;YAC/C,CAAC,UAAU,GAAG,IAAI;YAClB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,CAAC,WAAW,GAAG,KAAK,CAAC,eAAe,KAAK,+CAA+C,CAAC,MAAM;AAC/F,YAAA,MAAM,EAAE;AACP,gBAAA,KAAK,EAAE,QAAQ;AACf,aAAA;AACD,YAAA,KAAK,EAAE,YAAY;SACnB;QAED,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACnC;AAEA,IAAA,OAAO,UAAU;AAClB;;;;"}
+{"version":3,"file":"decorators.utility.js","sources":["../../../../../../../../../src/utility/api/controller/get-list/query/open-api/decorators.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYA;;;;AAIG;AACG,SAAU,0CAA0C,CAAC,IAAoC,EAAA;AAC9F,IAAA,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE;AACzB,QAAA,OAAO,EAAE;IACV;IAEA,MAAM,UAAU,GAA2B,EAAE;AAE7C,IAAA,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;AACtD,QAAA,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE;YACrB;QACD;QAEA,MAAM,WAAW,GAAiB,2CAA2C,CAAC,KAAK,CAAC,QAAQ,CAAC;QAE7F,MAAM,QAAQ,GAAwB,KAAK,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,SAA2B,KAAkB;YAC/G,MAAM,OAAO,GAAmB,iCAAiC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,OAAO;AAE9F,YAAA,MAAM,UAAU,GAAiC;AAChD,gBAAA,QAAQ,EAAE;oBACT,IAAI,EAAE,CAAC,SAAS,CAAC;AACjB,oBAAA,IAAI,EAAE,QAAQ;AACd,iBAAA;aACD;AACD,YAAA,MAAM,QAAQ,GAAkB,CAAC,UAAU,CAAC;AAE5C,YAAA,IAAI,OAAO,KAAK,cAAc,CAAC,KAAK,EAAE;AACrC,gBAAA,UAAU,CAAC,KAAK,GAAG,WAAW;AAC9B,gBAAA,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC;YACvB;AAEA,YAAA,IAAI,OAAO,KAAK,cAAc,CAAC,MAAM,IAAI,OAAO,KAAK,cAAc,CAAC,IAAI,EAAE;gBACzE,UAAU,CAAC,MAAM,GAAG;AACnB,oBAAA,KAAK,EAAE,WAAW;AAClB,oBAAA,QAAQ,EAAE,OAAO,KAAK,cAAc,CAAC,IAAI,GAAG,iCAAiC,CAAC,kBAAkB,GAAG,qBAAqB,CAAC,yBAAyB;AAClJ,oBAAA,QAAQ,EAAE,OAAO,KAAK,cAAc,CAAC,IAAI,GAAG,iCAAiC,CAAC,kBAAkB,GAAG,iCAAiC,CAAC,4BAA4B;AACjK,oBAAA,IAAI,EAAE,OAAO;iBACb;AACD,gBAAA,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC;YACxB;YAEA,MAAM,uBAAuB,GAAuB,sBAAsB;AAE1E,YAAA,MAAM,MAAM,GAAiB;gBAC5B,CAAC,uBAAuB,GAAG,KAAK;gBAChC,UAAU;gBACV,QAAQ;AACR,gBAAA,IAAI,EAAE,QAAQ;aACd;AAED,YAAA,OAAO,MAAM;AACd,QAAA,CAAC,CAAC;QAEF,MAAM,UAAU,GAAyC,SAAS;QAClE,MAAM,WAAW,GAAyC,UAAU;AAEpE,QAAA,MAAM,OAAO,GAAmC;YAC/C,CAAC,UAAU,GAAG,IAAI;YAClB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,CAAC,WAAW,GAAG,KAAK,CAAC,eAAe,KAAK,+CAA+C,CAAC,MAAM;AAC/F,YAAA,MAAM,EAAE;AACP,gBAAA,KAAK,EAAE,QAAQ;AACf,aAAA;AACD,YAAA,KAAK,EAAE,YAAY;SACnB;QAED,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACnC;AAEA,IAAA,OAAO,UAAU;AAClB;;;;"}

package/dist/esm/utility/api/controller/get-list/query/open-api/value-schema.utility.js

@@ -1,6 +1,7 @@
 import '../../../../../../enum/decorator/api/action.enum.js';
 import '../../../../../../enum/decorator/api/authentication-type.enum.js';
 import '../../../../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js';
+import '../../../../../../enum/decorator/api/controller/get-list/query/pagination-mode.enum.js';
 import '../../../../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js';
 import '../../../../../../enum/decorator/api/controller/relation-reference-shape.enum.js';
 import '../../../../../../enum/decorator/api/controller/request/target.enum.js';

package/dist/esm/utility/api/controller/get-list/query/open-api/value-schema.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"value-schema.utility.js","sources":["../../../../../../../../../src/utility/api/controller/get-list/query/open-api/value-schema.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOA;;;;AAIG;AACG,SAAU,2CAA2C,CAAC,QAAwC,EAAA;AACnG,IAAA,MAAM,YAAY,GAA6B,QAAQ,CAAC,IAAI;AAE5D,IAAA,IAAI,YAAY,KAAK,wBAAwB,CAAC,MAAM,IAAI,YAAY,KAAK,wBAAwB,CAAC,QAAQ,EAAE;AAC3G,QAAA,MAAM,cAAc,CAAC,2DAA2D,CAAC;IAClF;IAEA,QAAQ,YAAY;AACnB,QAAA,KAAK,wBAAwB,CAAC,OAAO,EAAE;AACtC,YAAA,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;QAC3B;AAEA,QAAA,KAAK,wBAAwB,CAAC,IAAI,EAAE;YACnC,OAAO,EAAE,MAAM,EAAE,QAAQ,IAAI,QAAQ,GAAG,QAAQ,CAAC,MAAM,GAAG,oBAAoB,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC3G;AAEA,QAAA,KAAK,wBAAwB,CAAC,IAAI,EAAE;AACnC,YAAA,IAAI,EAAE,MAAM,IAAI,QAAQ,CAAC,EAAE;AAC1B,gBAAA,MAAM,cAAc,CAAC,6CAA6C,CAAC;YACpE;YAEA,MAAM,UAAU,GAAmC,mCAAmC,CAAC,QAAQ,CAAC,IAAI,CAAC;AACrG,YAAA,MAAM,gBAAgB,GAAY,UAAU,CAAC,IAAI,CAAC,CAAC,KAAsB,KAAc,OAAO,KAAK,KAAK,QAAQ,CAAC;AACjH,YAAA,MAAM,eAAe,GAAY,UAAU,CAAC,IAAI,CAAC,CAAC,KAAsB,KAAc,OAAO,KAAK,KAAK,QAAQ,CAAC;AAChH,YAAA,IAAI,SAA0C;YAE9C,IAAI,CAAC,gBAAgB,EAAE;gBACtB,SAAS,GAAG,QAAQ;YACrB;iBAAO,IAAI,CAAC,eAAe,EAAE;gBAC5B,SAAS,GAAG,QAAQ;YACrB;YAEA,OAAO;AACN,gBAAA,IAAI,EAAE,CAAC,GAAG,UAAU,CAAC;AACrB,gBAAA,IAAI,EAAE,SAAS;aACf;QACF;AAEA,QAAA,KAAK,wBAAwB,CAAC,MAAM,EAAE;AACrC,YAAA,MAAM,YAAY,GAAuC,QAAQ,IAAI,QAAQ,GAAI,QAAQ,CAAC,MAAiC,GAAG,SAAS;AAEvI,YAAA,OAAO,EAAE,IAAI,EAAE,YAAY,KAAK,sBAAsB,CAAC,OAAO,GAAG,SAAS,GAAG,QAAQ,EAAE;QACxF;AAEA,QAAA,KAAK,wBAAwB,CAAC,MAAM,EAAE;AACrC,YAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC1B;AAEA,QAAA,KAAK,wBAAwB,CAAC,IAAI,EAAE;YACnC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC1C;;AAEF;;;;"}
+{"version":3,"file":"value-schema.utility.js","sources":["../../../../../../../../../src/utility/api/controller/get-list/query/open-api/value-schema.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOA;;;;AAIG;AACG,SAAU,2CAA2C,CAAC,QAAwC,EAAA;AACnG,IAAA,MAAM,YAAY,GAA6B,QAAQ,CAAC,IAAI;AAE5D,IAAA,IAAI,YAAY,KAAK,wBAAwB,CAAC,MAAM,IAAI,YAAY,KAAK,wBAAwB,CAAC,QAAQ,EAAE;AAC3G,QAAA,MAAM,cAAc,CAAC,2DAA2D,CAAC;IAClF;IAEA,QAAQ,YAAY;AACnB,QAAA,KAAK,wBAAwB,CAAC,OAAO,EAAE;AACtC,YAAA,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;QAC3B;AAEA,QAAA,KAAK,wBAAwB,CAAC,IAAI,EAAE;YACnC,OAAO,EAAE,MAAM,EAAE,QAAQ,IAAI,QAAQ,GAAG,QAAQ,CAAC,MAAM,GAAG,oBAAoB,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC3G;AAEA,QAAA,KAAK,wBAAwB,CAAC,IAAI,EAAE;AACnC,YAAA,IAAI,EAAE,MAAM,IAAI,QAAQ,CAAC,EAAE;AAC1B,gBAAA,MAAM,cAAc,CAAC,6CAA6C,CAAC;YACpE;YAEA,MAAM,UAAU,GAAmC,mCAAmC,CAAC,QAAQ,CAAC,IAAI,CAAC;AACrG,YAAA,MAAM,gBAAgB,GAAY,UAAU,CAAC,IAAI,CAAC,CAAC,KAAsB,KAAc,OAAO,KAAK,KAAK,QAAQ,CAAC;AACjH,YAAA,MAAM,eAAe,GAAY,UAAU,CAAC,IAAI,CAAC,CAAC,KAAsB,KAAc,OAAO,KAAK,KAAK,QAAQ,CAAC;AAChH,YAAA,IAAI,SAA0C;YAE9C,IAAI,CAAC,gBAAgB,EAAE;gBACtB,SAAS,GAAG,QAAQ;YACrB;iBAAO,IAAI,CAAC,eAAe,EAAE;gBAC5B,SAAS,GAAG,QAAQ;YACrB;YAEA,OAAO;AACN,gBAAA,IAAI,EAAE,CAAC,GAAG,UAAU,CAAC;AACrB,gBAAA,IAAI,EAAE,SAAS;aACf;QACF;AAEA,QAAA,KAAK,wBAAwB,CAAC,MAAM,EAAE;AACrC,YAAA,MAAM,YAAY,GAAuC,QAAQ,IAAI,QAAQ,GAAI,QAAQ,CAAC,MAAiC,GAAG,SAAS;AAEvI,YAAA,OAAO,EAAE,IAAI,EAAE,YAAY,KAAK,sBAAsB,CAAC,OAAO,GAAG,SAAS,GAAG,QAAQ,EAAE;QACxF;AAEA,QAAA,KAAK,wBAAwB,CAAC,MAAM,EAAE;AACrC,YAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC1B;AAEA,QAAA,KAAK,wBAAwB,CAAC,IAAI,EAAE;YACnC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC1C;;AAEF;;;;"}

package/dist/esm/utility/api/controller/get-list/query/resolve-cursor-order-fields.utility.d.ts

@@ -0,0 +1,7 @@
+import { IApiControllerGetListQueryPlanOrder } from '../../../../../interface/class/api/controller/get-list/query';
+/**
+ * Resolves the complete stable set of fields whose raw values may participate in a CURSOR order tuple.
+ * @param {IApiControllerGetListQueryPlanOrder} order - Compiled GET_LIST order contract.
+ * @returns {ReadonlyArray<string>} Frozen, code-unit sorted protected field paths.
+ */
+export declare function ApiControllerGetListQueryResolveCursorOrderFields(order: IApiControllerGetListQueryPlanOrder): ReadonlyArray<string>;

package/dist/esm/utility/api/controller/get-list/query/resolve-cursor-order-fields.utility.js

@@ -0,0 +1,24 @@
+/**
+ * Resolves the complete stable set of fields whose raw values may participate in a CURSOR order tuple.
+ * @param {IApiControllerGetListQueryPlanOrder} order - Compiled GET_LIST order contract.
+ * @returns {ReadonlyArray<string>} Frozen, code-unit sorted protected field paths.
+ */
+function ApiControllerGetListQueryResolveCursorOrderFields(order) {
+    return Object.freeze([
+        ...new Set([
+            ...Object.values(order.fields)
+                .filter((field) => field.isEnabled)
+                .map((field) => field.path),
+            ...(order.defaultOrder ?? []).map((entry) => entry.field),
+            ...(order.tieBreakers ?? []).map((entry) => entry.field),
+        ]),
+    ].toSorted((left, right) => {
+        if (left < right) {
+            return -1;
+        }
+        return left > right ? 1 : 0;
+    }));
+}
+
+export { ApiControllerGetListQueryResolveCursorOrderFields };
+//# sourceMappingURL=resolve-cursor-order-fields.utility.js.map

package/dist/esm/utility/api/controller/get-list/query/resolve-cursor-order-fields.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-cursor-order-fields.utility.js","sources":["../../../../../../../../src/utility/api/controller/get-list/query/resolve-cursor-order-fields.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"AAEA;;;;AAIG;AACG,SAAU,iDAAiD,CAAC,KAA0C,EAAA;IAC3G,OAAO,MAAM,CAAC,MAAM,CACnB;QACC,GAAG,IAAI,GAAG,CAAS;AAClB,YAAA,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM;iBAC3B,MAAM,CAAC,CAAC,KAA+C,KAAc,KAAK,CAAC,SAAS;iBACpF,GAAG,CAAC,CAAC,KAA+C,KAAa,KAAK,CAAC,IAAI,CAAC;AAC9E,YAAA,GAAG,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC,KAA+C,KAAa,KAAK,CAAC,KAAK,CAAC;AAC3G,YAAA,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC,KAA+C,KAAa,KAAK,CAAC,KAAK,CAAC;SAC1G,CAAC;AACF,KAAA,CAAC,QAAQ,CAAC,CAAC,IAAY,EAAE,KAAa,KAAY;AAClD,QAAA,IAAI,IAAI,GAAG,KAAK,EAAE;YACjB,OAAO,EAAE;QACV;QAEA,OAAO,IAAI,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC;IAC5B,CAAC,CAAC,CACF;AACF;;;;"}

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

@@ -3,6 +3,7 @@ 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/get-list/query/filter/missing-behavior.enum.js';
+import '../../../../../enum/decorator/api/controller/get-list/query/pagination-mode.enum.js';
 import '../../../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js';
 import '../../../../../enum/decorator/api/controller/relation-reference-shape.enum.js';
 import '../../../../../enum/decorator/api/controller/request/target.enum.js';

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