@elsikora/nestjs-crud-automator 2.0.1 → 2.0.2-dev.1

package/dist/cjs/src/utility/api/controller/apply/index.d.ts

@@ -1,2 +0,0 @@
-export { ApiControllerApplyDecorators } from './decorators.utility';
-export { ApiControllerApplyMetadata } from './metadata.utility';

package/dist/cjs/src/utility/api/controller/apply/metadata.utility.d.ts

@@ -1,19 +0,0 @@
-import type { EApiRouteType } from '../../../../enum/decorator/api/index';
-import type { IApiBaseEntity } from '../../../../interface/api-base-entity.interface';
-import type { IApiControllerProperties } from '../../../../interface/decorator/api/index';
-import type { IApiEntity } from '../../../../interface/entity/index';
-import type { TApiControllerPropertiesRoute } from '../../../../type/decorator/api/controller/index';
-/**
- * Applies metadata for NestJS controller methods to enable proper dependency injection.
- * Sets up parameter metadata for route arguments including DTOs, headers, IP, and authentication requests.
- * @param {object} target - The target controller class
- * @param {object} targetPrototype - The prototype of the target controller class
- * @param {IApiEntity<E>} entity - The entity metadata for the controller
- * @param {IApiControllerProperties<E>} properties - Controller configuration properties
- * @param {EApiRouteType} method - The type of route (CREATE, DELETE, GET, etc.)
- * @param {string} methodName - The name of the method being configured
- * @param {TApiControllerPropertiesRoute<E, typeof method>} routeConfig - Route-specific configuration
- * @returns {void}
- * @template E - The entity type
- */
-export declare function ApiControllerApplyMetadata<E extends IApiBaseEntity>(target: object, targetPrototype: object, entity: IApiEntity<E>, properties: IApiControllerProperties<E>, method: EApiRouteType, methodName: string, routeConfig: TApiControllerPropertiesRoute<E, typeof method>): void;

package/dist/cjs/src/utility/api/controller/get/dto.utility.d.ts

@@ -1,19 +0,0 @@
-import type { EApiDtoType, EApiRouteType } from '../../../../enum/decorator/api/index';
-import type { IApiBaseEntity } from '../../../../interface/api-base-entity.interface';
-import type { IApiControllerProperties } from '../../../../interface/decorator/api/index';
-import type { IApiEntity } from '../../../../interface/entity/index';
-import type { Type } from "@nestjs/common";
-import type { TApiControllerPropertiesRoute } from '../../../../type/decorator/api/controller/index';
-/**
- * Resolves a DTO class for a generated controller route.
- * Prefers an explicitly configured DTO and falls back to auto-generation.
- * @param {IApiControllerProperties<E>} properties - Controller configuration
- * @param {IApiEntity<E>} entity - Entity metadata
- * @param {R} method - Route type
- * @param {EApiDtoType} dtoType - DTO kind to resolve
- * @param {TApiControllerPropertiesRoute<E, R>} routeConfig - Route-specific configuration
- * @returns {Type<unknown> | undefined} -The resolved DTO class or undefined if no DTO is configured
- * @template E - Entity type
- * @template R - Route type
- */
-export declare function ApiControllerGetDto<E extends IApiBaseEntity, R extends EApiRouteType>(properties: IApiControllerProperties<E>, entity: IApiEntity<E>, method: R, dtoType: EApiDtoType, routeConfig: TApiControllerPropertiesRoute<E, R>): Type<unknown> | undefined;

package/dist/cjs/src/utility/api/controller/get/index.d.ts

@@ -1,3 +0,0 @@
-export { ApiControllerGetDto } from './dto.utility';
-export { ApiControllerGetMethodName } from './method-name.utility';
-export { ApiControllerGetPrimaryColumn } from './primary-column.utility';

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

@@ -1,8 +0,0 @@
-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/cjs/src/utility/api/controller/get/primary-column.utility.d.ts

