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

package/dist/cjs/decorator/api/property/enum.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"enum.decorator.js","sources":["../../../../../../src/decorator/api/property/enum.decorator.ts"],"sourcesContent":[null],"names":["applyDecorators","ApiProperty","IsEnum","IsOptional","IsArray","ArrayMinSize","ArrayMaxSize","ArrayNotEmpty","ApiResponseProperty","Expose","Exclude"],"mappings":"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"}
+{"version":3,"file":"enum.decorator.js","sources":["../../../../../../src/decorator/api/property/enum.decorator.ts"],"sourcesContent":[null],"names":["applyDecorators","ApiProperty","IsEnum","IsOptional","IsArray","ArrayMinSize","ArrayMaxSize","ArrayNotEmpty","ApiResponseProperty","Expose","Exclude"],"mappings":"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"}

package/dist/cjs/decorator/api/property/index.d.ts

@@ -1,7 +1,9 @@
-export * from "./boolean.decorator";
-export * from "./date.decorator";
-export * from "./describe.decorator";
-export * from "./number.decorator";
-export * from "./object.decorator";
-export * from "./string.decorator";
-export * from "./uuid.decorator";
+export { ApiPropertyBoolean } from './boolean.decorator';
+export { ApiPropertyCopy } from './copy.decorator';
+export { ApiPropertyDate } from './date.decorator';
+export { ApiPropertyDescribe } from './describe.decorator';
+export { ApiPropertyEnum } from './enum.decorator';
+export { ApiPropertyNumber } from './number.decorator';
+export { ApiPropertyObject } from './object.decorator';
+export { ApiPropertyString } from './string.decorator';
+export { ApiPropertyUUID } from './uuid.decorator';

package/dist/cjs/decorator/api/property/number.decorator.d.ts

