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

package/dist/cjs/utility/dto/generate/identity-read-parameters.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-read-parameters.utility.js","sources":["../../../../../../src/utility/dto/generate/identity-read-parameters.utility.ts"],"sourcesContent":[null],"names":["createHash","PROPERTY_DESCRIBE_DECORATOR_API_CONSTANT","ErrorException","DtoBuildDecorator","EApiRouteType","EApiDtoType","Validate"],"mappings":"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"}

package/dist/cjs/utility/dto/generate/index.d.ts

@@ -4,5 +4,5 @@ export { DtoGenerateDecorator } from './decorator.utility';
 export { DtoGenerateDynamic } from './dynamic.utility';
 export { DtoGenerateException } from './exception.utility';
 export { DtoGenerateFilterDecorator } from './filter-decorator.utility';
-export { DtoGenerateGetListResponse } from './get-list-response.utility';
+export { DtoGenerateGetListResponse } from './get-list';
 export { DtoGenerateRelationResponse } from './relation-response.utility';

package/dist/cjs/utility/dto/generate/read-parameters.utility.d.ts

@@ -0,0 +1,17 @@
+import { EApiRouteType } from '../../../enum/decorator/api';
+import { IApiControllerReadPlan } from '../../../interface/class/api/controller/read';
+import { IApiControllerPropertiesRouteAutoDtoConfig } from '../../../interface/decorator/api';
+import { IApiEntity } from '../../../interface/entity';
+import { Type } from '@nestjs/common';
+import { IAuthGuard } from '@nestjs/passport';
+/**
+ * Generates a cached PARAMETERS DTO for route-local inherited read scope.
+ * @template E - Entity type owned by the generated route.
+ * @param {IApiEntity<E>} entityMetadata - Entity metadata used for field decorators.
+ * @param {EApiRouteType} method - Generated GET or GET_LIST route type.
+ * @param {IApiControllerReadPlan} readPlan - Validated route-local read plan.
+ * @param {IApiControllerPropertiesRouteAutoDtoConfig} [dtoConfig] - Optional auto DTO validators.
+ * @param {Type<IAuthGuard>} [currentGuard] - Authentication guard used for field exposure metadata.
+ * @returns {Type<unknown>} Cached generated parameters DTO class.
+ */
+export declare function DtoGenerateReadParameters<E>(entityMetadata: IApiEntity<E>, method: EApiRouteType, readPlan: IApiControllerReadPlan, dtoConfig?: IApiControllerPropertiesRouteAutoDtoConfig, currentGuard?: Type<IAuthGuard>): Type<unknown>;

package/dist/cjs/utility/dto/generate/read-parameters.utility.js

@@ -0,0 +1,111 @@
+'use strict';
+
+require('../../../constant/decorator/api/function.constant.js');
+var propertyDescribe_constant = require('../../../constant/decorator/api/property-describe.constant.js');
+require('../../../enum/decorator/api/action.enum.js');
+require('../../../enum/decorator/api/authentication-type.enum.js');
+require('../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js');
+require('../../../enum/decorator/api/controller/get-list/query/pagination-mode.enum.js');
+require('../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js');
+require('../../../enum/decorator/api/controller/relation-reference-shape.enum.js');
+require('../../../enum/decorator/api/controller/request/target.enum.js');
+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/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');
+var type_enum = require('../../../enum/decorator/api/route/type.enum.js');
+var buildDecorator_utility = require('../build-decorator.utility.js');
+var exception_utility = require('../../error/exception.utility.js');
+var classValidator = require('class-validator');
+
+const readParametersDtoCache = new WeakMap();
+/**
+ * Generates a cached PARAMETERS DTO for route-local inherited read scope.
+ * @template E - Entity type owned by the generated route.
+ * @param {IApiEntity<E>} entityMetadata - Entity metadata used for field decorators.
+ * @param {EApiRouteType} method - Generated GET or GET_LIST route type.
+ * @param {IApiControllerReadPlan} readPlan - Validated route-local read plan.
+ * @param {IApiControllerPropertiesRouteAutoDtoConfig} [dtoConfig] - Optional auto DTO validators.
+ * @param {Type<IAuthGuard>} [currentGuard] - Authentication guard used for field exposure metadata.
+ * @returns {Type<unknown>} Cached generated parameters DTO class.
+ */
+function DtoGenerateReadParameters(entityMetadata, method, readPlan, dtoConfig, currentGuard) {
+    let guardCache = readParametersDtoCache.get(readPlan);
+    if (!guardCache) {
+        guardCache = new Map();
+        readParametersDtoCache.set(readPlan, guardCache);
+    }
+    let dtoConfigCache = guardCache.get(currentGuard);
+    if (!dtoConfigCache) {
+        dtoConfigCache = new Map();
+        guardCache.set(currentGuard, dtoConfigCache);
+    }
+    const cached = dtoConfigCache.get(dtoConfig);
+    if (cached) {
+        return cached;
+    }
+    const parameters = [];
+    if (method === type_enum.EApiRouteType.GET) {
+        const primaryKey = entityMetadata.primaryKey;
+        if (!primaryKey) {
+            throw exception_utility.ErrorException(`Primary key for entity ${String(entityMetadata.name)} not found in metadata storage`);
+        }
+        parameters.push({ field: String(primaryKey.name), parameter: String(primaryKey.name) });
+    }
+    parameters.push(...readPlan.parameters);
+    class GeneratedReadParametersDTO {
+        constructor() {
+            for (const parameter of parameters) {
+                Object.defineProperty(this, parameter.parameter, {
+                    // eslint-disable-next-line @elsikora/typescript/naming-convention
+                    configurable: true,
+                    // eslint-disable-next-line @elsikora/typescript/naming-convention
+                    enumerable: true,
+                    value: undefined,
+                    // eslint-disable-next-line @elsikora/typescript/naming-convention
+                    writable: true,
+                });
+            }
+        }
+    }
+    Object.defineProperty(GeneratedReadParametersDTO, "name", { value: readPlan.schemaName });
+    for (const parameter of parameters) {
+        const column = entityMetadata.columns.find((candidate) => String(candidate.name) === parameter.field);
+        const metadata = column?.metadata?.[propertyDescribe_constant.PROPERTY_DESCRIBE_DECORATOR_API_CONSTANT.METADATA_KEY];
+        if (!column || !metadata) {
+            throw exception_utility.ErrorException(`Metadata for generated read scope field ${parameter.field} not found`);
+        }
+        const decorators = buildDecorator_utility.DtoBuildDecorator(method, metadata, entityMetadata, dtoType_enum.EApiDtoType.PARAMETERS, parameter.parameter, currentGuard);
+        if (decorators) {
+            for (const decorator of decorators) {
+                decorator(GeneratedReadParametersDTO.prototype, parameter.parameter);
+            }
+        }
+    }
+    if (dtoConfig?.validators) {
+        for (const validator of dtoConfig.validators) {
+            classValidator.Validate(validator.constraintClass, validator.options)(GeneratedReadParametersDTO.prototype, "object");
+        }
+    }
+    dtoConfigCache.set(dtoConfig, GeneratedReadParametersDTO);
+    return GeneratedReadParametersDTO;
+}
+
+exports.DtoGenerateReadParameters = DtoGenerateReadParameters;
+//# sourceMappingURL=read-parameters.utility.js.map

