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

package/dist/esm/utility/api/controller/get-method-name.utility.d.ts

@@ -1,2 +1,8 @@
-import type { EApiRouteType } from "../../../enum";
+import type { EApiRouteType } from '../../../enum/decorator/api/index';
+/**
+ * Generates a standardized method name for controller methods based on the API route type.
+ * Prefixes the method name with a reserved prefix defined in constants.
+ * @param {EApiRouteType} method - The API route type (CREATE, DELETE, GET, etc.)
+ * @returns {string} The generated method name
+ */
 export declare function ApiControllerGetMethodName(method: EApiRouteType): string;

package/dist/esm/{src/utility → utility}/api/controller/get-method-name.utility.js

@@ -1,6 +1,12 @@
 import { CONTROLLER_API_DECORATOR_CONSTANT } from '../../../constant/decorator/api/controller.constant.js';
 import '../../../constant/decorator/api/function.constant.js';
 
+/**
+ * Generates a standardized method name for controller methods based on the API route type.
+ * Prefixes the method name with a reserved prefix defined in constants.
+ * @param {EApiRouteType} method - The API route type (CREATE, DELETE, GET, etc.)
+ * @returns {string} The generated method name
+ */
 function ApiControllerGetMethodName(method) {
     return `${CONTROLLER_API_DECORATOR_CONSTANT.RESERVED_METHOD_PREFIX}${method}`;
 }

package/dist/esm/utility/api/controller/get-method-name.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-method-name.utility.js","sources":["../../../../../../src/utility/api/controller/get-method-name.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAIA;;;;;AAKG;AACG,SAAU,0BAA0B,CAAC,MAAqB,EAAA;AAC/D,IAAA,OAAO,GAAG,iCAAiC,CAAC,sBAAsB,CAAG,EAAA,MAAM,EAAE;AAC9E;;;;"}

package/dist/esm/utility/api/controller/get-primary-column.utility.d.ts

@@ -1,3 +1,12 @@
+import type { IApiEntity } from '../../../interface/entity/index';
+import type { IApiControllerPrimaryColumn } from '../../../interface/utility/index';
 import type { DeepPartial } from "typeorm";
-import type { IApiControllerPrimaryColumn, IApiEntity } from "../../../interface";
+/**
+ * Extracts the primary key column and its value from an entity's metadata.
+ * Used for CRUD operations that need to identify records by primary key.
+ * @param {DeepPartial<E> | Partial<E>} parameters - The request parameters containing the primary key value
+ * @param {IApiEntity<E>} entityMetadata - The entity metadata containing column information
+ * @returns {IApiControllerPrimaryColumn<E> | undefined} The primary key information or undefined if no primary key is found
+ * @template E - The entity type
+ */
 export declare function ApiControllerGetPrimaryColumn<E>(parameters: DeepPartial<E> | Partial<E>, entityMetadata: IApiEntity<E>): IApiControllerPrimaryColumn<E> | undefined;

package/dist/esm/utility/api/controller/get-primary-column.utility.js

@@ -0,0 +1,21 @@
+/**
+ * Extracts the primary key column and its value from an entity's metadata.
+ * Used for CRUD operations that need to identify records by primary key.
+ * @param {DeepPartial<E> | Partial<E>} parameters - The request parameters containing the primary key value
+ * @param {IApiEntity<E>} entityMetadata - The entity metadata containing column information
+ * @returns {IApiControllerPrimaryColumn<E> | undefined} The primary key information or undefined if no primary key is found
+ * @template E - The entity type
+ */
+function ApiControllerGetPrimaryColumn(parameters, entityMetadata) {
+    const primaryKeyColumn = entityMetadata.columns.find((column) => column.isPrimary);
+    if (!primaryKeyColumn) {
+        return undefined;
+    }
+    return {
+        key: primaryKeyColumn.name,
+        value: parameters[primaryKeyColumn.name],
+    };
+}
+
+export { ApiControllerGetPrimaryColumn };
+//# sourceMappingURL=get-primary-column.utility.js.map

package/dist/esm/utility/api/controller/get-primary-column.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-primary-column.utility.js","sources":["../../../../../../src/utility/api/controller/get-primary-column.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"AAIA;;;;;;;AAOG;AACa,SAAA,6BAA6B,CAAI,UAAuC,EAAE,cAA6B,EAAA;AACtH,IAAA,MAAM,gBAAgB,GAAoC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAA2B,KAAoC,MAAM,CAAC,SAAS,CAAC;IAEvK,IAAI,CAAC,gBAAgB,EAAE;AACtB,QAAA,OAAO,SAAS;;IAGjB,OAAO;QACN,GAAG,EAAE,gBAAgB,CAAC,IAAI;AAC1B,QAAA,KAAK,EAAE,UAAU,CAAC,gBAAgB,CAAC,IAA4B,CAAW;KAC1E;AACF;;;;"}

package/dist/esm/utility/api/controller/handle-request-relations.utility.d.ts

@@ -1,4 +1,19 @@
+import type { IApiControllerProperties } from '../../../interface/decorator/api/index';
+import type { TApiControllerMethod } from '../../../type/class/index';
+import type { TApiControllerGetListQuery, TApiControllerPropertiesRouteBaseRequestRelations } from '../../../type/decorator/api/controller/index';
 import type { DeepPartial } from "typeorm";
