@elsikora/nestjs-crud-automator 2.1.2-dev.1 → 2.2.0-dev.1

package/dist/cjs/utility/api/discriminator/validate/config.utility.js

@@ -0,0 +1,54 @@
+'use strict';
+
+var constants_js = require('@nestjs/swagger/dist/constants.js');
+var exception_utility = require('../../../error/exception.utility.js');
+
+/**
+ * Validates discriminator config against the DTO variants used to build Swagger and runtime transforms.
+ * @param {TApiDiscriminatorValidateConfigProperties} properties - Discriminator validation properties.
+ * @returns {void}
+ */
+function ApiDiscriminatorValidateConfig(properties) {
+    const errors = [];
+    if (!Array.isArray(properties.variants) || properties.variants.length === 0) {
+        errors.push("type must contain at least one DTO class");
+    }
+    if (!properties.variants.every((variant) => typeof variant === "function")) {
+        errors.push("type must contain only DTO classes");
+    }
+    if (!properties.discriminator.propertyName || typeof properties.discriminator.propertyName !== "string") {
+        errors.push("discriminator.propertyName must be a non-empty string");
+    }
+    if (!properties.discriminator.mapping || typeof properties.discriminator.mapping !== "object" || Object.keys(properties.discriminator.mapping).length === 0) {
+        errors.push("discriminator.mapping must contain at least one variant");
+    }
+    const mappedVariants = Object.values(properties.discriminator.mapping);
+    const apiModelPropertiesMetadataKey = constants_js.DECORATORS.API_MODEL_PROPERTIES;
+    for (const [key, mappedType] of Object.entries(properties.discriminator.mapping)) {
+        if (typeof mappedType !== "function") {
+            errors.push(`discriminator.mapping.${key} must be a DTO class`);
+            continue;
+        }
+        if (!properties.variants.includes(mappedType)) {
+            errors.push(`discriminator.mapping.${key} references DTO ${mappedType.name || "Anonymous"} that is not listed in type`);
+        }
+    }
+    for (const variant of properties.variants) {
+        if (!mappedVariants.includes(variant)) {
+            errors.push(`type contains DTO ${variant.name || "Anonymous"} that is not referenced by discriminator.mapping`);
+        }
+        if (properties.shouldRequireDeclaredDiscriminatorProperty && typeof variant === "function" && typeof properties.discriminator.propertyName === "string") {
+            const variantPrototype = variant.prototype;
+            const hasDiscriminatorPropertyMetadata = Boolean(Reflect.getMetadata(apiModelPropertiesMetadataKey, variantPrototype, properties.discriminator.propertyName));
+            if (!hasDiscriminatorPropertyMetadata) {
+                errors.push(`DTO ${variant.name || "Anonymous"} must declare discriminator property '${properties.discriminator.propertyName}'`);
+            }
+        }
+    }
+    if (errors.length > 0) {
+        throw exception_utility.ErrorException(`${properties.context} discriminator config error: ${errors.join("\n")}`);
+    }
+}
+
+exports.ApiDiscriminatorValidateConfig = ApiDiscriminatorValidateConfig;
+//# sourceMappingURL=config.utility.js.map

package/dist/cjs/utility/api/discriminator/validate/config.utility.js.map

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

package/dist/cjs/utility/api/discriminator/validate/index.d.ts

@@ -0,0 +1 @@
+export { ApiDiscriminatorValidateConfig } from './config.utility';

package/dist/cjs/utility/api/get-default-string-format-properties/bigint-string/apply-options.utility.d.ts

@@ -0,0 +1,9 @@
+import { TApiPropertyDefaultStringFormatProperties } from '../../../../type/decorator/api/property';
+import { TApiGetDefaultStringFormatPropertiesBigIntStringOptions } from '../../../../type/utility/api';
+/**
+ * Applies bigint string-specific options to default string format properties.
+ * @param {TApiPropertyDefaultStringFormatProperties} properties - Base properties cloned from defaults.
+ * @param {TApiGetDefaultStringFormatPropertiesBigIntStringOptions | undefined} options - Bigint string-specific options.
+ * @returns {TApiPropertyDefaultStringFormatProperties} Properties adjusted for bigint string options.
+ */
+export declare function ApplyBigIntStringGetDefaultStringFormatPropertiesOptions(properties: TApiPropertyDefaultStringFormatProperties, options: TApiGetDefaultStringFormatPropertiesBigIntStringOptions | undefined): TApiPropertyDefaultStringFormatProperties;

package/dist/cjs/utility/api/get-default-string-format-properties/bigint-string/apply-options.utility.js

@@ -0,0 +1,20 @@
+'use strict';
+
+var constant = require('../../../../constant/utility/api/get-default-string-format-properties/bigint-string/constant.js');
+
+/**
+ * Applies bigint string-specific options to default string format properties.
+ * @param {TApiPropertyDefaultStringFormatProperties} properties - Base properties cloned from defaults.
+ * @param {TApiGetDefaultStringFormatPropertiesBigIntStringOptions | undefined} options - Bigint string-specific options.
+ * @returns {TApiPropertyDefaultStringFormatProperties} Properties adjusted for bigint string options.
+ */
+function ApplyBigIntStringGetDefaultStringFormatPropertiesOptions(properties, options) {
+    const sign = options?.sign ?? constant.BIGINT_STRING_GET_DEFAULT_STRING_FORMAT_PROPERTIES_API_UTILITY_CONSTANT.DEFAULT_SIGN;
+    return {
+        ...properties,
+        ...constant.BIGINT_STRING_GET_DEFAULT_STRING_FORMAT_PROPERTIES_API_UTILITY_CONSTANT.SIGN_PROPERTIES[sign],
+    };
+}
+
+exports.ApplyBigIntStringGetDefaultStringFormatPropertiesOptions = ApplyBigIntStringGetDefaultStringFormatPropertiesOptions;
+//# sourceMappingURL=apply-options.utility.js.map

