@elsikora/nestjs-crud-automator 1.24.0-dev.1 → 2.0.0-dev.1

package/dist/esm/index.js

@@ -1,3 +1,5 @@
+export { ApiFunctionTransactionScope } from './class/api/function/transaction-scope.class.js';
+export { ApiRouteRuntime } from './class/api/route-runtime.class.js';
 export { ApiServiceBase } from './class/api/service-base.class.js';
 export { ApiSubscriberBase } from './class/api/subscriber/base.class.js';
 export { ApiSubscriberDiscoveryService } from './class/api/subscriber/discovery-service.class.js';
@@ -5,7 +7,9 @@ export { ApiSubscriberExecutor } from './class/api/subscriber/executor.class.js'
 export { ApiFunctionSubscriberBase } from './class/api/subscriber/function-base.class.js';
 export { apiSubscriberRegistry } from './class/api/subscriber/registry.class.js';
 export { ApiRouteSubscriberBase } from './class/api/subscriber/route-base.class.js';
+export { SubscriberWrapper } from './class/api/subscriber/wrapper.class.js';
 export { ApiAuthorizationBootstrapValidationService } from './class/api/authorization/bootstrap-validation.service.class.js';
+export { ApiAuthorizationCacheInvalidationService } from './class/api/authorization/cache-invalidation.service.class.js';
 export { ApiAuthorizationEngine } from './class/api/authorization/engine.class.js';
 export { ApiAuthorizationGuard } from './class/api/authorization/guard.class.js';
 export { ApiAuthorizationHookPermissionResolver } from './class/api/authorization/hook-permission-resolver.class.js';
@@ -18,6 +22,7 @@ export { ApiAuthorizationPolicyBase } from './class/api/authorization/policy/bas
 export { ApiAuthorizationPolicyDiscoveryService } from './class/api/authorization/policy/discovery-service.class.js';
 export { ApiAuthorizationPolicyExecutor } from './class/api/authorization/policy/executor.class.js';
 export { ApiAuthorizationPolicyRegistry, apiAuthorizationPolicyRegistry } from './class/api/authorization/policy/registry.class.js';
+export { PolicySubscriberWrapper } from './class/api/authorization/policy/subscriber-wrapper.class.js';
 export { ApiAuthorizationRuntime } from './class/api/authorization/runtime.class.js';
 export { ApiAuthorizationSimulator } from './class/api/authorization/simulator.class.js';
 export { MetadataStorage } from './class/metadata-storage.class.js';
@@ -68,6 +73,7 @@ export { ApiController } from './decorator/api/controller/decorator.js';
 export { ApiControllerObservable } from './decorator/api/controller/observable.decorator.js';
 export { ApiControllerSecurable } from './decorator/api/controller/securable.decorator.js';
 export { ApiFunctionCreate } from './decorator/api/function/create.decorator.js';
+export { ApiFunctionCustom } from './decorator/api/function/custom.decorator.js';
 export { ApiFunction } from './decorator/api/function/decorator.js';
 export { ApiFunctionDelete } from './decorator/api/function/delete.decorator.js';
 export { ApiFunctionGet } from './decorator/api/function/get/decorator.js';
@@ -84,6 +90,7 @@ export { ApiPropertyNumber } from './decorator/api/property/number.decorator.js'
 export { ApiPropertyObject } from './decorator/api/property/object.decorator.js';
 export { ApiPropertyString } from './decorator/api/property/string.decorator.js';
 export { ApiPropertyUUID } from './decorator/api/property/uuid.decorator.js';
+export { ApiRouteCustom } from './decorator/api/route-custom.decorator.js';
 export { ApiService } from './decorator/api/service/decorator.js';
 export { ApiServiceObservable } from './decorator/api/service/observable.decorator.js';
 export { ApiFunctionSubscriber } from './decorator/api/subscriber/function.decorator.js';
@@ -100,8 +107,12 @@ export { EApiAuthorizationPrincipalType } from './enum/class/authorization/princ
 export { EApiAction } from './enum/decorator/api/action.enum.js';
 export { EApiAuthenticationType } from './enum/decorator/api/authentication-type.enum.js';
 export { EApiControllerLoadRelationsStrategy } from './enum/decorator/api/controller/load-relations-strategy.enum.js';
-export { EApiControllerRequestTransformerType } from './enum/decorator/api/controller/request-transformer-type.enum.js';
+export { EApiControllerRelationReferenceShape } from './enum/decorator/api/controller/relation-reference-shape.enum.js';
+export { EApiControllerRequestTarget } from './enum/decorator/api/controller/request/target.enum.js';
+export { EApiControllerRequestTransformerType } from './enum/decorator/api/controller/request/transformer-type.enum.js';
+export { EApiControllerResponseTarget } from './enum/decorator/api/controller/response-target.enum.js';
 export { EApiDtoType } from './enum/decorator/api/dto-type.enum.js';
+export { EApiFunctionTransactionMode } from './enum/decorator/api/function-transaction-mode.enum.js';
 export { EApiFunctionType } from './enum/decorator/api/function-type.enum.js';
 export { EApiSubscriberOnType } from './enum/decorator/api/on-type.enum.js';
 export { EApiPropertyDataType } from './enum/decorator/api/property/data-type.enum.js';
@@ -132,12 +143,15 @@ export { ApiControllerGetPrimaryColumn } from './utility/api/controller/get/prim
 export { ApiControllerGetListTransformFilter } from './utility/api/controller/get-list/transform/filter.utility.js';
 export { ApiControllerGetListTransformOperation } from './utility/api/controller/get-list/transform/operation.utility.js';
 export { ApiControllerHandleRequestRelations } from './utility/api/controller/handle-request-relations.utility.js';