-import type { IApiControllerProperties } from "../../../interface";
-import type { TApiControllerGetListQuery, TApiControllerMethod, TApiControllerPropertiesRouteBaseRequestRelations } from "../../../type";
+/**
+ * Manages loading related entities when processing API requests.
+ * Determines which relations to load based on configuration strategy (MANUAL or AUTO),
+ * finds the appropriate service for each relation, and loads the related entities.
+ * @param {TApiControllerMethod<E>} controllerMethod - The controller method with access to service instances
+ * @param {IApiControllerProperties<E>} properties - Controller configuration properties
+ * @param {TApiControllerPropertiesRouteBaseRequestRelations<E> | undefined} relationConfig - Configuration for relation loading
+ * @param {DeepPartial<E> | Partial<E> | TApiControllerGetListQuery<E>} parameters - The request parameters containing relation IDs
+ * @returns {Promise<void>} A promise that resolves when all relations are loaded
+ * @throws {BadRequestException} When an invalid relation ID is provided
+ * @throws {Error} When service configuration is invalid or services are not found
+ * @template E - The entity type
+ * @template R - The route type
+ */
 export declare function ApiControllerHandleRequestRelations<E>(controllerMethod: TApiControllerMethod<E>, properties: IApiControllerProperties<E>, relationConfig: TApiControllerPropertiesRouteBaseRequestRelations<E> | undefined, parameters: DeepPartial<E> | Partial<E> | TApiControllerGetListQuery<E>): Promise<void>;

package/dist/esm/{src/utility → utility}/api/controller/handle-request-relations.utility.js

@@ -1,6 +1,4 @@
-import { BadRequestException } from '@nestjs/common';
 import { ApiServiceBase } from '../../../class/api/service-base.class.js';
-import '../../../constant/decorator/api/function.constant.js';
 import '../../../enum/decorator/api/action.enum.js';
 import '../../../enum/decorator/api/authentication-type.enum.js';
 import { EApiControllerLoadRelationsStrategy } from '../../../enum/decorator/api/controller/load-relations-strategy.enum.js';
@@ -14,12 +12,24 @@ import '../../../enum/decorator/api/property/desribe-type.enum.js';
 import '../../../enum/decorator/api/property/number-type.enum.js';
 import '../../../enum/decorator/api/property/string-type.enum.js';
 import '../../../enum/decorator/api/route-type.enum.js';
-import '../../../enum/exception.enum.js';
-import '../../../enum/filter-order-direction.enum.js';
-import '../../../enum/utility/error-string-action.enum.js';
+import { BadRequestException } from '@nestjs/common';
 import { ErrorException } from '../../error-exception.utility.js';
 import { GetEntityColumns } from '../../get-entity-columns.utility.js';
 