package/dist/cjs/utility/api/get-default-string-format-properties/bigint-string/apply-options.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-options.utility.js","sources":["../../../../../../../src/utility/api/get-default-string-format-properties/bigint-string/apply-options.utility.ts"],"sourcesContent":[null],"names":["BIGINT_STRING_GET_DEFAULT_STRING_FORMAT_PROPERTIES_API_UTILITY_CONSTANT"],"mappings":";;;;AAKA;;;;;AAKG;AACG,SAAU,wDAAwD,CAAC,UAAqD,EAAE,OAA4E,EAAA;IAC3M,MAAM,IAAI,GAAyD,OAAO,EAAE,IAAI,IAAIA,gFAAuE,CAAC,YAAY;IAExK,OAAO;AACN,QAAA,GAAG,UAAU;AACb,QAAA,GAAGA,gFAAuE,CAAC,eAAe,CAAC,IAAI,CAAC;KAChG;AACF;;;;"}

package/dist/cjs/utility/api/get-default-string-format-properties/bigint-string/index.d.ts

@@ -0,0 +1 @@
+export { ApplyBigIntStringGetDefaultStringFormatPropertiesOptions } from './apply-options.utility';

package/dist/cjs/utility/api/get-default-string-format-properties/customizer/apply.utility.d.ts

@@ -0,0 +1,11 @@
+import { TApiPropertyDefaultStringFormat, TApiPropertyDefaultStringFormatProperties } from '../../../../type/decorator/api/property';
+import { TApiGetDefaultStringFormatPropertiesParameters } from '../../../../type/utility/api';
+/**
+ * Applies format-specific customizations through the registered customizer map.
+ * @param {TFormat} format - Default string format.
+ * @param {TApiPropertyDefaultStringFormatProperties} properties - Base properties cloned from defaults.
+ * @param {TApiGetDefaultStringFormatPropertiesParameters<TFormat>} parameters - Optional format-specific parameters.
+ * @returns {TApiPropertyDefaultStringFormatProperties} Customized properties when a customizer exists.
+ * @template TFormat - Default string format type.
+ */
+export declare function ApplyGetDefaultStringFormatPropertiesCustomizer<const TFormat extends TApiPropertyDefaultStringFormat>(format: TFormat, properties: TApiPropertyDefaultStringFormatProperties, ...parameters: TApiGetDefaultStringFormatPropertiesParameters<TFormat>): TApiPropertyDefaultStringFormatProperties;

package/dist/cjs/utility/api/get-default-string-format-properties/customizer/apply.utility.js

@@ -0,0 +1,20 @@
+'use strict';
+
+var constant = require('../../../../constant/utility/api/get-default-string-format-properties/constant.js');
+
+/**
+ * Applies format-specific customizations through the registered customizer map.
+ * @param {TFormat} format - Default string format.
+ * @param {TApiPropertyDefaultStringFormatProperties} properties - Base properties cloned from defaults.
+ * @param {TApiGetDefaultStringFormatPropertiesParameters<TFormat>} parameters - Optional format-specific parameters.
+ * @returns {TApiPropertyDefaultStringFormatProperties} Customized properties when a customizer exists.
+ * @template TFormat - Default string format type.
+ */
+function ApplyGetDefaultStringFormatPropertiesCustomizer(format, properties, ...parameters) {
+    const customizer = constant.GET_DEFAULT_STRING_FORMAT_PROPERTIES_API_UTILITY_CONSTANT.CUSTOMIZER_MAP[format];
+    const [options] = parameters;
+    return customizer?.(properties, options) ?? properties;
+}
+
+exports.ApplyGetDefaultStringFormatPropertiesCustomizer = ApplyGetDefaultStringFormatPropertiesCustomizer;
+//# sourceMappingURL=apply.utility.js.map

package/dist/cjs/utility/api/get-default-string-format-properties/customizer/apply.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.utility.js","sources":["../../../../../../../src/utility/api/get-default-string-format-properties/customizer/apply.utility.ts"],"sourcesContent":[null],"names":["GET_DEFAULT_STRING_FORMAT_PROPERTIES_API_UTILITY_CONSTANT"],"mappings":";;;;AAMA;;;;;;;AAOG;AACG,SAAU,+CAA+C,CAAwD,MAAe,EAAE,UAAqD,EAAE,GAAG,UAAmE,EAAA;IACpQ,MAAM,UAAU,GAAwEA,kEAAyD,CAAC,cAAc,CAAC,MAAM,CAAC;AACxK,IAAA,MAAM,CAAC,OAAO,CAAC,GAA4D,UAAU;IAErF,OAAO,UAAU,GAAG,UAAU,EAAE,OAAO,CAAC,IAAI,UAAU;AACvD;;;;"}

package/dist/cjs/utility/api/get-default-string-format-properties/customizer/index.d.ts

@@ -0,0 +1 @@
+export { ApplyGetDefaultStringFormatPropertiesCustomizer } from './apply.utility';

package/dist/cjs/utility/api/get-default-string-format-properties/index.d.ts

@@ -0,0 +1 @@
+export { GetDefaultStringFormatProperties } from './utility';

package/dist/cjs/utility/api/{get-default-string-format-properties.utility.d.ts → get-default-string-format-properties/utility.d.ts}

