@elsikora/nestjs-crud-automator 2.10.0 → 3.0.0-dev.1

package/dist/cjs/type/validator/has-paired-custom-suffixes-fields/index.d.ts

@@ -1,2 +1 @@
-export { type THasPairedCustomSuffixesFieldsOperationConfig } from './operation-config.type';
 export { type THasPairedCustomSuffixesFieldsValidationContext } from './validation-context.type';

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

@@ -1,4 +1,5 @@
 import { IApiBaseEntity } from '../../../../interface/api-base-entity.interface';
+import { IApiControllerGetListQueryPlan } from '../../../../interface/class/api/controller/get-list/query';
 import { IApiControllerProperties } from '../../../../interface/decorator/api';
 import { IApiEntity } from '../../../../interface/entity';
 import { TApiControllerPropertiesRoute } from '../../../../type/decorator/api/controller';
@@ -14,8 +15,9 @@ import { EApiRouteType } from '../../../../enum/decorator/api';
  * @param {string} methodName - The name of the method being decorated
  * @param {TApiControllerPropertiesRoute<E, typeof method>} routeConfig - Route-specific configuration
  * @param {Array<MethodDecorator> | Array<PropertyDecorator>} decorators - Additional decorators to apply
+ * @param {IApiControllerGetListQueryPlan} [queryPlan] - Normalized GET_LIST query plan used to emit deep-object filter documentation.
  * @returns {void}
  * @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>): void;
+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;

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

@@ -3,13 +3,21 @@
 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/unlisted-fields.enum.js');
 require('../../../../enum/decorator/api/controller/relation-reference-shape.enum.js');
 require('../../../../enum/decorator/api/controller/request/target.enum.js');
 require('../../../../enum/decorator/api/controller/request/transformer-type.enum.js');
 require('../../../../enum/decorator/api/controller/response-target.enum.js');
 var dtoType_enum = require('../../../../enum/decorator/api/dto-type.enum.js');
+require('../../../../enum/decorator/api/function/context-storage-kind.enum.js');
 require('../../../../enum/decorator/api/function/subscriber-transaction-expectation.enum.js');
-require('../../../../enum/decorator/api/function/transaction-mode.enum.js');
+require('../../../../enum/decorator/api/function/transaction/event-status.enum.js');
+require('../../../../enum/decorator/api/function/transaction/failure-stage.enum.js');
+require('../../../../enum/decorator/api/function/transaction/mode.enum.js');
+require('../../../../enum/decorator/api/function/transaction/outcome.enum.js');
+require('../../../../enum/decorator/api/function/transaction/owner-kind.enum.js');
+require('../../../../enum/decorator/api/function/transaction/trace-type.enum.js');
 require('../../../../enum/decorator/api/function/type.enum.js');
 require('../../../../enum/decorator/api/on-type.enum.js');
 require('../../../../enum/decorator/api/property/data-type.enum.js');