@@ -1,12 +0,0 @@
-import type { IApiEntity } from '../../../../interface/entity/index';
-import type { IApiControllerPrimaryColumn } from '../../../../interface/utility/index';
-import type { DeepPartial } from "typeorm";
-/**
- * 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/cjs/src/utility/api/controller/get-list/index.d.ts

@@ -1 +0,0 @@
-export * from './transform/index';

package/dist/cjs/src/utility/api/controller/get-list/transform/filter.utility.d.ts

@@ -1,12 +0,0 @@
-import type { IApiEntity } from '../../../../../interface/entity/index';
-import type { FindOptionsWhere } from "typeorm/index";
-/**
- * Transforms query parameters into TypeORM FindOptionsWhere filter objects.
- * Parses query parameters with filter operations and converts them to appropriate database filters.
- * Handles special cases for relation properties.
- * @param {Record<string, any>} query - The query parameters from the HTTP request
- * @param {IApiEntity<E>} entityMetadata - The entity metadata containing column information
- * @returns {FindOptionsWhere<E>} The TypeORM filter object for the query
- * @template E - The entity type
- */
-export declare function ApiControllerGetListTransformFilter<E>(query: Record<string, unknown>, entityMetadata: IApiEntity<E>): FindOptionsWhere<E>;

package/dist/cjs/src/utility/api/controller/get-list/transform/index.d.ts

@@ -1,2 +0,0 @@
-export { ApiControllerGetListTransformFilter } from './filter.utility';
-export { ApiControllerGetListTransformOperation } from './operation.utility';

package/dist/cjs/src/utility/api/controller/get-list/transform/operation.utility.d.ts

@@ -1,10 +0,0 @@
-import type { FindOperator } from "typeorm/find-options/FindOperator";
-import { EFilterOperation } from '../../../../../enum/filter/index';
-/**
- * Converts filter operation enum values to TypeORM query operators.
- * Supports various operations like BETWEEN, CONTAINS, EQUALS, GREATER_THAN, etc.
- * @param {EFilterOperation} operation - The filter operation type from the enum
- * @param {any} value - The value to filter by
- * @returns {FindOperator<any>} The TypeORM FindOperator for the specified operation and value
- */
-export declare function ApiControllerGetListTransformOperation(operation: EFilterOperation, value: unknown): FindOperator<unknown>;

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

@@ -1,20 +0,0 @@
-import type { IApiBaseEntity } from '../../../interface/api-base-entity.interface';
-import type { IApiControllerProperties, IApiControllerPropertiesRouteBaseRelationsRequest } from '../../../interface/decorator/api/index';
-import type { TApiControllerMethod } from '../../../type/class/index';
-import type { TApiControllerGetListQuery } from '../../../type/decorator/api/controller/index';
-import type { DeepPartial } from "typeorm";
-/**
- * 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 {IApiControllerPropertiesRouteBaseRelationsRequest<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 extends IApiBaseEntity>(controllerMethod: TApiControllerMethod<E>, properties: IApiControllerProperties<E>, relationConfig: IApiControllerPropertiesRouteBaseRelationsRequest<E> | undefined, parameters: DeepPartial<E> | Partial<E> | TApiControllerGetListQuery<E>): Promise<void>;

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

@@ -1,8 +0,0 @@
-export * from './apply/index';
-export * from './get/index';
-export * from './get-list/index';
-export { ApiControllerHandleRequestRelations } from './handle-request-relations.utility';
-export { ApiControllerSerializeRouteResponse } from './serialize-route-response.utility';
-export { ApiControllerTransformData } from './transform-data.utility';
-export { ApiControllerValidateRequest } from './validate-request.utility';
-export * from './write/index';

package/dist/cjs/src/utility/api/controller/serialize-route-response.utility.d.ts

@@ -1,14 +0,0 @@
-import type { EApiRouteType } from '../../../enum/decorator/api/index';
-import type { IApiBaseEntity } from '../../../interface/api-base-entity.interface';
-import type { Type } from "@nestjs/common";
-import type { TApiControllerPropertiesRoute } from '../../../type/decorator/api/controller/index';
-/**
- * Serializes a generated route response with the route DTO and serialization settings.
- * @template E - Entity type owned by the route.
- * @template R - Response value type.
- * @param {TApiControllerPropertiesRoute<E, EApiRouteType>} routeConfig - Route configuration containing response serialization settings.
- * @param {Type<unknown> | undefined} dto - DTO type used for response serialization.
- * @param {R} response - Response value to serialize.
- * @returns {R} Serialized response value.
- */
-export declare function ApiControllerSerializeRouteResponse<E extends IApiBaseEntity, R>(routeConfig: TApiControllerPropertiesRoute<E, EApiRouteType>, dto: Type<unknown> | undefined, response: R): R;

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

