@elsikora/nestjs-crud-automator 1.8.0-dev.2 → 1.9.0-dev.1

package/dist/esm/utility/dto/analize.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analize.utility.js","sources":["../../../../../src/utility/dto/analize.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAKA;;;;;AAKG;AACG,SAAU,qBAAqB,CAAC,MAAsB,EAAA;AAC3D,IAAA,MAAM,OAAO,GAAoB,eAAe,CAAC,WAAW,EAAE;AAE9D,IAA4C,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,IAAI,iBAAiB;AAIjG;;;;"}

package/dist/esm/utility/dto/build-decorator.utility.d.ts

@@ -1,6 +1,21 @@
+import type { IApiEntity } from '../../interface/entity/index';
 import type { Type } from "@nestjs/common";
 import type { IAuthGuard } from "@nestjs/passport";
-import type { IApiEntity } from "../../interface";
-import type { TApiPropertyDescribeProperties } from "../../type";
-import { EApiDtoType, EApiRouteType } from "../../enum";
-export declare function DtoBuildDecorator<E, M extends EApiRouteType, D extends EApiDtoType>(method: M, propertyMetadata: TApiPropertyDescribeProperties, entity: IApiEntity<E>, dtoType: D, propertyName: string, currentGuard?: Type<IAuthGuard>): Array<PropertyDecorator> | undefined;
+import type { TApiPropertyDescribeProperties } from '../../type/decorator/api/property/index';
+import { EApiDtoType, EApiRouteType } from '../../enum/decorator/api/index';
+/**
+ * Creates property decorators for DTOs based on property metadata, entity information, and context.
+ * Handles special cases for date properties and guard-based exposure rules.
+ * @param {M} method - The API route type (CREATE, DELETE, GET, etc.)
+ * @param {TApiPropertyDescribeProperties} propertyMetadata - Metadata describing the property
+ * @param {IApiEntity<E>} entity - The entity metadata
+ * @param {D} dtoType - The type of DTO (REQUEST, RESPONSE, etc.)
+ * @param {string} propertyName - The name of the property
+ * @param {Type<IAuthGuard>} [currentGuard] - Optional authentication guard
+ * @param {Record<string, Type<unknown>>} [generatedDTOs] - Optional record of dynamically generated DTOs
+ * @returns {Array<PropertyDecorator> | undefined} Array of property decorators or undefined if property should not be included
+ * @template E - The entity type
+ * @template M - The API route type
+ * @template D - The DTO type
+ */
+export declare function DtoBuildDecorator<E, M extends EApiRouteType, D extends EApiDtoType>(method: M, propertyMetadata: TApiPropertyDescribeProperties, entity: IApiEntity<E>, dtoType: D, propertyName: string, currentGuard?: Type<IAuthGuard>, generatedDTOs?: Record<string, Type<unknown>>): Array<PropertyDecorator> | undefined;

package/dist/esm/{src/utility → utility}/dto/build-decorator.utility.js

@@ -11,16 +11,28 @@ import { EApiPropertyDescribeType } from '../../enum/decorator/api/property/desr
 import '../../enum/decorator/api/property/number-type.enum.js';
 import '../../enum/decorator/api/property/string-type.enum.js';
 import { EApiRouteType } from '../../enum/decorator/api/route-type.enum.js';
-import '../../enum/exception.enum.js';
-import '../../enum/filter-order-direction.enum.js';
-import '../../enum/utility/error-string-action.enum.js';
 import { DtoGenerateDecorator } from './generate-decorator.utility.js';
 import { DtoGetDecoratorConfig } from './get-decorator-config.utility.js';
 import { DtoHandleDateProperty } from './handle-date-property.utility.js';
 import { DtoIsPropertyExposedForGuard } from './is-property-exposed-for-guard.utility.js';
 
+/**
+ * Creates property decorators for DTOs based on property metadata, entity information, and context.
+ * Handles special cases for date properties and guard-based exposure rules.
+ * @param {M} method - The API route type (CREATE, DELETE, GET, etc.)
+ * @param {TApiPropertyDescribeProperties} propertyMetadata - Metadata describing the property
+ * @param {IApiEntity<E>} entity - The entity metadata
+ * @param {D} dtoType - The type of DTO (REQUEST, RESPONSE, etc.)
+ * @param {string} propertyName - The name of the property
+ * @param {Type<IAuthGuard>} [currentGuard] - Optional authentication guard
+ * @param {Record<string, Type<unknown>>} [generatedDTOs] - Optional record of dynamically generated DTOs
+ * @returns {Array<PropertyDecorator> | undefined} Array of property decorators or undefined if property should not be included
+ * @template E - The entity type
+ * @template M - The API route type
+ * @template D - The DTO type
+ */
 // eslint-disable-next-line @elsikora/typescript/no-unnecessary-type-parameters