@@ -22,8 +30,10 @@ require('../../../../enum/decorator/api/route/subscriber-authorization-expectati
 var type_enum = require('../../../../enum/decorator/api/route/type.enum.js');
 var common = require('@nestjs/common');
 var buildRouteDocumentation_utility = require('../build-route-documentation.utility.js');
-var dto_utility = require('../get/dto.utility.js');
+var decorators_utility = require('../get-list/query/open-api/decorators.utility.js');
 var exception_utility = require('../../../error/exception.utility.js');
+require('../../../../constant/decorator/api/function.constant.js');
+var dto_utility = require('../get/dto.utility.js');
 
 /**
  * Applies appropriate decorators to controller methods based on the route type.
@@ -35,11 +45,12 @@ var exception_utility = require('../../../error/exception.utility.js');
  * @param {string} methodName - The name of the method being decorated
  * @param {TApiControllerPropertiesRoute<E, typeof method>} routeConfig - Route-specific configuration
  * @param {Array<MethodDecorator> | Array<PropertyDecorator>} decorators - Additional decorators to apply
+ * @param {IApiControllerGetListQueryPlan} [queryPlan] - Normalized GET_LIST query plan used to emit deep-object filter documentation.
  * @returns {void}
  * @throws {Error} If the method type is not implemented
  * @template E - The entity type
  */
-function ApiControllerApplyDecorators(targetMethod, entity, properties, method, methodName, routeConfig, decorators) {
+function ApiControllerApplyDecorators(targetMethod, entity, properties, method, methodName, routeConfig, decorators, queryPlan) {
     const responseDto = dto_utility.ApiControllerGetDto(properties, entity, method, dtoType_enum.EApiDtoType.RESPONSE, routeConfig);
     const customDecorators = [...decorators];
     switch (method) {
@@ -58,6 +69,9 @@ function ApiControllerApplyDecorators(targetMethod, entity, properties, method,
             break;
         }
         case type_enum.EApiRouteType.GET_LIST: {
+            if (queryPlan) {
+                customDecorators.push(...decorators_utility.ApiControllerGetListQueryOpenApiDecorators(queryPlan));
+            }
             customDecorators.push(method_decorator.ApiMethod({
                 metadata: createRouteMetadata(properties, routeConfig, method, common.RequestMethod.GET, "", common.HttpStatus.OK, responseDto, { hasInternalServerError: true, hasNotFound: true, hasUnauthorized: true }),
             }));

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","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":["ApiControllerGetDto","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,5 +1,6 @@
 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 { IApiControllerProperties } from '../../../../interface/decorator/api';
 import { IApiEntity } from '../../../../interface/entity';
 import { TApiControllerPropertiesRoute } from '../../../../type/decorator/api/controller';
@@ -13,7 +14,8 @@ import { TApiControllerPropertiesRoute } from '../../../../type/decorator/api/co
  * @param {EApiRouteType} method - The type of route (CREATE, DELETE, GET, etc.)
  * @param {string} methodName - The name of the method being configured
  * @param {TApiControllerPropertiesRoute<E, typeof method>} routeConfig - Route-specific configuration
+ * @param {IApiControllerGetListQueryPlan} [queryPlan] - Normalized plan used to resolve the route-scoped dynamic QUERY DTO.
  * @returns {void}
  * @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>): void;
+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;

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

@@ -2,13 +2,21 @@
 
 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/unlisted-fields.enum.js');
 require('../../../../enum/decorator/api/controller/relation-reference-shape.enum.js');
 require('../../../../enum/decorator/api/controller/request/target.enum.js');
 require('../../../../enum/decorator/api/controller/request/transformer-type.enum.js');
 require('../../../../enum/decorator/api/controller/response-target.enum.js');
 var dtoType_enum = require('../../../../enum/decorator/api/dto-type.enum.js');
+require('../../../../enum/decorator/api/function/context-storage-kind.enum.js');
 require('../../../../enum/decorator/api/function/subscriber-transaction-expectation.enum.js');
-require('../../../../enum/decorator/api/function/transaction-mode.enum.js');
+require('../../../../enum/decorator/api/function/transaction/event-status.enum.js');
+require('../../../../enum/decorator/api/function/transaction/failure-stage.enum.js');
+require('../../../../enum/decorator/api/function/transaction/mode.enum.js');
+require('../../../../enum/decorator/api/function/transaction/outcome.enum.js');
+require('../../../../enum/decorator/api/function/transaction/owner-kind.enum.js');
+require('../../../../enum/decorator/api/function/transaction/trace-type.enum.js');
 require('../../../../enum/decorator/api/function/type.enum.js');
 require('../../../../enum/decorator/api/on-type.enum.js');
 require('../../../../enum/decorator/api/property/data-type.enum.js');
@@ -34,16 +42,17 @@ var dto_utility = require('../get/dto.utility.js');
  * @param {EApiRouteType} method - The type of route (CREATE, DELETE, GET, etc.)
  * @param {string} methodName - The name of the method being configured
  * @param {TApiControllerPropertiesRoute<E, typeof method>} routeConfig - Route-specific configuration
+ * @param {IApiControllerGetListQueryPlan} [queryPlan] - Normalized plan used to resolve the route-scoped dynamic QUERY DTO.
  * @returns {void}
  * @template E - The entity type
  */
-function ApiControllerApplyMetadata(target, targetPrototype, entity, properties, method, methodName, routeConfig) {
+function ApiControllerApplyMetadata(target, targetPrototype, entity, properties, method, methodName, routeConfig, queryPlan) {
     let parameterIndex = 0;
     let routeArgumentsMetadata = {};
     const parameterTypes = [];
-    const requestDto = dto_utility.ApiControllerGetDto(properties, entity, method, dtoType_enum.EApiDtoType.PARAMETERS, routeConfig);
-    const queryDto = dto_utility.ApiControllerGetDto(properties, entity, method, dtoType_enum.EApiDtoType.QUERY, routeConfig);
-    const bodyDto = dto_utility.ApiControllerGetDto(properties, entity, method, dtoType_enum.EApiDtoType.BODY, routeConfig);
+    const 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);
     if (requestDto) {
         routeArgumentsMetadata = common.assignMetadata(routeArgumentsMetadata, routeParamtypes_enum_js.RouteParamtypes.PARAM, parameterIndex);
         parameterTypes.push(requestDto);

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

@@ -1 +1 @@
-{"version":3,"file":"metadata.utility.js","sources":["../../../../../../../src/utility/api/controller/apply/metadata.utility.ts"],"sourcesContent":[null],"names":["ApiControllerGetDto","EApiDtoType","assignMetadata","RouteParamtypes","ROUTE_ARGS_METADATA","PARAMTYPES_METADATA"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAaA;;;;;;;;;;;;AAYG;AACG,SAAU,0BAA0B,CAA2B,MAAc,EAAE,eAAuB,EAAE,MAAqB,EAAE,UAAuC,EAAE,MAAqB,EAAE,UAAkB,EAAE,WAA4D,EAAA;IACpR,IAAI,cAAc,GAAW,CAAC;IAC9B,IAAI,sBAAsB,GAAY,EAAE;IACxC,MAAM,cAAc,GAAmB,EAAE;AAEzC,IAAA,MAAM,UAAU,GAA8BA,+BAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAEC,wBAAW,CAAC,UAAU,EAAE,WAAW,CAAC;AAClI,IAAA,MAAM,QAAQ,GAA8BD,+BAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAEC,wBAAW,CAAC,KAAK,EAAE,WAAW,CAAC;AAC3H,IAAA,MAAM,OAAO,GAA8BD,+BAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAEC,wBAAW,CAAC,IAAI,EAAE,WAAW,CAAC;IAEzH,IAAI,UAAU,EAAE;QACf,sBAAsB,GAAGC,qBAAc,CAAC,sBAAsB,EAAEC,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":["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;;;;"}

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

@@ -3,13 +3,21 @@
 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/unlisted-fields.enum.js');
 require('../../../enum/decorator/api/controller/relation-reference-shape.enum.js');
 require('../../../enum/decorator/api/controller/request/target.enum.js');
 require('../../../enum/decorator/api/controller/request/transformer-type.enum.js');
 require('../../../enum/decorator/api/controller/response-target.enum.js');
 require('../../../enum/decorator/api/dto-type.enum.js');
+require('../../../enum/decorator/api/function/context-storage-kind.enum.js');
 require('../../../enum/decorator/api/function/subscriber-transaction-expectation.enum.js');
-require('../../../enum/decorator/api/function/transaction-mode.enum.js');
+require('../../../enum/decorator/api/function/transaction/event-status.enum.js');
+require('../../../enum/decorator/api/function/transaction/failure-stage.enum.js');
+require('../../../enum/decorator/api/function/transaction/mode.enum.js');
+require('../../../enum/decorator/api/function/transaction/outcome.enum.js');
+require('../../../enum/decorator/api/function/transaction/owner-kind.enum.js');
+require('../../../enum/decorator/api/function/transaction/trace-type.enum.js');
 require('../../../enum/decorator/api/function/type.enum.js');
 require('../../../enum/decorator/api/on-type.enum.js');
 require('../../../enum/decorator/api/property/data-type.enum.js');

package/dist/cjs/utility/api/controller/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,5 +1,6 @@
 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 { IApiControllerProperties } from '../../../../interface/decorator/api';
 import { IApiEntity } from '../../../../interface/entity';
 import { Type } from '@nestjs/common';
@@ -12,8 +13,9 @@ import { TApiControllerPropertiesRoute } from '../../../../type/decorator/api/co
  * @param {R} method - Route type
  * @param {EApiDtoType} dtoType - DTO kind to resolve
  * @param {TApiControllerPropertiesRoute<E, R>} routeConfig - Route-specific configuration
+ * @param {IApiControllerGetListQueryPlan} [queryPlan] - Route-scoped plan for dynamic GET_LIST QUERY DTO generation.
  * @returns {Type<unknown> | undefined} -The resolved DTO class or undefined if no DTO is configured
  * @template E - Entity type
  * @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>): Type<unknown> | undefined;
+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;

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

@@ -2,13 +2,21 @@
 
 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/unlisted-fields.enum.js');
 require('../../../../enum/decorator/api/controller/relation-reference-shape.enum.js');
 require('../../../../enum/decorator/api/controller/request/target.enum.js');
 require('../../../../enum/decorator/api/controller/request/transformer-type.enum.js');
 require('../../../../enum/decorator/api/controller/response-target.enum.js');
 var dtoType_enum = require('../../../../enum/decorator/api/dto-type.enum.js');
+require('../../../../enum/decorator/api/function/context-storage-kind.enum.js');
 require('../../../../enum/decorator/api/function/subscriber-transaction-expectation.enum.js');
-require('../../../../enum/decorator/api/function/transaction-mode.enum.js');
+require('../../../../enum/decorator/api/function/transaction/event-status.enum.js');
+require('../../../../enum/decorator/api/function/transaction/failure-stage.enum.js');
+require('../../../../enum/decorator/api/function/transaction/mode.enum.js');
+require('../../../../enum/decorator/api/function/transaction/outcome.enum.js');
+require('../../../../enum/decorator/api/function/transaction/owner-kind.enum.js');
+require('../../../../enum/decorator/api/function/transaction/trace-type.enum.js');
 require('../../../../enum/decorator/api/function/type.enum.js');
 require('../../../../enum/decorator/api/on-type.enum.js');
 require('../../../../enum/decorator/api/property/data-type.enum.js');
@@ -26,7 +34,7 @@ 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/dto/manual/property-metadata/decorator.enum.js');
+require('../../../../enum/utility/manual-dto-property-metadata-decorator.enum.js');
 require('@nestjs/common');
 require('class-transformer');
 require('class-validator');
@@ -37,6 +45,7 @@ require('../../../../constant/interface/api/property/default-string-format.const
 require('../../../../validator/is-regular-expression.validator.js');
 require('node:crypto');
 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');
@@ -54,11 +63,12 @@ const getListItemResponseDtoCache = new Map();
  * @param {R} method - Route type
  * @param {EApiDtoType} dtoType - DTO kind to resolve
  * @param {TApiControllerPropertiesRoute<E, R>} routeConfig - Route-specific configuration
+ * @param {IApiControllerGetListQueryPlan} [queryPlan] - Route-scoped plan for dynamic GET_LIST QUERY DTO generation.
  * @returns {Type<unknown> | undefined} -The resolved DTO class or undefined if no DTO is configured
  * @template E - Entity type
  * @template R - Route type
  */
-function ApiControllerGetDto(properties, entity, method, dtoType, routeConfig) {
+function ApiControllerGetDto(properties, entity, method, dtoType, routeConfig, queryPlan) {
     const configuredDto = routeConfig.dto?.[dtoType];
     if (configuredDto) {
         if (method === type_enum.EApiRouteType.GET_LIST && dtoType === dtoType_enum.EApiDtoType.RESPONSE && isGetListResponseDtoConfig(configuredDto)) {
@@ -66,7 +76,8 @@ function ApiControllerGetDto(properties, entity, method, dtoType, routeConfig) {
         }
         return configuredDto;
     }
-    return core_utility.DtoGenerate(properties.entity, entity, method, dtoType, routeConfig.autoDto?.[dtoType], routeConfig.security?.authentication?.guard);
+    const effectiveQueryPlan = method === type_enum.EApiRouteType.GET_LIST && dtoType === dtoType_enum.EApiDtoType.QUERY ? queryPlan : undefined;
+    return core_utility.DtoGenerate(properties.entity, entity, method, dtoType, routeConfig.autoDto?.[dtoType], routeConfig.security?.authentication?.guard, effectiveQueryPlan);
 }
 /**
  * Builds a stable generated wrapper class name for GET_LIST custom item response DTOs.

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

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

package/dist/cjs/utility/api/controller/get-list/query/enum-values.utility.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns canonical enum values while removing TypeScript numeric reverse mappings.
+ * @param {Readonly<Record<string, number | string>>} enumObject - Runtime enum object from property metadata.
+ * @returns {ReadonlyArray<number | string>} Stable unique values accepted by the query contract.
+ */
+export declare function ApiControllerGetListQueryEnumValues(enumObject: Readonly<Record<string, number | string>>): ReadonlyArray<number | string>;

package/dist/cjs/utility/api/controller/get-list/query/enum-values.utility.js

@@ -0,0 +1,19 @@
+'use strict';
+
+/**
+ * Returns canonical enum values while removing TypeScript numeric reverse mappings.
+ * @param {Readonly<Record<string, number | string>>} enumObject - Runtime enum object from property metadata.
+ * @returns {ReadonlyArray<number | string>} Stable unique values accepted by the query contract.
+ */
+function ApiControllerGetListQueryEnumValues(enumObject) {
+    const values = Object.entries(enumObject)
+        .filter(([key, value]) => {
+        const numericKey = Number(key);
+        return !(key.trim() !== "" && Number.isFinite(numericKey) && typeof value === "string" && enumObject[value] === numericKey);
+    })
+        .map(([, value]) => value);
+    return Object.freeze([...new Set(values)]);
+}
+
+exports.ApiControllerGetListQueryEnumValues = ApiControllerGetListQueryEnumValues;
+//# sourceMappingURL=enum-values.utility.js.map

package/dist/cjs/utility/api/controller/get-list/query/enum-values.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum-values.utility.js","sources":["../../../../../../../../src/utility/api/controller/get-list/query/enum-values.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;AAIG;AACG,SAAU,mCAAmC,CAAC,UAAqD,EAAA;AACxG,IAAA,MAAM,MAAM,GAA2B,MAAM,CAAC,OAAO,CAAC,UAAU;SAC9D,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAA4B,KAAa;AAC5D,QAAA,MAAM,UAAU,GAAW,MAAM,CAAC,GAAG,CAAC;AAEtC,QAAA,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,UAAU,CAAC,KAAK,CAAC,KAAK,UAAU,CAAC;AAC5H,IAAA,CAAC;SACA,GAAG,CAAC,CAAC,GAAG,KAAK,CAA4B,KAAsB,KAAK,CAAC;AAEvE,IAAA,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAC3C;;;;"}

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

@@ -0,0 +1,3 @@
+export { ApiControllerGetListQueryEnumValues } from './enum-values.utility';
+export * from './open-api';
+export * from './plan';

package/dist/cjs/utility/api/controller/get-list/query/open-api/decorators.utility.d.ts

@@ -0,0 +1,7 @@
+import { IApiControllerGetListQueryPlan } from '../../../../../../interface/class/api/controller/get-list/query';
+/**
+ * Builds deep-object OpenAPI query decorators from a normalized GET_LIST query plan.
+ * @param {IApiControllerGetListQueryPlan} plan - Immutable query plan shared with DTO generation and runtime parsing.
+ * @returns {Array<MethodDecorator>} Method decorators for enabled typed filter fields.
+ */
+export declare function ApiControllerGetListQueryOpenApiDecorators(plan: IApiControllerGetListQueryPlan): Array<MethodDecorator>;

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

@@ -0,0 +1,101 @@
+'use strict';
+
+var operatorRegistry_constant = require('../../../../../../constant/filter/operator-registry.constant.js');
+var generate_constant = require('../../../../../../constant/utility/dto/generate.constant.js');
+require('../../../../../../enum/decorator/api/action.enum.js');
+require('../../../../../../enum/decorator/api/authentication-type.enum.js');
+var missingBehavior_enum = require('../../../../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.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');
+require('../../../../../../enum/decorator/api/controller/request/transformer-type.enum.js');
+require('../../../../../../enum/decorator/api/controller/response-target.enum.js');
+require('../../../../../../enum/decorator/api/dto-type.enum.js');
+require('../../../../../../enum/decorator/api/function/context-storage-kind.enum.js');
+require('../../../../../../enum/decorator/api/function/subscriber-transaction-expectation.enum.js');
+require('../../../../../../enum/decorator/api/function/transaction/event-status.enum.js');
+require('../../../../../../enum/decorator/api/function/transaction/failure-stage.enum.js');
+require('../../../../../../enum/decorator/api/function/transaction/mode.enum.js');
+require('../../../../../../enum/decorator/api/function/transaction/outcome.enum.js');
+require('../../../../../../enum/decorator/api/function/transaction/owner-kind.enum.js');
+require('../../../../../../enum/decorator/api/function/transaction/trace-type.enum.js');
+require('../../../../../../enum/decorator/api/function/type.enum.js');
+require('../../../../../../enum/decorator/api/on-type.enum.js');
+require('../../../../../../enum/decorator/api/property/data-type.enum.js');
+require('../../../../../../enum/decorator/api/property/date/identifier.enum.js');
+require('../../../../../../enum/decorator/api/property/date/type.enum.js');
+require('../../../../../../enum/decorator/api/property/desribe-type.enum.js');
+require('../../../../../../enum/decorator/api/property/number-type.enum.js');
+require('../../../../../../enum/decorator/api/property/string-type.enum.js');
+require('../../../../../../enum/decorator/api/route/subscriber-authorization-expectation.enum.js');
+require('../../../../../../enum/decorator/api/route/type.enum.js');
+var operand_enum = require('../../../../../../enum/filter/operand.enum.js');
+require('../../../../../../enum/filter/operation.enum.js');
+require('../../../../../../enum/filter/order-direction.enum.js');
+var swagger = require('@nestjs/swagger');
+var valueSchema_utility = require('./value-schema.utility.js');
+
+/**
+ * Builds deep-object OpenAPI query decorators from a normalized GET_LIST query plan.
+ * @param {IApiControllerGetListQueryPlan} plan - Immutable query plan shared with DTO generation and runtime parsing.
+ * @returns {Array<MethodDecorator>} Method decorators for enabled typed filter fields.
+ */
+function ApiControllerGetListQueryOpenApiDecorators(plan) {
+    if (plan.filter.isLegacy) {
+        return [];
+    }
+    const decorators = [];
+    for (const field of Object.values(plan.filter.fields)) {
+        if (!field.isEnabled) {
+            continue;
+        }
+        const valueSchema = valueSchema_utility.ApiControllerGetListQueryOpenApiValueSchema(field.metadata);
+        const branches = field.allowedOperations.map((operation) => {
+            const operand = operatorRegistry_constant.FILTER_OPERATOR_REGISTRY_CONSTANT.OPERATORS[operation].operand;
+            const properties = {
+                operator: {
+                    enum: [operation],
+                    type: "string",
+                },
+            };
+            const required = ["operator"];
+            if (operand === operand_enum.EFilterOperand.VALUE) {
+                properties.value = valueSchema;
+                required.push("value");
+            }
+            if (operand === operand_enum.EFilterOperand.VALUES || operand === operand_enum.EFilterOperand.PAIR) {
+                properties.values = {
+                    items: valueSchema,
+                    maxItems: operand === operand_enum.EFilterOperand.PAIR ? operatorRegistry_constant.FILTER_OPERATOR_REGISTRY_CONSTANT.PAIR_OPERAND_COUNT : generate_constant.DTO_GENERATE_CONSTANT.MAXIMUM_FILTER_PROPERTIES,
+                    minItems: operand === operand_enum.EFilterOperand.PAIR ? operatorRegistry_constant.FILTER_OPERATOR_REGISTRY_CONSTANT.PAIR_OPERAND_COUNT : operatorRegistry_constant.FILTER_OPERATOR_REGISTRY_CONSTANT.VALUES_MINIMUM_OPERAND_COUNT,
+                    type: "array",
+                };
+                required.push("values");
+            }
+            const additionalPropertiesKey = "additionalProperties";
+            const branch = {
+                [additionalPropertiesKey]: false,
+                properties,
+                required,
+                type: "object",
+            };
+            return branch;
+        });
+        const explodeKey = "explode";
+        const requiredKey = "required";
+        const options = {
+            [explodeKey]: true,
+            name: field.path,
+            [requiredKey]: field.missingBehavior === missingBehavior_enum.EApiControllerGetListQueryFilterMissingBehavior.REJECT,
+            schema: {
+                oneOf: branches,
+            },
+            style: "deepObject",
+        };
+        decorators.push(swagger.ApiQuery(options));
+    }
+    return decorators;
+}
+
+exports.ApiControllerGetListQueryOpenApiDecorators = ApiControllerGetListQueryOpenApiDecorators;
+//# sourceMappingURL=decorators.utility.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.utility.js","sources":["../../../../../../../../../src/utility/api/controller/get-list/query/open-api/decorators.utility.ts"],"sourcesContent":[null],"names":["ApiControllerGetListQueryOpenApiValueSchema","FILTER_OPERATOR_REGISTRY_CONSTANT","EFilterOperand","DTO_GENERATE_CONSTANT","EApiControllerGetListQueryFilterMissingBehavior","ApiQuery"],"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,GAAiBA,+DAA2C,CAAC,KAAK,CAAC,QAAQ,CAAC;QAE7F,MAAM,QAAQ,GAAwB,KAAK,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,SAA2B,KAAkB;YAC/G,MAAM,OAAO,GAAmBC,2DAAiC,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,KAAKC,2BAAc,CAAC,KAAK,EAAE;AACrC,gBAAA,UAAU,CAAC,KAAK,GAAG,WAAW;AAC9B,gBAAA,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC;YACvB;AAEA,YAAA,IAAI,OAAO,KAAKA,2BAAc,CAAC,MAAM,IAAI,OAAO,KAAKA,2BAAc,CAAC,IAAI,EAAE;gBACzE,UAAU,CAAC,MAAM,GAAG;AACnB,oBAAA,KAAK,EAAE,WAAW;AAClB,oBAAA,QAAQ,EAAE,OAAO,KAAKA,2BAAc,CAAC,IAAI,GAAGD,2DAAiC,CAAC,kBAAkB,GAAGE,uCAAqB,CAAC,yBAAyB;AAClJ,oBAAA,QAAQ,EAAE,OAAO,KAAKD,2BAAc,CAAC,IAAI,GAAGD,2DAAiC,CAAC,kBAAkB,GAAGA,2DAAiC,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,KAAKG,oEAA+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,CAACC,gBAAQ,CAAC,OAAO,CAAC,CAAC;IACnC;AAEA,IAAA,OAAO,UAAU;AAClB;;;;"}

package/dist/cjs/utility/api/controller/get-list/query/open-api/index.d.ts

@@ -0,0 +1,2 @@
+export { ApiControllerGetListQueryOpenApiDecorators } from './decorators.utility';
+export { ApiControllerGetListQueryOpenApiValueSchema } from './value-schema.utility';

package/dist/cjs/utility/api/controller/get-list/query/open-api/value-schema.utility.d.ts

@@ -0,0 +1,8 @@
+import { SchemaObject } from '@nestjs/swagger/dist/interfaces/open-api-spec.interface';
+import { TApiPropertyDescribeProperties } from '../../../../../../type/decorator/api/property';
+/**
+ * Builds the scalar OpenAPI value schema shared by every operator branch for a field.
+ * @param {TApiPropertyDescribeProperties} metadata - Entity property metadata resolved into the query plan.
+ * @returns {SchemaObject} OpenAPI schema for one scalar filter operand.
+ */
+export declare function ApiControllerGetListQueryOpenApiValueSchema(metadata: TApiPropertyDescribeProperties): SchemaObject;

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

@@ -0,0 +1,83 @@
+'use strict';
+
+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/unlisted-fields.enum.js');
+require('../../../../../../enum/decorator/api/controller/relation-reference-shape.enum.js');
+require('../../../../../../enum/decorator/api/controller/request/target.enum.js');
+require('../../../../../../enum/decorator/api/controller/request/transformer-type.enum.js');
+require('../../../../../../enum/decorator/api/controller/response-target.enum.js');
+require('../../../../../../enum/decorator/api/dto-type.enum.js');
+require('../../../../../../enum/decorator/api/function/context-storage-kind.enum.js');
+require('../../../../../../enum/decorator/api/function/subscriber-transaction-expectation.enum.js');
+require('../../../../../../enum/decorator/api/function/transaction/event-status.enum.js');
+require('../../../../../../enum/decorator/api/function/transaction/failure-stage.enum.js');
+require('../../../../../../enum/decorator/api/function/transaction/mode.enum.js');
+require('../../../../../../enum/decorator/api/function/transaction/outcome.enum.js');
+require('../../../../../../enum/decorator/api/function/transaction/owner-kind.enum.js');
+require('../../../../../../enum/decorator/api/function/transaction/trace-type.enum.js');
+require('../../../../../../enum/decorator/api/function/type.enum.js');
+require('../../../../../../enum/decorator/api/on-type.enum.js');
+require('../../../../../../enum/decorator/api/property/data-type.enum.js');
+require('../../../../../../enum/decorator/api/property/date/identifier.enum.js');
+var type_enum = require('../../../../../../enum/decorator/api/property/date/type.enum.js');
+var desribeType_enum = require('../../../../../../enum/decorator/api/property/desribe-type.enum.js');
+var numberType_enum = 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');
+require('../../../../../../enum/decorator/api/route/type.enum.js');
+var enumValues_utility = require('../enum-values.utility.js');
+var exception_utility = require('../../../../../error/exception.utility.js');
+
+/**
+ * Builds the scalar OpenAPI value schema shared by every operator branch for a field.
+ * @param {TApiPropertyDescribeProperties} metadata - Entity property metadata resolved into the query plan.
+ * @returns {SchemaObject} OpenAPI schema for one scalar filter operand.
+ */
+function ApiControllerGetListQueryOpenApiValueSchema(metadata) {
+    const propertyType = metadata.type;
+    if (propertyType === desribeType_enum.EApiPropertyDescribeType.OBJECT || propertyType === desribeType_enum.EApiPropertyDescribeType.RELATION) {
+        throw exception_utility.ErrorException("GET_LIST query OpenAPI schemas support scalar fields only");
+    }
+    switch (propertyType) {
+        case desribeType_enum.EApiPropertyDescribeType.BOOLEAN: {
+            return { type: "boolean" };
+        }
+        case desribeType_enum.EApiPropertyDescribeType.DATE: {
+            return { format: "format" in metadata ? metadata.format : type_enum.EApiPropertyDateType.DATE_TIME, type: "string" };
+        }
+        case desribeType_enum.EApiPropertyDescribeType.ENUM: {
+            if (!("enum" in metadata)) {
+                throw exception_utility.ErrorException("GET_LIST enum query metadata is unavailable");
+            }
+            const enumValues = enumValues_utility.ApiControllerGetListQueryEnumValues(metadata.enum);
+            const hasNumericValues = enumValues.some((value) => typeof value === "number");
+            const hasStringValues = enumValues.some((value) => typeof value === "string");
+            let valueType;
+            if (!hasNumericValues) {
+                valueType = "string";
+            }
+            else if (!hasStringValues) {
+                valueType = "number";
+            }
+            return {
+                enum: [...enumValues],
+                type: valueType,
+            };
+        }
+        case desribeType_enum.EApiPropertyDescribeType.NUMBER: {
+            const numberFormat = "format" in metadata ? metadata.format : undefined;
+            return { type: numberFormat === numberType_enum.EApiPropertyNumberType.INTEGER ? "integer" : "number" };
+        }
+        case desribeType_enum.EApiPropertyDescribeType.STRING: {
+            return { type: "string" };
+        }
+        case desribeType_enum.EApiPropertyDescribeType.UUID: {
+            return { format: "uuid", type: "string" };
+        }
+    }
+}
+
+exports.ApiControllerGetListQueryOpenApiValueSchema = ApiControllerGetListQueryOpenApiValueSchema;
+//# sourceMappingURL=value-schema.utility.js.map

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

@@ -0,0 +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":["EApiPropertyDescribeType","ErrorException","EApiPropertyDateType","ApiControllerGetListQueryEnumValues","EApiPropertyNumberType"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOA;;;;AAIG;AACG,SAAU,2CAA2C,CAAC,QAAwC,EAAA;AACnG,IAAA,MAAM,YAAY,GAA6B,QAAQ,CAAC,IAAI;AAE5D,IAAA,IAAI,YAAY,KAAKA,yCAAwB,CAAC,MAAM,IAAI,YAAY,KAAKA,yCAAwB,CAAC,QAAQ,EAAE;AAC3G,QAAA,MAAMC,gCAAc,CAAC,2DAA2D,CAAC;IAClF;IAEA,QAAQ,YAAY;AACnB,QAAA,KAAKD,yCAAwB,CAAC,OAAO,EAAE;AACtC,YAAA,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;QAC3B;AAEA,QAAA,KAAKA,yCAAwB,CAAC,IAAI,EAAE;YACnC,OAAO,EAAE,MAAM,EAAE,QAAQ,IAAI,QAAQ,GAAG,QAAQ,CAAC,MAAM,GAAGE,8BAAoB,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC3G;AAEA,QAAA,KAAKF,yCAAwB,CAAC,IAAI,EAAE;AACnC,YAAA,IAAI,EAAE,MAAM,IAAI,QAAQ,CAAC,EAAE;AAC1B,gBAAA,MAAMC,gCAAc,CAAC,6CAA6C,CAAC;YACpE;YAEA,MAAM,UAAU,GAAmCE,sDAAmC,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,KAAKH,yCAAwB,CAAC,MAAM,EAAE;AACrC,YAAA,MAAM,YAAY,GAAuC,QAAQ,IAAI,QAAQ,GAAI,QAAQ,CAAC,MAAiC,GAAG,SAAS;AAEvI,YAAA,OAAO,EAAE,IAAI,EAAE,YAAY,KAAKI,sCAAsB,CAAC,OAAO,GAAG,SAAS,GAAG,QAAQ,EAAE;QACxF;AAEA,QAAA,KAAKJ,yCAAwB,CAAC,MAAM,EAAE;AACrC,YAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC1B;AAEA,QAAA,KAAKA,yCAAwB,CAAC,IAAI,EAAE;YACnC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC1C;;AAEF;;;;"}

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

@@ -0,0 +1,8 @@
+import { IApiControllerGetListQueryPlan } from '../../../../../../interface/class/api/controller/get-list/query';
+/**
+ * Reads the immutable GET_LIST query plan registered for one generated route.
+ * @param {object} target - Generated controller prototype.
+ * @param {string} methodName - Generated route method name.
+ * @returns {IApiControllerGetListQueryPlan | undefined} Registered plan, or undefined for a legacy route.
+ */
+export declare function ApiControllerGetListQueryPlanGet(target: object, methodName: string): IApiControllerGetListQueryPlan | undefined;