@@ -1,9 +1,11 @@
-import { TApiPropertyDefaultStringFormat, TApiPropertyDefaultStringFormatProperties } from '../../type/decorator/api/property';
+import { TApiPropertyDefaultStringFormat, TApiPropertyDefaultStringFormatProperties } from '../../../type/decorator/api/property';
+import { TApiGetDefaultStringFormatPropertiesParameters } from '../../../type/utility/api';
 /**
  * Returns default format properties for supported string types (EMAIL, IP, URL, UUID).
  * This utility provides standard validation rules including pattern, length constraints,
  * example values and descriptions for common string formats.
  * @param {TApiPropertyDefaultStringFormat} format - The string format type (EMAIL, IP, URL, or UUID)
+ * @param {TApiGetDefaultStringFormatPropertiesParameters<TFormat>} parameters - Optional format-specific settings.
  * @returns {TApiPropertyDefaultStringFormatProperties} Default properties for the specified format
  * @example
  * ```typescript
@@ -17,5 +19,6 @@ import { TApiPropertyDefaultStringFormat, TApiPropertyDefaultStringFormatPropert
  * //   pattern: "/^([a-zA-Z0-9_\\-.+])+@([a-zA-Z0-9-]+\\.)+[a-zA-Z]{2,}$/"
  * // }
  * ```
+ * @template TFormat - Default string format type.
  */
-export declare function GetDefaultStringFormatProperties(format: TApiPropertyDefaultStringFormat): TApiPropertyDefaultStringFormatProperties;
+export declare function GetDefaultStringFormatProperties<const TFormat extends TApiPropertyDefaultStringFormat>(format: TFormat, ...parameters: TApiGetDefaultStringFormatPropertiesParameters<TFormat>): TApiPropertyDefaultStringFormatProperties;

package/dist/cjs/utility/api/{get-default-string-format-properties.utility.js → get-default-string-format-properties/utility.js}

@@ -1,13 +1,15 @@
 'use strict';
 
-var defaultStringFormat_constant = require('../../constant/interface/api/property/default-string-format.constant.js');
+var defaultStringFormat_constant = require('../../../constant/interface/api/property/default-string-format.constant.js');
 var cloneDeep = require('lodash/cloneDeep.js');
+var apply_utility = require('./customizer/apply.utility.js');
 
 /**
  * Returns default format properties for supported string types (EMAIL, IP, URL, UUID).
  * This utility provides standard validation rules including pattern, length constraints,
  * example values and descriptions for common string formats.
  * @param {TApiPropertyDefaultStringFormat} format - The string format type (EMAIL, IP, URL, or UUID)
+ * @param {TApiGetDefaultStringFormatPropertiesParameters<TFormat>} parameters - Optional format-specific settings.
  * @returns {TApiPropertyDefaultStringFormatProperties} Default properties for the specified format
  * @example
  * ```typescript
@@ -21,11 +23,12 @@ var cloneDeep = require('lodash/cloneDeep.js');
  * //   pattern: "/^([a-zA-Z0-9_\\-.+])+@([a-zA-Z0-9-]+\\.)+[a-zA-Z]{2,}$/"
  * // }
  * ```
+ * @template TFormat - Default string format type.
  */