@@ -1,2 +1,68 @@
-import type { TApiPropertyNumberProperties } from "../../../type/decorator/api/property/number-properties.type";
+import type { TApiPropertyNumberProperties } from '../../../type/decorator/api/property/index';
+/**
+ * Creates a decorator that applies NestJS Swagger and class-validator/class-transformer decorators
+ * for number properties in DTOs.
+ *
+ * This decorator handles number properties with support for:
+ * - Integer and double/float formats
+ * - Single numbers or arrays of numbers
+ * - Response/Request specific decorators
+ * - Min/max value constraints
+ * - Multiple-of validation
+ * - Automatic transformation from string to number
+ * - Range validation
+ *
+ * The decorator can automatically generate an example value within the specified range
+ * if one is not provided, and applies appropriate validation rules based on the configuration.
+ * @param {TApiPropertyNumberProperties} properties - Configuration options for the number property
+ * @returns {Function} A decorator function that can be applied to a class property
+ * @example
+ * ```typescript
+ * // Simple integer property
+ * class ProductDto {
+ *   @ApiPropertyNumber({
+ *     entity: { name: 'Product' },
+ *     description: 'quantity',
+ *     format: EApiPropertyNumberType.INTEGER,
+ *     isRequired: true,
+ *     minimum: 1,
+ *     maximum: 100,
+ *     exampleValue: 10
+ *   })
+ *   quantity: number;
+ * }
+ *
+ * // Float property with multiple-of validation
+ * class PriceDto {
+ *   @ApiPropertyNumber({
+ *     entity: { name: 'Price' },
+ *     description: 'amount',
+ *     format: EApiPropertyNumberType.DOUBLE,
+ *     isRequired: true,
+ *     minimum: 0.01,
+ *     maximum: 999999.99,
+ *     multipleOf: 0.01,
+ *     exampleValue: 29.99
+ *   })
+ *   amount: number;
+ * }
+ *
+ * // Array of numbers
+ * class PointsDto {
+ *   @ApiPropertyNumber({
+ *     entity: { name: 'Coordinate' },
+ *     description: 'values',
+ *     format: EApiPropertyNumberType.INTEGER,
+ *     isArray: true,
+ *     minItems: 2,
+ *     maxItems: 3,
+ *     isUniqueItems: true,
+ *     minimum: -180,
+ *     maximum: 180,
+ *     exampleValue: [45, 90, 135]
+ *   })
+ *   coordinates: number[];
+ * }
+ * ```
+ */
 export declare function ApiPropertyNumber(properties: TApiPropertyNumberProperties): <Y>(target: object, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;

package/dist/cjs/decorator/api/property/number.decorator.js

@@ -1,11 +1,5 @@
 'use strict';
 
-var common = require('@nestjs/common');
-var swagger = require('@nestjs/swagger');
-var classTransformer = require('class-transformer');
-var classValidator = require('class-validator');
-var random = require('lodash/random');
-require('../../../constant/decorator/api/function.constant.js');
 var number_constant = require('../../../constant/number.constant.js');
 require('../../../enum/decorator/api/action.enum.js');
 require('../../../enum/decorator/api/authentication-type.enum.js');
@@ -20,10 +14,78 @@ require('../../../enum/decorator/api/property/desribe-type.enum.js');
 var numberType_enum = require('../../../enum/decorator/api/property/number-type.enum.js');
 require('../../../enum/decorator/api/property/string-type.enum.js');
 require('../../../enum/decorator/api/route-type.enum.js');
-require('../../../enum/exception.enum.js');
-require('../../../enum/filter-order-direction.enum.js');
-require('../../../enum/utility/error-string-action.enum.js');
+var common = require('@nestjs/common');
+var swagger = require('@nestjs/swagger');
+var classTransformer = require('class-transformer');
+var classValidator = require('class-validator');
+var random = require('lodash/random');
 
+/**
+ * Creates a decorator that applies NestJS Swagger and class-validator/class-transformer decorators
+ * for number properties in DTOs.
+ *
+ * This decorator handles number properties with support for:
+ * - Integer and double/float formats
+ * - Single numbers or arrays of numbers
+ * - Response/Request specific decorators
+ * - Min/max value constraints
+ * - Multiple-of validation
+ * - Automatic transformation from string to number
+ * - Range validation
+ *
+ * The decorator can automatically generate an example value within the specified range
+ * if one is not provided, and applies appropriate validation rules based on the configuration.
+ * @param {TApiPropertyNumberProperties} properties - Configuration options for the number property
+ * @returns {Function} A decorator function that can be applied to a class property
+ * @example
+ * ```typescript
+ * // Simple integer property
+ * class ProductDto {
+ *   @ApiPropertyNumber({
+ *     entity: { name: 'Product' },
+ *     description: 'quantity',
+ *     format: EApiPropertyNumberType.INTEGER,
+ *     isRequired: true,
+ *     minimum: 1,
+ *     maximum: 100,
+ *     exampleValue: 10
+ *   })
+ *   quantity: number;
+ * }
+ *
+ * // Float property with multiple-of validation
+ * class PriceDto {
+ *   @ApiPropertyNumber({
+ *     entity: { name: 'Price' },
+ *     description: 'amount',
+ *     format: EApiPropertyNumberType.DOUBLE,
+ *     isRequired: true,
+ *     minimum: 0.01,
+ *     maximum: 999999.99,
+ *     multipleOf: 0.01,
+ *     exampleValue: 29.99
+ *   })
+ *   amount: number;
+ * }
+ *
+ * // Array of numbers
+ * class PointsDto {
+ *   @ApiPropertyNumber({
+ *     entity: { name: 'Coordinate' },
+ *     description: 'values',
+ *     format: EApiPropertyNumberType.INTEGER,
+ *     isArray: true,
+ *     minItems: 2,
+ *     maxItems: 3,
+ *     isUniqueItems: true,
+ *     minimum: -180,
+ *     maximum: 180,
+ *     exampleValue: [45, 90, 135]
+ *   })
+ *   coordinates: number[];
+ * }
+ * ```
+ */
 function ApiPropertyNumber(properties) {
     if (properties.exampleValue === undefined) {
         properties.exampleValue = random(properties.minimum, properties.maximum);
@@ -33,6 +95,14 @@ function ApiPropertyNumber(properties) {
     const decorators = buildDecorators(properties, apiPropertyOptions);
     return common.applyDecorators(...decorators);
 }
+/**
+ * Builds the API property options object from the provided property configuration.
+ * Sets up number-specific properties including format, min/max values, example value,
+ * and multiple-of constraint.
+ * @param {TApiPropertyNumberProperties} properties - The property configuration
+ * @returns {ApiPropertyOptions} The Swagger API property options object
+ * @private
+ */
 function buildApiPropertyOptions(properties) {
     const apiPropertyOptions = {
         description: `${String(properties.entity.name)} ${properties.description ?? ""}`,
@@ -54,16 +124,32 @@ function buildApiPropertyOptions(properties) {
     }
     apiPropertyOptions.minimum = properties.minimum;
     apiPropertyOptions.maximum = properties.maximum;
-    if ((properties.isResponse === false || properties.isResponse === undefined) && properties.multipleOf !== undefined) {
+    if ((properties.isResponse === false || properties.isResponse === undefined) && properties.multipleOf != undefined) {
         apiPropertyOptions.multipleOf = properties.multipleOf;
     }
     return apiPropertyOptions;
 }
+/**
+ * Builds all the necessary decorators for the number property based on the configuration.
+ * Combines API property decorators, response decorators, request decorators, format decorators,
+ * transform decorators, and number validation decorators.
+ * @param {TApiPropertyNumberProperties} properties - The property configuration
+ * @param {ApiPropertyOptions} apiPropertyOptions - The Swagger API property options
+ * @returns {Array<PropertyDecorator>} An array of decorators to apply to the property
+ * @private
+ */
 function buildDecorators(properties, apiPropertyOptions) {
     const decorators = [swagger.ApiProperty(apiPropertyOptions)];
     decorators.push(...buildResponseDecorators(properties), ...buildRequestDecorators(properties), ...buildFormatDecorators(properties), ...buildTransformDecorators(properties), ...buildNumberValidationDecorators(properties));
     return decorators;
 }
+/**
+ * Builds decorators for number format validation based on the specified format type.
+ * Handles integer and double/float formats with appropriate validators.
+ * @param {TApiPropertyNumberProperties} properties - The property configuration
+ * @returns {Array<PropertyDecorator>} An array of format-specific validation decorators
+ * @private
+ */
 function buildFormatDecorators(properties) {
     const decorators = [];
     const isArray = properties.isArray ?? false;
@@ -87,15 +173,29 @@ function buildFormatDecorators(properties) {
     }
     return decorators;
 }
+/**
+ * Builds decorators for number-specific validation including multiple-of constraint,
+ * minimum value, and maximum value validation.
+ * @param {TApiPropertyNumberProperties} properties - The property configuration
+ * @returns {Array<PropertyDecorator>} An array of number validation decorators
+ * @private
+ */
 function buildNumberValidationDecorators(properties) {
     const decorators = [];
     const isArray = properties.isArray ?? false;
-    if ((properties.isResponse === false || properties.isResponse === undefined) && properties.multipleOf !== undefined) {
+    if ((properties.isResponse === false || properties.isResponse === undefined) && properties.multipleOf != undefined) {
         // eslint-disable-next-line @elsikora/typescript/naming-convention
         decorators.push(classValidator.IsDivisibleBy(properties.multipleOf, { each: isArray }), classValidator.Min(properties.minimum, { each: isArray }), classValidator.Max(properties.maximum, { each: isArray }));
     }
     return decorators;
 }
+/**
+ * Builds decorators for request validation including optional status,
+ * array validation, and size constraints for number properties.
+ * @param {TApiPropertyNumberProperties} properties - The property configuration
+ * @returns {Array<PropertyDecorator>} An array of request validation decorators
+ * @private
+ */
 function buildRequestDecorators(properties) {
     const decorators = [];
     if (properties.isResponse === false || properties.isResponse === undefined) {
@@ -111,6 +211,13 @@ function buildRequestDecorators(properties) {
     }
     return decorators;
 }
+/**
+ * Builds decorators for response serialization including API response property,
+ * expose, and exclude decorators for number properties.
+ * @param {TApiPropertyNumberProperties} properties - The property configuration
+ * @returns {Array<PropertyDecorator>} An array of response serialization decorators
+ * @private
+ */
 function buildResponseDecorators(properties) {
     const decorators = [];
     if (properties.isResponse) {
@@ -124,6 +231,13 @@ function buildResponseDecorators(properties) {
     }
     return decorators;
 }
+/**
+ * Builds decorators for type transformation from string to number.
+ * Handles both single values and arrays with appropriate transformers.
+ * @param {TApiPropertyNumberProperties} properties - The property configuration
+ * @returns {Array<PropertyDecorator>} An array of type transformation decorators
+ * @private
+ */
 function buildTransformDecorators(properties) {
     const decorators = [];
     if (!properties.isResponse) {
@@ -136,6 +250,13 @@ function buildTransformDecorators(properties) {
     }
     return decorators;
 }
+/**
+ * Determines the appropriate Swagger format for the number property.
+ * Maps integer types to int32/int64 based on value range, and handles double format.
+ * @param {TApiPropertyNumberProperties} properties - The property configuration
+ * @returns {string} The Swagger format string
+ * @private
+ */
 function getFormat(properties) {
     switch (properties.format) {
         case numberType_enum.EApiPropertyNumberType.DOUBLE: {
@@ -149,6 +270,13 @@ function getFormat(properties) {
         }
     }
 }
+/**
+ * Determines the appropriate Swagger data type for the number property.
+ * Maps formatter types to the corresponding API property data types.
+ * @param {TApiPropertyNumberProperties} properties - The property configuration
+ * @returns {EApiPropertyDataType.INTEGER | EApiPropertyDataType.NUMBER} The Swagger data type
+ * @private
+ */
 function getType(properties) {
     switch (properties.format) {
         case numberType_enum.EApiPropertyNumberType.DOUBLE: {
@@ -159,12 +287,24 @@ function getType(properties) {
         }
     }
 }
+/**
+ * Validates the configuration options for the API property number.
+ * Performs extensive validation including:
+ * - Min/max values consistency
+ * - Multiple-of constraints and example value compatibility
+ * - Example values within min/max range
+ * - Array options consistency (min/max items, unique items)
+ * @param {TApiPropertyNumberProperties} properties - The property configuration to validate
+ * @returns {void}
+ * @throws {Error} If the configuration is invalid with detailed error messages
+ * @private
+ */
 function validateOptions(properties) {
     const errors = [];
     if (properties.minimum > properties.maximum) {
         errors.push("'minimum' is greater than maximum");
     }
-    if (properties.multipleOf !== undefined) {
+    if (properties.multipleOf != undefined) {
         if (Array.isArray(properties.exampleValue)) {
             for (const example of properties.exampleValue) {
                 if (!classValidator.isInt(example / properties.multipleOf)) {

package/dist/cjs/decorator/api/property/number.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"number.decorator.js","sources":["../../../../../../src/decorator/api/property/number.decorator.ts"],"sourcesContent":[null],"names":["applyDecorators","ApiProperty","EApiPropertyNumberType","IsNumber","IsInt","Type","IsDivisibleBy","Min","Max","IsOptional","IsArray","ArrayMinSize","ArrayMaxSize","ArrayNotEmpty","ApiResponseProperty","Expose","Exclude","Transform","NUMBER_CONSTANT","EApiPropertyDataType","isInt"],"mappings":"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"}
+{"version":3,"file":"number.decorator.js","sources":["../../../../../../src/decorator/api/property/number.decorator.ts"],"sourcesContent":[null],"names":["applyDecorators","ApiProperty","EApiPropertyNumberType","IsNumber","IsInt","Type","IsDivisibleBy","Min","Max","IsOptional","IsArray","ArrayMinSize","ArrayMaxSize","ArrayNotEmpty","ApiResponseProperty","Expose","Exclude","Transform","NUMBER_CONSTANT","EApiPropertyDataType","isInt"],"mappings":"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"}

package/dist/cjs/decorator/api/property/object.decorator.d.ts

@@ -1,2 +1,28 @@
-import type { TApiPropertyObjectProperties } from "../../../type/decorator/api/property/object-properties.type";
+import type { TApiPropertyObjectProperties } from '../../../type/decorator/api/property/index';
+/**
+ * Creates a decorator that applies NestJS Swagger and class-validator/class-transformer decorators
+ * for object properties in DTOs.
+ *
+ * This decorator handles complex object properties with support for:
+ * - Single type objects
+ * - Polymorphic objects (with discriminator)
+ * - Arrays of objects
+ * - Response/Request specific decorators
+ * - Validation rules
+ * - Transformation rules
+ * @param {TApiPropertyObjectProperties} options - Configuration options for the object property
+ * @returns {Function} A decorator function that can be applied to a class property
+ * @example
+ * ```typescript
+ * class UserDto {
+ *   @ApiPropertyObject({
+ *     entity: { name: 'Address' },
+ *     type: AddressDto,
+ *     isRequired: true,
+ *     shouldValidateNested: true
+ *   })
+ *   address: AddressDto;
+ * }
+ * ```
+ */
 export declare function ApiPropertyObject(options: TApiPropertyObjectProperties): <Y>(target: object, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;

package/dist/cjs/decorator/api/property/object.decorator.js

@@ -2,22 +2,88 @@
 
 var common = require('@nestjs/common');
 var swagger = require('@nestjs/swagger');
+var mustMatchOneOfSchemas_validator = require('../../../validator/must-match-one-of-schemas.validator.js');
 var classTransformer = require('class-transformer');
 var classValidator = require('class-validator');
 
+/**
+ * Creates a decorator that applies NestJS Swagger and class-validator/class-transformer decorators
+ * for object properties in DTOs.
+ *
+ * This decorator handles complex object properties with support for:
+ * - Single type objects
+ * - Polymorphic objects (with discriminator)
+ * - Arrays of objects
+ * - Response/Request specific decorators
+ * - Validation rules
+ * - Transformation rules
+ * @param {TApiPropertyObjectProperties} options - Configuration options for the object property
+ * @returns {Function} A decorator function that can be applied to a class property
+ * @example
+ * ```typescript
+ * class UserDto {
+ *   @ApiPropertyObject({
+ *     entity: { name: 'Address' },
+ *     type: AddressDto,
+ *     isRequired: true,
+ *     shouldValidateNested: true
+ *   })
+ *   address: AddressDto;
+ * }
+ * ```
+ */
 function ApiPropertyObject(options) {
     validateOptions(options);
     const apiPropertyOptions = buildApiPropertyOptions(options);
     const decorators = buildDecorators(options, apiPropertyOptions);
     return common.applyDecorators(...decorators);
 }
+/**
+ * Builds the API property options object from the provided property configuration.
+ * Handles different scenarios including single type, multiple types, dynamically generated types, and arrays.
+ * @param {TApiPropertyObjectProperties} properties - The property configuration
+ * @returns {ApiPropertyOptions} The Swagger API property options object
+ * @private
+ */
 function buildApiPropertyOptions(properties) {
     const apiPropertyOptions = {
         description: `${String(properties.entity.name)} ${properties.description ?? ""}`,
         // eslint-disable-next-line @elsikora/typescript/naming-convention
         nullable: properties.isNullable,
-        type: properties.type,
     };
+    if (Array.isArray(properties.type)) {
+        // eslint-disable-next-line @elsikora/typescript/no-unsafe-function-type
+        apiPropertyOptions.oneOf = properties.type.map((type) => {
+            return { $ref: swagger.getSchemaPath(type) };
+        });
+        if (properties.discriminator) {
+            apiPropertyOptions.discriminator = {
+                // eslint-disable-next-line @elsikora/typescript/no-unsafe-function-type
+                mapping: Object.fromEntries(Object.keys(properties.discriminator.mapping).map((key) => [key, swagger.getSchemaPath(properties.discriminator?.mapping[key])])),
+                propertyName: properties.discriminator.propertyName,
+            };
+        }
+        // eslint-disable-next-line @elsikora/typescript/no-unsafe-assignment
+        apiPropertyOptions.type = "object";
+    }
+    else if ("isDynamicallyGenerated" in properties && properties.isDynamicallyGenerated) {
+        // eslint-disable-next-line @elsikora/typescript/no-unsafe-function-type
+        apiPropertyOptions.oneOf = Object.entries(properties.generatedDTOs).map(([_key, value]) => {
+            return { $ref: swagger.getSchemaPath(value) };
+        });
+        if (properties.discriminator) {
+            apiPropertyOptions.discriminator = {
+                // eslint-disable-next-line @elsikora/typescript/no-unsafe-function-type
+                mapping: Object.fromEntries(Object.keys(properties.discriminator.mapping).map((key) => [key, swagger.getSchemaPath(properties.generatedDTOs[key])])),
+                propertyName: properties.discriminator.propertyName,
+            };
+        }
+        // eslint-disable-next-line @elsikora/typescript/no-unsafe-assignment
+        apiPropertyOptions.type = "object";
+    }
+    else {
+        apiPropertyOptions.type = properties.type;
+    }
     apiPropertyOptions.required = properties.isResponse === false || properties.isResponse === undefined ? properties.isRequired : false;
     if (properties.additionalProperties) {
         apiPropertyOptions.additionalProperties = properties.additionalProperties;
@@ -31,11 +97,26 @@ function buildApiPropertyOptions(properties) {
     }
     return apiPropertyOptions;
 }
+/**
+ * Builds all the necessary decorators for the property based on the configuration.
+ * Combines API property decorators, response decorators, request decorators, transform decorators,
+ * and validation decorators.
+ * @param {TApiPropertyObjectProperties} properties - The property configuration
+ * @param {ApiPropertyOptions} apiPropertyOptions - The Swagger API property options
+ * @returns {Array<PropertyDecorator>} An array of decorators to apply to the property
+ * @private
+ */
 function buildDecorators(properties, apiPropertyOptions) {
     const decorators = [swagger.ApiProperty(apiPropertyOptions)];
     decorators.push(...buildResponseDecorators(properties), ...buildRequestDecorators(properties), ...buildTransformDecorators(properties), ...buildObjectValidationDecorators(properties));
     return decorators;
 }
+/**
+ * Builds decorators for validation of nested objects.
+ * @param {TApiPropertyObjectProperties} properties - The property configuration
+ * @returns {Array<PropertyDecorator>} An array of object validation decorators
+ * @private
+ */
 function buildObjectValidationDecorators(properties) {
     const decorators = [];
     const isArray = properties.isArray ?? false;
@@ -45,6 +126,13 @@ function buildObjectValidationDecorators(properties) {
     }
     return decorators;
 }
+/**
+ * Builds decorators for request validation including optional status,
+ * array validation, and size constraints.
+ * @param {TApiPropertyObjectProperties} properties - The property configuration
+ * @returns {Array<PropertyDecorator>} An array of request validation decorators
+ * @private
+ */
 function buildRequestDecorators(properties) {
     const decorators = [];
     if (properties.isResponse === false || properties.isResponse === undefined) {
@@ -60,6 +148,13 @@ function buildRequestDecorators(properties) {
     }
     return decorators;
 }
+/**
+ * Builds decorators for response serialization including API response property,
+ * expose, and exclude decorators.
+ * @param {TApiPropertyObjectProperties} properties - The property configuration
+ * @returns {Array<PropertyDecorator>} An array of response serialization decorators
+ * @private
+ */
 function buildResponseDecorators(properties) {
     const decorators = [];
     if (properties.isResponse) {
@@ -73,11 +168,58 @@ function buildResponseDecorators(properties) {
     }
     return decorators;
 }
+/**
+ * Builds decorators for type transformation including handling of discriminator-based
+ * polymorphic objects.
+ * @param {TApiPropertyObjectProperties} properties - The property configuration
+ * @returns {Array<PropertyDecorator>} An array of type transformation decorators
+ * @private
+ */
 function buildTransformDecorators(properties) {
     const decorators = [];
-    decorators.push(classTransformer.Type(() => properties.type));
+    if (Array.isArray(properties.type) && properties.discriminator) {
+        decorators.push(mustMatchOneOfSchemas_validator.MustMatchOneOfSchemasValidator({
+            discriminator: properties.discriminator,
+            schemas: properties.type,
+        }), classTransformer.Type(() => Object, {
+            discriminator: {
+                property: properties.discriminator.propertyName,
+                subTypes: Object.entries(properties.discriminator.mapping).map(([key, value]) => {
+                    return { name: key, value };
+                }),
+            },
+            // eslint-disable-next-line @elsikora/typescript/naming-convention
+            keepDiscriminatorProperty: properties.discriminator.shouldKeepDiscriminatorProperty,
+        }));
+    }
+    else if ("isDynamicallyGenerated" in properties && properties.isDynamicallyGenerated) {
+        decorators.push(mustMatchOneOfSchemas_validator.MustMatchOneOfSchemasValidator({
+            discriminator: properties.discriminator,
+            schemas: properties.generatedDTOs,
+        }), classTransformer.Type(() => Object, {
+            discriminator: {
+                property: properties.discriminator.propertyName,
+                subTypes: Object.entries(properties.discriminator.mapping).map(([key, value]) => {
+                    return { name: key, value: properties.generatedDTOs[value] };
+                }),
+            },
+            // eslint-disable-next-line @elsikora/typescript/naming-convention
+            keepDiscriminatorProperty: properties.discriminator.shouldKeepDiscriminatorProperty,
+        }));
+    }
+    else {
+        decorators.push(classTransformer.Type(() => properties.type));
+    }
     return decorators;
 }
+/**
+ * Validates the configuration options for the API property object.
+ * Throws an error if the configuration is invalid.
+ * @param {TApiPropertyObjectProperties} properties - The property configuration to validate
+ * @returns {void}
+ * @throws {Error} If the configuration is invalid
+ * @private
+ */
 function validateOptions(properties) {
     const errors = [];
     if (properties.isArray && !properties.shouldValidateNested && !properties.isResponse) {
@@ -98,7 +240,7 @@ function validateOptions(properties) {
         }
     }
     if (errors.length > 0) {
-        throw new Error(`ApiPropertyString error: ${errors.join("\n")}`);
+        throw new Error(`ApiPropertyObject error: ${errors.join("\n")}`);
     }
 }