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

package/dist/esm/utility/dto/generate/filter-decorator.utility.js

@@ -1,13 +1,21 @@
 import { ApiPropertyEnum } from '../../../decorator/api/property/enum.decorator.js';
 import '../../../enum/decorator/api/action.enum.js';
 import '../../../enum/decorator/api/authentication-type.enum.js';
+import '../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js';
+import '../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js';
 import '../../../enum/decorator/api/controller/relation-reference-shape.enum.js';
 import '../../../enum/decorator/api/controller/request/target.enum.js';
 import '../../../enum/decorator/api/controller/request/transformer-type.enum.js';
 import '../../../enum/decorator/api/controller/response-target.enum.js';
 import '../../../enum/decorator/api/dto-type.enum.js';
+import '../../../enum/decorator/api/function/context-storage-kind.enum.js';
 import '../../../enum/decorator/api/function/subscriber-transaction-expectation.enum.js';
-import '../../../enum/decorator/api/function/transaction-mode.enum.js';
+import '../../../enum/decorator/api/function/transaction/event-status.enum.js';
+import '../../../enum/decorator/api/function/transaction/failure-stage.enum.js';
+import '../../../enum/decorator/api/function/transaction/mode.enum.js';
+import '../../../enum/decorator/api/function/transaction/outcome.enum.js';
+import '../../../enum/decorator/api/function/transaction/owner-kind.enum.js';
+import '../../../enum/decorator/api/function/transaction/trace-type.enum.js';
 import '../../../enum/decorator/api/function/type.enum.js';
 import '../../../enum/decorator/api/on-type.enum.js';
 import '../../../enum/decorator/api/property/data-type.enum.js';
@@ -18,6 +26,7 @@ import '../../../enum/decorator/api/property/number-type.enum.js';
 import '../../../enum/decorator/api/property/string-type.enum.js';
 import '../../../enum/decorator/api/route/subscriber-authorization-expectation.enum.js';
 import '../../../enum/decorator/api/route/type.enum.js';
+import '../../../enum/filter/operand.enum.js';
 import { EFilterOperationUuid, EFilterOperationString, EFilterOperationRelation, EFilterOperationObject, EFilterOperationNumber, EFilterOperationEnum, EFilterOperationDate, EFilterOperationBoolean } from '../../../enum/filter/operation.enum.js';
 import '../../../enum/filter/order-direction.enum.js';
 
@@ -27,10 +36,16 @@ import '../../../enum/filter/order-direction.enum.js';
  * corresponding filter operation enums.
  * @param {TApiPropertyDescribeProperties} metadata - Metadata describing the property
  * @param {IApiEntity<E>} entity - The entity metadata
+ * @param {ReadonlyArray<EFilterOperation>} [allowedOperations] - Optional route-plan operation allowlist.
+ * @param {string} [enumName] - Route-scoped Swagger enum component name.
  * @returns {PropertyDecorator} A decorator that adds the appropriate filter operation enum
  * @template E - The entity type
  */