@@ -1,18 +0,0 @@
-import type { IApiBaseEntity } from '../../../interface/api-base-entity.interface';
-import type { IApiControllerProperties } from '../../../interface/decorator/api/index';
-import type { TApiRequestTransformer } from '../../../type/api-request-transformer.type';
-import type { TApiControllerTransformDataData, TApiControllerTransformDataObjectToTransform } from '../../../type/utility/index';
-import { EApiControllerRequestTarget, EApiControllerResponseTarget } from '../../../enum/decorator/api/index';
-/**
- * Transforms data between request/response objects and entity objects.
- * Handles both static and dynamic transformations for body, query, parameters, and response data.
- * @template E - The entity type.
- * @param {object | undefined} targets - Target-specific transformer configuration.
- * @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}
- */
-export declare function ApiControllerTransformData<E extends IApiBaseEntity>(targets: Partial<Record<EApiControllerRequestTarget | EApiControllerResponseTarget, {
-    transformers?: Array<TApiRequestTransformer<E>>;
-}>> | undefined, properties: IApiControllerProperties<E>, objectToTransform: TApiControllerTransformDataObjectToTransform<E>, data: TApiControllerTransformDataData): void;

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

@@ -1,14 +0,0 @@
-import type { IApiBaseEntity } from '../../../interface/api-base-entity.interface';
-import type { IApiControllerProperties } from '../../../interface/decorator/api/index';
-import type { IApiControllerPropertiesRouteBaseRequestTarget } from '../../../interface/decorator/api/controller/properties/route/base/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 {IApiControllerPropertiesRouteBaseRequestTarget<E> | undefined} target - Target request pipeline configuration
- * @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 extends IApiBaseEntity>(target: IApiControllerPropertiesRouteBaseRequestTarget<E> | undefined, properties: IApiControllerProperties<E>, parameters: Partial<E> | TApiControllerGetListQuery<E>): Promise<void>;

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

@@ -1,19 +0,0 @@
-import type { EApiRouteType } from '../../../../enum/decorator/api/index';
-import type { IApiBaseEntity } from '../../../../interface/api-base-entity.interface';
-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 extends IApiBaseEntity>(target: object, entity: IApiEntity<E>, properties: IApiControllerProperties<E>, method: EApiRouteType, routeConfig: TApiControllerPropertiesRoute<E, typeof method>, entityMetadata: IApiEntity<E>): void;

package/dist/cjs/src/utility/api/controller/write/index.d.ts

@@ -1,2 +0,0 @@
-export { ApiControllerWriteDtoSwagger } from './dto-swagger.utility';
-export { ApiControllerWriteMethod } from './method.utility';

package/dist/cjs/src/utility/api/controller/write/method.utility.d.ts