+/**
+ * Manages loading related entities when processing API requests.
+ * Determines which relations to load based on configuration strategy (MANUAL or AUTO),
+ * finds the appropriate service for each relation, and loads the related entities.
+ * @param {TApiControllerMethod<E>} controllerMethod - The controller method with access to service instances
+ * @param {IApiControllerProperties<E>} properties - Controller configuration properties
+ * @param {TApiControllerPropertiesRouteBaseRequestRelations<E> | undefined} relationConfig - Configuration for relation loading
+ * @param {DeepPartial<E> | Partial<E> | TApiControllerGetListQuery<E>} parameters - The request parameters containing relation IDs
+ * @returns {Promise<void>} A promise that resolves when all relations are loaded
+ * @throws {BadRequestException} When an invalid relation ID is provided
+ * @throws {Error} When service configuration is invalid or services are not found
+ * @template E - The entity type
+ * @template R - The route type
+ */
 async function ApiControllerHandleRequestRelations(controllerMethod, properties, relationConfig, parameters) {
     if (relationConfig?.shouldLoadRelations) {
         for (const propertyName of GetEntityColumns({ entity: properties.entity, shouldTakeRelationsOnly: true })) {

package/dist/esm/utility/api/controller/handle-request-relations.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-request-relations.utility.js","sources":["../../../../../../src/utility/api/controller/handle-request-relations.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAaA;;;;;;;;;;;;;AAaG;AACI,eAAe,mCAAmC,CAAI,gBAAyC,EAAE,UAAuC,EAAE,cAAgF,EAAE,UAAuE,EAAA;AACzS,IAAA,IAAI,cAAc,EAAE,mBAAmB,EAAE;AACxC,QAAA,KAAK,MAAM,YAAY,IAAI,gBAAgB,CAAI,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,uBAAuB,EAAE,IAAI,EAAE,CAAC,EAAE;;AAE7G,YAAA,IAAI,UAAU,CAAC,YAAY,CAAC,KAAK,SAAS,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE;AAC/E,gBAAA,IAAI,cAAc,CAAC,qBAAqB,KAAK,mCAAmC,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE;oBAClJ;;AAGD,gBAAA,IAAI,WAAiD;gBAErD,IAAI,cAAc,CAAC,oBAAoB,KAAK,mCAAmC,CAAC,MAAM,EAAE;oBACvF,MAAM,iBAAiB,GAAY,cAAc,CAAC,iBAAiB,CAAC,YAAY,CAAC;AAEjF,oBAAA,IAAI,iBAAiB,KAAK,SAAS,EAAE;AACpC,wBAAA,MAAM,cAAc,CAAC,CAAA,wCAAA,EAA2C,YAAY,CAAA,eAAA,CAAiB,CAAC;;oBAE/F,WAAW,GAAG,iBAA6C;;qBACrD;AACN,oBAAA,WAAW,GAAG,CAAA,EAAG,YAAY,CAAA,OAAA,CAAqC;;gBAGnE,IAAI,CAAC,WAAW,EAAE;AACjB,oBAAA,MAAM,cAAc,CAAC,CAAA,wCAAA,EAA2C,YAAY,CAAA,CAAE,CAAC;;AAGhF,gBAAA,MAAM,OAAO,GAAY,gBAAgB,CAAC,WAAW,CAAC;gBAEtD,IAAI,CAAC,OAAO,EAAE;oBACb,IAAI,CAAC,cAAc,CAAC,oBAAoB,KAAK,mCAAmC,CAAC,IAAI,IAAI,cAAc,CAAC,mCAAmC,KAAK,cAAc,CAAC,oBAAoB,KAAK,mCAAmC,CAAC,MAAM,EAAE;AACnO,wBAAA,MAAM,cAAc,CAAC,CAAA,QAAA,EAAW,WAAqB,CAAA,wBAAA,CAA0B,CAAC;;oBAEjF;;AAGD,gBAAA,IAAI,EAAE,OAAO,YAAY,cAAc,CAAC,EAAE;AACzC,oBAAA,MAAM,cAAc,CAAC,CAAA,QAAA,EAAW,WAAqB,CAAA,qCAAA,CAAuC,CAAC;;AAG9F,gBAAA,MAAM,iBAAiB,GAAiC;AACvD,oBAAA,KAAK,EAAE;AACN,wBAAA,EAAE,EAAE,UAAU,CAAC,YAAY,CAAC;AACL,qBAAA;iBACxB;gBAED,MAAM,MAAM,IAAyB,MAAM,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAwB;gBAEjG,IAAI,CAAC,MAAM,EAAE;oBACZ,MAAM,IAAI,mBAAmB,CAAC,CAAW,QAAA,EAAA,MAAM,CAAC,YAAY,CAAC,CAAK,GAAA,CAAA,CAAC;;;AAIpE,gBAAA,UAAU,CAAC,YAAY,CAAC,GAAG,MAAM;;;;AAIrC;;;;"}

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

@@ -1,9 +1,10 @@
-export * from "./apply-decorators.utility";
-export * from "./apply-metadata.utility";
-export * from "./get-list";
-export * from "./get-method-name.utility";
-export * from "./handle-request-relations.utility";
-export * from "./transform-data.utility";
-export * from "./validate-request.utility";
-export * from "./write-dto-swagger.utility";
-export * from "./write-method.utility";
+export { ApiControllerApplyDecorators } from './apply-decorators.utility';
+export { ApiControllerApplyMetadata } from './apply-metadata.utility';
+export * from './get-list/index';
+export { ApiControllerGetMethodName } from './get-method-name.utility';
+export { ApiControllerGetPrimaryColumn } from './get-primary-column.utility';
+export { ApiControllerHandleRequestRelations } from './handle-request-relations.utility';
+export { ApiControllerTransformData } from './transform-data.utility';
+export { ApiControllerValidateRequest } from './validate-request.utility';
+export { ApiControllerWriteDtoSwagger } from './write-dto-swagger.utility';
+export { ApiControllerWriteMethod } from './write-method.utility';

package/dist/esm/utility/api/controller/transform-data.utility.d.ts

@@ -1,4 +1,16 @@
-import type { EApiRouteType } from "../../../enum";
-import type { IApiControllerProperties } from "../../../interface";
-import type { TApiControllerPropertiesRouteBaseRequestTransformers, TApiControllerPropertiesRouteBaseResponseTransformers, TApiControllerTransformDataData, TApiControllerTransformDataObjectToTransform } from "../../../type";
+import type { EApiRouteType } from '../../../enum/decorator/api/index';
+import type { IApiControllerProperties } from '../../../interface/decorator/api/index';
+import type { TApiControllerPropertiesRouteBaseRequestTransformers, TApiControllerPropertiesRouteBaseResponseTransformers } from '../../../type/decorator/api/controller/index';
+import type { TApiControllerTransformDataData, TApiControllerTransformDataObjectToTransform } from '../../../type/utility/index';
+/**
+ * Transforms data between request/response objects and entity objects.
+ * Handles both static and dynamic transformations for body, query, request, and response data.
+ * @param {TApiControllerPropertiesRouteBaseRequestTransformers<E, R> | TApiControllerPropertiesRouteBaseResponseTransformers<E, R> | undefined} transformers - Configuration for data transformations
+ * @param {IApiControllerProperties<E>} properties - Controller configuration properties
+ * @param {TApiControllerTransformDataObjectToTransform<E>} objectToTransform - The object to apply transformations to
+ * @param {TApiControllerTransformDataData} data - Data sources to use for transformations including headers, IP address, and authentication
+ * @returns {void}
+ * @template E - The entity type
+ * @template R - The route type
+ */
 export declare function ApiControllerTransformData<E, R extends EApiRouteType>(transformers: TApiControllerPropertiesRouteBaseRequestTransformers<E, R> | TApiControllerPropertiesRouteBaseResponseTransformers<E, R> | undefined, properties: IApiControllerProperties<E>, objectToTransform: TApiControllerTransformDataObjectToTransform<E>, data: TApiControllerTransformDataData): void;

package/dist/esm/{src/utility → utility}/api/controller/transform-data.utility.js

@@ -1,4 +1,3 @@
-import { InternalServerErrorException } from '@nestjs/common';
 import { TRANSFORMER_VALUE_DTO_CONSTANT } from '../../../constant/dto/transformer-value.constant.js';
 import '../../../enum/decorator/api/action.enum.js';
 import '../../../enum/decorator/api/authentication-type.enum.js';
@@ -13,11 +12,21 @@ import '../../../enum/decorator/api/property/desribe-type.enum.js';
 import '../../../enum/decorator/api/property/number-type.enum.js';
 import '../../../enum/decorator/api/property/string-type.enum.js';
 import '../../../enum/decorator/api/route-type.enum.js';
-import '../../../enum/exception.enum.js';
-import '../../../enum/filter-order-direction.enum.js';
 import { EErrorStringAction } from '../../../enum/utility/error-string-action.enum.js';
+import { InternalServerErrorException } from '@nestjs/common';
 import { ErrorString } from '../../error-string.utility.js';
 
+/**
+ * Transforms data between request/response objects and entity objects.
+ * Handles both static and dynamic transformations for body, query, request, and response data.
+ * @param {TApiControllerPropertiesRouteBaseRequestTransformers<E, R> | TApiControllerPropertiesRouteBaseResponseTransformers<E, R> | undefined} transformers - Configuration for data transformations
+ * @param {IApiControllerProperties<E>} properties - Controller configuration properties
+ * @param {TApiControllerTransformDataObjectToTransform<E>} objectToTransform - The object to apply transformations to
+ * @param {TApiControllerTransformDataData} data - Data sources to use for transformations including headers, IP address, and authentication
+ * @returns {void}
+ * @template E - The entity type
+ * @template R - The route type
+ */
 function ApiControllerTransformData(transformers, properties, objectToTransform, data) {
     if (!transformers)
         return;
@@ -46,6 +55,17 @@ function ApiControllerTransformData(transformers, properties, objectToTransform,
         }
     }
 }
+/**
+ * Handles transformation of object properties, setting values with appropriate type handling.
+ * @param {TApiTransformDataIsValidationProperties<E>} object - The object to transform
+ * @param {keyof E | keyof IApiGetListResponseResult<E> | keyof TApiControllerGetListQuery<E>} key - The property key
+ * @param {unknown} value - The value to set
+ * @param {IApiBaseEntity} entity - The entity metadata
+ * @param {boolean} [shouldSetValueEvenIfMissing] - Whether to set the value even if the key is missing
+ * @returns {void}
+ * @throws {InternalServerErrorException} When key not found in object and not forced
+ * @private
+ */
 function handleTransformation(object, key, value, entity, shouldSetValueEvenIfMissing = false) {
     if (isApiGetListResponseResult(object)) {
         if (key in object) {
@@ -70,15 +90,44 @@ function handleTransformation(object, key, value, entity, shouldSetValueEvenIfMi
         }));
     }
 }
+/**
+ * Checks if an object is a get list query properties instance.
+ * @param {TApiTransformDataIsValidationProperties<E>} object - The object to check
+ * @returns {boolean} True if the object is a get list query object
+ * @private
+ */
 function isApiFunctionGetListProperties(object) {
     return "limit" in object && "page" in object;
 }
+/**
+ * Checks if an object is a get list response result instance.
+ * @param {TApiTransformDataIsValidationProperties<E>} object - The object to check
+ * @returns {boolean} True if the object is a get list response result
+ * @private
+ */
 function isApiGetListResponseResult(object) {
     return "items" in object && "totalCount" in object;
 }
+/**
+ * Checks if an object is a partial entity instance.
+ * @param {TApiTransformDataIsValidationProperties<E>} object - The object to check
+ * @returns {boolean} True if the object is a partial entity
+ * @private
+ */
 function isPartialE(object) {
     return !isApiGetListResponseResult(object) && !isApiFunctionGetListProperties(object);
 }
+/**
+ * Processes a single transformer, applying the transformation to the object.
+ * Handles both static and dynamic transformations including special values like user, IP, and headers.
+ * @param {TApiRequestTransformer<E>} transformer - The transformer configuration
+ * @param {TApiTransformDataIsValidationProperties<E>} objectToTransform - The object to transform
+ * @param {IApiControllerProperties<E>} properties - Controller configuration properties
+ * @param {TApiControllerTransformDataData} data - The data sources for transformation
+ * @returns {void}
+ * @throws {InternalServerErrorException} When required data for transformation is missing
+ * @private
+ */
 function processTransformer(transformer, objectToTransform, properties, data) {
     switch (transformer.type) {
         case EApiControllerRequestTransformerType.DYNAMIC: {

package/dist/esm/utility/api/controller/transform-data.utility.js.map

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

package/dist/esm/utility/api/controller/validate-request.utility.d.ts

@@ -1,3 +1,13 @@
-import type { IApiControllerProperties, IApiRequestValidator } from "../../../interface";
-import type { TApiControllerGetListQuery } from "../../../type";
+import type { IApiRequestValidator } from '../../../interface/api-request-validator.interface';
+import type { IApiControllerProperties } from '../../../interface/decorator/api/index';
+import type { TApiControllerGetListQuery } from '../../../type/decorator/api/controller/index';
+/**
+ * Validates incoming request parameters against defined validators.
+ * Sequentially applies validation functions and throws appropriate exceptions with error messages when validation fails.
+ * @param {Array<IApiRequestValidator<E>> | undefined} validators - List of request validators to apply
+ * @param {IApiControllerProperties<E>} properties - Controller configuration properties
+ * @param {Partial<E> | TApiControllerGetListQuery<E>} parameters - The request parameters to validate
+ * @returns {Promise<void>} A promise that resolves when validation passes
+ * @template E - The entity type
+ */
 export declare function ApiControllerValidateRequest<E>(validators: Array<IApiRequestValidator<E>> | undefined, properties: IApiControllerProperties<E>, parameters: Partial<E> | TApiControllerGetListQuery<E>): Promise<void>;

package/dist/esm/{src/utility → utility}/api/controller/validate-request.utility.js

@@ -1,5 +1,14 @@
 import { ErrorString } from '../../error-string.utility.js';
 
+/**
+ * Validates incoming request parameters against defined validators.
+ * Sequentially applies validation functions and throws appropriate exceptions with error messages when validation fails.
+ * @param {Array<IApiRequestValidator<E>> | undefined} validators - List of request validators to apply
+ * @param {IApiControllerProperties<E>} properties - Controller configuration properties
+ * @param {Partial<E> | TApiControllerGetListQuery<E>} parameters - The request parameters to validate
+ * @returns {Promise<void>} A promise that resolves when validation passes
+ * @template E - The entity type
+ */
 async function ApiControllerValidateRequest(validators, properties, parameters) {
     if (validators) {
         for (const validator of validators) {

package/dist/esm/utility/api/controller/validate-request.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-request.utility.js","sources":["../../../../../../src/utility/api/controller/validate-request.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAMA;;;;;;;;AAQG;AACI,eAAe,4BAA4B,CAAI,UAAsD,EAAE,UAAuC,EAAE,UAAsD,EAAA;IAC5M,IAAI,UAAU,EAAE;AACf,QAAA,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE;YACnC,MAAM,MAAM,GAA+B,SAAS,CAAC,kBAAkB,CAAC,UAAU,CAAC;AACnF,YAAA,MAAM,OAAO,GAAY,MAAM,YAAY,OAAO,GAAG,MAAM,MAAM,GAAG,MAAM;YAE1E,IAAI,CAAC,OAAO,EAAE;gBACb,MAAM,IAAI,SAAS,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC;;;;AAIxG;;;;"}

package/dist/esm/utility/api/controller/write-dto-swagger.utility.d.ts

@@ -1,4 +1,18 @@
-import type { EApiRouteType } from "../../../enum";
-import type { IApiControllerProperties, IApiEntity } from "../../../interface";
-import type { TApiControllerPropertiesRoute } from "../../../type";
+import type { EApiRouteType } from '../../../enum/decorator/api/index';
+import type { IApiControllerProperties } from '../../../interface/decorator/api/index';
+import type { IApiEntity } from '../../../interface/entity/index';
+import type { TApiControllerPropertiesRoute } from '../../../type/decorator/api/controller/index';
+/**
+ * Generates and registers Swagger documentation for DTOs.
+ * Creates or uses existing DTOs for request, query, body, and response,
+ * and ensures they're properly registered with Swagger for API documentation.
+ * @param {object} target - The target controller class
+ * @param {IApiEntity<E>} entity - The entity definition
+ * @param {IApiControllerProperties<E>} properties - Controller configuration properties
+ * @param {EApiRouteType} method - The type of route (CREATE, DELETE, GET, etc.)
+ * @param {TApiControllerPropertiesRoute<E, typeof method>} routeConfig - Route-specific configuration
+ * @param {IApiEntity<E>} entityMetadata - The entity metadata containing column information
+ * @returns {void}
+ * @template E - The entity type
+ */
 export declare function ApiControllerWriteDtoSwagger<E>(target: object, entity: IApiEntity<E>, properties: IApiControllerProperties<E>, method: EApiRouteType, routeConfig: TApiControllerPropertiesRoute<E, typeof method>, entityMetadata: IApiEntity<E>): void;

package/dist/esm/{src/utility → utility}/api/controller/write-dto-swagger.utility.js

@@ -1,5 +1,6 @@
-import { DECORATORS } from '@nestjs/swagger/dist/constants';
 import { MetadataStorage } from '../../../class/metadata-storage.class.js';
+import '../../../constant/decorator/api/function.constant.js';
+import { PROPERTY_DESCRIBE_DECORATOR_API_CONSTANT } from '../../../constant/decorator/api/property-describe.constant.js';
 import '../../../enum/decorator/api/action.enum.js';
 import '../../../enum/decorator/api/authentication-type.enum.js';
 import '../../../enum/decorator/api/controller/load-relations-strategy.enum.js';
@@ -13,30 +14,38 @@ import { EApiPropertyDescribeType } from '../../../enum/decorator/api/property/d
 import '../../../enum/decorator/api/property/number-type.enum.js';
 import '../../../enum/decorator/api/property/string-type.enum.js';
 import '../../../enum/decorator/api/route-type.enum.js';
-import '../../../enum/exception.enum.js';
-import '../../../enum/filter-order-direction.enum.js';
-import '../../../enum/utility/error-string-action.enum.js';
-import '../../../constant/decorator/api/function.constant.js';
-import { PROPERTY_DESCRIBE_DECORATOR_API_CONSTANT } from '../../../constant/decorator/api/property-describe.constant.js';
+import { DECORATORS } from '@nestjs/swagger/dist/constants';
 import { CamelCaseString } from '../../camel-case-string.utility.js';
 import '../../../constant/utility/dto/constant.js';
-import '../../../../external/tslib/tslib.es6.js';
+import '../../../external/tslib/tslib.es6.js';
 import '@nestjs/common';
 import '@nestjs/swagger';
 import 'class-transformer';
 import 'class-validator';
 import 'lodash/random';
-import '../../../validator/all-or-none-of-listed-properties.validator.js';
-import '../../../validator/has-at-least-one-and-only-one-of-listed-properties.validator.js';
-import '../../../validator/has-at-least-one-of-listed-properties.validator.js';
-import '../../../validator/has-at-least-one-property.validator.js';
 import '../../../validator/is-regular-expression.validator.js';
-import '../../../validator/only-one-of-listed-properties.validator.js';
 import 'node:crypto';
+import '../../../enum/filter-operation.enum.js';
+import '../../../validator/must-match-one-of-schemas.validator.js';
 import { DtoGenerate } from '../../dto/generate.utility.js';
+import '../../../enum/filter-order-direction.enum.js';
 import 'typeorm';
 import 'reflect-metadata';
+import '../../../validator/all-or-none-of-listed-properties.validator.js';
 
+/**
+ * Generates and registers Swagger documentation for DTOs.
+ * Creates or uses existing DTOs for request, query, body, and response,
+ * and ensures they're properly registered with Swagger for API documentation.
+ * @param {object} target - The target controller class
+ * @param {IApiEntity<E>} entity - The entity definition
+ * @param {IApiControllerProperties<E>} properties - Controller configuration properties
+ * @param {EApiRouteType} method - The type of route (CREATE, DELETE, GET, etc.)
+ * @param {TApiControllerPropertiesRoute<E, typeof method>} routeConfig - Route-specific configuration
+ * @param {IApiEntity<E>} entityMetadata - The entity metadata containing column information
+ * @returns {void}
+ * @template E - The entity type
+ */
 function ApiControllerWriteDtoSwagger(target, entity, properties, method, routeConfig, entityMetadata) {
     const swaggerModels = (Reflect.getMetadata(DECORATORS.API_EXTRA_MODELS, target) ?? []);
     const requestDto = routeConfig.dto?.request ?? DtoGenerate(properties.entity, entity, method, EApiDtoType.REQUEST, routeConfig.autoDto?.[EApiDtoType.REQUEST], routeConfig.authentication?.guard);

package/dist/esm/utility/api/controller/write-dto-swagger.utility.js.map

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

package/dist/esm/utility/api/controller/write-method.utility.d.ts

@@ -1,3 +1,17 @@
-import type { EApiRouteType } from "../../../enum";
-import type { IApiControllerProperties, IApiEntity } from "../../../interface";
+import type { EApiRouteType } from '../../../enum/decorator/api/index';
+import type { IApiControllerProperties } from '../../../interface/decorator/api/index';
+import type { IApiEntity } from '../../../interface/entity/index';
+/**
+ * Creates controller methods dynamically.
+ * Gets the method name, checks if it's already defined, and either
+ * calls the implementation or throws an error if not implemented.
+ * @param {Record<string, (method: EApiRouteType, methodName: string, properties: IApiControllerProperties<E>, entityMetadata: IApiEntity<E>) => void>} thisTarget - The object containing method implementations
+ * @param {Record<string, unknown>} target - The target controller class to add methods to
+ * @param {EApiRouteType} method - The type of route (CREATE, DELETE, GET, etc.)
+ * @param {IApiControllerProperties<E>} properties - Controller configuration properties
+ * @param {IApiEntity<E>} entityMetadata - The entity metadata containing column information
+ * @returns {void}
+ * @throws {Error} When the reserved method is already defined or method implementation is missing
+ * @template E - The entity type
+ */
 export declare function ApiControllerWriteMethod<E>(thisTarget: Record<string, (method: EApiRouteType, methodName: string, properties: IApiControllerProperties<E>, entityMetadata: IApiEntity<E>) => void>, target: Record<string, unknown>, method: EApiRouteType, properties: IApiControllerProperties<E>, entityMetadata: IApiEntity<E>): void;

package/dist/esm/utility/api/controller/write-method.utility.js

@@ -0,0 +1,31 @@
+import { ApiControllerGetMethodName } from './get-method-name.utility.js';
+import { ErrorException } from '../../error-exception.utility.js';
+
+/**
+ * Creates controller methods dynamically.
+ * Gets the method name, checks if it's already defined, and either
+ * calls the implementation or throws an error if not implemented.
+ * @param {Record<string, (method: EApiRouteType, methodName: string, properties: IApiControllerProperties<E>, entityMetadata: IApiEntity<E>) => void>} thisTarget - The object containing method implementations
+ * @param {Record<string, unknown>} target - The target controller class to add methods to
+ * @param {EApiRouteType} method - The type of route (CREATE, DELETE, GET, etc.)
+ * @param {IApiControllerProperties<E>} properties - Controller configuration properties
+ * @param {IApiEntity<E>} entityMetadata - The entity metadata containing column information
+ * @returns {void}
+ * @throws {Error} When the reserved method is already defined or method implementation is missing
+ * @template E - The entity type
+ */
+function ApiControllerWriteMethod(thisTarget, target, method, properties, entityMetadata) {
+    const methodName = ApiControllerGetMethodName(method);
+    if (target[methodName]) {
+        throw ErrorException(`Reserved method ${methodName} already defined`);
+    }
+    if (thisTarget[method]) {
+        thisTarget[method](method, methodName, properties, entityMetadata);
+    }
+    else {
+        throw ErrorException(`Method ${methodName} not implemented`);
+    }
+}
+
+export { ApiControllerWriteMethod };
+//# sourceMappingURL=write-method.utility.js.map

package/dist/esm/utility/api/controller/write-method.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-method.utility.js","sources":["../../../../../../src/utility/api/controller/write-method.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAOA;;;;;;;;;;;;AAYG;AACG,SAAU,wBAAwB,CAAI,UAAuJ,EAAE,MAA+B,EAAE,MAAqB,EAAE,UAAuC,EAAE,cAA6B,EAAA;AAClU,IAAA,MAAM,UAAU,GAAW,0BAA0B,CAAC,MAAM,CAAC;AAE7D,IAAA,IAAI,MAAM,CAAC,UAAU,CAAC,EAAE;AACvB,QAAA,MAAM,cAAc,CAAC,CAAA,gBAAA,EAAmB,UAAU,CAAA,gBAAA,CAAkB,CAAC;;AAGtE,IAAA,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE;AACvB,QAAA,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,CAAC;;SAC5D;AACN,QAAA,MAAM,cAAc,CAAC,CAAA,OAAA,EAAU,UAAU,CAAA,gBAAA,CAAkB,CAAC;;AAE9D;;;;"}

package/dist/esm/utility/api/filter-order-by-from-entity.utility.d.ts

@@ -1,6 +1,19 @@
+import type { EApiDtoType, EApiRouteType } from '../../enum/decorator/api/index';
+import type { IApiEntity } from '../../interface/entity/index';
+import type { TApiFilterOrderBy, TFilterFieldSelector } from '../../type/decorator/api/filter/index';
 import type { ObjectLiteral } from "typeorm";
-import type { EApiDtoType, EApiRouteType } from "../../enum";
-import type { IApiEntity } from "../../interface";
-import type { TApiFilterOrderBy, TFilterFieldSelector } from "../../type";
 import "reflect-metadata";
+/**
+ * Extracts filterable and sortable fields from an entity for building query filters.
+ * Analyzes entity columns, checks if they're of allowed types, and transforms
+ * property names to snake_case for use in filter and order-by operations.
+ * @param {ObjectLiteral} entity - The entity class
+ * @param {IApiEntity<E>} entityMetadata - The entity metadata containing column information
+ * @param {EApiRouteType} method - The type of route (CREATE, DELETE, GET, etc.)
+ * @param {EApiDtoType} dtoType - The type of DTO (REQUEST, RESPONSE, etc.)
+ * @param {TFilterFieldSelector<typeof entity>} [fieldSelector] - Optional selector to include/exclude specific fields
+ * @returns {TApiFilterOrderBy<typeof entity>} An object mapping snake_case column names to camelCase property names
+ * @throws {Error} When a field in the fieldSelector doesn't exist in the entity
+ * @template E - The entity type
+ */
 export declare function FilterOrderByFromEntity<E>(entity: ObjectLiteral, entityMetadata: IApiEntity<E>, method: EApiRouteType, dtoType: EApiDtoType, fieldSelector?: TFilterFieldSelector<typeof entity>): TApiFilterOrderBy<typeof entity>;

package/dist/esm/{src/utility → utility}/api/filter-order-by-from-entity.utility.js

@@ -1,9 +1,22 @@
-import { getMetadataArgsStorage } from 'typeorm';
 import '../../constant/decorator/api/function.constant.js';
 import { PROPERTY_DESCRIBE_DECORATOR_API_CONSTANT } from '../../constant/decorator/api/property-describe.constant.js';
 import { FILTER_API_INTERFACE_CONSTANT } from '../../constant/interface/api/filter.constant.js';
+import { getMetadataArgsStorage } from 'typeorm';
 import 'reflect-metadata';
 
+/**
+ * Extracts filterable and sortable fields from an entity for building query filters.
+ * Analyzes entity columns, checks if they're of allowed types, and transforms
+ * property names to snake_case for use in filter and order-by operations.
+ * @param {ObjectLiteral} entity - The entity class
+ * @param {IApiEntity<E>} entityMetadata - The entity metadata containing column information
+ * @param {EApiRouteType} method - The type of route (CREATE, DELETE, GET, etc.)
+ * @param {EApiDtoType} dtoType - The type of DTO (REQUEST, RESPONSE, etc.)
+ * @param {TFilterFieldSelector<typeof entity>} [fieldSelector] - Optional selector to include/exclude specific fields
+ * @returns {TApiFilterOrderBy<typeof entity>} An object mapping snake_case column names to camelCase property names
+ * @throws {Error} When a field in the fieldSelector doesn't exist in the entity
+ * @template E - The entity type
+ */
 function FilterOrderByFromEntity(entity, entityMetadata, method, dtoType, fieldSelector) {
     const metadata = getMetadataArgsStorage();
     const columns = metadata.columns.filter((column) => column.target == entity);

package/dist/esm/utility/api/filter-order-by-from-entity.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-order-by-from-entity.utility.js","sources":["../../../../../src/utility/api/filter-order-by-from-entity.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;AAcA;;;;;;;;;;;;AAYG;AACG,SAAU,uBAAuB,CAAI,MAAqB,EAAE,cAA6B,EAAE,MAAqB,EAAE,OAAoB,EAAE,aAAmD,EAAA;AAChM,IAAA,MAAM,QAAQ,GAAwB,sBAAsB,EAAE;AAC9D,IAAA,MAAM,OAAO,GAA8B,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAA0B,KAAK,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC;IAE3H,IAAI,aAAa,EAAE;AAClB,QAAA,MAAM,YAAY,GAAgB,IAAI,GAAG,CAAS,OAAO,CAAC,GAAG,CAAC,CAAC,GAAuB,KAAK,GAAG,CAAC,YAAY,CAAC,CAAC;AAE7G,QAAA,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE;YAClC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;AAC7B,gBAAA,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,CAAA,+BAAA,CAAiC,CAAC;;;;IAKpE,MAAM,WAAW,GAAqC,EAAE;AAExD,IAAA,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE;QAC7B,MAAM,UAAU,GAAmB,MAAM,CAAC,OAAO,EAAE,IAAsB,IAAK,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,MAAM,CAAC,SAAmB,EAAE,MAAM,CAAC,YAAY,CAAmB;QAEnL,MAAM,aAAa,GAAY,CAAC,OAAO,UAAU,KAAK,UAAU,KAAK,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,IAAI,CAAC,MAAM,6BAA6B,CAAC,gCAAgC,CAAC,QAAQ,CAAC,UAAoB,CAAC,KAAK,aAAa,KAAK,SAAS,IAAI,aAAa,CAAC,MAAM,CAAC,YAAmC,CAAC,KAAK,KAAK,CAAC,CAAC;QAEvV,IAAI,aAAa,EAAE;AAClB,YAAA,KAAK,MAAM,cAAc,IAAI,cAAc,CAAC,OAAO,EAAE;gBACpD,MAAM,QAAQ,GAAoC,cAAc,CAAC,QAAQ,GAAG,wCAAwC,CAAC,sBAAsB,CAAoC;;AAE/K,gBAAA,MAAM,WAAW,GAAyB,QAAQ,EAAE,UAAU,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,EAAE,kBAA8B,IAAI,KAAK;AAE5H,gBAAA,IAAI,cAAc,CAAC,IAAI,IAAI,MAAM,CAAC,YAAY,IAAI,QAAQ,KAAK,WAAW,IAAI,SAAS,IAAI,WAAW,CAAC,EAAE;AACxG,oBAAA,MAAM,cAAc,GAAW,MAAM,CAAC;;yBAEpC,KAAK,CAAC,EAAE;AACR,yBAAA,GAAG,CAAC,CAAC,IAAY,EAAE,KAAa,KAAY;AAC5C,wBAAA,IAAI,KAAK,GAAG,CAAC,IAAI,IAAI,KAAK,IAAI,CAAC,WAAW,EAAE,IAAI,IAAI,KAAK,IAAI,CAAC,WAAW,EAAE,EAAE;4BAC5E,OAAO,GAAG,GAAG,IAAI;;AAGlB,wBAAA,OAAO,IAAI;AACZ,qBAAC;yBACA,IAAI,CAAC,EAAE;AACP,yBAAA,WAAW,EAAE;AAEf,oBAAA,WAAW,CAAC,cAAwD,CAAC,GAAG,MAAM,CAAC,YAAY;;;;;AAM/F,IAAA,OAAO,WAAW;AACnB;;;;"}

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

@@ -1,2 +1,2 @@
-export * from "./controller";
-export * from "./filter-order-by-from-entity.utility";
+export * from './controller/index';
+export { FilterOrderByFromEntity } from './filter-order-by-from-entity.utility';

package/dist/esm/utility/camel-case-string.utility.d.ts

@@ -1 +1,6 @@
+/**
+ * Converts a string to camel case format with special handling for known compound words
+ * @param {string} string - The string to convert to camel case
+ * @returns {string} The camel-cased string
+ */
 export declare function CamelCaseString(string: string): string;

package/dist/esm/{src/utility → utility}/camel-case-string.utility.js

@@ -1,3 +1,8 @@
+/**
+ * Converts a string to camel case format with special handling for known compound words
+ * @param {string} string - The string to convert to camel case
+ * @returns {string} The camel-cased string
+ */
 function CamelCaseString(string) {
     const knownCompounds = {
         getlist: "GetList",

package/dist/esm/utility/camel-case-string.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camel-case-string.utility.js","sources":["../../../../src/utility/camel-case-string.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;AAIG;AACG,SAAU,eAAe,CAAC,MAAc,EAAA;AAC7C,IAAA,MAAM,cAAc,GAA2B;AAC9C,QAAA,OAAO,EAAE,SAAS;AAClB,QAAA,aAAa,EAAE,eAAe;KAC9B;IAED,MAAM,WAAW,GAAW,MAAM,CAAC,UAAU,CAAC,cAAc,EAAE,GAAG,CAAC;IAClE,MAAM,KAAK,GAAkB,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC;IAEnD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE;QACnC,MAAM,IAAI,GAAW,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;AAE3C,QAAA,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE;AACzB,YAAA,OAAO,cAAc,CAAC,IAAI,CAAC;;AAG5B,QAAA,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;;AAGpD,IAAA,OAAO;AACL,SAAA,GAAG,CAAC,CAAC,IAAY,KAAI;AACrB,QAAA,IAAI,CAAC,IAAI;AAAE,YAAA,OAAO,EAAE;AAEpB,QAAA,MAAM,SAAS,GAAW,IAAI,CAAC,WAAW,EAAE;AAE5C,QAAA,IAAI,cAAc,CAAC,SAAS,CAAC,EAAE;AAC9B,YAAA,OAAO,cAAc,CAAC,SAAS,CAAC;;AAGjC,QAAA,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AACzD,KAAC;SACA,IAAI,CAAC,EAAE,CAAC;AACX;;;;"}

package/dist/esm/utility/capitalize-string.utility.d.ts

@@ -1 +1,6 @@
+/**
+ * Capitalizes the first letter of a string and makes the rest lowercase
+ * @param {string} string - The string to capitalize
+ * @returns {string} The capitalized string
+ */
 export declare function CapitalizeString(string: string): string;

package/dist/esm/{src/utility → utility}/capitalize-string.utility.js

@@ -1,3 +1,8 @@
+/**
+ * Capitalizes the first letter of a string and makes the rest lowercase
+ * @param {string} string - The string to capitalize
+ * @returns {string} The capitalized string
+ */
 function CapitalizeString(string) {
     return string.charAt(0).toUpperCase() + string.toLowerCase().slice(1);
 }

package/dist/esm/utility/capitalize-string.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capitalize-string.utility.js","sources":["../../../../src/utility/capitalize-string.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;AAIG;AACG,SAAU,gBAAgB,CAAC,MAAc,EAAA;AAC9C,IAAA,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;AACtE;;;;"}

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

@@ -1,2 +1,8 @@
-import type { IApiBaseEntity } from "../../interface";
+import type { IApiBaseEntity } from '../../interface/api-base-entity.interface';
+/**
+ * Analyzes entity metadata using the MetadataStorage singleton class.
+ * Currently only retrieves metadata but doesn't perform further operations.
+ * @param {IApiBaseEntity} entity - The entity to analyze metadata for
+ * @returns {void}
+ */
 export declare function analyzeEntityMetadata(entity: IApiBaseEntity): void;

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

@@ -0,0 +1,15 @@
+import { MetadataStorage } from '../../class/metadata-storage.class.js';
+
+/**
+ * Analyzes entity metadata using the MetadataStorage singleton class.
+ * Currently only retrieves metadata but doesn't perform further operations.
+ * @param {IApiBaseEntity} entity - The entity to analyze metadata for
+ * @returns {void}
+ */
+function analyzeEntityMetadata(entity) {
+    const storage = MetadataStorage.getInstance();
+    storage.getMetadata(entity.name ?? "UnknownResource");
+}
+
+export { analyzeEntityMetadata };
+//# sourceMappingURL=analize.utility.js.map