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

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

@@ -1,11 +1,13 @@
-import { DEFAULT_STRING_FORMAT_PROPERTY_API_INTERFACE_CONSTANT } from '../../constant/interface/api/property/default-string-format.constant.js';
+import { DEFAULT_STRING_FORMAT_PROPERTY_API_INTERFACE_CONSTANT } from '../../../constant/interface/api/property/default-string-format.constant.js';
 import cloneDeep from 'lodash/cloneDeep.js';
+import { ApplyGetDefaultStringFormatPropertiesCustomizer } from './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
@@ -19,11 +21,12 @@ import cloneDeep from '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 = DEFAULT_STRING_FORMAT_PROPERTY_API_INTERFACE_CONSTANT.DEFAULT_FORMAT_PROPERTIES[format];
-    return cloneDeep(properties);
+function GetDefaultStringFormatProperties(format, ...parameters) {
+    const properties = cloneDeep(DEFAULT_STRING_FORMAT_PROPERTY_API_INTERFACE_CONSTANT.DEFAULT_FORMAT_PROPERTIES[format]);
+    return ApplyGetDefaultStringFormatPropertiesCustomizer(format, properties, ...parameters);
 }
 
 export { GetDefaultStringFormatProperties };
-//# sourceMappingURL=get-default-string-format-properties.utility.js.map
+//# sourceMappingURL=utility.js.map

package/dist/esm/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":[],"mappings":";;;;AAQA;;;;;;;;;;;;;;;;;;;;AAoBG;SACa,gCAAgC,CAAwD,MAAe,EAAE,GAAG,UAAmE,EAAA;IAC9L,MAAM,UAAU,GAA8C,SAAS,CAAC,qDAAqD,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAEhK,OAAO,+CAA+C,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,CAAC;AAC1F;;;;"}

package/dist/esm/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/esm/utility/api/route/apply-dto-metadata.utility.js

@@ -19,8 +19,12 @@ import '../../../enum/decorator/api/route-type.enum.js';
 import { applyDecorators } from '@nestjs/common';
 import { ROUTE_ARGS_METADATA, PARAMTYPES_METADATA } from '@nestjs/common/constants.js';
 import { RouteParamtypes } from '@nestjs/common/enums/route-paramtypes.enum.js';
-import { ApiExtraModels } from '@nestjs/swagger';
+import { ApiExtraModels, ApiBody } from '@nestjs/swagger';
 import { ApiControllerGetDto } from '../controller/get/dto.utility.js';