-function GetDefaultStringFormatProperties(format) {
-    const properties = defaultStringFormat_constant.DEFAULT_STRING_FORMAT_PROPERTY_API_INTERFACE_CONSTANT.DEFAULT_FORMAT_PROPERTIES[format];
-    return cloneDeep(properties);
+function GetDefaultStringFormatProperties(format, ...parameters) {
+    const properties = cloneDeep(defaultStringFormat_constant.DEFAULT_STRING_FORMAT_PROPERTY_API_INTERFACE_CONSTANT.DEFAULT_FORMAT_PROPERTIES[format]);
+    return apply_utility.ApplyGetDefaultStringFormatPropertiesCustomizer(format, properties, ...parameters);
 }
 
 exports.GetDefaultStringFormatProperties = GetDefaultStringFormatProperties;
-//# sourceMappingURL=get-default-string-format-properties.utility.js.map
+//# sourceMappingURL=utility.js.map

package/dist/cjs/utility/api/get-default-string-format-properties/utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.js","sources":["../../../../../../src/utility/api/get-default-string-format-properties/utility.ts"],"sourcesContent":[null],"names":["DEFAULT_STRING_FORMAT_PROPERTY_API_INTERFACE_CONSTANT","ApplyGetDefaultStringFormatPropertiesCustomizer"],"mappings":";;;;;;AAQA;;;;;;;;;;;;;;;;;;;;AAoBG;SACa,gCAAgC,CAAwD,MAAe,EAAE,GAAG,UAAmE,EAAA;IAC9L,MAAM,UAAU,GAA8C,SAAS,CAACA,kFAAqD,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAEhK,OAAOC,6DAA+C,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,CAAC;AAC1F;;;;"}

package/dist/cjs/utility/api/index.d.ts

@@ -1,4 +1,5 @@
 export * from './controller';
+export * from './discriminator';
 export { FilterOrderByFromEntity } from './filter-order-by-from-entity.utility';
-export { GetDefaultStringFormatProperties } from './get-default-string-format-properties.utility';
+export * from './get-default-string-format-properties';
 export * from './route';

package/dist/cjs/utility/api/route/apply-dto-metadata.utility.js

@@ -23,6 +23,10 @@ var constants_js = require('@nestjs/common/constants.js');
 var routeParamtypes_enum_js = require('@nestjs/common/enums/route-paramtypes.enum.js');
 var swagger = require('@nestjs/swagger');
 var dto_utility = require('../controller/get/dto.utility.js');
+var buildOpenApiSchema_utility = require('./discriminator/build-open-api-schema.utility.js');
+var isDtoProperties_utility = require('./discriminator/is-dto-properties.utility.js');
+require('@nestjs/swagger/dist/constants.js');
+var collectWithRegisteredChildren_utility = require('./dto/collect-with-registered-children.utility.js');
 var generateEntityInformation_utility = require('../../generate-entity-information.utility.js');
 
 /**
@@ -37,12 +41,14 @@ var generateEntityInformation_utility = require('../../generate-entity-informati
  */
 function ApiRouteApplyDtoMetadata(target, propertyKey, metadata, runtimeProperties, descriptor) {
     const bodyDto = resolveRequestDto(metadata, runtimeProperties, dtoType_enum.EApiDtoType.BODY);
-    const parametersDto = resolveRequestDto(metadata, runtimeProperties, dtoType_enum.EApiDtoType.PARAMETERS);
-    const queryDto = resolveRequestDto(metadata, runtimeProperties, dtoType_enum.EApiDtoType.QUERY);
+    const parametersDtoConfig = resolveRequestDto(metadata, runtimeProperties, dtoType_enum.EApiDtoType.PARAMETERS);
+    const queryDtoConfig = resolveRequestDto(metadata, runtimeProperties, dtoType_enum.EApiDtoType.QUERY);
+    const parametersDto = isDtoProperties_utility.ApiRouteIsDiscriminatedDtoProperties(parametersDtoConfig) ? undefined : parametersDtoConfig;
+    const queryDto = isDtoProperties_utility.ApiRouteIsDiscriminatedDtoProperties(queryDtoConfig) ? undefined : queryDtoConfig;
     const routeArgumentsMetadata = Reflect.getMetadata(constants_js.ROUTE_ARGS_METADATA, target.constructor, propertyKey);
     const parameterTypes = [...(Reflect.getMetadata(constants_js.PARAMTYPES_METADATA, target, propertyKey) ?? [])];
     for (const { dto, parameterType } of [
-        { dto: bodyDto, parameterType: routeParamtypes_enum_js.RouteParamtypes.BODY },
+        { dto: isDtoProperties_utility.ApiRouteIsDiscriminatedDtoProperties(bodyDto) ? Object : bodyDto, parameterType: routeParamtypes_enum_js.RouteParamtypes.BODY },
         { dto: parametersDto, parameterType: routeParamtypes_enum_js.RouteParamtypes.PARAM },
         { dto: queryDto, parameterType: routeParamtypes_enum_js.RouteParamtypes.QUERY },
     ]) {
@@ -59,11 +65,19 @@ function ApiRouteApplyDtoMetadata(target, propertyKey, metadata, runtimeProperti
     }
     const requestDtos = [];
     for (const dto of [bodyDto, parametersDto, queryDto]) {
-        if (dto) {
-            requestDtos.push(dto);
+        if (isDtoProperties_utility.ApiRouteIsDiscriminatedDtoProperties(dto)) {
+            collectWithRegisteredChildren_utility.ApiRouteCollectDtoWithRegisteredChildren(requestDtos, dto.type);
+        }
+        else if (dto) {
+            collectWithRegisteredChildren_utility.ApiRouteCollectDtoWithRegisteredChildren(requestDtos, dto);
         }
     }
     const swaggerDecorators = requestDtos.length > 0 ? [swagger.ApiExtraModels(...requestDtos)] : [];
+    if (isDtoProperties_utility.ApiRouteIsDiscriminatedDtoProperties(bodyDto)) {
+        swaggerDecorators.push(swagger.ApiBody({
+            schema: buildOpenApiSchema_utility.ApiRouteBuildDiscriminatedDtoOpenApiSchema(bodyDto, "ApiRouteCustom body"),
+        }));
+    }
     if (swaggerDecorators.length > 0) {
         common.applyDecorators(...swaggerDecorators)(target, propertyKey, descriptor);
     }
@@ -74,7 +88,7 @@ function ApiRouteApplyDtoMetadata(target, propertyKey, metadata, runtimeProperti
  * @param {IApiRouteMetadata<E>} metadata - Route metadata used for entity and route type.
  * @param {IApiRouteRuntimeProperties<E, undefined>} runtimeProperties - Runtime route config containing dto/autoDto.
  * @param {Exclude<EApiDtoType, EApiDtoType.RESPONSE>} dtoType - Request DTO target.
- * @returns {Type<unknown> | undefined} Resolved request DTO.
+ * @returns {TApiRouteRequestDto | undefined} Resolved request DTO.
  */
 function resolveRequestDto(metadata, runtimeProperties, dtoType) {
     const configuredDto = runtimeProperties.dto?.[dtoType];

package/dist/cjs/utility/api/route/apply-dto-metadata.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"apply-dto-metadata.utility.js","sources":["../../../../../../src/utility/api/route/apply-dto-metadata.utility.ts"],"sourcesContent":[null],"names":["EApiDtoType","ROUTE_ARGS_METADATA","PARAMTYPES_METADATA","RouteParamtypes","ApiExtraModels","applyDecorators","GenerateEntityInformation","ApiControllerGetDto"],"mappings":"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"}
+{"version":3,"file":"apply-dto-metadata.utility.js","sources":["../../../../../../src/utility/api/route/apply-dto-metadata.utility.ts"],"sourcesContent":[null],"names":["EApiDtoType","ApiRouteIsDiscriminatedDtoProperties","ROUTE_ARGS_METADATA","PARAMTYPES_METADATA","RouteParamtypes","ApiRouteCollectDtoWithRegisteredChildren","ApiExtraModels","ApiBody","ApiRouteBuildDiscriminatedDtoOpenApiSchema","applyDecorators","GenerateEntityInformation","ApiControllerGetDto"],"mappings":"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"}

package/dist/cjs/utility/api/route/discriminator/build-open-api-schema.utility.d.ts

@@ -0,0 +1,9 @@
+import { SchemaObject } from '@nestjs/swagger/dist/interfaces/open-api-spec.interface';
+import { TApiRouteDiscriminatedDtoProperties } from '../../../../type/decorator/api/route';
+/**
+ * Builds an OpenAPI oneOf schema with discriminator metadata for route-level DTO variants.
+ * @param {TApiRouteDiscriminatedDtoProperties} properties - Route-level discriminated DTO config.
+ * @param {string} context - Error message context.
+ * @returns {SchemaObject} OpenAPI schema for a discriminated root DTO.
+ */
+export declare function ApiRouteBuildDiscriminatedDtoOpenApiSchema(properties: TApiRouteDiscriminatedDtoProperties, context: string): SchemaObject;

package/dist/cjs/utility/api/route/discriminator/build-open-api-schema.utility.js

@@ -0,0 +1,26 @@
+'use strict';
+
+var swagger = require('@nestjs/swagger');
+var validateDtoProperties_utility = require('./validate-dto-properties.utility.js');
+
+/**
+ * Builds an OpenAPI oneOf schema with discriminator metadata for route-level DTO variants.
+ * @param {TApiRouteDiscriminatedDtoProperties} properties - Route-level discriminated DTO config.
+ * @param {string} context - Error message context.
+ * @returns {SchemaObject} OpenAPI schema for a discriminated root DTO.
+ */
+function ApiRouteBuildDiscriminatedDtoOpenApiSchema(properties, context) {
+    validateDtoProperties_utility.ApiRouteValidateDiscriminatedDtoProperties(properties, context);
+    return {
+        discriminator: {
+            mapping: Object.fromEntries(Object.entries(properties.discriminator.mapping).map(([key, value]) => [key, swagger.getSchemaPath(value)])),
+            propertyName: properties.discriminator.propertyName,
+        },
+        oneOf: properties.type.map((type) => {
+            return { $ref: swagger.getSchemaPath(type) };
+        }),
+    };
+}
+
+exports.ApiRouteBuildDiscriminatedDtoOpenApiSchema = ApiRouteBuildDiscriminatedDtoOpenApiSchema;
+//# sourceMappingURL=build-open-api-schema.utility.js.map

package/dist/cjs/utility/api/route/discriminator/build-open-api-schema.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-open-api-schema.utility.js","sources":["../../../../../../../src/utility/api/route/discriminator/build-open-api-schema.utility.ts"],"sourcesContent":[null],"names":["ApiRouteValidateDiscriminatedDtoProperties","getSchemaPath"],"mappings":";;;;;AAQA;;;;;AAKG;AACG,SAAU,0CAA0C,CAAC,UAA+C,EAAE,OAAe,EAAA;AAC1H,IAAAA,wEAA0C,CAAC,UAAU,EAAE,OAAO,CAAC;IAE/D,OAAO;AACN,QAAA,aAAa,EAAE;AACd,YAAA,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAA0B,KAAuB,CAAC,GAAG,EAAEC,qBAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC3K,YAAA,YAAY,EAAE,UAAU,CAAC,aAAa,CAAC,YAAY;AACnD,SAAA;QACD,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAmB,KAAsB;YACpE,OAAO,EAAE,IAAI,EAAEA,qBAAa,CAAC,IAAI,CAAC,EAAE;AACrC,QAAA,CAAC,CAAC;KACF;AACF;;;;"}

package/dist/cjs/utility/api/route/discriminator/create-validation-failure.utility.d.ts

@@ -0,0 +1,9 @@
+import { TApiRouteDiscriminatedDtoProperties } from '../../../../type/decorator/api/route';
+import { ValidationError } from 'class-validator';
+/**
+ * Creates class-validator-shaped validation failure for route-level discriminator selection failures.
+ * @param {TApiRouteDiscriminatedDtoProperties} properties - Route-level discriminated DTO config.
+ * @param {unknown} payload - Request body payload.
+ * @returns {ValidationError} Class-validator-compatible validation failure.
+ */
+export declare function ApiRouteCreateDiscriminatedDtoValidationFailure(properties: TApiRouteDiscriminatedDtoProperties, payload: unknown): ValidationError;

package/dist/cjs/utility/api/route/discriminator/create-validation-failure.utility.js

@@ -0,0 +1,46 @@
+'use strict';
+
+/**
+ * Creates class-validator-shaped validation failure for route-level discriminator selection failures.
+ * @param {TApiRouteDiscriminatedDtoProperties} properties - Route-level discriminated DTO config.
+ * @param {unknown} payload - Request body payload.
+ * @returns {ValidationError} Class-validator-compatible validation failure.
+ */
+function ApiRouteCreateDiscriminatedDtoValidationFailure(properties, payload) {
+    const discriminatorPropertyName = properties.discriminator.propertyName;
+    const allowedValuesDescription = Object.keys(properties.discriminator.mapping)
+        .map((value) => {
+        return `'${value}'`;
+    })
+        .join(", ");
+    if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
+        return {
+            constraints: {
+                mustMatchDiscriminatorMapping: "body must be an object",
+            },
+            property: "body",
+            value: payload,
+        };
+    }
+    const payloadAsRecord = payload;
+    if (!(discriminatorPropertyName in payloadAsRecord)) {
+        return {
+            constraints: {
+                mustMatchDiscriminatorMapping: `${discriminatorPropertyName} is missing required discriminator field '${discriminatorPropertyName}'`,
+            },
+            property: discriminatorPropertyName,
+            value: undefined,
+        };
+    }
+    const discriminatorValue = payloadAsRecord[discriminatorPropertyName];
+    return {
+        constraints: {
+            mustMatchDiscriminatorMapping: `${discriminatorPropertyName} has invalid discriminator value '${String(discriminatorValue)}'. must be one of: ${allowedValuesDescription}`,
+        },
+        property: discriminatorPropertyName,
+        value: discriminatorValue,
+    };
+}
+
+exports.ApiRouteCreateDiscriminatedDtoValidationFailure = ApiRouteCreateDiscriminatedDtoValidationFailure;
+//# sourceMappingURL=create-validation-failure.utility.js.map

package/dist/cjs/utility/api/route/discriminator/create-validation-failure.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-validation-failure.utility.js","sources":["../../../../../../../src/utility/api/route/discriminator/create-validation-failure.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAGA;;;;;AAKG;AACG,SAAU,+CAA+C,CAAC,UAA+C,EAAE,OAAgB,EAAA;AAChI,IAAA,MAAM,yBAAyB,GAAW,UAAU,CAAC,aAAa,CAAC,YAAY;IAE/E,MAAM,wBAAwB,GAAW,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,OAAO;AACnF,SAAA,GAAG,CAAC,CAAC,KAAa,KAAY;QAC9B,OAAO,CAAA,CAAA,EAAI,KAAK,CAAA,CAAA,CAAG;AACpB,IAAA,CAAC;SACA,IAAI,CAAC,IAAI,CAAC;AAEZ,IAAA,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;QACtE,OAAO;AACN,YAAA,WAAW,EAAE;AACZ,gBAAA,6BAA6B,EAAE,wBAAwB;AACvD,aAAA;AACD,YAAA,QAAQ,EAAE,MAAM;AAChB,YAAA,KAAK,EAAE,OAAO;SACd;IACF;IAEA,MAAM,eAAe,GAA4B,OAAkC;AAEnF,IAAA,IAAI,EAAE,yBAAyB,IAAI,eAAe,CAAC,EAAE;QACpD,OAAO;AACN,YAAA,WAAW,EAAE;AACZ,gBAAA,6BAA6B,EAAE,CAAA,EAAG,yBAAyB,CAAA,0CAAA,EAA6C,yBAAyB,CAAA,CAAA,CAAG;AACpI,aAAA;AACD,YAAA,QAAQ,EAAE,yBAAyB;AACnC,YAAA,KAAK,EAAE,SAAS;SAChB;IACF;AAEA,IAAA,MAAM,kBAAkB,GAAY,eAAe,CAAC,yBAAyB,CAAC;IAE9E,OAAO;AACN,QAAA,WAAW,EAAE;YACZ,6BAA6B,EAAE,CAAA,EAAG,yBAAyB,CAAA,kCAAA,EAAqC,MAAM,CAAC,kBAAkB,CAAC,CAAA,mBAAA,EAAsB,wBAAwB,CAAA,CAAE;AAC1K,SAAA;AACD,QAAA,QAAQ,EAAE,yBAAyB;AACnC,QAAA,KAAK,EAAE,kBAAkB;KACzB;AACF;;;;"}

package/dist/cjs/utility/api/route/discriminator/index.d.ts

@@ -0,0 +1,6 @@
+export { ApiRouteBuildDiscriminatedDtoOpenApiSchema } from './build-open-api-schema.utility';
+export { ApiRouteCreateDiscriminatedDtoValidationFailure } from './create-validation-failure.utility';
+export { ApiRouteIsDiscriminatedDtoProperties } from './is-dto-properties.utility';
+export { ApiRoutePrepareDiscriminatedDtoPayload } from './prepare-payload.utility';
+export { ApiRouteResolveDiscriminatedDto } from './resolve-dto.utility';
+export { ApiRouteValidateDiscriminatedDtoProperties } from './validate-dto-properties.utility';

package/dist/cjs/utility/api/route/discriminator/is-dto-properties.utility.d.ts

@@ -0,0 +1,7 @@
+import { TApiRouteDiscriminatedDtoProperties } from '../../../../type/decorator/api/route';
+/**
+ * Checks whether a value is a route-level discriminated DTO config.
+ * @param {unknown} value - Value to inspect.
+ * @returns {boolean} Whether the value is a discriminated DTO config.
+ */
+export declare function ApiRouteIsDiscriminatedDtoProperties(value: unknown): value is TApiRouteDiscriminatedDtoProperties;

package/dist/cjs/utility/api/route/discriminator/is-dto-properties.utility.js

@@ -0,0 +1,13 @@
+'use strict';
+
+/**
+ * Checks whether a value is a route-level discriminated DTO config.
+ * @param {unknown} value - Value to inspect.
+ * @returns {boolean} Whether the value is a discriminated DTO config.
+ */
+function ApiRouteIsDiscriminatedDtoProperties(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value) && "type" in value && Array.isArray(value.type) && "discriminator" in value;
+}
+
+exports.ApiRouteIsDiscriminatedDtoProperties = ApiRouteIsDiscriminatedDtoProperties;
+//# sourceMappingURL=is-dto-properties.utility.js.map

package/dist/cjs/utility/api/route/discriminator/is-dto-properties.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-dto-properties.utility.js","sources":["../../../../../../../src/utility/api/route/discriminator/is-dto-properties.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;;;AAIG;AACG,SAAU,oCAAoC,CAAC,KAAc,EAAA;AAClE,IAAA,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,OAAO,CAAE,KAA4B,CAAC,IAAI,CAAC,IAAI,eAAe,IAAI,KAAK;AAChL;;;;"}

package/dist/cjs/utility/api/route/discriminator/prepare-payload.utility.d.ts

@@ -0,0 +1,8 @@
+import { TApiRouteDiscriminatedDtoProperties } from '../../../../type/decorator/api/route';
+/**
+ * Removes the discriminator property from a root DTO payload when the config requests it.
+ * @param {TApiRouteDiscriminatedDtoProperties} properties - Route-level discriminated DTO config.
+ * @param {unknown} payload - Payload selected by the discriminator.
+ * @returns {unknown} Original or copied payload used for transformation/serialization.
+ */
+export declare function ApiRoutePrepareDiscriminatedDtoPayload(properties: TApiRouteDiscriminatedDtoProperties, payload: unknown): unknown;

package/dist/cjs/utility/api/route/discriminator/prepare-payload.utility.js

@@ -0,0 +1,19 @@
+'use strict';
+
+/**
+ * Removes the discriminator property from a root DTO payload when the config requests it.
+ * @param {TApiRouteDiscriminatedDtoProperties} properties - Route-level discriminated DTO config.
+ * @param {unknown} payload - Payload selected by the discriminator.
+ * @returns {unknown} Original or copied payload used for transformation/serialization.
+ */
+function ApiRoutePrepareDiscriminatedDtoPayload(properties, payload) {
+    if (properties.discriminator.shouldKeepDiscriminatorProperty !== false || !payload || typeof payload !== "object" || Array.isArray(payload)) {
+        return payload;
+    }
+    return Object.fromEntries(Object.entries(payload).filter(([key]) => {
+        return key !== properties.discriminator.propertyName;
+    }));
+}
+
+exports.ApiRoutePrepareDiscriminatedDtoPayload = ApiRoutePrepareDiscriminatedDtoPayload;
+//# sourceMappingURL=prepare-payload.utility.js.map

package/dist/cjs/utility/api/route/discriminator/prepare-payload.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-payload.utility.js","sources":["../../../../../../../src/utility/api/route/discriminator/prepare-payload.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;;;;AAKG;AACG,SAAU,sCAAsC,CAAC,UAA+C,EAAE,OAAgB,EAAA;IACvH,IAAI,UAAU,CAAC,aAAa,CAAC,+BAA+B,KAAK,KAAK,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;AAC5I,QAAA,OAAO,OAAO;IACf;AAEA,IAAA,OAAO,MAAM,CAAC,WAAW,CACxB,MAAM,CAAC,OAAO,CAAC,OAAkC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAoB,KAAa;AAC/F,QAAA,OAAO,GAAG,KAAK,UAAU,CAAC,aAAa,CAAC,YAAY;IACrD,CAAC,CAAC,CACF;AACF;;;;"}

package/dist/cjs/utility/api/route/discriminator/resolve-dto.utility.d.ts

@@ -0,0 +1,10 @@
+import { Type } from '@nestjs/common';
+import { TApiRouteDiscriminatedDtoProperties } from '../../../../type/decorator/api/route';
+/**
+ * Selects the route DTO class for a payload using the configured discriminator mapping.
+ * @param {TApiRouteDiscriminatedDtoProperties} properties - Route-level discriminated DTO config.
+ * @param {unknown} payload - Request or response payload.
+ * @param {string} context - Error message context.
+ * @returns {Type<unknown>} Selected DTO class.
+ */
+export declare function ApiRouteResolveDiscriminatedDto(properties: TApiRouteDiscriminatedDtoProperties, payload: unknown, context: string): Type<unknown>;

package/dist/cjs/utility/api/route/discriminator/resolve-dto.utility.js

@@ -0,0 +1,35 @@
+'use strict';
+
+var exception_utility = require('../../../error/exception.utility.js');
+var validateDtoProperties_utility = require('./validate-dto-properties.utility.js');
+
+/**
+ * Selects the route DTO class for a payload using the configured discriminator mapping.
+ * @param {TApiRouteDiscriminatedDtoProperties} properties - Route-level discriminated DTO config.
+ * @param {unknown} payload - Request or response payload.
+ * @param {string} context - Error message context.
+ * @returns {Type<unknown>} Selected DTO class.
+ */
+function ApiRouteResolveDiscriminatedDto(properties, payload, context) {
+    validateDtoProperties_utility.ApiRouteValidateDiscriminatedDtoProperties(properties, context);
+    if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
+        throw exception_utility.ErrorException(`${context} discriminator payload error: payload must be an object`);
+    }
+    const payloadAsRecord = payload;
+    const discriminatorPropertyName = properties.discriminator.propertyName;
+    if (!(discriminatorPropertyName in payloadAsRecord)) {
+        throw exception_utility.ErrorException(`${context} discriminator payload error: missing required discriminator field '${discriminatorPropertyName}'`);
+    }
+    const discriminatorValue = payloadAsRecord[discriminatorPropertyName];
+    if (typeof discriminatorValue !== "string" || discriminatorValue === "") {
+        throw exception_utility.ErrorException(`${context} discriminator payload error: invalid discriminator value '${String(discriminatorValue)}' for field '${discriminatorPropertyName}'`);
+    }
+    const dto = properties.discriminator.mapping[discriminatorValue];
+    if (!dto) {
+        throw exception_utility.ErrorException(`${context} discriminator payload error: invalid discriminator value '${discriminatorValue}' for field '${discriminatorPropertyName}'`);
+    }
+    return dto;
+}
+
+exports.ApiRouteResolveDiscriminatedDto = ApiRouteResolveDiscriminatedDto;
+//# sourceMappingURL=resolve-dto.utility.js.map

package/dist/cjs/utility/api/route/discriminator/resolve-dto.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-dto.utility.js","sources":["../../../../../../../src/utility/api/route/discriminator/resolve-dto.utility.ts"],"sourcesContent":[null],"names":["ApiRouteValidateDiscriminatedDtoProperties","ErrorException"],"mappings":";;;;;AAOA;;;;;;AAMG;SACa,+BAA+B,CAAC,UAA+C,EAAE,OAAgB,EAAE,OAAe,EAAA;AACjI,IAAAA,wEAA0C,CAAC,UAAU,EAAE,OAAO,CAAC;AAE/D,IAAA,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;AACtE,QAAA,MAAMC,gCAAc,CAAC,CAAA,EAAG,OAAO,CAAA,uDAAA,CAAyD,CAAC;IAC1F;IAEA,MAAM,eAAe,GAA4B,OAAkC;AACnF,IAAA,MAAM,yBAAyB,GAAW,UAAU,CAAC,aAAa,CAAC,YAAY;AAE/E,IAAA,IAAI,EAAE,yBAAyB,IAAI,eAAe,CAAC,EAAE;QACpD,MAAMA,gCAAc,CAAC,CAAA,EAAG,OAAO,uEAAuE,yBAAyB,CAAA,CAAA,CAAG,CAAC;IACpI;AAEA,IAAA,MAAM,kBAAkB,GAAY,eAAe,CAAC,yBAAyB,CAAC;IAE9E,IAAI,OAAO,kBAAkB,KAAK,QAAQ,IAAI,kBAAkB,KAAK,EAAE,EAAE;AACxE,QAAA,MAAMA,gCAAc,CAAC,CAAA,EAAG,OAAO,CAAA,2DAAA,EAA8D,MAAM,CAAC,kBAAkB,CAAC,CAAA,aAAA,EAAgB,yBAAyB,CAAA,CAAA,CAAG,CAAC;IACrK;IAEA,MAAM,GAAG,GAA8B,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,kBAAkB,CAAC;IAE3F,IAAI,CAAC,GAAG,EAAE;QACT,MAAMA,gCAAc,CAAC,CAAA,EAAG,OAAO,CAAA,2DAAA,EAA8D,kBAAkB,CAAA,aAAA,EAAgB,yBAAyB,CAAA,CAAA,CAAG,CAAC;IAC7J;AAEA,IAAA,OAAO,GAAG;AACX;;;;"}

package/dist/cjs/utility/api/route/discriminator/validate-dto-properties.utility.d.ts

@@ -0,0 +1,8 @@
+import { TApiRouteDiscriminatedDtoProperties } from '../../../../type/decorator/api/route';
+/**
+ * Validates that route-level discriminator config and variant DTO classes are consistent.
+ * @param {TApiRouteDiscriminatedDtoProperties} properties - Route-level discriminated DTO config.
+ * @param {string} context - Error message context.
+ * @returns {void}
+ */
+export declare function ApiRouteValidateDiscriminatedDtoProperties(properties: TApiRouteDiscriminatedDtoProperties, context: string): void;

package/dist/cjs/utility/api/route/discriminator/validate-dto-properties.utility.js

@@ -0,0 +1,21 @@
+'use strict';
+
+var config_utility = require('../../discriminator/validate/config.utility.js');
+
+/**
+ * Validates that route-level discriminator config and variant DTO classes are consistent.
+ * @param {TApiRouteDiscriminatedDtoProperties} properties - Route-level discriminated DTO config.
+ * @param {string} context - Error message context.
+ * @returns {void}
+ */
+function ApiRouteValidateDiscriminatedDtoProperties(properties, context) {
+    config_utility.ApiDiscriminatorValidateConfig({
+        context,
+        discriminator: properties.discriminator,
+        shouldRequireDeclaredDiscriminatorProperty: true,
+        variants: properties.type,
+    });
+}
+
+exports.ApiRouteValidateDiscriminatedDtoProperties = ApiRouteValidateDiscriminatedDtoProperties;
+//# sourceMappingURL=validate-dto-properties.utility.js.map

package/dist/cjs/utility/api/route/discriminator/validate-dto-properties.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-dto-properties.utility.js","sources":["../../../../../../../src/utility/api/route/discriminator/validate-dto-properties.utility.ts"],"sourcesContent":[null],"names":["ApiDiscriminatorValidateConfig"],"mappings":";;;;AAIA;;;;;AAKG;AACG,SAAU,0CAA0C,CAAC,UAA+C,EAAE,OAAe,EAAA;AAC1H,IAAAA,6CAA8B,CAAC;QAC9B,OAAO;QACP,aAAa,EAAE,UAAU,CAAC,aAAa;AACvC,QAAA,0CAA0C,EAAE,IAAI;QAChD,QAAQ,EAAE,UAAU,CAAC,IAAI;AACzB,KAAA,CAAC;AACH;;;;"}

package/dist/cjs/utility/api/route/dto/collect-with-registered-children.utility.d.ts

@@ -0,0 +1,8 @@
+import { Type } from '@nestjs/common';
+/**
+ * Adds a DTO and all registered nested manual DTO children to an accumulator.
+ * @param {Array<Type<unknown>>} target - DTO accumulator.
+ * @param {Array<Type<unknown>> | Type<unknown>} dto - DTO or DTO list to add.
+ * @returns {void}
+ */
+export declare function ApiRouteCollectDtoWithRegisteredChildren(target: Array<Type<unknown>>, dto: Array<Type<unknown>> | Type<unknown>): void;

package/dist/cjs/utility/api/route/dto/collect-with-registered-children.utility.js

@@ -0,0 +1,29 @@
+'use strict';
+
+var registerAutoDtoChild_utility = require('../../../register-auto-dto-child.utility.js');
+
+/**
+ * Adds a DTO and all registered nested manual DTO children to an accumulator.
+ * @param {Array<Type<unknown>>} target - DTO accumulator.
+ * @param {Array<Type<unknown>> | Type<unknown>} dto - DTO or DTO list to add.
+ * @returns {void}
+ */
+function ApiRouteCollectDtoWithRegisteredChildren(target, dto) {
+    if (Array.isArray(dto)) {
+        for (const item of dto) {
+            ApiRouteCollectDtoWithRegisteredChildren(target, item);
+        }
+        return;
+    }
+    if (!target.includes(dto)) {
+        target.push(dto);
+    }
+    for (const child of registerAutoDtoChild_utility.GetRegisteredAutoDtoChildrenRecursive(dto.prototype)) {
+        if (!target.includes(child)) {
+            target.push(child);
+        }
+    }
+}
+
+exports.ApiRouteCollectDtoWithRegisteredChildren = ApiRouteCollectDtoWithRegisteredChildren;
+//# sourceMappingURL=collect-with-registered-children.utility.js.map