+export { ApiControllerSerializeRouteResponse } from './utility/api/controller/serialize-route-response.utility.js';
 export { ApiControllerTransformData } from './utility/api/controller/transform-data.utility.js';
 export { ApiControllerValidateRequest } from './utility/api/controller/validate-request.utility.js';
 export { ApiControllerWriteDtoSwagger } from './utility/api/controller/write/dto-swagger.utility.js';
 export { ApiControllerWriteMethod } from './utility/api/controller/write/method.utility.js';
 export { FilterOrderByFromEntity } from './utility/api/filter-order-by-from-entity.utility.js';
 export { GetDefaultStringFormatProperties } from './utility/api/get-default-string-format-properties.utility.js';
+export { ApiRouteProjectRelationResponse } from './utility/api/route/response/project-relation.utility.js';
+export { ApiRouteSerializeResponse } from './utility/api/route/response/serialize.utility.js';
 export { AuthorizationDecisionApplyResult } from './utility/authorization/decision/apply-result.utility.js';
 export { AuthorizationDecisionAttachResource } from './utility/authorization/decision/attach-resource.utility.js';
 export { AuthorizationDecisionResolveFromRequest } from './utility/authorization/decision/resolve-from-request.utility.js';

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/esm/interceptor/api-route-runtime.interceptor.d.ts

@@ -0,0 +1,5 @@
+import type { CallHandler, ExecutionContext, NestInterceptor } from "@nestjs/common";
+import type { Observable } from "rxjs";
+export declare class ApiRouteRuntimeInterceptor implements NestInterceptor {
+    intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
+}

package/dist/esm/interceptor/api-route-runtime.interceptor.js

@@ -0,0 +1,29 @@
+import { __decorate } from '../external/tslib/tslib.es6.js';
+import { ApiRouteRuntime } from '../class/api/route-runtime.class.js';
+import '../constant/decorator/api/function.constant.js';
+import { METHOD_API_DECORATOR_CONSTANT } from '../constant/decorator/api/method.constant.js';
+import { Injectable } from '@nestjs/common';
+import { from } from '../external/rxjs/dist/esm5/internal/observable/from.js';
+import { lastValueFrom } from '../external/rxjs/dist/esm5/internal/lastValueFrom.js';
+
+let ApiRouteRuntimeInterceptor = class ApiRouteRuntimeInterceptor {
+    intercept(context, next) {
+        const metadata = Reflect.getMetadata(METHOD_API_DECORATOR_CONSTANT.ROUTE_METADATA_KEY, context.getHandler());
+        const runtimeProperties = Reflect.getMetadata(METHOD_API_DECORATOR_CONSTANT.ROUTE_RUNTIME_PROPERTIES_METADATA_KEY, context.getHandler());
+        if (!metadata) {
+            return next.handle();
+        }
+        return from(ApiRouteRuntime.executeCustom({
+            executionContext: context,
+            metadata,
+            operation: async () => await lastValueFrom(next.handle()),
+            runtimeProperties: runtimeProperties ?? {},
+        }));
+    }
+};
+ApiRouteRuntimeInterceptor = __decorate([
+    Injectable()
+], ApiRouteRuntimeInterceptor);
+
+export { ApiRouteRuntimeInterceptor };
+//# sourceMappingURL=api-route-runtime.interceptor.js.map

package/dist/esm/interceptor/api-route-runtime.interceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-route-runtime.interceptor.js","sources":["../../../../src/interceptor/api-route-runtime.interceptor.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;AAWO,IAAM,0BAA0B,GAAhC,MAAM,0BAA0B,CAAA;IAC/B,SAAS,CAAC,OAAyB,EAAE,IAAiB,EAAA;AAC5D,QAAA,MAAM,QAAQ,GAAkD,OAAO,CAAC,WAAW,CAAC,6BAA6B,CAAC,kBAAkB,EAAE,OAAO,CAAC,UAAU,EAAE,CAAkD;AAC5M,QAAA,MAAM,iBAAiB,GAA2D,OAAO,CAAC,WAAW,CAAC,6BAA6B,CAAC,qCAAqC,EAAE,OAAO,CAAC,UAAU,EAAE,CAA2D;QAE1P,IAAI,CAAC,QAAQ,EAAE;AACd,YAAA,OAAO,IAAI,CAAC,MAAM,EAAE;QACrB;AAEA,QAAA,OAAO,IAAI,CACV,eAAe,CAAC,aAAa,CAAC;AAC7B,YAAA,gBAAgB,EAAE,OAAO;YACzB,QAAQ;AACR,YAAA,SAAS,EAAE,YAA8B,MAAM,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAC3E,iBAAiB,EAAE,iBAAiB,IAAI,EAAE;AAC1C,SAAA,CAAC,CACF;IACF;;AAjBY,0BAA0B,GAAA,UAAA,CAAA;AADtC,IAAA,UAAU;AACE,CAAA,EAAA,0BAA0B,CAkBtC;;;;"}

package/dist/esm/interface/class/api/authorization/policy/registry.interface.d.ts

@@ -9,5 +9,6 @@ export interface IApiAuthorizationPolicyRegistry {
     clear(): void;
     configureCache(options?: IApiAuthorizationPolicyCacheOptions): void;
     hasSubscriberForEntity(entity: new () => IApiBaseEntity): boolean;
+    invalidateCache(entity?: new () => IApiBaseEntity): void;
     registerSubscriber<E extends IApiBaseEntity>(registration: IApiAuthorizationPolicySubscriberRegistration<E>): void;
 }