-function DtoGenerateFilterDecorator(metadata, entity) {
+function DtoGenerateFilterDecorator(metadata, entity, allowedOperations, enumName) {
+    if (allowedOperations) {
+        const operationEnum = Object.fromEntries(allowedOperations.map((operation) => [operation.toUpperCase(), operation]));
+        return ApiPropertyEnum({ description: "description" in metadata ? metadata.description : undefined, entity, enum: operationEnum, enumName: enumName ?? "EFilterOperation", isRequired: false });
+    }
     switch (metadata.type) {
         case EApiPropertyDescribeType.BOOLEAN: {
             return ApiPropertyEnum({ description: metadata.description, entity, enum: EFilterOperationBoolean, enumName: "EFilterOperationBoolean", isRequired: false });

package/dist/esm/utility/dto/generate/filter-decorator.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"filter-decorator.utility.js","sources":["../../../../../../src/utility/dto/generate/filter-decorator.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAOA;;;;;;;;AAQG;AACG,SAAU,0BAA0B,CAAI,QAAwC,EAAE,MAAqB,EAAA;AAC5G,IAAA,QAAQ,QAAQ,CAAC,IAAI;AACpB,QAAA,KAAK,wBAAwB,CAAC,OAAO,EAAE;YACtC,OAAO,eAAe,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,EAAE,QAAQ,EAAE,yBAAyB,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QAC7J;AAEA,QAAA,KAAK,wBAAwB,CAAC,IAAI,EAAE;AACnC,YAAA,OAAO,eAAe,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,sBAAsB,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QACpH;AAEA,QAAA,KAAK,wBAAwB,CAAC,IAAI,EAAE;YACnC,OAAO,eAAe,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,sBAAsB,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QACvJ;AAEA,QAAA,KAAK,wBAAwB,CAAC,MAAM,EAAE;YACrC,OAAO,eAAe,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,EAAE,QAAQ,EAAE,wBAAwB,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QAC3J;AAEA,QAAA,KAAK,wBAAwB,CAAC,MAAM,EAAE;YACrC,OAAO,eAAe,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,EAAE,QAAQ,EAAE,wBAAwB,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QAC3J;AAEA,QAAA,KAAK,wBAAwB,CAAC,QAAQ,EAAE;YACvC,OAAO,eAAe,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,wBAAwB,EAAE,QAAQ,EAAE,0BAA0B,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QAC/J;AAEA,QAAA,KAAK,wBAAwB,CAAC,MAAM,EAAE;YACrC,OAAO,eAAe,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,EAAE,QAAQ,EAAE,wBAAwB,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QAC3J;AAEA,QAAA,KAAK,wBAAwB,CAAC,IAAI,EAAE;YACnC,OAAO,eAAe,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,sBAAsB,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QACvJ;;AAEF;;;;"}
+{"version":3,"file":"filter-decorator.utility.js","sources":["../../../../../../src/utility/dto/generate/filter-decorator.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA;;;;;;;;;;AAUG;AACG,SAAU,0BAA0B,CAAI,QAAwC,EAAE,MAAqB,EAAE,iBAAmD,EAAE,QAAiB,EAAA;IACpL,IAAI,iBAAiB,EAAE;QACtB,MAAM,aAAa,GAAqC,MAAM,CAAC,WAAW,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,SAA2B,KAAiC,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;AAEpM,QAAA,OAAO,eAAe,CAAC,EAAE,WAAW,EAAE,aAAa,IAAI,QAAQ,GAAG,QAAQ,CAAC,WAAW,GAAG,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,IAAI,kBAAkB,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IAChM;AAEA,IAAA,QAAQ,QAAQ,CAAC,IAAI;AACpB,QAAA,KAAK,wBAAwB,CAAC,OAAO,EAAE;YACtC,OAAO,eAAe,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,EAAE,QAAQ,EAAE,yBAAyB,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QAC7J;AAEA,QAAA,KAAK,wBAAwB,CAAC,IAAI,EAAE;AACnC,YAAA,OAAO,eAAe,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,sBAAsB,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QACpH;AAEA,QAAA,KAAK,wBAAwB,CAAC,IAAI,EAAE;YACnC,OAAO,eAAe,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,sBAAsB,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QACvJ;AAEA,QAAA,KAAK,wBAAwB,CAAC,MAAM,EAAE;YACrC,OAAO,eAAe,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,EAAE,QAAQ,EAAE,wBAAwB,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QAC3J;AAEA,QAAA,KAAK,wBAAwB,CAAC,MAAM,EAAE;YACrC,OAAO,eAAe,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,EAAE,QAAQ,EAAE,wBAAwB,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QAC3J;AAEA,QAAA,KAAK,wBAAwB,CAAC,QAAQ,EAAE;YACvC,OAAO,eAAe,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,wBAAwB,EAAE,QAAQ,EAAE,0BAA0B,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QAC/J;AAEA,QAAA,KAAK,wBAAwB,CAAC,MAAM,EAAE;YACrC,OAAO,eAAe,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,EAAE,QAAQ,EAAE,wBAAwB,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QAC3J;AAEA,QAAA,KAAK,wBAAwB,CAAC,IAAI,EAAE;YACnC,OAAO,eAAe,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,sBAAsB,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QACvJ;;AAEF;;;;"}

package/dist/esm/utility/dto/generate/get-list-query-properties.utility.d.ts

@@ -0,0 +1,25 @@
+import { EFilterOperation } from '../../../enum/filter';
+import { IApiControllerGetListQueryPlan } from '../../../interface/class/api/controller/get-list/query';
+import { IApiEntity } from '../../../interface/entity';
+import { Type } from '@nestjs/common';
+import { IAuthGuard } from '@nestjs/passport';
+import { TApiPropertyDescribeProperties } from '../../../type/decorator/api/property';
+/**
+ * Resolves metadata-backed GET_LIST filter properties for legacy or normalized-plan DTO generation.
+ * @param {IApiEntity<E>} entityMetadata - Root entity metadata.
+ * @param {Array<{isPrimary: boolean; metadata: TApiPropertyDescribeProperties; name: keyof E}>} markedProperties - Legacy metadata-visible root properties.
+ * @param {Type<IAuthGuard>} currentGuard - Active route guard used by legacy visibility checks.
+ * @param {IApiControllerGetListQueryPlan} queryPlan - Optional normalized typed query plan.
+ * @returns {Array<object>} Filter properties consumed by the dynamic DTO generator.
+ * @template E - Root entity type.
+ */
+export declare function DtoGenerateGetListQueryProperties<E>(entityMetadata: IApiEntity<E>, markedProperties: Array<{
+    isPrimary: boolean;
+    metadata: TApiPropertyDescribeProperties;
+    name: keyof E;
+}>, currentGuard?: Type<IAuthGuard>, queryPlan?: IApiControllerGetListQueryPlan): Array<{
+    allowedOperations?: ReadonlyArray<EFilterOperation>;
+    entityMetadata: IApiEntity<unknown>;
+    metadata: TApiPropertyDescribeProperties;
+    name: string;
+}>;

package/dist/esm/utility/dto/generate/get-list-query-properties.utility.js

@@ -0,0 +1,105 @@
+import '../../../constant/decorator/api/function.constant.js';
+import { PROPERTY_DESCRIBE_DECORATOR_API_CONSTANT } from '../../../constant/decorator/api/property-describe.constant.js';
+import { GET_LIST_QUERY_DTO_FACTORY_CONSTANT } from '../../../constant/factory-dto-get-list-query.constant.js';
+import '../../../enum/decorator/api/action.enum.js';
+import '../../../enum/decorator/api/authentication-type.enum.js';
+import '../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js';
+import '../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js';
+import '../../../enum/decorator/api/controller/relation-reference-shape.enum.js';
+import '../../../enum/decorator/api/controller/request/target.enum.js';
+import '../../../enum/decorator/api/controller/request/transformer-type.enum.js';
+import '../../../enum/decorator/api/controller/response-target.enum.js';
+import { EApiDtoType } from '../../../enum/decorator/api/dto-type.enum.js';
+import '../../../enum/decorator/api/function/context-storage-kind.enum.js';
+import '../../../enum/decorator/api/function/subscriber-transaction-expectation.enum.js';
+import '../../../enum/decorator/api/function/transaction/event-status.enum.js';
+import '../../../enum/decorator/api/function/transaction/failure-stage.enum.js';
+import '../../../enum/decorator/api/function/transaction/mode.enum.js';
+import '../../../enum/decorator/api/function/transaction/outcome.enum.js';
+import '../../../enum/decorator/api/function/transaction/owner-kind.enum.js';
+import '../../../enum/decorator/api/function/transaction/trace-type.enum.js';
+import '../../../enum/decorator/api/function/type.enum.js';
+import '../../../enum/decorator/api/on-type.enum.js';
+import '../../../enum/decorator/api/property/data-type.enum.js';
+import '../../../enum/decorator/api/property/date/identifier.enum.js';
+import '../../../enum/decorator/api/property/date/type.enum.js';
+import { EApiPropertyDescribeType } from '../../../enum/decorator/api/property/desribe-type.enum.js';
+import '../../../enum/decorator/api/property/number-type.enum.js';
+import '../../../enum/decorator/api/property/string-type.enum.js';
+import '../../../enum/decorator/api/route/subscriber-authorization-expectation.enum.js';
+import { EApiRouteType } from '../../../enum/decorator/api/route/type.enum.js';
+import { DtoIsPropertyShouldBeMarked } from '../is/property/should-be-marked.utility.js';
+import { ErrorException } from '../../error/exception.utility.js';
+import { GenerateEntityInformation } from '../../generate-entity-information.utility.js';
+
+/**
+ * Resolves metadata-backed GET_LIST filter properties for legacy or normalized-plan DTO generation.
+ * @param {IApiEntity<E>} entityMetadata - Root entity metadata.
+ * @param {Array<{isPrimary: boolean; metadata: TApiPropertyDescribeProperties; name: keyof E}>} markedProperties - Legacy metadata-visible root properties.
+ * @param {Type<IAuthGuard>} currentGuard - Active route guard used by legacy visibility checks.
+ * @param {IApiControllerGetListQueryPlan} queryPlan - Optional normalized typed query plan.
+ * @returns {Array<object>} Filter properties consumed by the dynamic DTO generator.
+ * @template E - Root entity type.
+ */
+function DtoGenerateGetListQueryProperties(entityMetadata, markedProperties, currentGuard, queryPlan) {
+    const queryFilterProperties = [];
+    if (queryPlan && !queryPlan.filter.isLegacy) {
+        for (const field of Object.values(queryPlan.filter.fields)) {
+            if (!field.isEnabled) {
+                continue;
+            }
+            const path = field.path.split(".");
+            let propertyEntityMetadata = entityMetadata;
+            if (path.length === GET_LIST_QUERY_DTO_FACTORY_CONSTANT.NESTED_FILTER_PATH_SEGMENT_COUNT) {
+                const relationColumn = entityMetadata.columns.find((column) => String(column.name) === path[0]);
+                if (!relationColumn?.relation?.target) {
+                    throw ErrorException(`Relation metadata for GET_LIST query field "${field.path}" is unavailable`);
+                }
+                propertyEntityMetadata = GenerateEntityInformation(relationColumn.relation.target);
+            }
+            queryFilterProperties.push({
+                allowedOperations: field.allowedOperations,
+                entityMetadata: propertyEntityMetadata,
+                metadata: field.metadata,
+                name: field.path,
+            });
+        }
+        return queryFilterProperties;
+    }
+    for (const property of markedProperties) {
+        if (property.metadata.type !== EApiPropertyDescribeType.RELATION) {
+            queryFilterProperties.push({
+                entityMetadata: entityMetadata,
+                metadata: property.metadata,
+                name: property.name,
+            });
+            continue;
+        }
+        const relationColumn = entityMetadata.columns.find((column) => column.name == property.name);
+        if (!relationColumn?.relation?.target)
+            continue;
+        let relationEntityMetadata;
+        try {
+            relationEntityMetadata = GenerateEntityInformation(relationColumn.relation.target);
+        }
+        catch {
+            continue;
+        }
+        for (const relationProperty of relationEntityMetadata.columns) {
+            const relationPropertyMetadata = relationProperty.metadata?.[PROPERTY_DESCRIBE_DECORATOR_API_CONSTANT.METADATA_KEY];
+            if (!relationPropertyMetadata || relationPropertyMetadata.type === EApiPropertyDescribeType.RELATION || relationPropertyMetadata.type === EApiPropertyDescribeType.OBJECT)
+                continue;
+            if (!relationProperty.isPrimary && !DtoIsPropertyShouldBeMarked(EApiRouteType.GET_LIST, EApiDtoType.QUERY, relationProperty.name, relationPropertyMetadata, relationProperty.isPrimary, currentGuard))
+                continue;
+            queryFilterProperties.push({
+                entityMetadata: relationEntityMetadata,
+                metadata: relationPropertyMetadata,
+                name: `${property.name}.${relationProperty.name}`,
+            });
+        }
+    }
+    return queryFilterProperties;
+}
+
+export { DtoGenerateGetListQueryProperties };
+//# sourceMappingURL=get-list-query-properties.utility.js.map

package/dist/esm/utility/dto/generate/get-list-query-properties.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-list-query-properties.utility.js","sources":["../../../../../../src/utility/dto/generate/get-list-query-properties.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/utility/dto/generate/get-list-response.utility.js

@@ -4,13 +4,21 @@ import { ApiPropertyNumber } from '../../../decorator/api/property/number.decora
 import { ApiPropertyObject } from '../../../decorator/api/property/object.decorator.js';
 import '../../../enum/decorator/api/action.enum.js';
 import '../../../enum/decorator/api/authentication-type.enum.js';
+import '../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js';
+import '../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js';
 import '../../../enum/decorator/api/controller/relation-reference-shape.enum.js';
 import '../../../enum/decorator/api/controller/request/target.enum.js';
 import '../../../enum/decorator/api/controller/request/transformer-type.enum.js';
 import '../../../enum/decorator/api/controller/response-target.enum.js';
 import '../../../enum/decorator/api/dto-type.enum.js';
+import '../../../enum/decorator/api/function/context-storage-kind.enum.js';
 import '../../../enum/decorator/api/function/subscriber-transaction-expectation.enum.js';
-import '../../../enum/decorator/api/function/transaction-mode.enum.js';
+import '../../../enum/decorator/api/function/transaction/event-status.enum.js';
+import '../../../enum/decorator/api/function/transaction/failure-stage.enum.js';
+import '../../../enum/decorator/api/function/transaction/mode.enum.js';
+import '../../../enum/decorator/api/function/transaction/outcome.enum.js';
+import '../../../enum/decorator/api/function/transaction/owner-kind.enum.js';
+import '../../../enum/decorator/api/function/transaction/trace-type.enum.js';
 import '../../../enum/decorator/api/function/type.enum.js';
 import '../../../enum/decorator/api/on-type.enum.js';
 import '../../../enum/decorator/api/property/data-type.enum.js';

package/dist/esm/utility/dto/generate/get-list-response.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-list-response.utility.js","sources":["../../../../../../src/utility/dto/generate/get-list-response.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"get-list-response.utility.js","sources":["../../../../../../src/utility/dto/generate/get-list-response.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/utility/dto/generate/manual-child.utility.js

@@ -2,7 +2,7 @@ import { CONTEXTUAL_MANUAL_DTO_CONSTANT } from '../../../constant/dto/contextual
 import { CamelCaseString } from '../../camel-case-string.utility.js';
 import { DtoAutoContextPop } from '../auto/context/pop.utility.js';
 import { DtoAutoContextPush } from '../auto/context/push.utility.js';
-import { GetManualDtoPropertyMetadata } from '../manual/property-metadata.utility.js';
+import { GetManualDtoPropertyMetadata } from '../manual/property-metadata/get.utility.js';
 
 const contextualManualDtoCache = new WeakMap();
 /**

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

@@ -1,3 +1,4 @@
+import { IApiControllerGetListQueryPlan } from '../../../interface/class/api/controller/get-list/query';
 import { Type } from '@nestjs/common';
 import { ObjectLiteral } from '../../../../node_modules/typeorm/index';
 import { EApiDtoType, EApiRouteType } from '../../../enum/decorator/api';
@@ -10,7 +11,8 @@ import { IApiEntity } from '../../../interface/entity';
  * @param {IApiEntity<E>} entityMetadata - The entity metadata containing column information
  * @param {EApiRouteType} method - The API route type (GET_LIST)
  * @param {EApiDtoType} dtoType - The type of DTO (QUERY)
+ * @param {IApiControllerGetListQueryPlan} [queryPlan] - Optional normalized plan that narrows sortable fields.
  * @returns {Type<unknown>} A base class for list query DTOs
  * @template E - The entity type
  */
-export declare function DtoGetGetListQueryBaseClass<E>(entity: ObjectLiteral, entityMetadata: IApiEntity<E>, method: EApiRouteType, dtoType: EApiDtoType): Type<unknown>;
+export declare function DtoGetGetListQueryBaseClass<E>(entity: ObjectLiteral, entityMetadata: IApiEntity<E>, method: EApiRouteType, dtoType: EApiDtoType, queryPlan?: IApiControllerGetListQueryPlan): Type<unknown>;

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

@@ -4,13 +4,21 @@ import { ApiPropertyEnum } from '../../../decorator/api/property/enum.decorator.
 import { ApiPropertyNumber } from '../../../decorator/api/property/number.decorator.js';
 import '../../../enum/decorator/api/action.enum.js';
 import '../../../enum/decorator/api/authentication-type.enum.js';
+import '../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js';
+import '../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js';
 import '../../../enum/decorator/api/controller/relation-reference-shape.enum.js';
 import '../../../enum/decorator/api/controller/request/target.enum.js';
 import '../../../enum/decorator/api/controller/request/transformer-type.enum.js';
 import '../../../enum/decorator/api/controller/response-target.enum.js';
 import '../../../enum/decorator/api/dto-type.enum.js';
+import '../../../enum/decorator/api/function/context-storage-kind.enum.js';
 import '../../../enum/decorator/api/function/subscriber-transaction-expectation.enum.js';
-import '../../../enum/decorator/api/function/transaction-mode.enum.js';
+import '../../../enum/decorator/api/function/transaction/event-status.enum.js';
+import '../../../enum/decorator/api/function/transaction/failure-stage.enum.js';
+import '../../../enum/decorator/api/function/transaction/mode.enum.js';
+import '../../../enum/decorator/api/function/transaction/outcome.enum.js';
+import '../../../enum/decorator/api/function/transaction/owner-kind.enum.js';
+import '../../../enum/decorator/api/function/transaction/trace-type.enum.js';
 import '../../../enum/decorator/api/function/type.enum.js';
 import '../../../enum/decorator/api/on-type.enum.js';
 import '../../../enum/decorator/api/property/data-type.enum.js';
@@ -21,6 +29,7 @@ import { EApiPropertyNumberType } from '../../../enum/decorator/api/property/num
 import '../../../enum/decorator/api/property/string-type.enum.js';
 import '../../../enum/decorator/api/route/subscriber-authorization-expectation.enum.js';
 import '../../../enum/decorator/api/route/type.enum.js';
+import '../../../enum/filter/operand.enum.js';
 import '../../../enum/filter/operation.enum.js';
 import { EFilterOrderDirection } from '../../../enum/filter/order-direction.enum.js';
 import { FilterOrderByFromEntity } from '../../api/filter-order-by-from-entity.utility.js';
@@ -36,10 +45,16 @@ import { Validate } from 'class-validator';
  * @param {IApiEntity<E>} entityMetadata - The entity metadata containing column information
  * @param {EApiRouteType} method - The API route type (GET_LIST)
  * @param {EApiDtoType} dtoType - The type of DTO (QUERY)
+ * @param {IApiControllerGetListQueryPlan} [queryPlan] - Optional normalized plan that narrows sortable fields.
  * @returns {Type<unknown>} A base class for list query DTOs
  * @template E - The entity type
  */
-function DtoGetGetListQueryBaseClass(entity, entityMetadata, method, dtoType) {
+function DtoGetGetListQueryBaseClass(entity, entityMetadata, method, dtoType, queryPlan) {
+    const orderBy = queryPlan && !queryPlan.order.isLegacy
+        ? Object.fromEntries(Object.values(queryPlan.order.fields)
+            .filter((field) => field.isEnabled)
+            .map((field) => [field.path, field.path]))
+        : FilterOrderByFromEntity(entity, entityMetadata, method, dtoType);
     class BaseQueryDTO {
         limit;
         orderBy;
@@ -66,8 +81,8 @@ function DtoGetGetListQueryBaseClass(entity, entityMetadata, method, dtoType) {
         ApiPropertyEnum({
             description: "order by field",
             entity: entityMetadata,
-            enum: FilterOrderByFromEntity(entity, entityMetadata, method, dtoType),
-            enumName: `E${CapitalizeString(entityMetadata.name ?? "UnknownResource")}FilterOrderBy`,
+            enum: orderBy,
+            enumName: queryPlan ? `${queryPlan.schemaName}OrderBy` : `E${CapitalizeString(entityMetadata.name ?? "UnknownResource")}FilterOrderBy`,
             isRequired: false,
         }),
         __metadata("design:type", String)

package/dist/esm/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":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcA;;;;;;;;;;AAUG;AACG,SAAU,2BAA2B,CAAI,MAAqB,EAAE,cAA6B,EAAE,MAAqB,EAAE,OAAoB,EAAA;AAC/I,IAAA,MAAM,YAAY,CAAA;AAWjB,QAAA,KAAK;AASL,QAAA,OAAO;AASP,QAAA,cAAc;AAYd,QAAA,IAAI;QAGJ,MAAM,GAAA;AACL,YAAA,OAAO,IAAI;QACZ;AACA;AApCA,IAAA,UAAA,CAAA;AAVC,QAAA,iBAAiB,CAAC;AAClB,YAAA,WAAW,EAAE,gBAAgB;AAC7B,YAAA,MAAM,EAAE,cAAc;YACtB,YAAY,EAAE,mCAAmC,CAAC,mBAAmB;YACrE,MAAM,EAAE,sBAAsB,CAAC,OAAO;AACtC,YAAA,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,mCAAmC,CAAC,mBAAmB;YAChE,OAAO,EAAE,mCAAmC,CAAC,mBAAmB;YAChE,UAAU,EAAE,mCAAmC,CAAC,gBAAgB;SAChE,CAAC;;AACa,KAAA,EAAA,YAAA,CAAA,SAAA,EAAA,OAAA,EAAA,MAAA,CAAA;AASf,IAAA,UAAA,CAAA;AAPC,QAAA,eAAe,CAAC;AAChB,YAAA,WAAW,EAAE,gBAAgB;AAC7B,YAAA,MAAM,EAAE,cAAc;YACtB,IAAI,EAAE,uBAAuB,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC;YACtE,QAAQ,EAAE,CAAA,CAAA,EAAI,gBAAgB,CAAC,cAAc,CAAC,IAAI,IAAI,iBAAiB,CAAC,CAAA,aAAA,CAAe;AACvF,YAAA,UAAU,EAAE,KAAK;SACjB,CAAC;;AACe,KAAA,EAAA,YAAA,CAAA,SAAA,EAAA,SAAA,EAAA,MAAA,CAAA;AASjB,IAAA,UAAA,CAAA;AAPC,QAAA,eAAe,CAAC;AAChB,YAAA,WAAW,EAAE,iBAAiB;AAC9B,YAAA,MAAM,EAAE,cAAc;AACtB,YAAA,IAAI,EAAE,qBAAqB;AAC3B,YAAA,QAAQ,EAAE,uBAAuB;AACjC,YAAA,UAAU,EAAE,KAAK;SACjB,CAAC;;AACqC,KAAA,EAAA,YAAA,CAAA,SAAA,EAAA,gBAAA,EAAA,MAAA,CAAA;AAYvC,IAAA,UAAA,CAAA;AAVC,QAAA,iBAAiB,CAAC;AAClB,YAAA,WAAW,EAAE,gBAAgB;AAC7B,YAAA,MAAM,EAAE,cAAc;YACtB,YAAY,EAAE,mCAAmC,CAAC,wBAAwB;YAC1E,MAAM,EAAE,sBAAsB,CAAC,OAAO;AACtC,YAAA,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,mCAAmC,CAAC,wBAAwB;YACrE,OAAO,EAAE,mCAAmC,CAAC,wBAAwB;YACrE,UAAU,EAAE,mCAAmC,CAAC,gBAAgB;SAChE,CAAC;;AACY,KAAA,EAAA,YAAA,CAAA,SAAA,EAAA,MAAA,EAAA,MAAA,CAAA;AAGd,IAAA,UAAA,CAAA;QADC,QAAQ,CAAC,oCAAoC,EAAE,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;;;;AAG7E,KAAA,EAAA,YAAA,CAAA,SAAA,EAAA,QAAA,EAAA,IAAA,CAAA;AAGF,IAAA,OAAO,YAAY;AACpB;;;;"}
+{"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":[],"mappings":"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"}

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

@@ -1,12 +1,20 @@
 import '../../enum/decorator/api/action.enum.js';
 import '../../enum/decorator/api/authentication-type.enum.js';
+import '../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js';
+import '../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js';
 import '../../enum/decorator/api/controller/relation-reference-shape.enum.js';
 import '../../enum/decorator/api/controller/request/target.enum.js';
 import '../../enum/decorator/api/controller/request/transformer-type.enum.js';
 import '../../enum/decorator/api/controller/response-target.enum.js';
 import '../../enum/decorator/api/dto-type.enum.js';
+import '../../enum/decorator/api/function/context-storage-kind.enum.js';
 import '../../enum/decorator/api/function/subscriber-transaction-expectation.enum.js';
-import '../../enum/decorator/api/function/transaction-mode.enum.js';
+import '../../enum/decorator/api/function/transaction/event-status.enum.js';
+import '../../enum/decorator/api/function/transaction/failure-stage.enum.js';
+import '../../enum/decorator/api/function/transaction/mode.enum.js';
+import '../../enum/decorator/api/function/transaction/outcome.enum.js';
+import '../../enum/decorator/api/function/transaction/owner-kind.enum.js';
+import '../../enum/decorator/api/function/transaction/trace-type.enum.js';
 import '../../enum/decorator/api/function/type.enum.js';
 import '../../enum/decorator/api/on-type.enum.js';
 import '../../enum/decorator/api/property/data-type.enum.js';

package/dist/esm/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":[],"mappings":";;;;;;;;;;;;;;;;;;;;AAEA;;;;;;;AAOG;MACU,qBAAqB,GAAG,CAAC,YAAoB,EAAE,UAAsC,KAAqE;AACtK,IAAA,MAAM,SAAS,GAAsH;AACpI,QAAA,CAAC,0BAA0B,CAAC,UAAU,GAAG,EAAE,IAAI,EAAE,0BAA0B,CAAC,eAAe,EAAE,EAAE,EAAE,0BAA0B,CAAC,aAAa,EAAE;AAC3I,QAAA,CAAC,0BAA0B,CAAC,WAAW,GAAG,EAAE,IAAI,EAAE,0BAA0B,CAAC,gBAAgB,EAAE,EAAE,EAAE,0BAA0B,CAAC,cAAc,EAAE;AAC9I,QAAA,CAAC,0BAA0B,CAAC,UAAU,GAAG,EAAE,IAAI,EAAE,0BAA0B,CAAC,eAAe,EAAE,EAAE,EAAE,0BAA0B,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":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA;;;;;;;AAOG;MACU,qBAAqB,GAAG,CAAC,YAAoB,EAAE,UAAsC,KAAqE;AACtK,IAAA,MAAM,SAAS,GAAsH;AACpI,QAAA,CAAC,0BAA0B,CAAC,UAAU,GAAG,EAAE,IAAI,EAAE,0BAA0B,CAAC,eAAe,EAAE,EAAE,EAAE,0BAA0B,CAAC,aAAa,EAAE;AAC3I,QAAA,CAAC,0BAA0B,CAAC,WAAW,GAAG,EAAE,IAAI,EAAE,0BAA0B,CAAC,gBAAgB,EAAE,EAAE,EAAE,0BAA0B,CAAC,cAAc,EAAE;AAC9I,QAAA,CAAC,0BAA0B,CAAC,UAAU,GAAG,EAAE,IAAI,EAAE,0BAA0B,CAAC,eAAe,EAAE,EAAE,EAAE,0BAA0B,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/esm/utility/dto/is/property/index.d.ts

@@ -1,2 +1,3 @@
 export { DtoIsPropertyExposedForGuard } from './exposed-for-guard.utility';
+export { DtoIsPropertyInfrastructureTimestamp } from './infrastructure-timestamp.utility';
 export { DtoIsPropertyShouldBeMarked } from './should-be-marked.utility';

package/dist/esm/utility/dto/is/property/infrastructure-timestamp.utility.d.ts

@@ -0,0 +1,7 @@
+import { TApiPropertyDescribeProperties } from '../../../../type/decorator/api/property';
+/**
+ * Determines whether date metadata represents a server-owned infrastructure timestamp.
+ * @param {TApiPropertyDescribeProperties} propertyMetadata - Metadata describing the property
+ * @returns {boolean} True for created, received, and updated infrastructure timestamps
+ */
+export declare function DtoIsPropertyInfrastructureTimestamp(propertyMetadata: TApiPropertyDescribeProperties): boolean;

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

@@ -0,0 +1,43 @@
+import { DTO_UTILITY_CONSTANT } from '../../../../constant/utility/dto/constant.js';
+import '../../../../enum/decorator/api/action.enum.js';
+import '../../../../enum/decorator/api/authentication-type.enum.js';
+import '../../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js';
+import '../../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js';
+import '../../../../enum/decorator/api/controller/relation-reference-shape.enum.js';
+import '../../../../enum/decorator/api/controller/request/target.enum.js';
+import '../../../../enum/decorator/api/controller/request/transformer-type.enum.js';
+import '../../../../enum/decorator/api/controller/response-target.enum.js';
+import '../../../../enum/decorator/api/dto-type.enum.js';
+import '../../../../enum/decorator/api/function/context-storage-kind.enum.js';
+import '../../../../enum/decorator/api/function/subscriber-transaction-expectation.enum.js';
+import '../../../../enum/decorator/api/function/transaction/event-status.enum.js';
+import '../../../../enum/decorator/api/function/transaction/failure-stage.enum.js';
+import '../../../../enum/decorator/api/function/transaction/mode.enum.js';
+import '../../../../enum/decorator/api/function/transaction/outcome.enum.js';
+import '../../../../enum/decorator/api/function/transaction/owner-kind.enum.js';
+import '../../../../enum/decorator/api/function/transaction/trace-type.enum.js';
+import '../../../../enum/decorator/api/function/type.enum.js';
+import '../../../../enum/decorator/api/on-type.enum.js';
+import '../../../../enum/decorator/api/property/data-type.enum.js';
+import '../../../../enum/decorator/api/property/date/identifier.enum.js';
+import '../../../../enum/decorator/api/property/date/type.enum.js';
+import { EApiPropertyDescribeType } from '../../../../enum/decorator/api/property/desribe-type.enum.js';
+import '../../../../enum/decorator/api/property/number-type.enum.js';
+import '../../../../enum/decorator/api/property/string-type.enum.js';
+import '../../../../enum/decorator/api/route/subscriber-authorization-expectation.enum.js';
+import '../../../../enum/decorator/api/route/type.enum.js';
+
+/**
+ * Determines whether date metadata represents a server-owned infrastructure timestamp.
+ * @param {TApiPropertyDescribeProperties} propertyMetadata - Metadata describing the property
+ * @returns {boolean} True for created, received, and updated infrastructure timestamps
+ */
+function DtoIsPropertyInfrastructureTimestamp(propertyMetadata) {
+    if (propertyMetadata.type !== EApiPropertyDescribeType.DATE) {
+        return false;
+    }
+    return DTO_UTILITY_CONSTANT.INFRASTRUCTURE_TIMESTAMP_IDENTIFIERS.includes(propertyMetadata.identifier);
+}
+
+export { DtoIsPropertyInfrastructureTimestamp };
+//# sourceMappingURL=infrastructure-timestamp.utility.js.map

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

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

package/dist/esm/utility/dto/is/property/should-be-marked.utility.d.ts

@@ -6,10 +6,10 @@ import { EApiDtoType, EApiRouteType } from '../../../../enum/decorator/api';
  * Determines if a property should be marked for inclusion in a specific DTO type
  * @param {EApiRouteType} method - The API route type (GET, POST, etc.)
  * @param {EApiDtoType} dtoType - The DTO type (request, response, etc.)
- * @param {string} propertyName - The name of the property
+ * @param {string} _propertyName - The name of the property
  * @param {TApiPropertyDescribeProperties} propertyMetadata - The property's metadata
  * @param {boolean} isPrimary - Whether the property is a primary key
  * @param {Type<IAuthGuard>} currentGuard - The current authentication guard
  * @returns {boolean} True if the property should be marked, false otherwise
  */
-export declare function DtoIsPropertyShouldBeMarked(method: EApiRouteType, dtoType: EApiDtoType, propertyName: string, propertyMetadata: TApiPropertyDescribeProperties, isPrimary: boolean, currentGuard?: Type<IAuthGuard>): boolean;
+export declare function DtoIsPropertyShouldBeMarked(method: EApiRouteType, dtoType: EApiDtoType, _propertyName: string, propertyMetadata: TApiPropertyDescribeProperties, isPrimary: boolean, currentGuard?: Type<IAuthGuard>): boolean;

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

@@ -1,12 +1,20 @@
 import '../../../../enum/decorator/api/action.enum.js';
 import '../../../../enum/decorator/api/authentication-type.enum.js';
+import '../../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js';
+import '../../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js';
 import '../../../../enum/decorator/api/controller/relation-reference-shape.enum.js';
 import '../../../../enum/decorator/api/controller/request/target.enum.js';
 import '../../../../enum/decorator/api/controller/request/transformer-type.enum.js';
 import '../../../../enum/decorator/api/controller/response-target.enum.js';
 import { EApiDtoType } from '../../../../enum/decorator/api/dto-type.enum.js';
+import '../../../../enum/decorator/api/function/context-storage-kind.enum.js';
 import '../../../../enum/decorator/api/function/subscriber-transaction-expectation.enum.js';
-import '../../../../enum/decorator/api/function/transaction-mode.enum.js';
+import '../../../../enum/decorator/api/function/transaction/event-status.enum.js';
+import '../../../../enum/decorator/api/function/transaction/failure-stage.enum.js';
+import '../../../../enum/decorator/api/function/transaction/mode.enum.js';
+import '../../../../enum/decorator/api/function/transaction/outcome.enum.js';
+import '../../../../enum/decorator/api/function/transaction/owner-kind.enum.js';
+import '../../../../enum/decorator/api/function/transaction/trace-type.enum.js';
 import '../../../../enum/decorator/api/function/type.enum.js';
 import '../../../../enum/decorator/api/on-type.enum.js';
 import '../../../../enum/decorator/api/property/data-type.enum.js';
@@ -18,20 +26,21 @@ import '../../../../enum/decorator/api/property/string-type.enum.js';
 import '../../../../enum/decorator/api/route/subscriber-authorization-expectation.enum.js';
 import { EApiRouteType } from '../../../../enum/decorator/api/route/type.enum.js';
 import { DtoIsPropertyExposedForGuard } from './exposed-for-guard.utility.js';
+import { DtoIsPropertyInfrastructureTimestamp } from './infrastructure-timestamp.utility.js';
 
 /**
  * Determines if a property should be marked for inclusion in a specific DTO type
  * @param {EApiRouteType} method - The API route type (GET, POST, etc.)
  * @param {EApiDtoType} dtoType - The DTO type (request, response, etc.)
- * @param {string} propertyName - The name of the property
+ * @param {string} _propertyName - The name of the property
  * @param {TApiPropertyDescribeProperties} propertyMetadata - The property's metadata
  * @param {boolean} isPrimary - Whether the property is a primary key
  * @param {Type<IAuthGuard>} currentGuard - The current authentication guard
  * @returns {boolean} True if the property should be marked, false otherwise
  */
-function DtoIsPropertyShouldBeMarked(method, dtoType, propertyName, propertyMetadata, isPrimary, currentGuard) {
-    const isDateField = ["createdAt", "receivedAt", "updatedAt"].includes(propertyName);
-    if (method === EApiRouteType.CREATE && dtoType === EApiDtoType.BODY && isDateField) {
+function DtoIsPropertyShouldBeMarked(method, dtoType, _propertyName, propertyMetadata, isPrimary, currentGuard) {
+    const isWriteBody = dtoType === EApiDtoType.BODY && (method === EApiRouteType.CREATE || method === EApiRouteType.UPDATE || method === EApiRouteType.PARTIAL_UPDATE);
+    if (isWriteBody && DtoIsPropertyInfrastructureTimestamp(propertyMetadata)) {
         return false;
     }
     const properties = propertyMetadata.properties?.[method];

package/dist/esm/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":[],"mappings":";;;;;;;;;;;;;;;;;;;;;AAOA;;;;;;;;;AASG;AACG,SAAU,2BAA2B,CAAC,MAAqB,EAAE,OAAoB,EAAE,YAAoB,EAAE,gBAAgD,EAAE,SAAkB,EAAE,YAA+B,EAAA;AACnN,IAAA,MAAM,WAAW,GAAY,CAAC,WAAW,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC;AAE5F,IAAA,IAAI,MAAM,KAAK,aAAa,CAAC,MAAM,IAAI,OAAO,KAAK,WAAW,CAAC,IAAI,IAAI,WAAW,EAAE;AACnF,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,CAAC,4BAA4B,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE;AACnF,QAAA,OAAO,KAAK;IACb;AAEA,IAAA,IAAI,OAAO,KAAK,WAAW,CAAC,KAAK,IAAI,gBAAgB,CAAC,IAAI,KAAK,wBAAwB,CAAC,MAAM,EAAE;AAC/F,QAAA,OAAO,KAAK;IACb;IAEA,IAAI,OAAO,KAAK,WAAW,CAAC,UAAU,IAAI,SAAS,EAAE;AACpD,QAAA,OAAO,IAAI;IACZ;AAEA,IAAA,IAAI,CAAC,OAAO,KAAK,WAAW,CAAC,KAAK,IAAI,OAAO,KAAK,WAAW,CAAC,IAAI,KAAK,CAAC,SAAS,EAAE;AAClF,QAAA,OAAO,IAAI;IACZ;AAEA,IAAA,OAAO,OAAO,KAAK,WAAW,CAAC,UAAU,IAAI,OAAO,KAAK,WAAW,CAAC,KAAK,IAAI,OAAO,KAAK,WAAW,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":[],"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,KAAK,WAAW,CAAC,IAAI,KAAK,MAAM,KAAK,aAAa,CAAC,MAAM,IAAI,MAAM,KAAK,aAAa,CAAC,MAAM,IAAI,MAAM,KAAK,aAAa,CAAC,cAAc,CAAC;AAE5K,IAAA,IAAI,WAAW,IAAI,oCAAoC,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,CAAC,4BAA4B,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE;AACnF,QAAA,OAAO,KAAK;IACb;AAEA,IAAA,IAAI,OAAO,KAAK,WAAW,CAAC,KAAK,IAAI,gBAAgB,CAAC,IAAI,KAAK,wBAAwB,CAAC,MAAM,EAAE;AAC/F,QAAA,OAAO,KAAK;IACb;IAEA,IAAI,OAAO,KAAK,WAAW,CAAC,UAAU,IAAI,SAAS,EAAE;AACpD,QAAA,OAAO,IAAI;IACZ;AAEA,IAAA,IAAI,CAAC,OAAO,KAAK,WAAW,CAAC,KAAK,IAAI,OAAO,KAAK,WAAW,CAAC,IAAI,KAAK,CAAC,SAAS,EAAE;AAClF,QAAA,OAAO,IAAI;IACZ;AAEA,IAAA,OAAO,OAAO,KAAK,WAAW,CAAC,UAAU,IAAI,OAAO,KAAK,WAAW,CAAC,KAAK,IAAI,OAAO,KAAK,WAAW,CAAC,IAAI;AAC3G;;;;"}

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

@@ -1,12 +1,20 @@
 import '../../../enum/decorator/api/action.enum.js';
 import '../../../enum/decorator/api/authentication-type.enum.js';
+import '../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js';
+import '../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js';
 import '../../../enum/decorator/api/controller/relation-reference-shape.enum.js';
 import '../../../enum/decorator/api/controller/request/target.enum.js';
 import '../../../enum/decorator/api/controller/request/transformer-type.enum.js';
 import '../../../enum/decorator/api/controller/response-target.enum.js';
 import { EApiDtoType } from '../../../enum/decorator/api/dto-type.enum.js';
+import '../../../enum/decorator/api/function/context-storage-kind.enum.js';
 import '../../../enum/decorator/api/function/subscriber-transaction-expectation.enum.js';
-import '../../../enum/decorator/api/function/transaction-mode.enum.js';
+import '../../../enum/decorator/api/function/transaction/event-status.enum.js';
+import '../../../enum/decorator/api/function/transaction/failure-stage.enum.js';
+import '../../../enum/decorator/api/function/transaction/mode.enum.js';
+import '../../../enum/decorator/api/function/transaction/outcome.enum.js';
+import '../../../enum/decorator/api/function/transaction/owner-kind.enum.js';
+import '../../../enum/decorator/api/function/transaction/trace-type.enum.js';
 import '../../../enum/decorator/api/function/type.enum.js';
 import '../../../enum/decorator/api/on-type.enum.js';
 import '../../../enum/decorator/api/property/data-type.enum.js';

package/dist/esm/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":[],"mappings":";;;;;;;;;;;;;;;;;;;;AAEA;;;;;;;;;AASG;MACU,sBAAsB,GAAG,CAAC,MAAqB,EAAE,OAAoB,KAAa;IAC9F,QAAQ,OAAO;AACd,QAAA,KAAK,WAAW,CAAC,IAAI,EAAE;AACtB,YAAA,OAAO,CAAC,aAAa,CAAC,MAAM,EAAE,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QACnG;AAEA,QAAA,KAAK,WAAW,CAAC,UAAU,EAAE;YAC5B,OAAO,CAAC,aAAa,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,EAAE,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QACtH;AAEA,QAAA,KAAK,WAAW,CAAC,KAAK,EAAE;AACvB,YAAA,OAAO,MAAM,KAAK,aAAa,CAAC,QAAQ;QACzC;AAEA,QAAA,KAAK,WAAW,CAAC,QAAQ,EAAE;AAC1B,YAAA,OAAO,MAAM,KAAK,aAAa,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":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA;;;;;;;;;AASG;MACU,sBAAsB,GAAG,CAAC,MAAqB,EAAE,OAAoB,KAAa;IAC9F,QAAQ,OAAO;AACd,QAAA,KAAK,WAAW,CAAC,IAAI,EAAE;AACtB,YAAA,OAAO,CAAC,aAAa,CAAC,MAAM,EAAE,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QACnG;AAEA,QAAA,KAAK,WAAW,CAAC,UAAU,EAAE;YAC5B,OAAO,CAAC,aAAa,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,EAAE,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QACtH;AAEA,QAAA,KAAK,WAAW,CAAC,KAAK,EAAE;AACvB,YAAA,OAAO,MAAM,KAAK,aAAa,CAAC,QAAQ;QACzC;AAEA,QAAA,KAAK,WAAW,CAAC,QAAQ,EAAE;AAC1B,YAAA,OAAO,MAAM,KAAK,aAAa,CAAC,MAAM;QACvC;QAEA,SAAS;AACR,YAAA,OAAO,KAAK;QACb;;AAEF;;;;"}

package/dist/esm/utility/dto/manual/index.d.ts

@@ -0,0 +1 @@
+export * from './property-metadata';

package/dist/esm/utility/dto/manual/property-metadata/get.utility.d.ts

@@ -0,0 +1,8 @@
+import { TManualDtoPropertyMetadata } from '../../../../type/utility/dto/manual-property-metadata.type';
+/**
+ * Returns merged manual DTO decorator metadata for the supplied prototype, including inherited
+ * properties with child definitions overriding parent ones.
+ * @param {object} target - DTO prototype.
+ * @returns {Map<string | symbol, TManualDtoPropertyMetadata>} Merged property metadata map.
+ */
+export declare function GetManualDtoPropertyMetadata(target: object): Map<string | symbol, TManualDtoPropertyMetadata>;

package/dist/esm/utility/dto/manual/property-metadata/get.utility.js

@@ -0,0 +1,30 @@
+import { MANUAL_PROPERTY_METADATA_DTO_UTILITY_CONSTANT } from '../../../../constant/utility/dto/manual-property-metadata.constant.js';
+
+/**
+ * Returns merged manual DTO decorator metadata for the supplied prototype, including inherited
+ * properties with child definitions overriding parent ones.
+ * @param {object} target - DTO prototype.
+ * @returns {Map<string | symbol, TManualDtoPropertyMetadata>} Merged property metadata map.
+ */
+function GetManualDtoPropertyMetadata(target) {
+    const prototypes = [];
+    let current = target;
+    while (current && current !== Object.prototype) {
+        prototypes.unshift(current);
+        current = Object.getPrototypeOf(current);
+    }
+    const merged = new Map();
+    for (const prototype of prototypes) {
+        const registry = Reflect.getMetadata?.(MANUAL_PROPERTY_METADATA_DTO_UTILITY_CONSTANT.KEY, prototype);
+        if (!registry) {
+            continue;
+        }
+        for (const [propertyKey, metadata] of registry.entries()) {
+            merged.set(propertyKey, metadata);
+        }
+    }
+    return merged;
+}
+
+export { GetManualDtoPropertyMetadata };
+//# sourceMappingURL=get.utility.js.map

package/dist/esm/utility/dto/manual/property-metadata/get.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.utility.js","sources":["../../../../../../../src/utility/dto/manual/property-metadata/get.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAIA;;;;;AAKG;AACG,SAAU,4BAA4B,CAAC,MAAc,EAAA;IAC1D,MAAM,UAAU,GAAkB,EAAE;IACpC,IAAI,OAAO,GAAkB,MAAM;IAEnC,OAAO,OAAO,IAAI,OAAO,KAAK,MAAM,CAAC,SAAS,EAAE;AAC/C,QAAA,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC;AAC3B,QAAA,OAAO,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,CAAkB;IAC1D;AAEA,IAAA,MAAM,MAAM,GAAqD,IAAI,GAAG,EAA+C;AAEvH,IAAA,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE;AACnC,QAAA,MAAM,QAAQ,GAAiE,OAAO,CAAC,WAAW,GAAG,6CAA6C,CAAC,GAAG,EAAE,SAAS,CAAiE;QAElO,IAAI,CAAC,QAAQ,EAAE;YACd;QACD;AAEA,QAAA,KAAK,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE;AACzD,YAAA,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC;QAClC;IACD;AAEA,IAAA,OAAO,MAAM;AACd;;;;"}

package/dist/esm/utility/dto/manual/property-metadata/index.d.ts

@@ -0,0 +1,2 @@
+export { GetManualDtoPropertyMetadata } from './get.utility';
+export { RegisterManualDtoPropertyMetadata } from './register.utility';