-function DtoBuildDecorator(method, propertyMetadata, entity, dtoType, propertyName, currentGuard) {
+function DtoBuildDecorator(method, propertyMetadata, entity, dtoType, propertyName, currentGuard, generatedDTOs) {
     const properties = propertyMetadata.properties?.[method];
     if (properties?.[dtoType]?.isEnabled === false || (properties?.[dtoType]?.isResponse && properties?.[dtoType]?.isExpose === false)) {
         return undefined;
@@ -43,7 +55,7 @@ function DtoBuildDecorator(method, propertyMetadata, entity, dtoType, propertyNa
         }
     }
     const config = DtoGetDecoratorConfig(method, propertyMetadata, dtoType);
-    return [DtoGenerateDecorator(propertyMetadata, entity, config, method, dtoType, propertyName)];
+    return [DtoGenerateDecorator(propertyMetadata, entity, config, method, dtoType, propertyName, generatedDTOs)];
 }
 
 export { DtoBuildDecorator };

package/dist/esm/utility/dto/build-decorator.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-decorator.utility.js","sources":["../../../../../src/utility/dto/build-decorator.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAaA;;;;;;;;;;;;;;AAcG;AACH;AACgB,SAAA,iBAAiB,CAAoD,MAAS,EAAE,gBAAgD,EAAE,MAAqB,EAAE,OAAU,EAAE,YAAoB,EAAE,YAA+B,EAAE,aAA6C,EAAA;IAKxR,MAAM,UAAU,GAA2C,gBAAgB,CAAC,UAAU,GAAG,MAAM,CAA2C;AAE1I,IAAA,IAAI,UAAU,GAAG,OAAO,CAAC,EAAE,SAAS,KAAK,KAAK,KAAK,UAAU,GAAG,OAAO,CAAC,EAAE,UAAU,IAAI,UAAU,GAAG,OAAO,CAAC,EAAE,QAAQ,KAAK,KAAK,CAAC,EAAE;AACnI,QAAA,OAAO,SAAS;;AAGjB,IAAA,IAAI,CAAC,4BAA4B,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE;AACnF,QAAA,OAAO,SAAS;;IAGjB,IAAI,gBAAgB,CAAC,IAAI,KAAK,wBAAwB,CAAC,IAAI,EAAE;QAC5D,MAAM,YAAY,GAAuC,gBAAgB;QAEzE,IAAI,CAAC,MAAM,KAAK,aAAa,CAAC,MAAM,IAAI,MAAM,KAAK,aAAa,CAAC,cAAc,KAAK,OAAO,KAAK,WAAW,CAAC,IAAI,EAAE;AACjH,YAAA,OAAO,SAAS;;AAGjB,QAAA,IAAI,MAAM,KAAK,aAAa,CAAC,QAAQ,IAAI,OAAO,KAAK,WAAW,CAAC,KAAK,EAAE;YACvE,MAAM,cAAc,GAAoE,qBAAqB,CAAC,YAAY,EAAE,YAAY,CAAC,UAAU,CAAC;AAEpJ,YAAA,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,QAAkE,KAAI;AAChG,gBAAA,MAAM,WAAW,GAAmC,EAAE,GAAG,YAAY,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE;AACxG,gBAAA,MAAM,MAAM,GAAsC,qBAAqB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC;AAEpH,gBAAA,OAAO,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC;AACxF,aAAC,CAAC;;;AAIJ,IAAA,MAAM,MAAM,GAAsC,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAqB,CAAC;AAExH,IAAA,OAAO,CAAC,oBAAoB,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;AAC9G;;;;"}

package/dist/esm/utility/dto/generate-decorator.utility.d.ts

@@ -1,4 +1,19 @@
-import type { EApiDtoType, EApiRouteType } from "../../enum";
-import type { IApiEntity } from "../../interface";
-import type { TApiPropertyDescribeDtoProperties, TApiPropertyDescribeProperties } from "../../type";
-export declare function DtoGenerateDecorator<E>(metadata: TApiPropertyDescribeProperties, entity: IApiEntity<E>, config: TApiPropertyDescribeDtoProperties, method: EApiRouteType, dtoType: EApiDtoType, propertyName: string): PropertyDecorator;
+import type { EApiDtoType, EApiRouteType } from '../../enum/decorator/api/index';
+import type { IApiEntity } from '../../interface/entity/index';
+import type { Type } from "@nestjs/common";
+import type { TApiPropertyDescribeDtoProperties, TApiPropertyDescribeProperties } from '../../type/decorator/api/property/index';
+/**
+ * Factory function that generates appropriate property decorators based on property type.
+ * Uses factories defined in DTO_UTILITY_CONSTANT to create the correct decorator for each property type.
+ * @param {TApiPropertyDescribeProperties} metadata - Metadata describing the property
+ * @param {IApiEntity<E>} entity - The entity metadata
+ * @param {TApiPropertyDescribeDtoProperties} config - Configuration for the decorator
+ * @param {EApiRouteType} method - The API route type (CREATE, DELETE, GET, etc.)
+ * @param {EApiDtoType} dtoType - The type of DTO (REQUEST, RESPONSE, etc.)
+ * @param {string} propertyName - The name of the property
+ * @param {Record<string, Type<unknown>>} [generatedDTOs] - Optional record of dynamically generated DTOs
+ * @returns {PropertyDecorator} The generated property decorator
+ * @throws {Error} When property type has no registered factory
+ * @template E - The entity type
+ */
+export declare function DtoGenerateDecorator<E>(metadata: TApiPropertyDescribeProperties, entity: IApiEntity<E>, config: TApiPropertyDescribeDtoProperties, method: EApiRouteType, dtoType: EApiDtoType, propertyName: string, generatedDTOs?: Record<string, Type<unknown>>): PropertyDecorator;

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

@@ -0,0 +1,27 @@
+import { DTO_UTILITY_CONSTANT } from '../../constant/utility/dto/constant.js';
+import { ErrorException } from '../error-exception.utility.js';
+
+/**
+ * Factory function that generates appropriate property decorators based on property type.
+ * Uses factories defined in DTO_UTILITY_CONSTANT to create the correct decorator for each property type.
+ * @param {TApiPropertyDescribeProperties} metadata - Metadata describing the property
+ * @param {IApiEntity<E>} entity - The entity metadata
+ * @param {TApiPropertyDescribeDtoProperties} config - Configuration for the decorator
+ * @param {EApiRouteType} method - The API route type (CREATE, DELETE, GET, etc.)
+ * @param {EApiDtoType} dtoType - The type of DTO (REQUEST, RESPONSE, etc.)
+ * @param {string} propertyName - The name of the property
+ * @param {Record<string, Type<unknown>>} [generatedDTOs] - Optional record of dynamically generated DTOs
+ * @returns {PropertyDecorator} The generated property decorator
+ * @throws {Error} When property type has no registered factory
+ * @template E - The entity type
+ */
+function DtoGenerateDecorator(metadata, entity, config, method, dtoType, propertyName, generatedDTOs) {
+    const factory = DTO_UTILITY_CONSTANT.PROPERTY_DECORATOR_FACTORIES[metadata.type];
+    if (!factory) {
+        throw ErrorException(`Unknown property type ${metadata.type}`);
+    }
+    return factory.create(metadata, entity, config, method, dtoType, propertyName, generatedDTOs);
+}
+
+export { DtoGenerateDecorator };
+//# sourceMappingURL=generate-decorator.utility.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate-decorator.utility.js","sources":["../../../../../src/utility/dto/generate-decorator.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AASA;;;;;;;;;;;;;AAaG;AACa,SAAA,oBAAoB,CAAI,QAAwC,EAAE,MAAqB,EAAE,MAAyC,EAAE,MAAqB,EAAE,OAAoB,EAAE,YAAoB,EAAE,aAA6C,EAAA;IACnQ,MAAM,OAAO,GAA2B,oBAAoB,CAAC,4BAA4B,CAAC,QAAQ,CAAC,IAAI,CAA2B;IAElI,IAAI,CAAC,OAAO,EAAE;QACb,MAAM,cAAc,CAAC,CAAyB,sBAAA,EAAA,QAAQ,CAAC,IAAI,CAAA,CAAE,CAAC;;AAG/D,IAAA,OAAO,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,CAAC;AAC9F;;;;"}

package/dist/esm/utility/dto/generate-dynamic.utility.d.ts

@@ -0,0 +1,21 @@
+import type { EApiDtoType, EApiRouteType } from '../../enum/decorator/api/index';
+import type { IApiEntity } from '../../interface/entity/index';
+import type { Type } from "@nestjs/common";
+import type { IAuthGuard } from "@nestjs/passport";
+import type { TApiPropertyDescribeProperties } from '../../type/decorator/api/property/index';
+/**
+ * Generates dynamic DTOs for object-type properties based on property metadata.
+ * Creates classes on the fly with appropriate decorators for each property and sets up
+ * proper inheritance and naming conventions.
+ * @param {M} method - The API route type (CREATE, DELETE, GET, etc.)
+ * @param {TApiPropertyDescribeProperties} propertyMetadata - Metadata describing the property
+ * @param {IApiEntity<E>} entity - The entity metadata
+ * @param {D} dtoType - The type of DTO (REQUEST, RESPONSE, etc.)
+ * @param {string} _propertyName - The name of the property
+ * @param {Type<IAuthGuard>} [currentGuard] - Optional authentication guard
+ * @returns {Record<string, Type<unknown>> | undefined} A record of generated DTO classes or undefined if generation not needed
+ * @template E - The entity type
+ * @template M - The API route type
+ * @template D - The DTO type
+ */
+export declare function DtoGenerateDynamic<E, M extends EApiRouteType, D extends EApiDtoType>(method: M, propertyMetadata: TApiPropertyDescribeProperties, entity: IApiEntity<E>, dtoType: D, _propertyName: string, currentGuard?: Type<IAuthGuard>): Record<string, Type<unknown>> | undefined;

package/dist/esm/utility/dto/generate-dynamic.utility.js

@@ -0,0 +1,92 @@
+import '../../enum/decorator/api/action.enum.js';
+import '../../enum/decorator/api/authentication-type.enum.js';
+import '../../enum/decorator/api/controller/load-relations-strategy.enum.js';
+import '../../enum/decorator/api/controller/request-transformer-type.enum.js';
+import '../../enum/decorator/api/dto-type.enum.js';
+import '../../enum/decorator/api/function/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-type.enum.js';
+import { CamelCaseString } from '../camel-case-string.utility.js';
+import { DtoBuildDecorator } from './build-decorator.utility.js';
+import { DtoIsPropertyExposedForGuard } from './is-property-exposed-for-guard.utility.js';
+
+/**
+ * Generates dynamic DTOs for object-type properties based on property metadata.
+ * Creates classes on the fly with appropriate decorators for each property and sets up
+ * proper inheritance and naming conventions.
+ * @param {M} method - The API route type (CREATE, DELETE, GET, etc.)
+ * @param {TApiPropertyDescribeProperties} propertyMetadata - Metadata describing the property
+ * @param {IApiEntity<E>} entity - The entity metadata
+ * @param {D} dtoType - The type of DTO (REQUEST, RESPONSE, etc.)
+ * @param {string} _propertyName - The name of the property
+ * @param {Type<IAuthGuard>} [currentGuard] - Optional authentication guard
+ * @returns {Record<string, Type<unknown>> | undefined} A record of generated DTO classes or undefined if generation not needed
+ * @template E - The entity type
+ * @template M - The API route type
+ * @template D - The DTO type
+ */
+// eslint-disable-next-line @elsikora/typescript/no-unnecessary-type-parameters
+function DtoGenerateDynamic(method, propertyMetadata, entity, dtoType, _propertyName, currentGuard) {
+    if (propertyMetadata.type !== EApiPropertyDescribeType.OBJECT) {
+        return undefined;
+    }
+    const properties = propertyMetadata.properties?.[method];
+    if (properties?.[dtoType]?.isEnabled === false || (properties?.[dtoType]?.isResponse && properties?.[dtoType]?.isExpose === false)) {
+        return undefined;
+    }
+    if (!DtoIsPropertyExposedForGuard(method, propertyMetadata, dtoType, currentGuard)) {
+        return undefined;
+    }
+    const generatedDTOs = {};
+    if (propertyMetadata.type === EApiPropertyDescribeType.OBJECT && !Array.isArray(propertyMetadata.dataType) && "isDynamicallyGenerated" in propertyMetadata && propertyMetadata.isDynamicallyGenerated) {
+        const dataForGeneration = [];
+        for (const dynamicDtoName of Object.keys(propertyMetadata.dataType)) {
+            if (propertyMetadata.dataType[dynamicDtoName]) {
+                dataForGeneration.push({
+                    data: propertyMetadata.dataType[dynamicDtoName],
+                    name: dynamicDtoName,
+                });
+            }
+        }
+        for (const { data, name } of dataForGeneration) {
+            class GeneratedDTO {
+                constructor() {
+                    for (const propertyName of Object.keys(data)) {
+                        Object.defineProperty(this, propertyName, {
+                            // 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,
+                        });
+                    }
+                }
+            }
+            for (const propertyName of Object.keys(data)) {
+                if (data[propertyName]) {
+                    const decorators = DtoBuildDecorator(method, data[propertyName], entity, dtoType, propertyName, currentGuard, {});
+                    if (decorators) {
+                        for (const [, decorator] of decorators.entries()) {
+                            decorator(GeneratedDTO.prototype, propertyName);
+                        }
+                    }
+                }
+            }
+            Object.defineProperty(GeneratedDTO, "name", {
+                value: `${entity.name ?? "UnknownResource"}${CamelCaseString(method)}${CamelCaseString(dtoType)}${CamelCaseString(_propertyName)}${CamelCaseString(name)}DTO`,
+            });
+            generatedDTOs[name] = GeneratedDTO;
+        }
+    }
+    return generatedDTOs;
+}
+
+export { DtoGenerateDynamic };
+//# sourceMappingURL=generate-dynamic.utility.js.map

package/dist/esm/utility/dto/generate-dynamic.utility.js.map

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

package/dist/esm/utility/dto/generate-exception.utility.d.ts

@@ -1,2 +1,9 @@
 import { HttpStatus, type Type } from "@nestjs/common";
+/**
+ * Creates exception DTOs with standardized properties based on HTTP status codes.
+ * Generates a class with properties like correlationID, error name, message, status code, and timestamp,
+ * all properly decorated with Swagger and validation decorators.
+ * @param {HttpStatus} httpStatus - The HTTP status code for the exception
+ * @returns {Type<unknown>} A generated DTO class for the exception
+ */
 export declare function DtoGenerateException(httpStatus: HttpStatus): Type<unknown>;

package/dist/esm/{src/utility → utility}/dto/generate-exception.utility.js

@@ -1,7 +1,5 @@
-import { __decorate, __metadata } from '../../../external/tslib/tslib.es6.js';
-import { HttpStatus } from '@nestjs/common';
+import { __decorate, __metadata } from '../../external/tslib/tslib.es6.js';
 import { DATE_CONSTANT } from '../../constant/date.constant.js';
-import '../../constant/decorator/api/function.constant.js';
 import { EXCEPTION_DTO_CONSTANT } from '../../constant/dto/exception.constant.js';
 import { NUMBER_CONSTANT } from '../../constant/number.constant.js';
 import { ApiPropertyEnum } from '../../decorator/api/property/enum.decorator.js';
@@ -21,11 +19,16 @@ import '../../enum/decorator/api/property/desribe-type.enum.js';
 import { EApiPropertyNumberType } from '../../enum/decorator/api/property/number-type.enum.js';
 import { EApiPropertyStringType } from '../../enum/decorator/api/property/string-type.enum.js';
 import '../../enum/decorator/api/route-type.enum.js';
-import '../../enum/exception.enum.js';
-import '../../enum/filter-order-direction.enum.js';
-import '../../enum/utility/error-string-action.enum.js';
+import { HttpStatus } from '@nestjs/common';
 import { CamelCaseString } from '../camel-case-string.utility.js';
 
+/**
+ * Creates exception DTOs with standardized properties based on HTTP status codes.
+ * Generates a class with properties like correlationID, error name, message, status code, and timestamp,
+ * all properly decorated with Swagger and validation decorators.
+ * @param {HttpStatus} httpStatus - The HTTP status code for the exception
+ * @returns {Type<unknown>} A generated DTO class for the exception
+ */
 function DtoGenerateException(httpStatus) {
     const errorName = HttpStatus[httpStatus];
     class GeneratedErrorDTO {

package/dist/esm/utility/dto/generate-exception.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-exception.utility.js","sources":["../../../../../src/utility/dto/generate-exception.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAWA;;;;;;AAMG;AACG,SAAU,oBAAoB,CAAC,UAAsB,EAAA;AAC1D,IAAA,MAAM,SAAS,GAAW,UAAU,CAAC,UAAU,CAAC;AAEhD,IAAA,MAAM,iBAAiB,CAAA;AAEtB,QAAA,aAAa;AAYb,QAAA,KAAK,GAAW,eAAe,CAAC,SAAS,CAAC;QAY1C,OAAO,GAAW,eAAe;QAUjC,UAAU,GAAe,UAAU;AAYnC,QAAA,SAAS;AACT;AA/CA,IAAA,UAAA,CAAA;AADC,QAAA,eAAe,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;;AAChD,KAAA,EAAA,iBAAA,CAAA,SAAA,EAAA,eAAA,EAAA,MAAA,CAAA;AAYvB,IAAA,UAAA,CAAA;AAVC,QAAA,iBAAiB,CAAC;AAClB,YAAA,WAAW,EAAE,MAAM;AACnB,YAAA,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;AACzB,YAAA,YAAY,EAAE,eAAe,CAAC,SAAS,CAAC;YACxC,MAAM,EAAE,sBAAsB,CAAC,MAAM;AACrC,YAAA,UAAU,EAAE,IAAI;YAChB,SAAS,EAAE,sBAAsB,CAAC,oBAAoB;YACtD,SAAS,EAAE,sBAAsB,CAAC,oBAAoB;AACtD,YAAA,OAAO,EAAE,sBAAsB;SAC/B,CAAC;;AACyC,KAAA,EAAA,iBAAA,CAAA,SAAA,EAAA,OAAA,EAAA,MAAA,CAAA;AAY3C,IAAA,UAAA,CAAA;AAVC,QAAA,iBAAiB,CAAC;AAClB,YAAA,WAAW,EAAE,SAAS;AACtB,YAAA,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;AACzB,YAAA,YAAY,EAAE,eAAe;YAC7B,MAAM,EAAE,sBAAsB,CAAC,MAAM;AACrC,YAAA,UAAU,EAAE,IAAI;YAChB,SAAS,EAAE,sBAAsB,CAAC,4BAA4B;YAC9D,SAAS,EAAE,sBAAsB,CAAC,4BAA4B;AAC9D,YAAA,OAAO,EAAE,sBAAsB;SAC/B,CAAC;;AACgC,KAAA,EAAA,iBAAA,CAAA,SAAA,EAAA,SAAA,EAAA,MAAA,CAAA;AAUlC,IAAA,UAAA,CAAA;AARC,QAAA,eAAe,CAAC;AAChB,YAAA,WAAW,EAAE,aAAa;AAC1B,YAAA,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;AACzB,YAAA,IAAI,EAAE,UAAU;AAChB,YACA,YAAY,EAAE,UAAU;AACxB,YAAA,UAAU,EAAE,IAAI;SAChB,CAAC;;AACkC,KAAA,EAAA,iBAAA,CAAA,SAAA,EAAA,YAAA,EAAA,MAAA,CAAA;AAYpC,IAAA,UAAA,CAAA;AAVC,QAAA,iBAAiB,CAAC;AAClB,YAAA,WAAW,EAAE,WAAW;AACxB,YAAA,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;AACzB,YAAA,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;YACxB,MAAM,EAAE,sBAAsB,CAAC,OAAO;AACtC,YAAA,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,aAAa,CAAC,iBAAiB;YACxC,OAAO,EAAE,aAAa,CAAC,iBAAiB;YACxC,UAAU,EAAE,eAAe,CAAC,GAAG;SAC/B,CAAC;;AACiB,KAAA,EAAA,iBAAA,CAAA,SAAA,EAAA,WAAA,EAAA,MAAA,CAAA;AAGpB,IAAA,MAAM,CAAC,cAAc,CAAC,iBAAiB,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,CAAA,SAAA,EAAY,eAAe,CAAC,SAAS,CAAC,CAAK,GAAA,CAAA,EAAE,CAAC;AAExG,IAAA,OAAO,iBAAiB;AACzB;;;;"}

package/dist/esm/utility/dto/generate-filter-decorator.utility.d.ts

@@ -1,3 +1,12 @@
-import type { IApiEntity } from "../../interface";
-import type { TApiPropertyDescribeProperties } from "../../type";
+import type { IApiEntity } from '../../interface/entity/index';
+import type { TApiPropertyDescribeProperties } from '../../type/decorator/api/property/index';
+/**
+ * Generates filter operation enum decorators based on property type.
+ * Maps different property types (boolean, date, enum, number, string, etc.) to their
+ * corresponding filter operation enums.
+ * @param {TApiPropertyDescribeProperties} metadata - Metadata describing the property
+ * @param {IApiEntity<E>} entity - The entity metadata
+ * @returns {PropertyDecorator} A decorator that adds the appropriate filter operation enum
+ * @template E - The entity type
+ */
 export declare function DtoGenerateFilterDecorator<E>(metadata: TApiPropertyDescribeProperties, entity: IApiEntity<E>): PropertyDecorator;

package/dist/esm/{src/utility → utility}/dto/generate-filter-decorator.utility.js

@@ -12,11 +12,17 @@ import { EApiPropertyDescribeType } from '../../enum/decorator/api/property/desr
 import '../../enum/decorator/api/property/number-type.enum.js';
 import '../../enum/decorator/api/property/string-type.enum.js';
 import '../../enum/decorator/api/route-type.enum.js';
-import '../../enum/exception.enum.js';
-import '../../enum/filter-order-direction.enum.js';
-import '../../enum/utility/error-string-action.enum.js';
 import { EFilterOperationUuid, EFilterOperationString, EFilterOperationRelation, EFilterOperationObject, EFilterOperationNumber, EFilterOperationEnum, EFilterOperationDate, EFilterOperationBoolean } from '../../enum/filter-operation.enum.js';
 
+/**
+ * Generates filter operation enum decorators based on property type.
+ * Maps different property types (boolean, date, enum, number, string, etc.) to their
+ * corresponding filter operation enums.
+ * @param {TApiPropertyDescribeProperties} metadata - Metadata describing the property
+ * @param {IApiEntity<E>} entity - The entity metadata
+ * @returns {PropertyDecorator} A decorator that adds the appropriate filter operation enum
+ * @template E - The entity type
+ */
 function DtoGenerateFilterDecorator(metadata, entity) {
     switch (metadata.type) {
         case EApiPropertyDescribeType.BOOLEAN: {

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate-filter-decorator.utility.js","sources":["../../../../../src/utility/dto/generate-filter-decorator.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;AAOA;;;;;;;;AAQG;AACa,SAAA,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,EAAuC,UAAU,EAAE,KAAK,EAAE,CAAC;;AAG7J,QAAA,KAAK,wBAAwB,CAAC,IAAI,EAAE;;AAGnC,YAAA,OAAO,eAAe,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,EAAoC,UAAU,EAAE,KAAK,EAAE,CAAC;;AAGpH,QAAA,KAAK,wBAAwB,CAAC,IAAI,EAAE;YACnC,OAAO,eAAe,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,EAAoC,UAAU,EAAE,KAAK,EAAE,CAAC;;AAGvJ,QAAA,KAAK,wBAAwB,CAAC,MAAM,EAAE;;YAGrC,OAAO,eAAe,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,EAAsC,UAAU,EAAE,KAAK,EAAE,CAAC;;AAG3J,QAAA,KAAK,wBAAwB,CAAC,MAAM,EAAE;YACrC,OAAO,eAAe,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,EAAsC,UAAU,EAAE,KAAK,EAAE,CAAC;;AAG3J,QAAA,KAAK,wBAAwB,CAAC,QAAQ,EAAE;YACvC,OAAO,eAAe,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,wBAAwB,EAAwC,UAAU,EAAE,KAAK,EAAE,CAAC;;AAG/J,QAAA,KAAK,wBAAwB,CAAC,MAAM,EAAE;YACrC,OAAO,eAAe,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,EAAsC,UAAU,EAAE,KAAK,EAAE,CAAC;;AAG3J,QAAA,KAAK,wBAAwB,CAAC,IAAI,EAAE;YACnC,OAAO,eAAe,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,EAAoC,UAAU,EAAE,KAAK,EAAE,CAAC;;;AAGzJ;;;;"}

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

@@ -1,4 +1,13 @@
 import { Type } from "@nestjs/common";
 type TClassType<T = any> = new (...arguments_: Array<any>) => T;
+/**
+ * Generates a DTO for paginated list responses with appropriate metadata.
+ * Creates a class with count, currentPage, items, totalCount, and totalPages properties,
+ * all properly decorated with Swagger and validation decorators.
+ * @param {TClassType} resourceClass - The class representing the entity being listed
+ * @param {TClassType} responseResourceClass - The response DTO class for individual items
+ * @param {string} name - The name for the generated DTO class
+ * @returns {Type<unknown>} A generated DTO class for paginated list responses
+ */
 export declare function DtoGenerateGetListResponse(resourceClass: TClassType, responseResourceClass: TClassType, name: string): Type<unknown>;
 export {};

package/dist/esm/{src/utility → utility}/dto/generate-get-list-response.utility.js

@@ -1,8 +1,7 @@
-import { __decorate, __metadata } from '../../../external/tslib/tslib.es6.js';
-import { PickType } from '@nestjs/swagger';
+import { __decorate, __metadata } from '../../external/tslib/tslib.es6.js';
+import { LIST_DTO_CONSTANT } from '../../constant/dto/list.constant.js';
 import { ApiPropertyNumber } from '../../decorator/api/property/number.decorator.js';
 import { ApiPropertyObject } from '../../decorator/api/property/object.decorator.js';
-import LIST_DTO_CONSTANT from '../../constant/dto/list.constant.js';
 import '../../enum/decorator/api/action.enum.js';
 import '../../enum/decorator/api/authentication-type.enum.js';
 import '../../enum/decorator/api/controller/load-relations-strategy.enum.js';
@@ -16,10 +15,17 @@ import '../../enum/decorator/api/property/desribe-type.enum.js';
 import { EApiPropertyNumberType } from '../../enum/decorator/api/property/number-type.enum.js';
 import '../../enum/decorator/api/property/string-type.enum.js';
 import '../../enum/decorator/api/route-type.enum.js';
-import '../../enum/exception.enum.js';
-import '../../enum/filter-order-direction.enum.js';
-import '../../enum/utility/error-string-action.enum.js';
+import { PickType } from '@nestjs/swagger';
 
+/**
+ * Generates a DTO for paginated list responses with appropriate metadata.
+ * Creates a class with count, currentPage, items, totalCount, and totalPages properties,
+ * all properly decorated with Swagger and validation decorators.
+ * @param {TClassType} resourceClass - The class representing the entity being listed
+ * @param {TClassType} responseResourceClass - The response DTO class for individual items
+ * @param {string} name - The name for the generated DTO class
+ * @returns {Type<unknown>} A generated DTO class for paginated list responses
+ */
 function DtoGenerateGetListResponse(resourceClass, responseResourceClass, name) {
     class ApiListGetResponse extends PickType(resourceClass, []) {
         count;

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate-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-relation-response.utility.d.ts

@@ -1,4 +1,14 @@
 import type { Type } from "@nestjs/common";
-import type { IApiEntity } from "../../interface";
-import { EApiDtoType, EApiRouteType } from "../../enum";
+import { EApiDtoType, EApiRouteType } from '../../enum/decorator/api/index';
+import { IApiEntity } from '../../interface/entity/index';
+/**
+ * Creates a simple relationship DTO containing only an ID field.
+ * Used for representing related entities in API responses with minimal information.
+ * @param {IApiEntity<E>} entity - The entity metadata
+ * @param {EApiRouteType} method - The API route type (CREATE, DELETE, GET, etc.)
+ * @param {EApiDtoType} dtoType - The type of DTO (REQUEST, RESPONSE, etc.)
+ * @param {string} propertyName - The name of the relation property
+ * @returns {Type<unknown>} A generated DTO class for relation representation
+ * @template E - The entity type
+ */
 export declare function DtoGenerateRelationResponse<E>(entity: IApiEntity<E>, method: EApiRouteType, dtoType: EApiDtoType, propertyName: string): Type<unknown>;

package/dist/esm/{src/utility → utility}/dto/generate-relation-response.utility.js

@@ -1,8 +1,18 @@
-import { __decorate, __metadata } from '../../../external/tslib/tslib.es6.js';
+import { __decorate, __metadata } from '../../external/tslib/tslib.es6.js';
 import { ApiPropertyUUID } from '../../decorator/api/property/uuid.decorator.js';
 import { CamelCaseString } from '../camel-case-string.utility.js';
 import { CapitalizeString } from '../capitalize-string.utility.js';
 
+/**
+ * Creates a simple relationship DTO containing only an ID field.
+ * Used for representing related entities in API responses with minimal information.
+ * @param {IApiEntity<E>} entity - The entity metadata
+ * @param {EApiRouteType} method - The API route type (CREATE, DELETE, GET, etc.)
+ * @param {EApiDtoType} dtoType - The type of DTO (REQUEST, RESPONSE, etc.)
+ * @param {string} propertyName - The name of the relation property
+ * @returns {Type<unknown>} A generated DTO class for relation representation
+ * @template E - The entity type
+ */
 function DtoGenerateRelationResponse(entity, method, dtoType, propertyName) {
     class GeneratedRelationDTO {
         id;

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate-relation-response.utility.js","sources":["../../../../../src/utility/dto/generate-relation-response.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAQA;;;;;;;;;AASG;AACG,SAAU,2BAA2B,CAAI,MAAqB,EAAE,MAAqB,EAAE,OAAoB,EAAE,YAAoB,EAAA;AACtI,IAAA,MAAM,oBAAoB,CAAA;AAEzB,QAAA,EAAE;AACF;AADA,IAAA,UAAA,CAAA;QADC,eAAe,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;;AAClC,KAAA,EAAA,oBAAA,CAAA,SAAA,EAAA,IAAA,EAAA,MAAA,CAAA;AAGb,IAAA,MAAM,CAAC,cAAc,CAAC,oBAAoB,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,CAAG,EAAA,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAG,EAAA,eAAe,CAAC,MAAM,CAAC,CAAG,EAAA,eAAe,CAAC,OAAO,CAAC,CAAG,EAAA,gBAAgB,CAAC,YAAY,CAAC,CAAK,GAAA,CAAA,EAAE,CAAC;AAEjL,IAAA,OAAO,oBAAoB;AAC5B;;;;"}

package/dist/esm/utility/dto/generate.utility.d.ts

@@ -1,6 +1,21 @@
+import type { IApiControllerPropertiesRouteAutoDtoConfig } from '../../interface/decorator/api/index';
+import type { IApiEntity } from '../../interface/entity/index';
 import type { Type } from "@nestjs/common";
 import type { IAuthGuard } from "@nestjs/passport";
 import type { ObjectLiteral } from "typeorm";
-import type { IApiControllerPropertiesRouteAutoDtoConfig, IApiEntity } from "../../interface";
-import { EApiDtoType, EApiRouteType } from "../../enum";
+import { EApiDtoType, EApiRouteType } from '../../enum/decorator/api/index';
+/**
+ * Core utility for DTO generation that determines which properties should be included in the DTO.
+ * Builds decorators, handles special cases like filter queries, and generates the appropriate class
+ * based on entity metadata, route type, and DTO type.
+ * @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 (CREATE, DELETE, GET, etc.)
+ * @param {EApiDtoType} dtoType - The type of DTO (REQUEST, RESPONSE, etc.)
+ * @param {IApiControllerPropertiesRouteAutoDtoConfig} [dtoConfig] - Optional configuration for automatic DTO generation
+ * @param {Type<IAuthGuard>} [currentGuard] - Optional authentication guard for property visibility control
+ * @returns {Type<unknown> | undefined} The generated DTO class or undefined if no DTO should be generated
+ * @throws {Error} When primary key metadata is missing
+ * @template E - The entity type
+ */
 export declare function DtoGenerate<E>(entity: ObjectLiteral, entityMetadata: IApiEntity<E>, method: EApiRouteType, dtoType: EApiDtoType, dtoConfig?: IApiControllerPropertiesRouteAutoDtoConfig, currentGuard?: Type<IAuthGuard>): Type<unknown> | undefined;

package/dist/esm/{src/utility → utility}/dto/generate.utility.js

@@ -1,4 +1,3 @@
-import { Validate } from 'class-validator';
 import '../../constant/decorator/api/function.constant.js';
 import { PROPERTY_DESCRIBE_DECORATOR_API_CONSTANT } from '../../constant/decorator/api/property-describe.constant.js';
 import { DTO_GENERATE_CONSTANT } from '../../constant/utility/dto/generate.constant.js';
@@ -11,23 +10,37 @@ import '../../enum/decorator/api/function/type.enum.js';
 import '../../enum/decorator/api/property/data-type.enum.js';
 import '../../enum/decorator/api/property/date/identifier.enum.js';
 import '../../enum/decorator/api/property/date/type.enum.js';
-import '../../enum/decorator/api/property/desribe-type.enum.js';
+import { 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 { EApiRouteType } from '../../enum/decorator/api/route-type.enum.js';
-import '../../enum/exception.enum.js';
-import '../../enum/filter-order-direction.enum.js';
-import '../../enum/utility/error-string-action.enum.js';
-import { HasPairedCustomSuffixesFields } from '../../validator/has-paired-custom-suffixes-fields.validator.js';
+import { ApiExtraModels } from '@nestjs/swagger';
 import { CamelCaseString } from '../camel-case-string.utility.js';
-import { ErrorException } from '../error-exception.utility.js';
 import { DtoBuildDecorator } from './build-decorator.utility.js';
+import { DtoGenerateDynamic } from './generate-dynamic.utility.js';
 import { DtoGenerateFilterDecorator } from './generate-filter-decorator.utility.js';
 import { DtoGenerateGetListResponse } from './generate-get-list-response.utility.js';
 import { DtoGetGetListQueryBaseClass } from './get-get-list-query-base-class.utility.js';
 import { DtoIsPropertyShouldBeMarked } from './is-property-should-be-marked.utility.js';
 import { DtoIsShouldBeGenerated } from './is-should-be-generated.utility.js';
+import { ErrorException } from '../error-exception.utility.js';
+import { HasPairedCustomSuffixesFieldsValidator } from '../../validator/has-paired-custom-suffixes-fields.validator.js';
+import { Validate } from 'class-validator';
 
+/**
+ * Core utility for DTO generation that determines which properties should be included in the DTO.
+ * Builds decorators, handles special cases like filter queries, and generates the appropriate class
+ * based on entity metadata, route type, and DTO type.
+ * @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 (CREATE, DELETE, GET, etc.)
+ * @param {EApiDtoType} dtoType - The type of DTO (REQUEST, RESPONSE, etc.)
+ * @param {IApiControllerPropertiesRouteAutoDtoConfig} [dtoConfig] - Optional configuration for automatic DTO generation
+ * @param {Type<IAuthGuard>} [currentGuard] - Optional authentication guard for property visibility control
+ * @returns {Type<unknown> | undefined} The generated DTO class or undefined if no DTO should be generated
+ * @throws {Error} When primary key metadata is missing
+ * @template E - The entity type
+ */
 function DtoGenerate(entity, entityMetadata, method, dtoType, dtoConfig, currentGuard) {
     if (!DtoIsShouldBeGenerated(method, dtoType)) {
         return undefined;
@@ -35,6 +48,8 @@ function DtoGenerate(entity, entityMetadata, method, dtoType, dtoConfig, current
     if (!entityMetadata.primaryKey?.metadata?.[PROPERTY_DESCRIBE_DECORATOR_API_CONSTANT.METADATA_PROPERTY_NAME]) {
         throw ErrorException(`Primary key for entity ${String(entityMetadata.name)} not found in metadata storage`);
     }
+    // eslint-disable-next-line @elsikora/typescript/no-unsafe-function-type
+    const extraModels = [];
     const markedProperties = [];
     for (const column of entityMetadata.columns) {
         if (column.metadata?.[PROPERTY_DESCRIBE_DECORATOR_API_CONSTANT.METADATA_PROPERTY_NAME] && DtoIsPropertyShouldBeMarked(method, dtoType, column.name, column.metadata[PROPERTY_DESCRIBE_DECORATOR_API_CONSTANT.METADATA_PROPERTY_NAME], column.isPrimary, currentGuard)) {
@@ -95,7 +110,8 @@ function DtoGenerate(entity, entityMetadata, method, dtoType, dtoConfig, current
         }
     }
     for (const property of markedProperties) {
-        const decorators = DtoBuildDecorator(method, property.metadata, entityMetadata, dtoType, property.name, currentGuard);
+        const generatedDTOs = DtoGenerateDynamic(method, property.metadata, entityMetadata, dtoType, property.name, currentGuard);
+        const decorators = DtoBuildDecorator(method, property.metadata, entityMetadata, dtoType, property.name, currentGuard, generatedDTOs);
         if (decorators) {
             for (const [, decorator] of decorators.entries()) {
                 if (method === EApiRouteType.GET_LIST && dtoType === EApiDtoType.QUERY) {
@@ -117,6 +133,15 @@ function DtoGenerate(entity, entityMetadata, method, dtoType, dtoConfig, current
                 }
             }
         }
+        if (property.metadata.type === EApiPropertyDescribeType.OBJECT && Array.isArray(property.metadata.dataType)) {
+            // @ts-ignore
+            extraModels.push(...property.metadata.dataType);
+        }
+        if (generatedDTOs) {
+            for (const [, value] of Object.entries(generatedDTOs)) {
+                extraModels.push(value);
+            }
+        }
     }
     if (dtoConfig?.validators) {
         for (const validator of dtoConfig.validators) {
@@ -135,13 +160,16 @@ function DtoGenerate(entity, entityMetadata, method, dtoType, dtoConfig, current
             // eslint-disable-next-line @elsikora/typescript/naming-convention
             writable: true,
         });
-        Validate(HasPairedCustomSuffixesFields, ["operator", ["value", "values"]])(GeneratedDTO.prototype, "object");
+        Validate(HasPairedCustomSuffixesFieldsValidator, ["operator", ["value", "values"]])(GeneratedDTO.prototype, "object");
+    }
+    if (extraModels.length > 0) {
+        ApiExtraModels(...extraModels)(GeneratedDTO);
     }
     Object.defineProperty(GeneratedDTO, "name", {
-        value: `${entityMetadata.name ?? "UnknownResource"}${CamelCaseString(method)}${CamelCaseString(dtoType)}ItemsDTO`,
+        value: `${entityMetadata.name ?? "UnknownResource"}${CamelCaseString(method)}${CamelCaseString(dtoType)}DTO`,
     });
     // @ts-ignore
-    return method === EApiRouteType.GET_LIST && dtoType === EApiDtoType.RESPONSE ? DtoGenerateGetListResponse(entity, GeneratedDTO, `${entityMetadata.name ?? "UnknownResource"}${CamelCaseString(method)}${CamelCaseString(dtoType)}DTO`) : GeneratedDTO;
+    return method === EApiRouteType.GET_LIST && dtoType === EApiDtoType.RESPONSE ? DtoGenerateGetListResponse(entity, GeneratedDTO, `${entityMetadata.name ?? "UnknownResource"}${CamelCaseString(method)}${CamelCaseString(dtoType)}ItemsDTO`) : GeneratedDTO;
 }
 
 export { DtoGenerate };

package/dist/esm/utility/dto/generate.utility.js.map

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