package/dist/esm/interface/class/api/authorization/policy/subscriber/context/interface.d.ts

@@ -7,7 +7,7 @@ import type { IApiEntity } from '../../../../../../entity/interface';
 import type { IApiAuthorizationPolicySubscriberContextData } from './data.interface';
 /**
  * Execution context for authorization policy hooks.
- * Includes typed DATA while keeping legacy top-level fields.
+ * Includes typed DATA and explicit route/action identity.
  */
 export interface IApiAuthorizationPolicySubscriberContext<E extends IApiBaseEntity> extends IApiAuthorizationRequestMetadata<E> {
     action: string;

package/dist/esm/interface/class/api/function/context/index.d.ts

@@ -0,0 +1,2 @@
+export { type IApiFunctionContext } from './interface';
+export { type IApiFunctionContextOperations } from './operations.interface';

package/dist/esm/interface/class/api/function/context/interface.d.ts

@@ -0,0 +1,10 @@
+import type { IApiBaseEntity } from '../../../../api-base-entity.interface';
+import type { EntityManager, Repository } from "typeorm";
+import type { IApiFunctionContextOperations } from './operations.interface';
+export interface IApiFunctionContext<E extends IApiBaseEntity> {
+    entity: new () => E;
+    eventManager?: EntityManager;
+    getRepository: <T extends IApiBaseEntity>(entity: new () => T) => Repository<T>;
+    operations: IApiFunctionContextOperations<E>;
+    repository: Repository<E>;
+}

package/dist/esm/interface/class/api/function/context/operations.interface.d.ts

@@ -0,0 +1,13 @@
+import type { IApiBaseEntity } from '../../../../api-base-entity.interface';
+import type { IApiGetListResponseResult } from '../../../../decorator/api/index';
+import type { TApiFunctionCreateProperties, TApiFunctionDeleteCriteria, TApiFunctionGetListProperties, TApiFunctionGetManyProperties, TApiFunctionGetProperties, TApiFunctionUpdateCriteria, TApiFunctionUpdateProperties } from '../../../../../type/decorator/api/function/index';
+import type { Repository } from "typeorm";
+export interface IApiFunctionContextOperations<E extends IApiBaseEntity> {
+    create: (properties: TApiFunctionCreateProperties<E>) => Promise<E>;
+    delete: (criteria: Array<TApiFunctionDeleteCriteria<E>> | TApiFunctionDeleteCriteria<E>) => Promise<void>;
+    get: (properties: TApiFunctionGetProperties<E>) => Promise<E>;
+    getList: (properties: TApiFunctionGetListProperties<E>) => Promise<IApiGetListResponseResult<E>>;
+    getMany: (properties: TApiFunctionGetManyProperties<E>) => Promise<Array<E>>;
+    getRepository: <T extends IApiBaseEntity>(entity: new () => T) => Repository<T>;
+    update: (criteria: Array<TApiFunctionUpdateCriteria<E>> | TApiFunctionUpdateCriteria<E>, properties: TApiFunctionUpdateProperties<E>) => Promise<E>;
+}

package/dist/esm/interface/class/api/function/index.d.ts

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

package/dist/esm/interface/class/api/index.d.ts

@@ -1,2 +1,4 @@
 export type * from './authorization/index';
+export type * from './function/index';
+export type * from './route/index';
 export type * from './subscriber/index';

package/dist/esm/interface/class/api/route/index.d.ts

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

package/dist/esm/interface/class/api/route/runtime/context-data.interface.d.ts

@@ -0,0 +1,10 @@
+import type { IApiBaseEntity } from '../../../../api-base-entity.interface';
+import type { IApiAuthenticationRequest } from '../../../../api/authentication-request.interface';
+import type { IApiRouteMetadata, IApiRouteRuntimeProperties } from '../../../../decorator/api/index';
+export interface IApiRouteRuntimeContextData<E extends IApiBaseEntity> {
+    authenticationRequest?: IApiAuthenticationRequest;
+    headers: Record<string, string>;
+    ip: string;
+    metadata: IApiRouteMetadata<E>;
+    runtimeProperties: IApiRouteRuntimeProperties<E>;
+}

package/dist/esm/interface/class/api/route/runtime/custom-execution-options.interface.d.ts

@@ -0,0 +1,9 @@
+import type { IApiBaseEntity } from '../../../../api-base-entity.interface';
+import type { IApiRouteMetadata, IApiRouteRuntimeProperties } from '../../../../decorator/api/index';
+import type { ExecutionContext } from "@nestjs/common";
+export interface IApiRouteRuntimeCustomExecutionOptions<E extends IApiBaseEntity, R> {
+    executionContext: ExecutionContext;
+    metadata: IApiRouteMetadata<E>;
+    operation: () => Promise<R>;
+    runtimeProperties: IApiRouteRuntimeProperties<E>;
+}

package/dist/esm/interface/class/api/route/runtime/generated/execution-options.interface.d.ts

@@ -0,0 +1,14 @@
+import type { EApiRouteType } from '../../../../../../enum/decorator/api/index';
+import type { IApiBaseEntity } from '../../../../../api-base-entity.interface';
+import type { IApiControllerProperties } from '../../../../../decorator/api/index';
+import type { IApiEntity } from '../../../../../entity/index';
+import type { TApiControllerMethod } from '../../../../../../type/class/index';
+import type { IApiRouteRuntimeGeneratedTargets } from './targets.interface';
+export interface IApiRouteRuntimeGeneratedExecutionOptions<E extends IApiBaseEntity, R extends EApiRouteType> {
+    controller: TApiControllerMethod<E>;
+    entityMetadata: IApiEntity<E>;
+    method: R;
+    methodName: string;
+    properties: IApiControllerProperties<E>;
+    targets: IApiRouteRuntimeGeneratedTargets<E>;
+}

package/dist/esm/interface/class/api/route/runtime/generated/index.d.ts

@@ -0,0 +1,2 @@
+export { type IApiRouteRuntimeGeneratedExecutionOptions } from './execution-options.interface';
+export { type IApiRouteRuntimeGeneratedTargets } from './targets.interface';

package/dist/esm/interface/class/api/route/runtime/generated/targets.interface.d.ts

@@ -0,0 +1,12 @@
+import type { IApiBaseEntity } from '../../../../../api-base-entity.interface';
+import type { IApiAuthenticationRequest } from '../../../../../api/authentication-request.interface';
+import type { TApiControllerGetListQuery } from '../../../../../../type/decorator/api/controller/index';
+import type { DeepPartial } from "typeorm";
+export interface IApiRouteRuntimeGeneratedTargets<E extends IApiBaseEntity> {
+    authenticationRequest?: IApiAuthenticationRequest;
+    body?: DeepPartial<E>;
+    headers: Record<string, string>;
+    ip: string;
+    parameters?: Partial<E>;
+    query?: TApiControllerGetListQuery<E>;
+}

package/dist/esm/interface/class/api/route/runtime/http-request.interface.d.ts

@@ -0,0 +1,8 @@
+import type { IApiBaseEntity } from '../../../../api-base-entity.interface';
+export interface IApiRouteRuntimeHttpRequest<E extends IApiBaseEntity> {
+    body?: Partial<E>;
+    headers?: Record<string, Array<string> | string | undefined>;
+    ip?: string;
+    params?: Partial<E>;
+    query?: Partial<E>;
+}

package/dist/esm/interface/class/api/route/runtime/index.d.ts

@@ -0,0 +1,4 @@
+export { type IApiRouteRuntimeContextData } from './context-data.interface';
+export { type IApiRouteRuntimeCustomExecutionOptions } from './custom-execution-options.interface';
+export type * from './generated/index';
+export { type IApiRouteRuntimeHttpRequest } from './http-request.interface';

package/dist/esm/interface/class/api/subscriber/function/error-execution-context.interface.d.ts

@@ -8,5 +8,6 @@ import type { IApiSubscriberErrorExecutionContext } from '../error-execution-con
  * @template Input - Type of the DATA field (immutable context data). Use IApiSubscriberFunctionExecutionContextData<E> for typed access.
  */
 export interface IApiSubscriberFunctionErrorExecutionContext<E extends IApiBaseEntity, Input = unknown> extends IApiSubscriberErrorExecutionContext<E, Input> {
+    action?: string;
     readonly FUNCTION_TYPE: EApiFunctionType;
 }

package/dist/esm/interface/class/api/subscriber/function/execution/context.interface.d.ts

@@ -25,5 +25,6 @@ import type { IApiSubscriberExecutionContext } from '../../execution-context.int
  * ```
  */
 export interface IApiSubscriberFunctionExecutionContext<E extends IApiBaseEntity, Result = unknown, Input = unknown> extends IApiSubscriberExecutionContext<E, Result, Input> {
+    action?: string;
     readonly FUNCTION_TYPE: EApiFunctionType;
 }

package/dist/esm/interface/class/api/subscriber/function.interface.d.ts

@@ -7,8 +7,10 @@ import type { IApiGetListResponseResult } from '../../../decorator/api/index';
 import type { TApiFunctionCreateProperties, TApiFunctionDeleteCriteria, TApiFunctionGetListProperties, TApiFunctionGetManyProperties, TApiFunctionGetProperties, TApiFunctionUpdateProperties } from '../../../../type/decorator/api/function/index';
 export interface IApiSubscriberFunction<E extends IApiBaseEntity> extends IApiSubscriber {
     onAfterCreate?(context: IApiSubscriberFunctionExecutionContext<E, E, IApiSubscriberFunctionExecutionContextData<E>>): Promise<E | undefined>;
+    onAfterCustom?(context: IApiSubscriberFunctionExecutionContext<E, unknown, IApiSubscriberFunctionExecutionContextData<E>>): Promise<unknown>;
     onAfterDelete?(context: IApiSubscriberFunctionExecutionContext<E, E, IApiSubscriberFunctionExecutionContextData<E>>): Promise<E | undefined>;
     onAfterErrorCreate?(context: IApiSubscriberFunctionErrorExecutionContext<E, IApiSubscriberFunctionExecutionContextData<E>>, error: Error): Promise<void>;
+    onAfterErrorCustom?(context: IApiSubscriberFunctionErrorExecutionContext<E, IApiSubscriberFunctionExecutionContextData<E>>, error: Error): Promise<void>;
     onAfterErrorDelete?(context: IApiSubscriberFunctionErrorExecutionContext<E, IApiSubscriberFunctionExecutionContextData<E>>, error: Error): Promise<void>;
     onAfterErrorGet?(context: IApiSubscriberFunctionErrorExecutionContext<E, IApiSubscriberFunctionExecutionContextData<E>>, error: Error): Promise<void>;
     onAfterErrorGetList?(context: IApiSubscriberFunctionErrorExecutionContext<E, IApiSubscriberFunctionExecutionContextData<E>>, error: Error): Promise<void>;
@@ -19,8 +21,10 @@ export interface IApiSubscriberFunction<E extends IApiBaseEntity> extends IApiSu
     onAfterGetMany?(context: IApiSubscriberFunctionExecutionContext<E, Array<E>, IApiSubscriberFunctionExecutionContextData<E>>): Promise<Array<E> | undefined>;
     onAfterUpdate?(context: IApiSubscriberFunctionExecutionContext<E, E, IApiSubscriberFunctionExecutionContextData<E>>): Promise<E | undefined>;
     onBeforeCreate?(context: IApiSubscriberFunctionExecutionContext<E, TApiFunctionCreateProperties<E>, IApiSubscriberFunctionExecutionContextData<E>>): Promise<TApiFunctionCreateProperties<E> | undefined>;
+    onBeforeCustom?(context: IApiSubscriberFunctionExecutionContext<E, unknown, IApiSubscriberFunctionExecutionContextData<E>>): Promise<unknown>;
     onBeforeDelete?(context: IApiSubscriberFunctionExecutionContext<E, TApiFunctionDeleteCriteria<E>, IApiSubscriberFunctionExecutionContextData<E>>): Promise<TApiFunctionDeleteCriteria<E> | undefined>;
     onBeforeErrorCreate?(context: IApiSubscriberFunctionErrorExecutionContext<E, IApiSubscriberFunctionExecutionContextData<E>>, error: Error): Promise<void>;
+    onBeforeErrorCustom?(context: IApiSubscriberFunctionErrorExecutionContext<E, IApiSubscriberFunctionExecutionContextData<E>>, error: Error): Promise<void>;
     onBeforeErrorDelete?(context: IApiSubscriberFunctionErrorExecutionContext<E, IApiSubscriberFunctionExecutionContextData<E>>, error: Error): Promise<void>;
     onBeforeErrorGet?(context: IApiSubscriberFunctionErrorExecutionContext<E, IApiSubscriberFunctionExecutionContextData<E>>, error: Error): Promise<void>;
     onBeforeErrorGetList?(context: IApiSubscriberFunctionErrorExecutionContext<E, IApiSubscriberFunctionExecutionContextData<E>>, error: Error): Promise<void>;

package/dist/esm/interface/class/api/subscriber/route/error-execution-context.interface.d.ts

@@ -8,5 +8,6 @@ import type { IApiSubscriberErrorExecutionContext } from '../error-execution-con
  * @template Input - Type of the DATA field (immutable context data). Use IApiSubscriberRouteExecutionContextData<E, R> or IApiSubscriberRouteExecutionContextDataExtended<E, R> for typed access.
  */
 export interface IApiSubscriberRouteErrorExecutionContext<E extends IApiBaseEntity, Input = unknown> extends IApiSubscriberErrorExecutionContext<E, Input> {
-    readonly ROUTE_TYPE: EApiRouteType;
+    action?: string;
+    readonly ROUTE_TYPE?: EApiRouteType;
 }

package/dist/esm/interface/class/api/subscriber/route/execution/context/data/extended.interface.d.ts

@@ -0,0 +1,36 @@
+import type { IApiBaseEntity } from '../../../../../../../api-base-entity.interface';
+import type { IApiAuthenticationRequest } from '../../../../../../../api/authentication-request.interface';
+import type { TApiAuthorizationRuleTransformPayload } from '../../../../../../../../type/class/api/authorization/rule/transform-payload.type';
+import type { TApiControllerGetListQuery } from '../../../../../../../../type/decorator/api/controller/index';
+import type { DeepPartial } from "typeorm";
+import type { IApiSubscriberRouteExecutionContextData } from './interface';
+/**
+ * Extended data container for route subscriber execution context.
+ * Includes request context in addition to base route data.
+ */
+export interface IApiSubscriberRouteExecutionContextDataExtended<E extends IApiBaseEntity, R = TApiAuthorizationRuleTransformPayload<E>> extends IApiSubscriberRouteExecutionContextData<E, R> {
+    /**
+     * Authentication request information.
+     */
+    authenticationRequest?: IApiAuthenticationRequest;
+    /**
+     * Request body payload for create and update routes.
+     */
+    body?: DeepPartial<E>;
+    /**
+     * HTTP request headers.
+     */
+    headers: Record<string, string>;
+    /**
+     * Client IP address.
+     */
+    ip: string;
+    /**
+     * Route parameters for get, delete, and update routes.
+     */
+    parameters?: Partial<E>;
+    /**
+     * Query payload for get list routes.
+     */
+    query?: TApiControllerGetListQuery<E>;
+}

package/dist/esm/interface/class/api/subscriber/route/execution/context/data/index.d.ts

@@ -0,0 +1,2 @@
+export { type IApiSubscriberRouteExecutionContextDataExtended } from './extended.interface';
+export { type IApiSubscriberRouteExecutionContextData } from './interface';

package/dist/esm/interface/class/api/subscriber/route/execution/context/data/interface.d.ts

@@ -0,0 +1,32 @@
+import type { EApiRouteType } from '../../../../../../../../enum/decorator/api/route-type.enum';
+import type { IApiBaseEntity } from '../../../../../../../api-base-entity.interface';
+import type { IApiAuthorizationDecision } from '../../../../../authorization/index';
+import type { IApiControllerProperties } from '../../../../../../../decorator/api/controller/properties.interface';
+import type { IApiEntity } from '../../../../../../../entity/index';
+import type { TApiAuthorizationRuleTransformPayload } from '../../../../../../../../type/class/api/authorization/rule/transform-payload.type';
+/**
+ * Base data container for route subscriber execution context.
+ * Contains route metadata, configuration, and the current authorization decision when available.
+ */
+export interface IApiSubscriberRouteExecutionContextData<E extends IApiBaseEntity, R = TApiAuthorizationRuleTransformPayload<E>> {
+    /**
+     * Authorization decision attached to the request.
+     */
+    authorizationDecision?: IApiAuthorizationDecision<E, R>;
+    /**
+     * Entity metadata containing information about entity columns, relations, and configuration.
+     */
+    entityMetadata: IApiEntity<E>;
+    /**
+     * Route method type.
+     */
+    method: EApiRouteType;
+    /**
+     * Controller method name as defined in the controller.
+     */
+    methodName: string;
+    /**
+     * Controller properties and configuration for the current route.
+     */
+    properties: IApiControllerProperties<E>;
+}

package/dist/esm/interface/class/api/subscriber/route/execution/context/index.d.ts

@@ -0,0 +1,2 @@
+export type * from './data/index';
+export { type IApiSubscriberRouteExecutionContext } from './interface';

package/dist/esm/interface/class/api/subscriber/route/execution/context/interface.d.ts

@@ -0,0 +1,11 @@
+import type { EApiRouteType } from '../../../../../../../enum/decorator/api/route-type.enum';
+import type { IApiBaseEntity } from '../../../../../../api-base-entity.interface';
+import type { IApiSubscriberExecutionContext } from '../../../execution-context.interface';
+/**
+ * Execution context for route subscriber callbacks.
+ * Extends base execution context with route type information.
+ */
+export interface IApiSubscriberRouteExecutionContext<E extends IApiBaseEntity, Result = unknown, Input = unknown> extends IApiSubscriberExecutionContext<E, Result, Input> {
+    action?: string;
+    readonly ROUTE_TYPE?: EApiRouteType;
+}

package/dist/esm/interface/class/api/subscriber/route/execution/index.d.ts

@@ -1,2 +1 @@
-export { type IApiSubscriberRouteExecutionContextData, type IApiSubscriberRouteExecutionContextDataExtended } from './context-data.interface';
-export { type IApiSubscriberRouteExecutionContext } from './context.interface';
+export type * from './context/index';

package/dist/esm/interface/class/api/subscriber/route.interface.d.ts

@@ -2,15 +2,17 @@ import type { IApiBaseEntity } from '../../../api-base-entity.interface';
 import type { IApiAuthenticationRequest } from '../../../api/authentication-request.interface';
 import type { IApiSubscriber } from './interface';
 import type { IApiSubscriberRouteErrorExecutionContext } from './route/error-execution-context.interface';
-import type { IApiSubscriberRouteExecutionContextData, IApiSubscriberRouteExecutionContextDataExtended } from './route/execution/context-data.interface';
-import type { IApiSubscriberRouteExecutionContext } from './route/execution/context.interface';
+import type { IApiSubscriberRouteExecutionContextData, IApiSubscriberRouteExecutionContextDataExtended } from './route/execution/context/index';
+import type { IApiSubscriberRouteExecutionContext } from './route/execution/context/index';
 import type { IApiGetListResponseResult } from '../../../decorator/api/index';
 import type { TApiControllerGetListQuery } from '../../../../type/decorator/api/controller/index';
 import type { DeepPartial } from "typeorm";
 export interface IApiSubscriberRoute<E extends IApiBaseEntity> extends IApiSubscriber {
     onAfterCreate?(context: IApiSubscriberRouteExecutionContext<E, E, IApiSubscriberRouteExecutionContextDataExtended<E, E>>): Promise<E | undefined>;
+    onAfterCustom?(context: IApiSubscriberRouteExecutionContext<E, unknown, IApiSubscriberRouteExecutionContextDataExtended<E, unknown>>): Promise<unknown>;
     onAfterDelete?(context: IApiSubscriberRouteExecutionContext<E, Partial<E>, IApiSubscriberRouteExecutionContextDataExtended<E, undefined>>): Promise<Partial<E> | undefined>;
     onAfterErrorCreate?(context: IApiSubscriberRouteErrorExecutionContext<E, IApiSubscriberRouteExecutionContextDataExtended<E, E>>, error: Error): Promise<void>;
+    onAfterErrorCustom?(context: IApiSubscriberRouteErrorExecutionContext<E, IApiSubscriberRouteExecutionContextDataExtended<E, unknown>>, error: Error): Promise<void>;
     onAfterErrorDelete?(context: IApiSubscriberRouteErrorExecutionContext<E, IApiSubscriberRouteExecutionContextDataExtended<E, undefined>>, error: Error): Promise<void>;
     onAfterErrorGet?(context: IApiSubscriberRouteErrorExecutionContext<E, IApiSubscriberRouteExecutionContextDataExtended<E, E>>, error: Error): Promise<void>;
     onAfterErrorGetList?(context: IApiSubscriberRouteErrorExecutionContext<E, IApiSubscriberRouteExecutionContextDataExtended<E, IApiGetListResponseResult<E>>>, error: Error): Promise<void>;
@@ -31,6 +33,7 @@ export interface IApiSubscriberRoute<E extends IApiBaseEntity> extends IApiSubsc
         headers: Record<string, string>;
         ip: string;
     } | undefined>;
+    onBeforeCustom?(context: IApiSubscriberRouteExecutionContext<E, unknown, IApiSubscriberRouteExecutionContextData<E, unknown>>): Promise<unknown>;
     onBeforeDelete?(context: IApiSubscriberRouteExecutionContext<E, {
         authenticationRequest?: IApiAuthenticationRequest;
         headers: Record<string, string>;
@@ -43,6 +46,7 @@ export interface IApiSubscriberRoute<E extends IApiBaseEntity> extends IApiSubsc
         parameters: Partial<E>;
     } | undefined>;
     onBeforeErrorCreate?(context: IApiSubscriberRouteErrorExecutionContext<E, IApiSubscriberRouteExecutionContextData<E, E>>, error: Error): Promise<void>;
+    onBeforeErrorCustom?(context: IApiSubscriberRouteErrorExecutionContext<E, IApiSubscriberRouteExecutionContextData<E, unknown>>, error: Error): Promise<void>;
     onBeforeErrorDelete?(context: IApiSubscriberRouteErrorExecutionContext<E, IApiSubscriberRouteExecutionContextData<E, undefined>>, error: Error): Promise<void>;
     onBeforeErrorGet?(context: IApiSubscriberRouteErrorExecutionContext<E, IApiSubscriberRouteExecutionContextData<E, E>>, error: Error): Promise<void>;
     onBeforeErrorGetList?(context: IApiSubscriberRouteErrorExecutionContext<E, IApiSubscriberRouteExecutionContextData<E, IApiGetListResponseResult<E>>>, error: Error): Promise<void>;

package/dist/esm/interface/decorator/api/controller/properties/route/authentication.interface.d.ts

@@ -5,5 +5,5 @@ export interface IApiControllerPropertiesRouteAuthentication {
     bearerStrategies?: Array<string>;
     guard: Type<IAuthGuard>;
     securityStrategies?: Array<string>;
-    type: EApiAuthenticationType;
+    type: EApiAuthenticationType | string;
 }

package/dist/esm/interface/decorator/api/controller/properties/route/base/generation.interface.d.ts

@@ -0,0 +1,5 @@
+export interface IApiControllerPropertiesRouteBaseGeneration {
+    decorators?: Array<MethodDecorator> | Array<PropertyDecorator>;
+    isEnabled?: boolean;
+    shouldWriteToController?: boolean;
+}

package/dist/esm/interface/decorator/api/controller/properties/route/base/index.d.ts

@@ -1,4 +1,7 @@
 export { type IApiControllerRouteAuthorizationProperties } from './authorization.interface';
+export { type IApiControllerPropertiesRouteBaseGeneration } from './generation.interface';
 export { type IApiControllerPropertiesRouteBase } from './interface';
-export { type IApiControllerPropertiesRouteBaseRequest } from './request.interface';
-export { type IApiControllerPropertiesRouteBaseResponse } from './response.interface';
+export type * from './relations/index';
+export type * from './request/index';
+export type * from './response/index';
+export { type IApiControllerPropertiesRouteBaseSecurity } from './security.interface';

package/dist/esm/interface/decorator/api/controller/properties/route/base/interface.d.ts

@@ -1,12 +1,9 @@
 import type { EApiRouteType } from '../../../../../../../enum/decorator/api/index';
-import type { IApiControllerPropertiesRouteAuthentication, IApiControllerPropertiesRouteBaseRequest, IApiControllerPropertiesRouteBaseResponse } from '../../../../index';
-import type { IApiControllerRouteAuthorizationProperties } from './authorization.interface';
+import type { IApiControllerPropertiesRouteBaseGeneration, IApiControllerPropertiesRouteBaseRelations, IApiControllerPropertiesRouteBaseRequest, IApiControllerPropertiesRouteBaseResponse, IApiControllerPropertiesRouteBaseSecurity } from '../../../../index';
 export interface IApiControllerPropertiesRouteBase<E, R extends EApiRouteType> {
-    authentication?: IApiControllerPropertiesRouteAuthentication;
-    authorization?: IApiControllerRouteAuthorizationProperties;
-    decorators?: Array<MethodDecorator> | Array<PropertyDecorator>;
-    isEnabled?: boolean;
+    generation?: IApiControllerPropertiesRouteBaseGeneration;
+    relations?: IApiControllerPropertiesRouteBaseRelations<E>;
     request?: IApiControllerPropertiesRouteBaseRequest<E, R>;
     response?: IApiControllerPropertiesRouteBaseResponse<E, R>;
-    shouldWriteToController?: boolean;
+    security?: IApiControllerPropertiesRouteBaseSecurity;
 }

package/dist/esm/interface/decorator/api/controller/properties/route/base/relations/index.d.ts

@@ -0,0 +1,4 @@
+export { type IApiControllerPropertiesRouteBaseRelations } from './interface';
+export { type IApiControllerPropertiesRouteBaseRelationsReference } from './reference.interface';
+export type * from './request/index';
+export type * from './response/index';

package/dist/esm/interface/decorator/api/controller/properties/route/base/relations/interface.d.ts

@@ -0,0 +1,6 @@
+import type { IApiControllerPropertiesRouteBaseRelationsRequest } from './request/index';
+import type { IApiControllerPropertiesRouteBaseRelationsResponse } from './response/index';
+export interface IApiControllerPropertiesRouteBaseRelations<E> {
+    request?: IApiControllerPropertiesRouteBaseRelationsRequest<E>;
+    response?: IApiControllerPropertiesRouteBaseRelationsResponse<E>;
+}

package/dist/esm/interface/decorator/api/controller/properties/route/base/relations/reference.interface.d.ts

@@ -0,0 +1,5 @@
+import type { EApiControllerRelationReferenceShape } from '../../../../../../../../enum/decorator/api/index';
+export interface IApiControllerPropertiesRouteBaseRelationsReference {
+    key?: string;
+    shape: EApiControllerRelationReferenceShape;
+}

package/dist/esm/interface/decorator/api/controller/properties/route/base/relations/request/index.d.ts

@@ -0,0 +1,2 @@
+export { type IApiControllerPropertiesRouteBaseRelationsRequest } from './interface';
+export { type IApiControllerPropertiesRouteBaseRelationsRequestLoad } from './load.interface';

package/dist/esm/interface/decorator/api/controller/properties/route/base/relations/request/interface.d.ts

@@ -0,0 +1,6 @@
+import type { IApiControllerPropertiesRouteBaseRelationsReference } from '../reference.interface';
+import type { IApiControllerPropertiesRouteBaseRelationsRequestLoad } from './load.interface';
+export interface IApiControllerPropertiesRouteBaseRelationsRequest<E> {
+    load?: IApiControllerPropertiesRouteBaseRelationsRequestLoad<E>;
+    reference: IApiControllerPropertiesRouteBaseRelationsReference;
+}

package/dist/esm/interface/decorator/api/controller/properties/route/base/relations/request/load.interface.d.ts

@@ -0,0 +1,10 @@
+import type { EApiControllerLoadRelationsStrategy } from '../../../../../../../../../enum/decorator/api/index';
+import type { FindOptionsRelations } from "typeorm";
+export interface IApiControllerPropertiesRouteBaseRelationsRequestLoad<E> {
+    relations?: Array<keyof FindOptionsRelations<E>>;
+    relationStrategy?: EApiControllerLoadRelationsStrategy;
+    services?: Partial<Record<keyof FindOptionsRelations<E>, string>>;
+    serviceStrategy?: EApiControllerLoadRelationsStrategy;
+    shouldForceAllServicesToBeSpecified?: boolean;
+    shouldLoad: boolean;
+}

package/dist/esm/interface/decorator/api/controller/properties/route/base/relations/response/index.d.ts

@@ -0,0 +1,2 @@
+export { type IApiControllerPropertiesRouteBaseRelationsResponse } from './interface';
+export { type IApiControllerPropertiesRouteBaseRelationsResponseLoad } from './load.interface';

package/dist/esm/interface/decorator/api/controller/properties/route/base/relations/response/interface.d.ts

@@ -0,0 +1,6 @@
+import type { IApiControllerPropertiesRouteBaseRelationsReference } from '../reference.interface';
+import type { IApiControllerPropertiesRouteBaseRelationsResponseLoad } from './load.interface';
+export interface IApiControllerPropertiesRouteBaseRelationsResponse<E> {
+    load?: IApiControllerPropertiesRouteBaseRelationsResponseLoad<E>;
+    reference: IApiControllerPropertiesRouteBaseRelationsReference;
+}

package/dist/esm/interface/decorator/api/controller/properties/route/base/relations/response/load.interface.d.ts

@@ -0,0 +1,4 @@
+import type { FindOptionsRelations } from "typeorm";
+export interface IApiControllerPropertiesRouteBaseRelationsResponseLoad<E> {
+    include?: FindOptionsRelations<E>;
+}

package/dist/esm/interface/decorator/api/controller/properties/route/base/request/index.d.ts

@@ -0,0 +1,2 @@
+export { type IApiControllerPropertiesRouteBaseRequest } from './interface';
+export { type IApiControllerPropertiesRouteBaseRequestTarget } from './target.interface';

package/dist/esm/interface/decorator/api/controller/properties/route/base/request/interface.d.ts

@@ -0,0 +1,6 @@
+import type { EApiControllerRequestTarget, EApiRouteType } from '../../../../../../../../enum/decorator/api/index';
+import type { TApiControllerAllowedRequestTarget } from '../../../../../../../../type/decorator/api/controller/index';
+import type { IApiControllerPropertiesRouteBaseRequestTarget } from './target.interface';
+export type IApiControllerPropertiesRouteBaseRequest<E, R extends EApiRouteType> = {
+    [TARGET in EApiControllerRequestTarget as TARGET extends TApiControllerAllowedRequestTarget<R> ? TARGET : never]?: IApiControllerPropertiesRouteBaseRequestTarget<E>;
+};

package/dist/esm/interface/decorator/api/controller/properties/route/base/request/target.interface.d.ts

@@ -0,0 +1,6 @@
+import type { IApiRequestValidator } from '../../../../../../../api/request-validator.interface';
+import type { TApiRequestTransformer } from '../../../../../../../../type/api-request-transformer.type';
+export interface IApiControllerPropertiesRouteBaseRequestTarget<E> {
+    transformers?: Array<TApiRequestTransformer<E>>;
+    validators?: Array<IApiRequestValidator<E>>;
+}

package/dist/esm/interface/decorator/api/controller/properties/route/base/response/index.d.ts

@@ -0,0 +1,2 @@
+export { type IApiControllerPropertiesRouteBaseResponse } from './interface';
+export { type IApiControllerPropertiesRouteBaseResponseTarget } from './target.interface';

package/dist/esm/interface/decorator/api/controller/properties/route/base/response/interface.d.ts

@@ -0,0 +1,7 @@
+import type { EApiControllerResponseTarget, EApiRouteType } from '../../../../../../../../enum/decorator/api/index';
+import type { IApiRouteResponseSerializationProperties } from '../../../../../route/index';
+import type { IApiControllerPropertiesRouteBaseResponseTarget } from './target.interface';
+export interface IApiControllerPropertiesRouteBaseResponse<E, R extends EApiRouteType> {
+    [EApiControllerResponseTarget.RESPONSE]?: R extends EApiRouteType.DELETE ? never : IApiControllerPropertiesRouteBaseResponseTarget<E>;
+    serialization?: IApiRouteResponseSerializationProperties;
+}

package/dist/esm/interface/decorator/api/controller/properties/route/base/response/target.interface.d.ts

@@ -0,0 +1,4 @@
+import type { TApiRequestTransformer } from '../../../../../../../../type/api-request-transformer.type';
+export interface IApiControllerPropertiesRouteBaseResponseTarget<E> {
+    transformers?: Array<TApiRequestTransformer<E>>;
+}