+import { ApiRouteBuildDiscriminatedDtoOpenApiSchema } from './discriminator/build-open-api-schema.utility.js';
+import { ApiRouteIsDiscriminatedDtoProperties } from './discriminator/is-dto-properties.utility.js';
+import '@nestjs/swagger/dist/constants.js';
+import { ApiRouteCollectDtoWithRegisteredChildren } from './dto/collect-with-registered-children.utility.js';
 import { GenerateEntityInformation } from '../../generate-entity-information.utility.js';
 
 /**
@@ -35,12 +39,14 @@ import { GenerateEntityInformation } from '../../generate-entity-information.uti
  */
 function ApiRouteApplyDtoMetadata(target, propertyKey, metadata, runtimeProperties, descriptor) {
     const bodyDto = resolveRequestDto(metadata, runtimeProperties, EApiDtoType.BODY);
-    const parametersDto = resolveRequestDto(metadata, runtimeProperties, EApiDtoType.PARAMETERS);
-    const queryDto = resolveRequestDto(metadata, runtimeProperties, EApiDtoType.QUERY);
+    const parametersDtoConfig = resolveRequestDto(metadata, runtimeProperties, EApiDtoType.PARAMETERS);
+    const queryDtoConfig = resolveRequestDto(metadata, runtimeProperties, EApiDtoType.QUERY);
+    const parametersDto = ApiRouteIsDiscriminatedDtoProperties(parametersDtoConfig) ? undefined : parametersDtoConfig;
+    const queryDto = ApiRouteIsDiscriminatedDtoProperties(queryDtoConfig) ? undefined : queryDtoConfig;
     const routeArgumentsMetadata = Reflect.getMetadata(ROUTE_ARGS_METADATA, target.constructor, propertyKey);
     const parameterTypes = [...(Reflect.getMetadata(PARAMTYPES_METADATA, target, propertyKey) ?? [])];
     for (const { dto, parameterType } of [
-        { dto: bodyDto, parameterType: RouteParamtypes.BODY },
+        { dto: ApiRouteIsDiscriminatedDtoProperties(bodyDto) ? Object : bodyDto, parameterType: RouteParamtypes.BODY },
         { dto: parametersDto, parameterType: RouteParamtypes.PARAM },
         { dto: queryDto, parameterType: RouteParamtypes.QUERY },
     ]) {
@@ -57,11 +63,19 @@ function ApiRouteApplyDtoMetadata(target, propertyKey, metadata, runtimeProperti
     }
     const requestDtos = [];
     for (const dto of [bodyDto, parametersDto, queryDto]) {
-        if (dto) {
-            requestDtos.push(dto);
+        if (ApiRouteIsDiscriminatedDtoProperties(dto)) {
+            ApiRouteCollectDtoWithRegisteredChildren(requestDtos, dto.type);
+        }
+        else if (dto) {
+            ApiRouteCollectDtoWithRegisteredChildren(requestDtos, dto);
         }
     }
     const swaggerDecorators = requestDtos.length > 0 ? [ApiExtraModels(...requestDtos)] : [];
+    if (ApiRouteIsDiscriminatedDtoProperties(bodyDto)) {
+        swaggerDecorators.push(ApiBody({
+            schema: ApiRouteBuildDiscriminatedDtoOpenApiSchema(bodyDto, "ApiRouteCustom body"),
+        }));
+    }
     if (swaggerDecorators.length > 0) {
         applyDecorators(...swaggerDecorators)(target, propertyKey, descriptor);
     }
@@ -72,7 +86,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/esm/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":[],"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":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmBA;;;;;;;;;AASG;AACG,SAAU,wBAAwB,CAA2B,MAAc,EAAE,WAA4B,EAAE,QAA8B,EAAE,iBAA2D,EAAE,UAA8B,EAAA;AAC3O,IAAA,MAAM,OAAO,GAAoC,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,WAAW,CAAC,IAAI,CAAC;AACjH,IAAA,MAAM,mBAAmB,GAAoC,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,WAAW,CAAC,UAAU,CAAC;AACnI,IAAA,MAAM,cAAc,GAAoC,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,WAAW,CAAC,KAAK,CAAC;AACzH,IAAA,MAAM,aAAa,GAA8B,oCAAoC,CAAC,mBAAmB,CAAC,GAAG,SAAS,GAAG,mBAAmB;AAC5I,IAAA,MAAM,QAAQ,GAA8B,oCAAoC,CAAC,cAAc,CAAC,GAAG,SAAS,GAAG,cAAc;AAC7H,IAAA,MAAM,sBAAsB,GAAmE,OAAO,CAAC,WAAW,CAAC,mBAAmB,EAAE,MAAM,CAAC,WAAW,EAAE,WAAW,CAAmE;AAC1O,IAAA,MAAM,cAAc,GAAmB,CAAC,IAAK,OAAO,CAAC,WAAW,CAAC,mBAAmB,EAAE,MAAM,EAAE,WAAW,CAAgC,IAAI,EAAE,CAAC,CAAC;AAEjJ,IAAA,KAAK,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,IAAI;QACpC,EAAE,GAAG,EAAE,oCAAoC,CAAC,OAAO,CAAC,GAAG,MAAM,GAAG,OAAO,EAAE,aAAa,EAAE,eAAe,CAAC,IAAI,EAAE;QAC9G,EAAE,GAAG,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,CAAC,KAAK,EAAE;QAC5D,EAAE,GAAG,EAAE,QAAQ,EAAE,aAAa,EAAE,eAAe,CAAC,KAAK,EAAE;AACvD,KAAA,EAAE;QACF,IAAI,CAAC,GAAG,EAAE;YACT;QACD;QAEA,MAAM,aAAa,GAAuB,yBAAyB,CAAC,sBAAsB,EAAE,aAAa,CAAC;AAE1G,QAAA,IAAI,aAAa,KAAK,SAAS,EAAE;AAChC,YAAA,cAAc,CAAC,aAAa,CAAC,GAAG,GAAG;QACpC;IACD;AAEA,IAAA,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE;QAC9B,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,CAAC;IACjF;IAEA,MAAM,WAAW,GAAyB,EAAE;IAE5C,KAAK,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE;AACrD,QAAA,IAAI,oCAAoC,CAAC,GAAG,CAAC,EAAE;AAC9C,YAAA,wCAAwC,CAAC,WAAW,EAAE,GAAG,CAAC,IAAI,CAAC;QAChE;aAAO,IAAI,GAAG,EAAE;AACf,YAAA,wCAAwC,CAAC,WAAW,EAAE,GAAG,CAAC;QAC3D;IACD;IAEA,MAAM,iBAAiB,GAA2B,WAAW,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,WAAW,CAAC,CAAC,GAAG,EAAE;AAEhH,IAAA,IAAI,oCAAoC,CAAC,OAAO,CAAC,EAAE;AAClD,QAAA,iBAAiB,CAAC,IAAI,CACrB,OAAO,CAAC;AACP,YAAA,MAAM,EAAE,0CAA0C,CAAC,OAAO,EAAE,qBAAqB,CAAC;AAClF,SAAA,CAAC,CACF;IACF;AAEA,IAAA,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE;QACjC,eAAe,CAAC,GAAG,iBAAiB,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC;IACvE;AACD;AAEA;;;;;;;AAOG;AACH,SAAS,iBAAiB,CAA2B,QAA8B,EAAE,iBAA2D,EAAE,OAAmD,EAAA;IACpM,MAAM,aAAa,GAAoC,iBAAiB,CAAC,GAAG,GAAG,OAAO,CAAC;IAEvF,IAAI,aAAa,EAAE;AAClB,QAAA,OAAO,aAAa;IACrB;AAEA,IAAA,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,iBAAiB,CAAC,OAAO,GAAG,OAAO,CAAC,EAAE;AAClE,QAAA,OAAO,SAAS;IACjB;IAEA,MAAM,MAAM,GAAkB,yBAAyB,CAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;AAEpF,IAAA,MAAM,oBAAoB,GAAgC;AACzD,QAAA,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAE1B;AAED,IAAA,MAAM,WAAW,GAAiE;AACjF,QAAA,GAAG,iBAAiB;QACpB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;KACqC;AAEjE,IAAA,OAAO,mBAAmB,CAAC,oBAAoB,EAAE,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,CAAC;AACpG;AAEA;;;;;AAKG;AACH,SAAS,yBAAyB,CAAC,sBAAsF,EAAE,aAA8B,EAAA;IACxJ,IAAI,CAAC,sBAAsB,EAAE;AAC5B,QAAA,OAAO,SAAS;IACjB;IAEA,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC,sBAAsB,CAAC,EAAE;AAC3D,QAAA,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,GAAiD,KAAK;QACxE,MAAM,CAAC,IAAI,CAAC,GAAkB,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC;AAC5C,QAAA,MAAM,qBAAqB,GAAoB,MAAM,CAAC,IAAI,CAAC;QAE3D,IAAI,qBAAqB,KAAK,aAAa,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE;YACxE,OAAO,KAAK,CAAC,KAAK;QACnB;IACD;AAEA,IAAA,OAAO,SAAS;AACjB;;;;"}

package/dist/esm/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/esm/utility/api/route/discriminator/build-open-api-schema.utility.js

@@ -0,0 +1,24 @@
+import { getSchemaPath } from '@nestjs/swagger';
+import { ApiRouteValidateDiscriminatedDtoProperties } from './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) {
+    ApiRouteValidateDiscriminatedDtoProperties(properties, context);
+    return {
+        discriminator: {
+            mapping: Object.fromEntries(Object.entries(properties.discriminator.mapping).map(([key, value]) => [key, getSchemaPath(value)])),
+            propertyName: properties.discriminator.propertyName,
+        },
+        oneOf: properties.type.map((type) => {
+            return { $ref: getSchemaPath(type) };
+        }),
+    };
+}
+
+export { ApiRouteBuildDiscriminatedDtoOpenApiSchema };
+//# sourceMappingURL=build-open-api-schema.utility.js.map

package/dist/esm/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":[],"mappings":";;;AAQA;;;;;AAKG;AACG,SAAU,0CAA0C,CAAC,UAA+C,EAAE,OAAe,EAAA;AAC1H,IAAA,0CAA0C,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,EAAE,aAAa,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,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE;AACrC,QAAA,CAAC,CAAC;KACF;AACF;;;;"}

package/dist/esm/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/esm/utility/api/route/discriminator/create-validation-failure.utility.js

@@ -0,0 +1,44 @@
+/**
+ * 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,
+    };
+}
+
+export { ApiRouteCreateDiscriminatedDtoValidationFailure };
+//# sourceMappingURL=create-validation-failure.utility.js.map

package/dist/esm/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/esm/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/esm/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/esm/utility/api/route/discriminator/is-dto-properties.utility.js

@@ -0,0 +1,11 @@
+/**
+ * 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;
+}
+
+export { ApiRouteIsDiscriminatedDtoProperties };
+//# sourceMappingURL=is-dto-properties.utility.js.map

package/dist/esm/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/esm/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/esm/utility/api/route/discriminator/prepare-payload.utility.js

@@ -0,0 +1,17 @@
+/**
+ * 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;
+    }));
+}
+
+export { ApiRoutePrepareDiscriminatedDtoPayload };
+//# sourceMappingURL=prepare-payload.utility.js.map

package/dist/esm/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/esm/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/esm/utility/api/route/discriminator/resolve-dto.utility.js

@@ -0,0 +1,33 @@
+import { ErrorException } from '../../../error/exception.utility.js';
+import { ApiRouteValidateDiscriminatedDtoProperties } from './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) {
+    ApiRouteValidateDiscriminatedDtoProperties(properties, context);
+    if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
+        throw ErrorException(`${context} discriminator payload error: payload must be an object`);
+    }
+    const payloadAsRecord = payload;
+    const discriminatorPropertyName = properties.discriminator.propertyName;
+    if (!(discriminatorPropertyName in payloadAsRecord)) {
+        throw ErrorException(`${context} discriminator payload error: missing required discriminator field '${discriminatorPropertyName}'`);
+    }
+    const discriminatorValue = payloadAsRecord[discriminatorPropertyName];
+    if (typeof discriminatorValue !== "string" || discriminatorValue === "") {
+        throw ErrorException(`${context} discriminator payload error: invalid discriminator value '${String(discriminatorValue)}' for field '${discriminatorPropertyName}'`);
+    }
+    const dto = properties.discriminator.mapping[discriminatorValue];
+    if (!dto) {
+        throw ErrorException(`${context} discriminator payload error: invalid discriminator value '${discriminatorValue}' for field '${discriminatorPropertyName}'`);
+    }
+    return dto;
+}
+
+export { ApiRouteResolveDiscriminatedDto };
+//# sourceMappingURL=resolve-dto.utility.js.map

package/dist/esm/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":[],"mappings":";;;AAOA;;;;;;AAMG;SACa,+BAA+B,CAAC,UAA+C,EAAE,OAAgB,EAAE,OAAe,EAAA;AACjI,IAAA,0CAA0C,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,MAAM,cAAc,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,MAAM,cAAc,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,MAAM,cAAc,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,MAAM,cAAc,CAAC,CAAA,EAAG,OAAO,CAAA,2DAAA,EAA8D,kBAAkB,CAAA,aAAA,EAAgB,yBAAyB,CAAA,CAAA,CAAG,CAAC;IAC7J;AAEA,IAAA,OAAO,GAAG;AACX;;;;"}

package/dist/esm/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/esm/utility/api/route/discriminator/validate-dto-properties.utility.js

@@ -0,0 +1,19 @@
+import { ApiDiscriminatorValidateConfig } from '../../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) {
+    ApiDiscriminatorValidateConfig({
+        context,
+        discriminator: properties.discriminator,
+        shouldRequireDeclaredDiscriminatorProperty: true,
+        variants: properties.type,
+    });
+}
+
+export { ApiRouteValidateDiscriminatedDtoProperties };
+//# sourceMappingURL=validate-dto-properties.utility.js.map

package/dist/esm/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":[],"mappings":";;AAIA;;;;;AAKG;AACG,SAAU,0CAA0C,CAAC,UAA+C,EAAE,OAAe,EAAA;AAC1H,IAAA,8BAA8B,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/esm/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/esm/utility/api/route/dto/collect-with-registered-children.utility.js

@@ -0,0 +1,27 @@
+import { GetRegisteredAutoDtoChildrenRecursive } from '../../../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 GetRegisteredAutoDtoChildrenRecursive(dto.prototype)) {
+        if (!target.includes(child)) {
+            target.push(child);
+        }
+    }
+}
+
+export { ApiRouteCollectDtoWithRegisteredChildren };
+//# sourceMappingURL=collect-with-registered-children.utility.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collect-with-registered-children.utility.js","sources":["../../../../../../../src/utility/api/route/dto/collect-with-registered-children.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAIA;;;;;AAKG;AACG,SAAU,wCAAwC,CAAC,MAA4B,EAAE,GAAyC,EAAA;AAC/H,IAAA,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;AACvB,QAAA,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE;AACvB,YAAA,wCAAwC,CAAC,MAAM,EAAE,IAAI,CAAC;QACvD;QAEA;IACD;IAEA,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;AAC1B,QAAA,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;IACjB;IAEA,KAAK,MAAM,KAAK,IAAI,qCAAqC,CAAC,GAAG,CAAC,SAAmB,CAAC,EAAE;QACnF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE;AAC5B,YAAA,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;QACnB;IACD;AACD;;;;"}

package/dist/esm/utility/api/route/dto/index.d.ts

@@ -0,0 +1 @@
+export { ApiRouteCollectDtoWithRegisteredChildren } from './collect-with-registered-children.utility';

package/dist/esm/utility/api/route/index.d.ts

@@ -1 +1,5 @@
+export { ApiRouteApplyDtoMetadata } from './apply-dto-metadata.utility';
+export * from './discriminator';
+export * from './dto';
 export * from './response';
+export * from './validation';

package/dist/esm/utility/api/route/response/project-relation.utility.js

@@ -43,18 +43,21 @@ function ApiRouteProjectRelationResponse(relationConfig, response) {
             return projectedItem;
         });
     }
-    else if (response !== null && typeof response === "object" && "items" in response && Array.isArray(response.items)) {
-        response.items = response.items.map((item) => {
-            if (item === null || typeof item !== "object") {
-                return item;
-            }
-            const projectedItem = { ...item };
-            responses.push(projectedItem);
-            return projectedItem;
-        });
-    }
-    else if (response !== null && typeof response === "object") {
-        responses.push(response);
+    else {
+        const responseValue = response;
+        if (responseValue !== null && typeof responseValue === "object" && "items" in responseValue && Array.isArray(responseValue.items)) {
+            responseValue.items = responseValue.items.map((item) => {
+                if (item === null || typeof item !== "object") {
+                    return item;
+                }
+                const projectedItem = { ...item };
+                responses.push(projectedItem);
+                return projectedItem;
+            });
+        }
+        else if (responseValue !== null && typeof responseValue === "object") {
+            responses.push(responseValue);
+        }
     }
     for (const projectedResponse of responses) {
         for (const relationName of relationNames) {
@@ -66,7 +69,7 @@ function ApiRouteProjectRelationResponse(relationConfig, response) {
             projectedResponse[relationName] = relationConfig.reference.shape === EApiControllerRelationReferenceShape.SCALAR ? referenceValue : { [referenceKey]: referenceValue };
         }
     }
-    return projectedArray ? projectedArray : response;
+    return projectedArray || response;
 }
 
 export { ApiRouteProjectRelationResponse };

package/dist/esm/utility/api/route/response/project-relation.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"project-relation.utility.js","sources":["../../../../../../../src/utility/api/route/response/project-relation.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;AAKA;;;;;;;AAOG;AACG,SAAU,+BAA+B,CAA8B,cAAiF,EAAE,QAAW,EAAA;AAC1K,IAAA,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,OAAO,EAAE;AACnC,QAAA,OAAO,QAAQ;IAChB;AAEA,IAAA,MAAM,aAAa,GAAkB,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;IAC7E,MAAM,YAAY,GAAW,cAAc,CAAC,SAAS,CAAC,GAAG,IAAI,IAAI;IACjE,MAAM,SAAS,GAAmC,EAAE;AACpD,IAAA,IAAI,cAA0C;AAE9C,IAAA,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;QAC5B,cAAc,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAa,KAAa;YACxD,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;AAC9C,gBAAA,OAAO,IAAI;YACZ;AAEA,YAAA,MAAM,aAAa,GAA4B,EAAE,GAAI,IAAgC,EAAE;AACvF,YAAA,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC;AAE7B,YAAA,OAAO,aAAa;AACrB,QAAA,CAAC,CAAC;IACH;SAAO,IAAI,QAAQ,KAAK,IAAI,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,OAAO,IAAI,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAE,QAAgC,CAAC,KAAK,CAAC,EAAE;AAC7I,QAAA,QAAsC,CAAC,KAAK,GAAI,QAAsC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAa,KAAa;YAC5H,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;AAC9C,gBAAA,OAAO,IAAI;YACZ;AAEA,YAAA,MAAM,aAAa,GAA4B,EAAE,GAAI,IAAgC,EAAE;AACvF,YAAA,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC;AAE7B,YAAA,OAAO,aAAa;AACrB,QAAA,CAAC,CAAC;IACH;SAAO,IAAI,QAAQ,KAAK,IAAI,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE;AAC7D,QAAA,SAAS,CAAC,IAAI,CAAC,QAAmC,CAAC;IACpD;AAEA,IAAA,KAAK,MAAM,iBAAiB,IAAI,SAAS,EAAE;AAC1C,QAAA,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE;AACzC,YAAA,MAAM,aAAa,GAAY,iBAAiB,CAAC,YAAY,CAAC;AAE9D,YAAA,IAAI,aAAa,KAAK,IAAI,IAAI,aAAa,KAAK,SAAS,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE;gBAC/F;YACD;AAEA,YAAA,MAAM,cAAc,GAAa,aAAyC,CAAC,YAAY,CAAC;YACxF,iBAAiB,CAAC,YAAY,CAAC,GAAG,cAAc,CAAC,SAAS,CAAC,KAAK,KAAK,oCAAoC,CAAC,MAAM,GAAG,cAAc,GAAG,EAAE,CAAC,YAAY,GAAG,cAAc,EAAE;QACvK;IACD;IAEA,OAAO,cAAc,GAAI,cAAoB,GAAG,QAAQ;AACzD;;;;"}
+{"version":3,"file":"project-relation.utility.js","sources":["../../../../../../../src/utility/api/route/response/project-relation.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;AAKA;;;;;;;AAOG;AACG,SAAU,+BAA+B,CAA8B,cAAiF,EAAE,QAAW,EAAA;AAC1K,IAAA,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,OAAO,EAAE;AACnC,QAAA,OAAO,QAAQ;IAChB;AAEA,IAAA,MAAM,aAAa,GAAkB,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;IAC7E,MAAM,YAAY,GAAW,cAAc,CAAC,SAAS,CAAC,GAAG,IAAI,IAAI;IACjE,MAAM,SAAS,GAAmC,EAAE;AACpD,IAAA,IAAI,cAA0C;AAE9C,IAAA,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;QAC5B,cAAc,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAa,KAAa;YACxD,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;AAC9C,gBAAA,OAAO,IAAI;YACZ;AAEA,YAAA,MAAM,aAAa,GAA4B,EAAE,GAAI,IAAgC,EAAE;AACvF,YAAA,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC;AAE7B,YAAA,OAAO,aAAa;AACrB,QAAA,CAAC,CAAC;IACH;SAAO;QACN,MAAM,aAAa,GAAY,QAAQ;QAEvC,IAAI,aAAa,KAAK,IAAI,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,OAAO,IAAI,aAAa,IAAI,KAAK,CAAC,OAAO,CAAE,aAAqC,CAAC,KAAK,CAAC,EAAE;AAC1J,YAAA,aAA2C,CAAC,KAAK,GAAI,aAA2C,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAa,KAAa;gBACtI,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;AAC9C,oBAAA,OAAO,IAAI;gBACZ;AAEA,gBAAA,MAAM,aAAa,GAA4B,EAAE,GAAI,IAAgC,EAAE;AACvF,gBAAA,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC;AAE7B,gBAAA,OAAO,aAAa;AACrB,YAAA,CAAC,CAAC;QACH;aAAO,IAAI,aAAa,KAAK,IAAI,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE;AACvE,YAAA,SAAS,CAAC,IAAI,CAAC,aAAwC,CAAC;QACzD;IACD;AAEA,IAAA,KAAK,MAAM,iBAAiB,IAAI,SAAS,EAAE;AAC1C,QAAA,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE;AACzC,YAAA,MAAM,aAAa,GAAY,iBAAiB,CAAC,YAAY,CAAC;AAE9D,YAAA,IAAI,aAAa,KAAK,IAAI,IAAI,aAAa,KAAK,SAAS,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE;gBAC/F;YACD;AAEA,YAAA,MAAM,cAAc,GAAa,aAAyC,CAAC,YAAY,CAAC;YACxF,iBAAiB,CAAC,YAAY,CAAC,GAAG,cAAc,CAAC,SAAS,CAAC,KAAK,KAAK,oCAAoC,CAAC,MAAM,GAAG,cAAc,GAAG,EAAE,CAAC,YAAY,GAAG,cAAc,EAAE;QACvK;IACD;IAEA,OAAQ,cAAoB,IAAI,QAAQ;AACzC;;;;"}

package/dist/esm/utility/api/route/response/serialize.utility.js

@@ -1,4 +1,9 @@
 import { HttpStatus } from '@nestjs/common';
+import '@nestjs/swagger';
+import '@nestjs/swagger/dist/constants.js';
+import { ErrorException } from '../../../error/exception.utility.js';
+import { ApiRoutePrepareDiscriminatedDtoPayload } from '../discriminator/prepare-payload.utility.js';
+import { ApiRouteResolveDiscriminatedDto } from '../discriminator/resolve-dto.utility.js';
 import { plainToInstance } from 'class-transformer';
 
 /**
@@ -13,6 +18,21 @@ function ApiRouteSerializeResponse(metadata, response) {
     if (!metadata.response?.serialization?.isEnabled || !metadata.response.type || metadata.response.status === HttpStatus.NO_CONTENT) {
         return response;
     }
+    if (Array.isArray(metadata.response.type)) {
+        if (!metadata.response.discriminator) {
+            throw ErrorException("ApiRouteSerializeResponse error: response.discriminator is required when response.type is an array");
+        }
+        const discriminatedResponseProperties = {
+            discriminator: metadata.response.discriminator,
+            type: metadata.response.type,
+        };
+        const selectedDto = ApiRouteResolveDiscriminatedDto(discriminatedResponseProperties, response, "ApiRouteSerializeResponse");
+        return plainToInstance(selectedDto, ApiRoutePrepareDiscriminatedDtoPayload(discriminatedResponseProperties, response), {
+            // eslint-disable-next-line @elsikora/typescript/naming-convention
+            excludeExtraneousValues: true,
+            strategy: "excludeAll",
+        });
+    }
     return plainToInstance(metadata.response.type, response, {
         // eslint-disable-next-line @elsikora/typescript/naming-convention
         excludeExtraneousValues: true,

package/dist/esm/utility/api/route/response/serialize.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"serialize.utility.js","sources":["../../../../../../../src/utility/api/route/response/serialize.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAOA;;;;;;;AAOG;AACG,SAAU,yBAAyB,CAA8B,QAAgD,EAAE,QAAW,EAAA;IACnI,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,SAAS,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,KAAK,UAAU,CAAC,UAAU,EAAE;AAClI,QAAA,OAAO,QAAQ;IAChB;IAEA,OAAO,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAA2B,EAAE,QAAQ,EAAE;;AAE/E,QAAA,uBAAuB,EAAE,IAAI;AAC7B,QAAA,QAAQ,EAAE,YAAY;AACtB,KAAA,CAAC;AACH;;;;"}
+{"version":3,"file":"serialize.utility.js","sources":["../../../../../../../src/utility/api/route/response/serialize.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;AAUA;;;;;;;AAOG;AACG,SAAU,yBAAyB,CAA8B,QAAgD,EAAE,QAAW,EAAA;IACnI,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,SAAS,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,KAAK,UAAU,CAAC,UAAU,EAAE;AAClI,QAAA,OAAO,QAAQ;IAChB;IAEA,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;AAC1C,QAAA,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,aAAa,EAAE;AACrC,YAAA,MAAM,cAAc,CAAC,oGAAoG,CAAC;QAC3H;AAEA,QAAA,MAAM,+BAA+B,GAAwC;AAC5E,YAAA,aAAa,EAAE,QAAQ,CAAC,QAAQ,CAAC,aAAa;AAC9C,YAAA,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI;SAC5B;QACD,MAAM,WAAW,GAAwB,+BAA+B,CAAC,+BAA+B,EAAE,QAAQ,EAAE,2BAA2B,CAAwB;QAEvK,OAAO,eAAe,CAAC,WAAW,EAAE,sCAAsC,CAAC,+BAA+B,EAAE,QAAQ,CAAC,EAAE;;AAEtH,YAAA,uBAAuB,EAAE,IAAI;AAC7B,YAAA,QAAQ,EAAE,YAAY;AACtB,SAAA,CAAC;IACH;IAEA,OAAO,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAA2B,EAAE,QAAQ,EAAE;;AAE/E,QAAA,uBAAuB,EAAE,IAAI;AAC7B,QAAA,QAAQ,EAAE,YAAY;AACtB,KAAA,CAAC;AACH;;;;"}

package/dist/esm/utility/api/route/validation/flatten-errors.utility.d.ts

@@ -0,0 +1,8 @@
+import { ValidationError } from 'class-validator';
+/**
+ * Flattens class-validator errors into the same message array shape used by Nest ValidationPipe.
+ * @param {Array<ValidationError>} errors - Validation errors to flatten.
+ * @param {string} [parentProperty] - Parent property path.
+ * @returns {Array<string>} Flattened validation messages.
+ */
+export declare function ApiRouteValidationFlattenErrors(errors: Array<ValidationError>, parentProperty?: string): Array<string>;

package/dist/esm/utility/api/route/validation/flatten-errors.utility.js

@@ -0,0 +1,24 @@
+/**
+ * Flattens class-validator errors into the same message array shape used by Nest ValidationPipe.
+ * @param {Array<ValidationError>} errors - Validation errors to flatten.
+ * @param {string} [parentProperty] - Parent property path.
+ * @returns {Array<string>} Flattened validation messages.
+ */
+function ApiRouteValidationFlattenErrors(errors, parentProperty) {
+    const messages = [];
+    for (const error of errors) {
+        const propertyPath = parentProperty ? `${parentProperty}.${error.property}` : error.property;
+        if (error.constraints) {
+            messages.push(...Object.values(error.constraints).map((message) => {
+                return parentProperty ? message.replace(`${error.property} `, `${propertyPath} `) : message;
+            }));
+        }
+        if (error.children && error.children.length > 0) {
+            messages.push(...ApiRouteValidationFlattenErrors(error.children, propertyPath));
+        }
+    }
+    return messages;
+}
+
+export { ApiRouteValidationFlattenErrors };
+//# sourceMappingURL=flatten-errors.utility.js.map

package/dist/esm/utility/api/route/validation/flatten-errors.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten-errors.utility.js","sources":["../../../../../../../src/utility/api/route/validation/flatten-errors.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"AAEA;;;;;AAKG;AACG,SAAU,+BAA+B,CAAC,MAA8B,EAAE,cAAuB,EAAA;IACtG,MAAM,QAAQ,GAAkB,EAAE;AAElC,IAAA,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;AAC3B,QAAA,MAAM,YAAY,GAAW,cAAc,GAAG,GAAG,cAAc,CAAA,CAAA,EAAI,KAAK,CAAC,QAAQ,EAAE,GAAG,KAAK,CAAC,QAAQ;AAEpG,QAAA,IAAI,KAAK,CAAC,WAAW,EAAE;AACtB,YAAA,QAAQ,CAAC,IAAI,CACZ,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,OAAe,KAAY;gBACnE,OAAO,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA,EAAG,KAAK,CAAC,QAAQ,CAAA,CAAA,CAAG,EAAE,GAAG,YAAY,CAAA,CAAA,CAAG,CAAC,GAAG,OAAO;YAC5F,CAAC,CAAC,CACF;QACF;AAEA,QAAA,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE;AAChD,YAAA,QAAQ,CAAC,IAAI,CAAC,GAAG,+BAA+B,CAAC,KAAK,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAChF;IACD;AAEA,IAAA,OAAO,QAAQ;AAChB;;;;"}

package/dist/esm/utility/api/route/validation/index.d.ts

@@ -0,0 +1 @@
+export { ApiRouteValidationFlattenErrors } from './flatten-errors.utility';

package/dist/esm/utility/authorization/scope-merge-where.utility.js

@@ -41,8 +41,8 @@ function areValuesEquivalent(left, right) {
         return left.every((value, index) => areValuesEquivalent(value, right[index]));
     }
     if (isRecord(left) && isRecord(right)) {
-        const leftKeys = Object.keys(left).sort((a, b) => a.localeCompare(b));
-        const rightKeys = Object.keys(right).sort((a, b) => a.localeCompare(b));
+        const leftKeys = Object.keys(left).toSorted((a, b) => a.localeCompare(b));
+        const rightKeys = Object.keys(right).toSorted((a, b) => a.localeCompare(b));
         if (!areValuesEquivalent(leftKeys, rightKeys)) {
             return false;
         }