package/dist/cjs/utility/dto/generate/read-parameters.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-parameters.utility.js","sources":["../../../../../../src/utility/dto/generate/read-parameters.utility.ts"],"sourcesContent":[null],"names":["EApiRouteTypeValue","ErrorException","PROPERTY_DESCRIBE_DECORATOR_API_CONSTANT","DtoBuildDecorator","EApiDtoType","Validate"],"mappings":"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"}

package/dist/cjs/utility/dto/get/get-list-query-base-class.utility.d.ts

@@ -5,8 +5,9 @@ import { EApiDtoType, EApiRouteType } from '../../../enum/decorator/api';
 import { IApiEntity } from '../../../interface/entity';
 /**
  * Creates a base class for list query DTOs with pagination and sorting properties.
- * Includes limit, orderBy, orderDirection, and page fields with appropriate validation rules
- * to ensure consistent pagination behavior.
+ * Includes limit, mode-specific pagination fields, and applicable sorting properties with
+ * appropriate validation rules. CURSOR omits orderBy and orderDirection when the plan enables
+ * no client-order fields.
  * @param {ObjectLiteral} entity - The entity class or prototype
  * @param {IApiEntity<E>} entityMetadata - The entity metadata containing column information
  * @param {EApiRouteType} method - The API route type (GET_LIST)

package/dist/cjs/utility/dto/get/get-list-query-base-class.utility.js

@@ -1,12 +1,15 @@
 'use strict';
 
 var tslib_es6 = require('../../../external/tslib/tslib.es6.js');
+var apiControllerCursor_constant = require('../../../constant/api-controller-cursor.constant.js');
 var factoryDtoGetListQuery_constant = require('../../../constant/factory-dto-get-list-query.constant.js');
 var enum_decorator = require('../../../decorator/api/property/enum.decorator.js');
 var number_decorator = require('../../../decorator/api/property/number.decorator.js');
+var string_decorator = require('../../../decorator/api/property/string.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');
+var paginationMode_enum = require('../../../enum/decorator/api/controller/get-list/query/pagination-mode.enum.js');
 require('../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js');
 require('../../../enum/decorator/api/controller/relation-reference-shape.enum.js');
 require('../../../enum/decorator/api/controller/request/target.enum.js');
@@ -28,21 +31,25 @@ 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');
 var numberType_enum = require('../../../enum/decorator/api/property/number-type.enum.js');
-require('../../../enum/decorator/api/property/string-type.enum.js');
+var stringType_enum = 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');
 require('../../../enum/filter/operand.enum.js');
 require('../../../enum/filter/operation.enum.js');
 var orderDirection_enum = require('../../../enum/filter/order-direction.enum.js');
+var getPaginationMode_utility = require('../../api/controller/get-list/query/get-pagination-mode.utility.js');
 var filterOrderByFromEntity_utility = require('../../api/filter-order-by-from-entity.utility.js');
 var capitalizeString_utility = require('../../capitalize-string.utility.js');
 var allOrNoneOfListedProperties_validator = require('../../../validator/all-or-none-of-listed-properties.validator.js');
 var classValidator = require('class-validator');
 
+const noopPropertyDecorator = () => undefined;
+const noopApiPropertyEnum = () => noopPropertyDecorator;
 /**
  * Creates a base class for list query DTOs with pagination and sorting properties.
- * Includes limit, orderBy, orderDirection, and page fields with appropriate validation rules
- * to ensure consistent pagination behavior.
+ * Includes limit, mode-specific pagination fields, and applicable sorting properties with
+ * appropriate validation rules. CURSOR omits orderBy and orderDirection when the plan enables
+ * no client-order fields.
  * @param {ObjectLiteral} entity - The entity class or prototype
  * @param {IApiEntity<E>} entityMetadata - The entity metadata containing column information
  * @param {EApiRouteType} method - The API route type (GET_LIST)
@@ -52,16 +59,29 @@ var classValidator = require('class-validator');
  * @template E - The entity type
  */
 function DtoGetGetListQueryBaseClass(entity, entityMetadata, method, dtoType, queryPlan) {
+    const isCursor = getPaginationMode_utility.ApiControllerGetListQueryGetPaginationMode(queryPlan) === paginationMode_enum.EApiControllerGetListQueryPaginationMode.CURSOR;
     const orderBy = queryPlan && !queryPlan.order.isLegacy
         ? Object.fromEntries(Object.values(queryPlan.order.fields)
             .filter((field) => field.isEnabled)
             .map((field) => [field.path, field.path]))
         : filterOrderByFromEntity_utility.FilterOrderByFromEntity(entity, entityMetadata, method, dtoType);
+    const hasClientOrderFields = Object.keys(orderBy).length > 0;
+    const shouldExposeClientOrder = !isCursor || hasClientOrderFields;
+    const clientOrderPropertyDecorator = shouldExposeClientOrder ? enum_decorator.ApiPropertyEnum : noopApiPropertyEnum;
     class BaseQueryDTO {
         limit;
         orderBy;
         orderDirection;
         page;
+        constructor() {
+            if (isCursor) {
+                Reflect.deleteProperty(this, "page");
+                if (!shouldExposeClientOrder) {
+                    Reflect.deleteProperty(this, "orderBy");
+                    Reflect.deleteProperty(this, "orderDirection");
+                }
+            }
+        }
         object() {
             return this;
         }
@@ -80,7 +100,7 @@ function DtoGetGetListQueryBaseClass(entity, entityMetadata, method, dtoType, qu
         tslib_es6.__metadata("design:type", Number)
     ], BaseQueryDTO.prototype, "limit", void 0);
     tslib_es6.__decorate([
-        enum_decorator.ApiPropertyEnum({
+        clientOrderPropertyDecorator({
             description: "order by field",
             entity: entityMetadata,
             enum: orderBy,
@@ -90,7 +110,7 @@ function DtoGetGetListQueryBaseClass(entity, entityMetadata, method, dtoType, qu
         tslib_es6.__metadata("design:type", String)
     ], BaseQueryDTO.prototype, "orderBy", void 0);
     tslib_es6.__decorate([
-        enum_decorator.ApiPropertyEnum({
+        clientOrderPropertyDecorator({
             description: "order direction",
             entity: entityMetadata,
             enum: orderDirection_enum.EFilterOrderDirection,
@@ -99,7 +119,24 @@ function DtoGetGetListQueryBaseClass(entity, entityMetadata, method, dtoType, qu
         }),
         tslib_es6.__metadata("design:type", String)
     ], BaseQueryDTO.prototype, "orderDirection", void 0);
-    tslib_es6.__decorate([
+    if (isCursor) {
+        for (const [property, description] of [
+            ["after", "Cursor after which to return items"],
+            ["before", "Cursor before which to return items"],
+        ]) {
+            string_decorator.ApiPropertyString({
+                description,
+                entity: entityMetadata,
+                exampleValue: "eyJ2IjoxLCJjIjoiLi4uIiwidmFsdWVzIjpbIi4uLiJdfQ",
+                format: stringType_enum.EApiPropertyStringType.STRING,
+                isRequired: false,
+                maxLength: apiControllerCursor_constant.API_CONTROLLER_CURSOR_TOKEN_MAX_LENGTH,
+                minLength: 1,
+                pattern: "/^[A-Za-z0-9_-]+$/",
+            })(BaseQueryDTO.prototype, property);
+        }
+    }
+    else {
         number_decorator.ApiPropertyNumber({
             description: "Page to return",
             entity: entityMetadata,
@@ -109,15 +146,11 @@ function DtoGetGetListQueryBaseClass(entity, entityMetadata, method, dtoType, qu
             maximum: factoryDtoGetListQuery_constant.GET_LIST_QUERY_DTO_FACTORY_CONSTANT.MAXIMUM_LIST_PAGES_COUNT,
             minimum: factoryDtoGetListQuery_constant.GET_LIST_QUERY_DTO_FACTORY_CONSTANT.MINIMUM_LIST_PAGES_COUNT,
             multipleOf: factoryDtoGetListQuery_constant.GET_LIST_QUERY_DTO_FACTORY_CONSTANT.LIST_MULTIPLE_OF,
-        }),
-        tslib_es6.__metadata("design:type", Number)
-    ], BaseQueryDTO.prototype, "page", void 0);
-    tslib_es6.__decorate([
-        classValidator.Validate(allOrNoneOfListedProperties_validator.AllOrNoneOfListedPropertiesValidator, ["orderBy", "orderDirection"]),
-        tslib_es6.__metadata("design:type", Function),
-        tslib_es6.__metadata("design:paramtypes", []),
-        tslib_es6.__metadata("design:returntype", Object)
-    ], BaseQueryDTO.prototype, "object", null);
+        })(BaseQueryDTO.prototype, "page");
+    }
+    if (shouldExposeClientOrder) {
+        classValidator.Validate(allOrNoneOfListedProperties_validator.AllOrNoneOfListedPropertiesValidator, ["orderBy", "orderDirection"])(BaseQueryDTO.prototype, "object");
+    }
     return BaseQueryDTO;
 }
 

package/dist/cjs/utility/dto/get/get-list-query-base-class.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-list-query-base-class.utility.js","sources":["../../../../../../src/utility/dto/get/get-list-query-base-class.utility.ts"],"sourcesContent":[null],"names":["FilterOrderByFromEntity","__decorate","ApiPropertyNumber","GET_LIST_QUERY_DTO_FACTORY_CONSTANT","EApiPropertyNumberType","ApiPropertyEnum","CapitalizeString","EFilterOrderDirection","Validate","AllOrNoneOfListedPropertiesValidator"],"mappings":"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"}
+{"version":3,"file":"get-list-query-base-class.utility.js","sources":["../../../../../../src/utility/dto/get/get-list-query-base-class.utility.ts"],"sourcesContent":[null],"names":["ApiControllerGetListQueryGetPaginationMode","EApiControllerGetListQueryPaginationMode","FilterOrderByFromEntity","ApiPropertyEnum","__decorate","ApiPropertyNumber","GET_LIST_QUERY_DTO_FACTORY_CONSTANT","EApiPropertyNumberType","CapitalizeString","EFilterOrderDirection","ApiPropertyString","EApiPropertyStringType","API_CONTROLLER_CURSOR_TOKEN_MAX_LENGTH","Validate","AllOrNoneOfListedPropertiesValidator"],"mappings":"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"}

package/dist/cjs/utility/dto/handle-date-property.utility.js

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

package/dist/cjs/utility/dto/handle-date-property.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"handle-date-property.utility.js","sources":["../../../../../src/utility/dto/handle-date-property.utility.ts"],"sourcesContent":[null],"names":["EApiPropertyDateIdentifier"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA;;;;;;;AAOG;MACU,qBAAqB,GAAG,CAAC,YAAoB,EAAE,UAAsC,KAAqE;AACtK,IAAA,MAAM,SAAS,GAAsH;AACpI,QAAA,CAACA,0CAA0B,CAAC,UAAU,GAAG,EAAE,IAAI,EAAEA,0CAA0B,CAAC,eAAe,EAAE,EAAE,EAAEA,0CAA0B,CAAC,aAAa,EAAE;AAC3I,QAAA,CAACA,0CAA0B,CAAC,WAAW,GAAG,EAAE,IAAI,EAAEA,0CAA0B,CAAC,gBAAgB,EAAE,EAAE,EAAEA,0CAA0B,CAAC,cAAc,EAAE;AAC9I,QAAA,CAACA,0CAA0B,CAAC,UAAU,GAAG,EAAE,IAAI,EAAEA,0CAA0B,CAAC,eAAe,EAAE,EAAE,EAAEA,0CAA0B,CAAC,aAAa,EAAE;KAC3I;IAED,OAAO,SAAS,CAAC,UAAU;AAC1B,UAAE;AACA,YAAA,EAAE,UAAU,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAA,EAAG,YAAY,MAAM,EAAE;AACvE,YAAA,EAAE,UAAU,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAA,EAAG,YAAY,IAAI,EAAE;AACnE;UACA,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;AACxC;;;;"}
+{"version":3,"file":"handle-date-property.utility.js","sources":["../../../../../src/utility/dto/handle-date-property.utility.ts"],"sourcesContent":[null],"names":["EApiPropertyDateIdentifier"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA;;;;;;;AAOG;MACU,qBAAqB,GAAG,CAAC,YAAoB,EAAE,UAAsC,KAAqE;AACtK,IAAA,MAAM,SAAS,GAAsH;AACpI,QAAA,CAACA,0CAA0B,CAAC,UAAU,GAAG,EAAE,IAAI,EAAEA,0CAA0B,CAAC,eAAe,EAAE,EAAE,EAAEA,0CAA0B,CAAC,aAAa,EAAE;AAC3I,QAAA,CAACA,0CAA0B,CAAC,WAAW,GAAG,EAAE,IAAI,EAAEA,0CAA0B,CAAC,gBAAgB,EAAE,EAAE,EAAEA,0CAA0B,CAAC,cAAc,EAAE;AAC9I,QAAA,CAACA,0CAA0B,CAAC,UAAU,GAAG,EAAE,IAAI,EAAEA,0CAA0B,CAAC,eAAe,EAAE,EAAE,EAAEA,0CAA0B,CAAC,aAAa,EAAE;KAC3I;IAED,OAAO,SAAS,CAAC,UAAU;AAC1B,UAAE;AACA,YAAA,EAAE,UAAU,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAA,EAAG,YAAY,MAAM,EAAE;AACvE,YAAA,EAAE,UAAU,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAA,EAAG,YAAY,IAAI,EAAE;AACnE;UACA,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;AACxC;;;;"}

package/dist/cjs/utility/dto/is/property/infrastructure-timestamp.utility.js

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

package/dist/cjs/utility/dto/is/property/infrastructure-timestamp.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"infrastructure-timestamp.utility.js","sources":["../../../../../../../src/utility/dto/is/property/infrastructure-timestamp.utility.ts"],"sourcesContent":[null],"names":["EApiPropertyDescribeType","DTO_UTILITY_CONSTANT"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKA;;;;AAIG;AACG,SAAU,oCAAoC,CAAC,gBAAgD,EAAA;IACpG,IAAI,gBAAgB,CAAC,IAAI,KAAKA,yCAAwB,CAAC,IAAI,EAAE;AAC5D,QAAA,OAAO,KAAK;IACb;IAEA,OAAOC,6BAAoB,CAAC,oCAAoC,CAAC,QAAQ,CAAC,gBAAgB,CAAC,UAAU,CAAC;AACvG;;;;"}
+{"version":3,"file":"infrastructure-timestamp.utility.js","sources":["../../../../../../../src/utility/dto/is/property/infrastructure-timestamp.utility.ts"],"sourcesContent":[null],"names":["EApiPropertyDescribeType","DTO_UTILITY_CONSTANT"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKA;;;;AAIG;AACG,SAAU,oCAAoC,CAAC,gBAAgD,EAAA;IACpG,IAAI,gBAAgB,CAAC,IAAI,KAAKA,yCAAwB,CAAC,IAAI,EAAE;AAC5D,QAAA,OAAO,KAAK;IACb;IAEA,OAAOC,6BAAoB,CAAC,oCAAoC,CAAC,QAAQ,CAAC,gBAAgB,CAAC,UAAU,CAAC;AACvG;;;;"}

package/dist/cjs/utility/dto/is/property/should-be-marked.utility.js

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

package/dist/cjs/utility/dto/is/property/should-be-marked.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"should-be-marked.utility.js","sources":["../../../../../../../src/utility/dto/is/property/should-be-marked.utility.ts"],"sourcesContent":[null],"names":["EApiDtoType","EApiRouteType","DtoIsPropertyInfrastructureTimestamp","DtoIsPropertyExposedForGuard","EApiPropertyDescribeType"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA;;;;;;;;;AASG;AACG,SAAU,2BAA2B,CAAC,MAAqB,EAAE,OAAoB,EAAE,aAAqB,EAAE,gBAAgD,EAAE,SAAkB,EAAE,YAA+B,EAAA;IACpN,MAAM,WAAW,GAAY,OAAO,KAAKA,wBAAW,CAAC,IAAI,KAAK,MAAM,KAAKC,uBAAa,CAAC,MAAM,IAAI,MAAM,KAAKA,uBAAa,CAAC,MAAM,IAAI,MAAM,KAAKA,uBAAa,CAAC,cAAc,CAAC;AAE5K,IAAA,IAAI,WAAW,IAAIC,oEAAoC,CAAC,gBAAgB,CAAC,EAAE;AAC1E,QAAA,OAAO,KAAK;IACb;IAEA,MAAM,UAAU,GAAuE,gBAAgB,CAAC,UAAU,GAAG,MAAM,CAAuE;IAElM,IAAI,UAAU,GAAG,OAAO,CAAC,EAAE,SAAS,KAAK,KAAK,EAAE;AAC/C,QAAA,OAAO,KAAK;IACb;AAEA,IAAA,IAAI,CAACC,oDAA4B,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE;AACnF,QAAA,OAAO,KAAK;IACb;AAEA,IAAA,IAAI,OAAO,KAAKH,wBAAW,CAAC,KAAK,IAAI,gBAAgB,CAAC,IAAI,KAAKI,yCAAwB,CAAC,MAAM,EAAE;AAC/F,QAAA,OAAO,KAAK;IACb;IAEA,IAAI,OAAO,KAAKJ,wBAAW,CAAC,UAAU,IAAI,SAAS,EAAE;AACpD,QAAA,OAAO,IAAI;IACZ;AAEA,IAAA,IAAI,CAAC,OAAO,KAAKA,wBAAW,CAAC,KAAK,IAAI,OAAO,KAAKA,wBAAW,CAAC,IAAI,KAAK,CAAC,SAAS,EAAE;AAClF,QAAA,OAAO,IAAI;IACZ;AAEA,IAAA,OAAO,OAAO,KAAKA,wBAAW,CAAC,UAAU,IAAI,OAAO,KAAKA,wBAAW,CAAC,KAAK,IAAI,OAAO,KAAKA,wBAAW,CAAC,IAAI;AAC3G;;;;"}
+{"version":3,"file":"should-be-marked.utility.js","sources":["../../../../../../../src/utility/dto/is/property/should-be-marked.utility.ts"],"sourcesContent":[null],"names":["EApiDtoType","EApiRouteType","DtoIsPropertyInfrastructureTimestamp","DtoIsPropertyExposedForGuard","EApiPropertyDescribeType"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA;;;;;;;;;AASG;AACG,SAAU,2BAA2B,CAAC,MAAqB,EAAE,OAAoB,EAAE,aAAqB,EAAE,gBAAgD,EAAE,SAAkB,EAAE,YAA+B,EAAA;IACpN,MAAM,WAAW,GAAY,OAAO,KAAKA,wBAAW,CAAC,IAAI,KAAK,MAAM,KAAKC,uBAAa,CAAC,MAAM,IAAI,MAAM,KAAKA,uBAAa,CAAC,MAAM,IAAI,MAAM,KAAKA,uBAAa,CAAC,cAAc,CAAC;AAE5K,IAAA,IAAI,WAAW,IAAIC,oEAAoC,CAAC,gBAAgB,CAAC,EAAE;AAC1E,QAAA,OAAO,KAAK;IACb;IAEA,MAAM,UAAU,GAAuE,gBAAgB,CAAC,UAAU,GAAG,MAAM,CAAuE;IAElM,IAAI,UAAU,GAAG,OAAO,CAAC,EAAE,SAAS,KAAK,KAAK,EAAE;AAC/C,QAAA,OAAO,KAAK;IACb;AAEA,IAAA,IAAI,CAACC,oDAA4B,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE;AACnF,QAAA,OAAO,KAAK;IACb;AAEA,IAAA,IAAI,OAAO,KAAKH,wBAAW,CAAC,KAAK,IAAI,gBAAgB,CAAC,IAAI,KAAKI,yCAAwB,CAAC,MAAM,EAAE;AAC/F,QAAA,OAAO,KAAK;IACb;IAEA,IAAI,OAAO,KAAKJ,wBAAW,CAAC,UAAU,IAAI,SAAS,EAAE;AACpD,QAAA,OAAO,IAAI;IACZ;AAEA,IAAA,IAAI,CAAC,OAAO,KAAKA,wBAAW,CAAC,KAAK,IAAI,OAAO,KAAKA,wBAAW,CAAC,IAAI,KAAK,CAAC,SAAS,EAAE;AAClF,QAAA,OAAO,IAAI;IACZ;AAEA,IAAA,OAAO,OAAO,KAAKA,wBAAW,CAAC,UAAU,IAAI,OAAO,KAAKA,wBAAW,CAAC,KAAK,IAAI,OAAO,KAAKA,wBAAW,CAAC,IAAI;AAC3G;;;;"}

package/dist/cjs/utility/dto/is/should-be-generated.utility.js

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

package/dist/cjs/utility/dto/is/should-be-generated.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"should-be-generated.utility.js","sources":["../../../../../../src/utility/dto/is/should-be-generated.utility.ts"],"sourcesContent":[null],"names":["EApiDtoType","EApiRouteType"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA;;;;;;;;;AASG;MACU,sBAAsB,GAAG,CAAC,MAAqB,EAAE,OAAoB,KAAa;IAC9F,QAAQ,OAAO;AACd,QAAA,KAAKA,wBAAW,CAAC,IAAI,EAAE;AACtB,YAAA,OAAO,CAACC,uBAAa,CAAC,MAAM,EAAEA,uBAAa,CAAC,cAAc,EAAEA,uBAAa,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QACnG;AAEA,QAAA,KAAKD,wBAAW,CAAC,UAAU,EAAE;YAC5B,OAAO,CAACC,uBAAa,CAAC,MAAM,EAAEA,uBAAa,CAAC,GAAG,EAAEA,uBAAa,CAAC,cAAc,EAAEA,uBAAa,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QACtH;AAEA,QAAA,KAAKD,wBAAW,CAAC,KAAK,EAAE;AACvB,YAAA,OAAO,MAAM,KAAKC,uBAAa,CAAC,QAAQ;QACzC;AAEA,QAAA,KAAKD,wBAAW,CAAC,QAAQ,EAAE;AAC1B,YAAA,OAAO,MAAM,KAAKC,uBAAa,CAAC,MAAM;QACvC;QAEA,SAAS;AACR,YAAA,OAAO,KAAK;QACb;;AAEF;;;;"}
+{"version":3,"file":"should-be-generated.utility.js","sources":["../../../../../../src/utility/dto/is/should-be-generated.utility.ts"],"sourcesContent":[null],"names":["EApiDtoType","EApiRouteType"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA;;;;;;;;;AASG;MACU,sBAAsB,GAAG,CAAC,MAAqB,EAAE,OAAoB,KAAa;IAC9F,QAAQ,OAAO;AACd,QAAA,KAAKA,wBAAW,CAAC,IAAI,EAAE;AACtB,YAAA,OAAO,CAACC,uBAAa,CAAC,MAAM,EAAEA,uBAAa,CAAC,cAAc,EAAEA,uBAAa,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QACnG;AAEA,QAAA,KAAKD,wBAAW,CAAC,UAAU,EAAE;YAC5B,OAAO,CAACC,uBAAa,CAAC,MAAM,EAAEA,uBAAa,CAAC,GAAG,EAAEA,uBAAa,CAAC,cAAc,EAAEA,uBAAa,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QACtH;AAEA,QAAA,KAAKD,wBAAW,CAAC,KAAK,EAAE;AACvB,YAAA,OAAO,MAAM,KAAKC,uBAAa,CAAC,QAAQ;QACzC;AAEA,QAAA,KAAKD,wBAAW,CAAC,QAAQ,EAAE;AAC1B,YAAA,OAAO,MAAM,KAAKC,uBAAa,CAAC,MAAM;QACvC;QAEA,SAAS;AACR,YAAA,OAAO,KAAK;QACb;;AAEF;;;;"}

package/dist/cjs/utility/object-find-property-descriptor.utility.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Finds the nearest own descriptor for a property across an object's prototype chain.
+ * @param {object} source - Object whose chain is inspected.
+ * @param {PropertyKey} key - Property key to resolve.
+ * @returns {PropertyDescriptor | undefined} Nearest descriptor, if present.
+ */
+export declare function ObjectFindPropertyDescriptor(source: object, key: PropertyKey): PropertyDescriptor | undefined;

package/dist/cjs/utility/object-find-property-descriptor.utility.js

@@ -0,0 +1,22 @@
+'use strict';
+
+/**
+ * Finds the nearest own descriptor for a property across an object's prototype chain.
+ * @param {object} source - Object whose chain is inspected.
+ * @param {PropertyKey} key - Property key to resolve.
+ * @returns {PropertyDescriptor | undefined} Nearest descriptor, if present.
+ */
+function ObjectFindPropertyDescriptor(source, key) {
+    let current = source;
+    while (current) {
+        const descriptor = Object.getOwnPropertyDescriptor(current, key);
+        if (descriptor) {
+            return descriptor;
+        }
+        current = Object.getPrototypeOf(current);
+    }
+    return undefined;
+}
+
+exports.ObjectFindPropertyDescriptor = ObjectFindPropertyDescriptor;
+//# sourceMappingURL=object-find-property-descriptor.utility.js.map

package/dist/cjs/utility/object-find-property-descriptor.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-find-property-descriptor.utility.js","sources":["../../../../src/utility/object-find-property-descriptor.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;AAKG;AACG,SAAU,4BAA4B,CAAC,MAAc,EAAE,GAAgB,EAAA;IAC5E,IAAI,OAAO,GAAkB,MAAM;IAEnC,OAAO,OAAO,EAAE;QACf,MAAM,UAAU,GAAmC,MAAM,CAAC,wBAAwB,CAAC,OAAO,EAAE,GAAG,CAAC;QAEhG,IAAI,UAAU,EAAE;AACf,YAAA,OAAO,UAAU;QAClB;AAEA,QAAA,OAAO,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,CAAkB;IAC1D;AAEA,IAAA,OAAO,SAAS;AACjB;;;;"}

package/dist/cjs/validator/at-most-one-of-listed-properties.validator.d.ts

@@ -0,0 +1,5 @@
+import { ValidationArguments, ValidatorConstraintInterface } from 'class-validator';
+export declare class AtMostOneOfListedPropertiesValidator implements ValidatorConstraintInterface {
+    defaultMessage(properties: ValidationArguments): string;
+    validate(_value: unknown, properties: ValidationArguments): boolean;
+}

package/dist/cjs/validator/at-most-one-of-listed-properties.validator.js

@@ -0,0 +1,21 @@
+'use strict';
+
+var tslib_es6 = require('../external/tslib/tslib.es6.js');
+var classValidator = require('class-validator');
+
+// eslint-disable-next-line @elsikora/typescript/naming-convention
+exports.AtMostOneOfListedPropertiesValidator = class AtMostOneOfListedPropertiesValidator {
+    defaultMessage(properties) {
+        return `at most one of the following properties may be provided: ${properties.constraints.join(", ")}`;
+    }
+    validate(_value, properties) {
+        const constraints = properties.constraints;
+        const object = properties.object;
+        const definedCount = constraints.filter((field) => Object.hasOwn(object, field) && object[field] !== undefined).length;
+        return definedCount <= 1;
+    }
+};
+exports.AtMostOneOfListedPropertiesValidator = tslib_es6.__decorate([
+    classValidator.ValidatorConstraint({ async: false, name: "at-most-one-of-listed-properties" })
+], exports.AtMostOneOfListedPropertiesValidator);
+//# sourceMappingURL=at-most-one-of-listed-properties.validator.js.map

package/dist/cjs/validator/at-most-one-of-listed-properties.validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"at-most-one-of-listed-properties.validator.js","sources":["../../../../src/validator/at-most-one-of-listed-properties.validator.ts"],"sourcesContent":[null],"names":["AtMostOneOfListedPropertiesValidator","__decorate","ValidatorConstraint"],"mappings":";;;;;AAIA;AAEaA,4CAAoC,GAA1C,MAAM,oCAAoC,CAAA;AAChD,IAAA,cAAc,CAAC,UAA+B,EAAA;QAC7C,OAAO,CAAA,yDAAA,EAA4D,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAE;IACvG;IAEA,QAAQ,CAAC,MAAe,EAAE,UAA+B,EAAA;AACxD,QAAA,MAAM,WAAW,GAAkB,UAAU,CAAC,WAA4B;AAC1E,QAAA,MAAM,MAAM,GAA4B,UAAU,CAAC,MAAiC;AACpF,QAAA,MAAM,YAAY,GAAW,WAAW,CAAC,MAAM,CAAC,CAAC,KAAa,KAAc,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,CAAC,MAAM;QAE/I,OAAO,YAAY,IAAI,CAAC;IACzB;;AAXYA,4CAAoC,GAAAC,oBAAA,CAAA;IADhDC,kCAAmB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,kCAAkC,EAAE;AAClE,CAAA,EAAAF,4CAAoC,CAYhD;;"}

package/dist/esm/class/api/authorization/guard.class.d.ts

@@ -8,6 +8,7 @@ export declare class ApiAuthorizationGuard implements CanActivate {
     private isControllerSecurable;
     private resolveControllerProperties;
     private resolveHeaders;
+    private resolveIdentityParameters;
     private resolveRequestMetadata;
     private resolveRouteMetadata;
 }

package/dist/esm/class/api/authorization/guard.class.js

@@ -16,6 +16,7 @@ import '../../../enum/class/authorization/policy/status.enum.js';
 import '../../../enum/class/authorization/principal-type.enum.js';
 import { Injectable, ForbiddenException } from '@nestjs/common';
 import { ErrorException } from '../../../utility/error/exception.utility.js';
+import { ApiControllerIdentityPlanGet } from '../../../utility/api/controller/identity/plan/get.utility.js';
 import { LoggerUtility } from '../../../utility/logger.utility.js';
 
 const authorizationGuardLogger = LoggerUtility.getLogger("ApiAuthorizationGuard");
@@ -40,7 +41,8 @@ let ApiAuthorizationGuard = class ApiAuthorizationGuard {
         authorizationGuardLogger.verbose(`Evaluating authorization for entity "${entityConstructor.name}" action "${action}"`);
         const request = context.switchToHttp().getRequest();
         const authenticationRequest = request;
-        const requestMetadata = this.resolveRequestMetadata(request);
+        const identityPlan = ApiControllerIdentityPlanGet(context.getHandler());
+        const requestMetadata = this.resolveRequestMetadata(request, identityPlan);
         const decision = await this.runtime.evaluate({
             action,
             authenticationRequest,
@@ -87,12 +89,46 @@ let ApiAuthorizationGuard = class ApiAuthorizationGuard {
         }
         return resolvedHeaders;
     }
-    resolveRequestMetadata(request) {
+    resolveIdentityParameters(parameters, identityPlan) {
+        if (!parameters || typeof parameters !== "object") {
+            return undefined;
+        }
+        const resolvedParameters = {};
+        for (const key of Reflect.ownKeys(parameters)) {
+            const descriptor = Object.getOwnPropertyDescriptor(parameters, key);
+            if (!descriptor?.enumerable || !("value" in descriptor)) {
+                continue;
+            }
+            Object.defineProperty(resolvedParameters, key, {
+                // eslint-disable-next-line @elsikora/typescript/naming-convention
+                configurable: true,
+                // eslint-disable-next-line @elsikora/typescript/naming-convention
+                enumerable: true,
+                value: descriptor.value,
+                // eslint-disable-next-line @elsikora/typescript/naming-convention
+                writable: true,
+            });
+        }
+        const identityDescriptor = Object.getOwnPropertyDescriptor(resolvedParameters, identityPlan.parameter);
+        if (identityDescriptor && "value" in identityDescriptor) {
+            Object.defineProperty(resolvedParameters, identityPlan.field, {
+                // eslint-disable-next-line @elsikora/typescript/naming-convention
+                configurable: true,
+                // eslint-disable-next-line @elsikora/typescript/naming-convention
+                enumerable: true,
+                value: identityDescriptor.value,
+                // eslint-disable-next-line @elsikora/typescript/naming-convention
+                writable: true,
+            });
+        }
+        return resolvedParameters;
+    }
+    resolveRequestMetadata(request, identityPlan) {
         return {
             body: request.body,
             headers: this.resolveHeaders(request.headers),
             ip: typeof request.ip === "string" ? request.ip : undefined,
-            parameters: request.params,
+            parameters: identityPlan ? this.resolveIdentityParameters(request.params, identityPlan) : request.params,
             query: request.query,
         };
     }

package/dist/esm/class/api/authorization/guard.class.js.map

@@ -1 +1 @@
-{"version":3,"file":"guard.class.js","sources":["../../../../../../src/class/api/authorization/guard.class.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AAkBA,MAAM,wBAAwB,GAAkB,aAAa,CAAC,SAAS,CAAC,uBAAuB,CAAC;AAGzF,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB,CAAA;AACG,IAAA,OAAA;AAApC,IAAA,WAAA,CAAoC,OAAgC,EAAA;QAAhC,IAAA,CAAA,OAAO,GAAP,OAAO;IAA4B;IAEhE,MAAM,WAAW,CAAC,OAAyB,EAAA;QACjD,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,EAAE;AACzC,YAAA,wBAAwB,CAAC,KAAK,CAAC,6EAA6E,CAAC;AAE7G,YAAA,OAAO,IAAI;QACZ;QAEA,MAAM,UAAU,GAAyD,IAAI,CAAC,2BAA2B,CAAC,OAAO,CAAC;AAElH,QAAA,IAAI,CAAC,UAAU,EAAE,aAAa,EAAE;AAC/B,YAAA,wBAAwB,CAAC,KAAK,CAAC,+EAA+E,CAAC;AAE/G,YAAA,MAAM,cAAc,CAAC,+EAA+E,CAAC;QACtG;QAEA,MAAM,aAAa,GAAsC,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC;AAC3F,QAAA,MAAM,iBAAiB,GAA6B,aAAa,CAAC,QAAQ,CAAC,MAAM;AACjF,QAAA,MAAM,MAAM,GAAW,aAAa,CAAC,QAAQ,CAAC,MAAM;QACpD,wBAAwB,CAAC,OAAO,CAAC,CAAA,qCAAA,EAAwC,iBAAiB,CAAC,IAAI,CAAA,UAAA,EAAa,MAAM,CAAA,CAAA,CAAG,CAAC;QAEtH,MAAM,OAAO,GAAkC,OAAO,CAAC,YAAY,EAAE,CAAC,UAAU,EAAiC;QACjH,MAAM,qBAAqB,GAA8B,OAA+C;QACxG,MAAM,eAAe,GAAqD,IAAI,CAAC,sBAAsB,CAAiB,OAAO,CAAC;QAE9H,MAAM,QAAQ,GAAqG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;YAC9I,MAAM;YACN,qBAAqB;YACrB,aAAa,EAAE,UAAU,CAAC,aAAa;AACvC,YAAA,MAAM,EAAE,iBAAiB;YACzB,eAAe;AACf,YAAA,QAAQ,EAAE,SAAS;AACnB,YAAA,kBAAkB,EAAE,aAAa,CAAC,QAAQ,EAAE,aAAa;AACzD,YAAA,SAAS,EAAE,aAAa,CAAC,KAAK,CAAC,IAAI;AACnC,SAAA,CAAC;AAEF,QAAA,IAAI,CAAC,uBAAuB,CAAC,OAAO,EAAE,QAAQ,CAAC;QAE/C,IAAI,QAAQ,CAAC,MAAM,KAAK,gBAAgB,CAAC,IAAI,EAAE;AAC9C,YAAA,wBAAwB,CAAC,IAAI,CAAC,CAAA,0BAAA,EAA6B,iBAAiB,CAAC,IAAI,CAAA,UAAA,EAAa,MAAM,CAAA,aAAA,EAAgB,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAA,CAAA,CAAG,CAAC;YAE7I,MAAM,IAAI,kBAAkB,EAAE;QAC/B;AAEA,QAAA,wBAAwB,CAAC,OAAO,CAAC,CAAA,2BAAA,EAA8B,iBAAiB,CAAC,IAAI,CAAA,UAAA,EAAa,MAAM,CAAA,aAAA,EAAgB,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAA,CAAA,CAAG,CAAC;AAEjJ,QAAA,OAAO,IAAI;IACZ;IAEQ,uBAAuB,CAAI,OAAsC,EAAE,QAAsD,EAAA;AAChI,QAAA,OAAO,CAAC,qBAAqB,GAAG,QAA8D;AAC9F,QAAA,OAAO,CAAC,wCAAwC,CAAC,WAAW,CAAC,GAAG,QAAQ;IACzE;AAEQ,IAAA,qBAAqB,CAAC,OAAyB,EAAA;AACtD,QAAA,OAAO,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,iCAAiC,CAAC,sBAAsB,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAClH;AAEQ,IAAA,2BAA2B,CAAC,OAAyB,EAAA;AAC5D,QAAA,OAAO,OAAO,CAAC,WAAW,CAAC,iCAAiC,CAAC,uBAAuB,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAyD;IAClK;AAEQ,IAAA,cAAc,CAAC,OAAiD,EAAA;QACvE,IAAI,CAAC,OAAO,EAAE;AACb,YAAA,OAAO,SAAS;QACjB;QAEA,MAAM,eAAe,GAA2B,EAAE;AAElD,QAAA,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;AACnD,YAAA,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;AAC9B,gBAAA,eAAe,CAAC,GAAG,CAAC,GAAG,KAAK;YAC7B;AAEA,YAAA,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;AACzB,gBAAA,MAAM,mBAAmB,GAAuB,KAAK,CAAC,IAAI,CAAC,CAAC,WAAoB,KAA4B,OAAO,WAAW,KAAK,QAAQ,CAAC;gBAE5I,IAAI,mBAAmB,EAAE;AACxB,oBAAA,eAAe,CAAC,GAAG,CAAC,GAAG,mBAAmB;gBAC3C;YACD;QACD;AAEA,QAAA,OAAO,eAAe;IACvB;AAEQ,IAAA,sBAAsB,CAA2B,OAAsC,EAAA;QAC9F,OAAO;YACN,IAAI,EAAE,OAAO,CAAC,IAAkC;YAChD,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC;AAC7C,YAAA,EAAE,EAAE,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ,GAAG,OAAO,CAAC,EAAE,GAAG,SAAS;YAC3D,UAAU,EAAE,OAAO,CAAC,MAAgC;YACpD,KAAK,EAAE,OAAO,CAAC,KAAkD;SACjE;IACF;AAEQ,IAAA,oBAAoB,CAAC,OAAyB,EAAA;AACrD,QAAA,MAAM,QAAQ,GAAkD,OAAO,CAAC,WAAW,CAAC,6BAA6B,CAAC,kBAAkB,EAAE,OAAO,CAAC,UAAU,EAAE,CAAkD;QAE5M,IAAI,QAAQ,EAAE;AACb,YAAA,OAAO,QAAQ;QAChB;QAEA,MAAM,WAAW,GAAW,OAAO,CAAC,UAAU,EAAE,CAAC,IAAI,IAAI,SAAS;AAClE,QAAA,wBAAwB,CAAC,KAAK,CAAC,mCAAmC,WAAW,CAAA,wCAAA,CAA0C,CAAC;AAExH,QAAA,MAAM,cAAc,CAAC,CAAA,gCAAA,EAAmC,WAAW,CAAA,wCAAA,CAA0C,CAAC;IAC/G;;AA7GY,qBAAqB,GAAA,UAAA,CAAA;AADjC,IAAA,UAAU,EAAE;qCAEiC,uBAAuB,CAAA;AADxD,CAAA,EAAA,qBAAqB,CA8GjC;;;;"}
+{"version":3,"file":"guard.class.js","sources":["../../../../../../src/class/api/authorization/guard.class.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/class/api/authorization/iam/engine.class.d.ts

@@ -1,3 +1,4 @@
+import { EApiControllerGetListQueryPaginationMode } from '../../../../enum/decorator/api';
 import { IApiBaseEntity } from '../../../../interface/api-base-entity.interface';
 import { IApiAuthorizationDecision, IApiAuthorizationPrincipal, IApiAuthorizationRequestMetadata, IApiAuthorizationResourceDefinition, IApiPolicyDocumentRecord, IApiResolvedPolicyAttachments } from '../../../../interface/class/api/authorization';
 import { TApiAuthorizationRuleTransformPayload } from '../../../../type/class/api/authorization/rule/transform-payload.type';
@@ -5,13 +6,13 @@ import { ApiAuthorizationIamQueryPlanner } from './query-planner.class';
 export declare class ApiAuthorizationIamEngine {
     private readonly queryPlanner;
     constructor(queryPlanner: ApiAuthorizationIamQueryPlanner);
-    evaluate<E extends IApiBaseEntity>(options: {
+    evaluate<E extends IApiBaseEntity, M extends EApiControllerGetListQueryPaginationMode = EApiControllerGetListQueryPaginationMode.PAGE>(options: {
         action: string;
         attachments: IApiResolvedPolicyAttachments;
         documents: ReadonlyArray<IApiPolicyDocumentRecord>;
         policyNamespace: string;
         principal: IApiAuthorizationPrincipal;
-        requestMetadata: IApiAuthorizationRequestMetadata<E>;
+        requestMetadata: IApiAuthorizationRequestMetadata<E, M>;
         resource?: E;
         resourceDefinition: IApiAuthorizationResourceDefinition<E>;
     }): Promise<IApiAuthorizationDecision<E, TApiAuthorizationRuleTransformPayload<E>>>;