@@ -1,18 +0,0 @@
-import type { EApiRouteType } from '../../../../enum/decorator/api/index';
-import type { IApiBaseEntity } from '../../../../interface/api-base-entity.interface';
-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 extends IApiBaseEntity>(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/cjs/src/utility/api/filter-order-by-from-entity.utility.d.ts

@@ -1,19 +0,0 @@
-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 "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/cjs/src/utility/api/function-transaction.utility.d.ts

@@ -1,20 +0,0 @@
-import type { IApiBaseEntity } from '../../interface/api-base-entity.interface';
-import type { EntityManager, Repository } from "typeorm";
-import { EApiFunctionTransactionMode } from '../../enum/decorator/api/index';
-/**
- * Executes an ApiFunction callback according to its transaction mode.
- * @template E - Entity type owned by the function repository.
- * @template R - Callback result type.
- * @param {object} options - Transaction execution options.
- * @param {(eventManager: EntityManager | undefined) => Promise<R>} options.callback - Function body to run with the resolved transaction manager.
- * @param {new (...arguments_: Array<unknown>) => E} options.entity - Entity constructor associated with the function.
- * @param {EApiFunctionTransactionMode} options.mode - Transaction mode to enforce.
- * @param {Repository<E>} options.repository - Repository used to open new transactions when required.
- * @returns {Promise<R>} Callback result.
- */
-export declare function ApiFunctionExecuteWithTransaction<E extends IApiBaseEntity, R>(options: {
-    callback: (eventManager: EntityManager | undefined) => Promise<R>;
-    entity: new (...arguments_: Array<unknown>) => E;
-    mode: EApiFunctionTransactionMode;
-    repository: Repository<E>;
-}): Promise<R>;

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

@@ -1,21 +0,0 @@
-import type { TApiPropertyDefaultStringFormat, TApiPropertyDefaultStringFormatProperties } from '../../type/decorator/api/property/index';
-/**
- * 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)
- * @returns {TApiPropertyDefaultStringFormatProperties} Default properties for the specified format
- * @example
- * ```typescript
- * const emailDefaults = GetDefaultStringFormatProperties(TApiPropertyDefaultStringFormat.EMAIL);
- * // Returns:
- * // {
- * //   description: "email",
- * //   exampleValue: "user@example.com",
- * //   maxLength: 321,
- * //   minLength: 5,
- * //   pattern: "/^([a-zA-Z0-9_\\-.+])+@([a-zA-Z0-9-]+\\.)+[a-zA-Z]{2,}$/"
- * // }
- * ```
- */
-export declare function GetDefaultStringFormatProperties(format: TApiPropertyDefaultStringFormat): TApiPropertyDefaultStringFormatProperties;

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

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

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

@@ -1 +0,0 @@
-export * from './response/index';

package/dist/cjs/src/utility/api/route/response/index.d.ts

@@ -1,2 +0,0 @@
-export { ApiRouteProjectRelationResponse } from './project-relation.utility';
-export { ApiRouteSerializeResponse } from './serialize.utility';

package/dist/cjs/src/utility/api/route/response/project-relation.utility.d.ts

@@ -1,11 +0,0 @@
-import type { IApiBaseEntity } from '../../../../interface/api-base-entity.interface';
-import type { IApiControllerPropertiesRouteBaseRelationsResponse } from '../../../../interface/decorator/api/index';
-/**
- * Projects loaded relation objects into the configured response reference shape.
- * @template E - Entity type that owns the relation configuration.
- * @template R - Response value type.
- * @param {IApiControllerPropertiesRouteBaseRelationsResponse<E> | undefined} relationConfig - Response relation projection configuration.
- * @param {R} response - Response value to project.
- * @returns {R} Response value with projected relation references.
- */
-export declare function ApiRouteProjectRelationResponse<E extends IApiBaseEntity, R>(relationConfig: IApiControllerPropertiesRouteBaseRelationsResponse<E> | undefined, response: R): R;

package/dist/cjs/src/utility/api/route/response/serialize.utility.d.ts

@@ -1,11 +0,0 @@
-import type { IApiBaseEntity } from '../../../../interface/api-base-entity.interface';
-import type { IApiRouteMetadata } from '../../../../interface/decorator/api/index';
-/**
- * Serializes a route response using the route metadata response DTO configuration.
- * @template E - Entity type represented by the route metadata.
- * @template R - Response value type.
- * @param {Pick<IApiRouteMetadata<E>, "response">} metadata - Route metadata containing response serialization settings.
- * @param {R} response - Response value to serialize.
- * @returns {R} Serialized response value.
- */
-export declare function ApiRouteSerializeResponse<E extends IApiBaseEntity, R>(metadata: Pick<IApiRouteMetadata<E>, "response">, response: R): R;

package/dist/cjs/src/utility/apply-auto-dto-response-exposure.utility.d.ts

@@ -1,14 +0,0 @@
-import type { TApiPropertyBaseProperties } from '../type/decorator/api/property/base/properties.type';
-/**
- * Applies class-transformer exposure to neutral manual DTO properties without marking them
- * as Swagger response-only fields.
- *
- * Explicit response-only properties (`isResponse: true`) still rely on the decorator-specific
- * response branch that uses `ApiResponseProperty()`.
- * @param {object} target - Decorated DTO prototype.
- * @param {string | symbol} propertyKey - Decorated property key.
- * @param {TApiPropertyBaseProperties} properties - Crud-automator property options.
- */
-export declare function ApplyAutoDtoResponseExposure(target: object, propertyKey: string | symbol, properties: {
-    isExpose?: boolean;
-} & Pick<TApiPropertyBaseProperties, "isResponse">): void;

package/dist/cjs/src/utility/authorization/decision/apply-result.utility.d.ts

@@ -1,12 +0,0 @@
-import type { IApiBaseEntity } from '../../../interface/api-base-entity.interface';
-import type { IApiAuthorizationDecision } from '../../../interface/class/api/authorization/decision/index';
-import type { TApiAuthorizationRuleTransformPayload } from '../../../type/class/api/authorization/rule/transform-payload.type';
-/**
- * Applies decision result transforms sequentially to a response payload.
- * @template E - Entity type
- * @template R - Result payload type
- * @param {IApiAuthorizationDecision<E, R> | undefined} decision - Evaluated decision.
- * @param {R} result - Result to transform.
- * @returns {Promise<R>} Transformed payload.
- */
-export declare function AuthorizationDecisionApplyResult<E extends IApiBaseEntity, R extends TApiAuthorizationRuleTransformPayload<E>>(decision: IApiAuthorizationDecision<E, R> | undefined, result: R): Promise<R>;

package/dist/cjs/src/utility/authorization/decision/attach-resource.utility.d.ts

@@ -1,11 +0,0 @@
-import type { IApiBaseEntity } from '../../../interface/api-base-entity.interface';
-import type { IApiAuthorizationDecision } from '../../../interface/class/api/authorization/decision/index';
-/**
- * Mutates authorization decision to include the resolved entity resource.
- * @template E - Entity type
- * @template R - Result payload type
- * @param {IApiAuthorizationDecision<E, R> | undefined} decision - Decision to enrich.
- * @param {E | undefined} resource - Entity instance to attach.
- * @returns {IApiAuthorizationDecision<E, R> | undefined} Updated decision reference.
- */
-export declare function AuthorizationDecisionAttachResource<E extends IApiBaseEntity, R>(decision: IApiAuthorizationDecision<E, R> | undefined, resource: E | undefined): IApiAuthorizationDecision<E, R> | undefined;

package/dist/cjs/src/utility/authorization/decision/index.d.ts

@@ -1,3 +0,0 @@
-export { AuthorizationDecisionApplyResult } from './apply-result.utility';
-export { AuthorizationDecisionAttachResource } from './attach-resource.utility';
-export { AuthorizationDecisionResolveFromRequest } from './resolve-from-request.utility';

package/dist/cjs/src/utility/authorization/decision/resolve-from-request.utility.d.ts

@@ -1,12 +0,0 @@
-import type { IApiBaseEntity } from '../../../interface/api-base-entity.interface';
-import type { IApiAuthenticationRequest } from '../../../interface/api/authentication-request.interface';
-import type { IApiAuthorizationDecision } from '../../../interface/class/api/authorization/decision/index';
-import type { TApiAuthorizationRuleTransformPayload } from '../../../type/class/api/authorization/rule/transform-payload.type';
-/**
- * Extracts an authorization decision from the authentication request metadata stored on the HTTP request.
- * @template E - Entity type
- * @template R - Result payload type
- * @param {IApiAuthenticationRequest} [authenticationRequest] - Request object bound to the route handler.
- * @returns {IApiAuthorizationDecision<E, R> | undefined} Authorization decision if present.
- */
-export declare function AuthorizationDecisionResolveFromRequest<E extends IApiBaseEntity, R extends TApiAuthorizationRuleTransformPayload<E> = TApiAuthorizationRuleTransformPayload<E>>(authenticationRequest?: IApiAuthenticationRequest): IApiAuthorizationDecision<E, R> | undefined;

package/dist/cjs/src/utility/authorization/index.d.ts

@@ -1,4 +0,0 @@
-export * from './decision/index';
-export * from './permission/index';
-export { AuthorizationResolveDefaultPrincipal } from './resolve-default-principal.utility';
-export { AuthorizationScopeMergeWhere } from './scope-merge-where.utility';

package/dist/cjs/src/utility/authorization/permission/index.d.ts

@@ -1,2 +0,0 @@
-export { AuthorizationPermissionMatches } from './matches.utility';
-export { AuthorizationPermissionSetMatches } from './set-matches.utility';

package/dist/cjs/src/utility/authorization/permission/set-matches.utility.d.ts

@@ -1,13 +0,0 @@
-import { EApiAuthorizationPermissionMatch } from '../../../enum/class/authorization/index';
-/**
- * Checks whether granted permissions satisfy the required permissions.
- * An empty granted or required list never matches.
- * @param {Array<string>} grantedPermissions - Permissions granted to the principal.
- * @param {Array<string>} requiredPermissions - Concrete permissions required by the rule.
- * @param {{ match?: EApiAuthorizationPermissionMatch }} [options] - Required permission matching strategy.
- * @param {EApiAuthorizationPermissionMatch} [options.match] - `ANY` requires one matching permission, `ALL` requires every permission.
- * @returns {boolean} True when the granted permissions satisfy the requested match strategy.
- */
-export declare function AuthorizationPermissionSetMatches(grantedPermissions: ReadonlyArray<string>, requiredPermissions: ReadonlyArray<string>, options?: {
-    match?: EApiAuthorizationPermissionMatch;
-}): boolean;

package/dist/cjs/src/utility/authorization/resolve-default-principal.utility.d.ts

@@ -1,7 +0,0 @@
-import type { IApiAuthorizationPrincipal } from '../../interface/class/api/authorization/index';
-/**
- * Resolves a principal from request.user with smart fallbacks.
- * @param {unknown} user - Request user payload.
- * @returns {IApiAuthorizationPrincipal} Normalized authorization principal.
- */
-export declare function AuthorizationResolveDefaultPrincipal(user: unknown): IApiAuthorizationPrincipal;

package/dist/cjs/src/utility/authorization/scope-merge-where.utility.d.ts

@@ -1,10 +0,0 @@
-import type { IApiBaseEntity } from '../../interface/api-base-entity.interface';
-import type { TApiAuthorizationScopeWhere } from '../../type/class/api/authorization/scope-where.type';
-/**
- * Merges two WHERE expressions by building a Cartesian product of OR branches.
- * @template E - Entity type
- * @param {TApiAuthorizationScopeWhere<E>} baseWhere - Existing filter.
- * @param {TApiAuthorizationScopeWhere<E>} scopedWhere - Additional scope filter.
- * @returns {TApiAuthorizationScopeWhere<E>} Combined filter.
- */
-export declare function AuthorizationScopeMergeWhere<E extends IApiBaseEntity>(baseWhere: TApiAuthorizationScopeWhere<E>, scopedWhere: TApiAuthorizationScopeWhere<E>): TApiAuthorizationScopeWhere<E>;

package/dist/cjs/src/utility/database/index.d.ts

@@ -1 +0,0 @@
-export * from './typeorm/index';

package/dist/cjs/src/utility/database/typeorm/get/index.d.ts

@@ -1,2 +0,0 @@
-export { DatabaseTypeOrmGetForeignKeyViolationDetails } from './foreign-key-violation-details.utility';
-export { DatabaseTypeOrmGetUniqueViolationDetails } from './unique-violation-details.utility';

package/dist/cjs/src/utility/database/typeorm/index.d.ts

@@ -1,6 +0,0 @@
-export { DatabaseTypeOrmGetForeignKeyViolationDetails } from './get/foreign-key-violation-details.utility';
-export { DatabaseTypeOrmGetUniqueViolationDetails } from './get/unique-violation-details.utility';
-export { DatabaseTypeOrmIsEntityMetadataNotFound } from './is/entity/metadata-not-found.utility';
-export { DatabaseTypeOrmIsEntityNotFound } from './is/entity/not-found.utility';
-export { DatabaseTypeOrmIsForeignKeyViolation } from './is/foreign-key-violation.utility';
-export { DatabaseTypeOrmIsUniqueViolation } from './is/unique-violation.utility';

package/dist/cjs/src/utility/database/typeorm/is/entity/index.d.ts

@@ -1,2 +0,0 @@
-export { DatabaseTypeOrmIsEntityMetadataNotFound } from './metadata-not-found.utility';
-export { DatabaseTypeOrmIsEntityNotFound } from './not-found.utility';

package/dist/cjs/src/utility/database/typeorm/is/index.d.ts

@@ -1,3 +0,0 @@
-export * from './entity/index';
-export { DatabaseTypeOrmIsForeignKeyViolation } from './foreign-key-violation.utility';
-export { DatabaseTypeOrmIsUniqueViolation } from './unique-violation.utility';

package/dist/cjs/src/utility/dto/auto/context/index.d.ts

@@ -1,2 +0,0 @@
-export { DtoAutoContextPop } from './pop.utility';
-export { DtoAutoContextPush } from './push.utility';

package/dist/cjs/src/utility/dto/auto/context/push.utility.d.ts

@@ -1,9 +0,0 @@
-import type { EApiDtoType, EApiRouteType } from '../../../../enum/index';
-/**
- * Pushes DTO auto-context onto the provided DTO prototype so property decorators can read it later.
- * @param {object} target - DTO prototype to annotate.
- * @param {EApiRouteType} method - Route method currently being generated.
- * @param {EApiDtoType} dtoType - DTO type currently being generated.
- * @param {WeakSet<object>} [visited] - Set of visited prototypes to avoid infinite recursion.
- */
-export declare function DtoAutoContextPush(target: object, method: EApiRouteType, dtoType: EApiDtoType, visited?: WeakSet<object>): void;

package/dist/cjs/src/utility/dto/auto/index.d.ts

@@ -1 +0,0 @@
-export * from './context/index';

package/dist/cjs/src/utility/dto/build-decorator.utility.d.ts

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

package/dist/cjs/src/utility/dto/generate/cache-key.utility.d.ts

@@ -1,7 +0,0 @@
-import type { IDtoGenerateCacheKey } from '../../../interface/utility/index';
-/**
- * Generates a unique cache key for DTO instances based on entity name, route method, DTO type, guard, and config.
- * @param {IDtoGenerateCacheKey} key - The key object containing entity name, method, DTO type, guard name, and DTO config
- * @returns {string} A unique string key for caching DTO instances
- */
-export declare function DtoGenerateCacheKey(key: IDtoGenerateCacheKey): string;

package/dist/cjs/src/utility/dto/generate/core.utility.d.ts

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

package/dist/cjs/src/utility/dto/generate/decorator.utility.d.ts

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

package/dist/cjs/src/utility/dto/generate/dynamic.utility.d.ts

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