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

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

@@ -0,0 +1,59 @@
+import type { IApiBaseEntity } from '../../../../../../src/interface/api-base-entity.interface';
+import type { TApiFunctionCreateProperties, TApiFunctionDeleteCriteria, TApiFunctionGetListProperties, TApiFunctionGetManyProperties, TApiFunctionGetProperties, TApiFunctionUpdateCriteria } from '../../../../../../src/type/decorator/api/function/index';
+import type { EntityManager, Repository } from "typeorm";
+/**
+ * Data container for function subscriber execution context.
+ * Contains transaction manager, repository references, and operation payload metadata.
+ * This interface provides typed access to the DATA field in function execution contexts.
+ * @example
+ * ```typescript
+ * async onBeforeCreate(
+ *   context: IApiSubscriberFunctionExecutionContext<
+ *     User,
+ *     TApiFunctionCreateProperties<User>,
+ *     IApiSubscriberFunctionExecutionContextData<User>
+ *   >
+ * ): Promise<TApiFunctionCreateProperties<User>> {
+ *   const manager = context.DATA.eventManager;
+ *   const repository = context.DATA.repository;
+ *
+ *   if (manager) {
+ *     await manager.save(RelatedEntity, { ... });
+ *   }
+ *
+ *   return context.result;
+ * }
+ * ```
+ */
+export interface IApiSubscriberFunctionExecutionContextData<E extends IApiBaseEntity> {
+    /**
+     * Criteria used for update/delete operations.
+     */
+    criteria?: TApiFunctionDeleteCriteria<E> | TApiFunctionUpdateCriteria<E>;
+    /**
+     * Entity manager for transactional operations.
+     * Available when service methods are called with a transaction manager.
+     */
+    eventManager?: EntityManager;
+    /**
+     * Input payload for get list operations (before hooks).
+     */
+    getListProperties?: TApiFunctionGetListProperties<E>;
+    /**
+     * Input payload for get many operations (before hooks).
+     */
+    getManyProperties?: TApiFunctionGetManyProperties<E>;
+    /**
+     * Input payload for get operations (before hooks).
+     */
+    getProperties?: TApiFunctionGetProperties<E>;
+    /**
+     * Properties used in function executor contexts (create/get/getList/getMany).
+     */
+    properties?: TApiFunctionCreateProperties<E> | TApiFunctionGetListProperties<E> | TApiFunctionGetManyProperties<E> | TApiFunctionGetProperties<E>;
+    /**
+     * TypeORM repository instance for the entity.
+     * Provides access to database operations for the entity type.
+     */
+    repository: Repository<E>;
+}

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

@@ -0,0 +1,30 @@
+import type { EApiFunctionType } from '../../../../../../src/enum/decorator/api/function-type.enum';
+import type { IApiBaseEntity } from '../../../../../../src/interface/api-base-entity.interface';
+import type { IApiSubscriberExecutionContext } from '../../../../../../src/interface/class/api/subscriber/execution-context.interface';
+/**
+ * Execution context for function subscriber callbacks.
+ * Extends base execution context with function type information.
+ * @template E - Entity type extending IApiBaseEntity
+ * @template Result - Type of the result field (mutable data payload)
+ * @template Input - Type of the DATA field (immutable context data). Use IApiSubscriberFunctionExecutionContextData<E> for typed access.
+ * @example
+ * ```typescript
+ * import type { IApiSubscriberFunctionExecutionContextData } from '@elsikora/nestjs-crud-automator';
+ *
+ * async onBeforeCreate(
+ *   context: IApiSubscriberFunctionExecutionContext<
+ *     User,
+ *     TApiFunctionCreateProperties<User>,
+ *     IApiSubscriberFunctionExecutionContextData<User>
+ *   >
+ * ): Promise<TApiFunctionCreateProperties<User>> {
+ *   const manager = context.DATA.eventManager;
+ *   const repository = context.DATA.repository;
+ *   // ...
+ * }
+ * ```
+ */
+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/execution/index.d.ts

@@ -0,0 +1,2 @@
+export { type IApiSubscriberFunctionExecutionContextData } from "./context-data.interface";
+export { type IApiSubscriberFunctionExecutionContext } from "./context.interface";

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

@@ -0,0 +1,2 @@
+export { type IApiSubscriberFunctionErrorExecutionContext } from "./error-execution-context.interface";
+export type * from "./execution";

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

@@ -0,0 +1,37 @@
+import type { IApiBaseEntity } from '../../../../src/interface/api-base-entity.interface';
+import type { IApiSubscriberFunctionErrorExecutionContext } from '../../../../src/interface/class/api/subscriber/function/error-execution-context.interface';
+import type { IApiSubscriberFunctionExecutionContextData } from '../../../../src/interface/class/api/subscriber/function/execution/context-data.interface';
+import type { IApiSubscriberFunctionExecutionContext } from '../../../../src/interface/class/api/subscriber/function/execution/context.interface';
+import type { IApiSubscriber } from '../../../../src/interface/class/api/subscriber/interface';
+import type { IApiGetListResponseResult } from '../../../../src/interface/decorator/api/index';
+import type { TApiFunctionCreateProperties, TApiFunctionDeleteCriteria, TApiFunctionGetListProperties, TApiFunctionGetManyProperties, TApiFunctionGetProperties, TApiFunctionUpdateProperties } from '../../../../src/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>;
+    onAfterErrorGetMany?(context: IApiSubscriberFunctionErrorExecutionContext<E, IApiSubscriberFunctionExecutionContextData<E>>, error: Error): Promise<void>;
+    onAfterErrorUpdate?(context: IApiSubscriberFunctionErrorExecutionContext<E, IApiSubscriberFunctionExecutionContextData<E>>, error: Error): Promise<void>;
+    onAfterGet?(context: IApiSubscriberFunctionExecutionContext<E, E, IApiSubscriberFunctionExecutionContextData<E>>): Promise<E | undefined>;
+    onAfterGetList?(context: IApiSubscriberFunctionExecutionContext<E, IApiGetListResponseResult<E>, IApiSubscriberFunctionExecutionContextData<E>>): Promise<IApiGetListResponseResult<E> | undefined>;
+    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>;
+    onBeforeErrorGetMany?(context: IApiSubscriberFunctionErrorExecutionContext<E, IApiSubscriberFunctionExecutionContextData<E>>, error: Error): Promise<void>;
+    onBeforeErrorUpdate?(context: IApiSubscriberFunctionErrorExecutionContext<E, IApiSubscriberFunctionExecutionContextData<E>>, error: Error): Promise<void>;
+    onBeforeGet?(context: IApiSubscriberFunctionExecutionContext<E, TApiFunctionGetProperties<E>, IApiSubscriberFunctionExecutionContextData<E>>): Promise<TApiFunctionGetProperties<E> | undefined>;
+    onBeforeGetList?(context: IApiSubscriberFunctionExecutionContext<E, TApiFunctionGetListProperties<E>, IApiSubscriberFunctionExecutionContextData<E>>): Promise<TApiFunctionGetListProperties<E> | undefined>;
+    onBeforeGetMany?(context: IApiSubscriberFunctionExecutionContext<E, TApiFunctionGetManyProperties<E>, IApiSubscriberFunctionExecutionContextData<E>>): Promise<TApiFunctionGetManyProperties<E> | undefined>;
+    onBeforeUpdate?(context: IApiSubscriberFunctionExecutionContext<E, TApiFunctionUpdateProperties<E>, IApiSubscriberFunctionExecutionContextData<E>>): Promise<TApiFunctionUpdateProperties<E> | undefined>;
+}

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

@@ -0,0 +1,7 @@
+export type * from "./error-execution-context.interface";
+export type * from "./execution-context.interface";
+export type * from "./function";
+export type * from "./function.interface";
+export type * from "./interface";
+export type * from "./route";
+export type * from "./route.interface";

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

@@ -0,0 +1,13 @@
+import type { EApiRouteType } from '../../../../../src/enum/decorator/api/route-type.enum';
+import type { IApiBaseEntity } from '../../../../../src/interface/api-base-entity.interface';
+import type { IApiSubscriberErrorExecutionContext } from '../../../../../src/interface/class/api/subscriber/error-execution-context.interface';
+/**
+ * Error execution context for route subscriber callbacks.
+ * Contains route type information but no result field.
+ * @template E - Entity type extending IApiBaseEntity
+ * @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> {
+    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 '../../../../../../../../src/interface/api-base-entity.interface';
+import type { IApiAuthenticationRequest } from '../../../../../../../../src/interface/api/authentication-request.interface';
+import type { TApiAuthorizationRuleTransformPayload } from '../../../../../../../../src/type/class/api/authorization/rule/transform-payload.type';
+import type { TApiControllerGetListQuery } from '../../../../../../../../src/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 '../../../../../../../../src/enum/decorator/api/route-type.enum';
+import type { IApiBaseEntity } from '../../../../../../../../src/interface/api-base-entity.interface';
+import type { IApiAuthorizationDecision } from '../../../../../../../../src/interface/class/api/authorization/index';
+import type { IApiControllerProperties } from '../../../../../../../../src/interface/decorator/api/controller/properties.interface';
+import type { IApiEntity } from '../../../../../../../../src/interface/entity/index';
+import type { TApiAuthorizationRuleTransformPayload } from '../../../../../../../../src/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";
+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 '../../../../../../../src/enum/decorator/api/route-type.enum';
+import type { IApiBaseEntity } from '../../../../../../../src/interface/api-base-entity.interface';
+import type { IApiSubscriberExecutionContext } from '../../../../../../../src/interface/class/api/subscriber/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

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

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

@@ -0,0 +1,2 @@
+export { type IApiSubscriberRouteErrorExecutionContext } from "./error-execution-context.interface";
+export type * from "./execution";

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

@@ -0,0 +1,103 @@
+import type { IApiBaseEntity } from '../../../../src/interface/api-base-entity.interface';
+import type { IApiAuthenticationRequest } from '../../../../src/interface/api/authentication-request.interface';
+import type { IApiSubscriber } from '../../../../src/interface/class/api/subscriber/interface';
+import type { IApiSubscriberRouteErrorExecutionContext } from '../../../../src/interface/class/api/subscriber/route/error-execution-context.interface';
+import type { IApiSubscriberRouteExecutionContextData, IApiSubscriberRouteExecutionContextDataExtended } from '../../../../src/interface/class/api/subscriber/route/execution/context/index';
+import type { IApiSubscriberRouteExecutionContext } from '../../../../src/interface/class/api/subscriber/route/execution/context/index';
+import type { IApiGetListResponseResult } from '../../../../src/interface/decorator/api/index';
+import type { TApiControllerGetListQuery } from '../../../../src/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>;
+    onAfterErrorPartialUpdate?(context: IApiSubscriberRouteErrorExecutionContext<E, IApiSubscriberRouteExecutionContextDataExtended<E, E>>, error: Error): Promise<void>;
+    onAfterErrorUpdate?(context: IApiSubscriberRouteErrorExecutionContext<E, IApiSubscriberRouteExecutionContextDataExtended<E, E>>, error: Error): Promise<void>;
+    onAfterGet?(context: IApiSubscriberRouteExecutionContext<E, E, IApiSubscriberRouteExecutionContextDataExtended<E, E>>): Promise<E | undefined>;
+    onAfterGetList?(context: IApiSubscriberRouteExecutionContext<E, IApiGetListResponseResult<E>, IApiSubscriberRouteExecutionContextDataExtended<E, IApiGetListResponseResult<E>>>): Promise<IApiGetListResponseResult<E> | undefined>;
+    onAfterPartialUpdate?(context: IApiSubscriberRouteExecutionContext<E, E, IApiSubscriberRouteExecutionContextDataExtended<E, E>>): Promise<E | undefined>;
+    onAfterUpdate?(context: IApiSubscriberRouteExecutionContext<E, E, IApiSubscriberRouteExecutionContextDataExtended<E, E>>): Promise<E | undefined>;
+    onBeforeCreate?(context: IApiSubscriberRouteExecutionContext<E, {
+        authenticationRequest?: IApiAuthenticationRequest;
+        body: DeepPartial<E>;
+        headers: Record<string, string>;
+        ip: string;
+    }, IApiSubscriberRouteExecutionContextData<E, E>>): Promise<{
+        authenticationRequest?: IApiAuthenticationRequest;
+        body: DeepPartial<E>;
+        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>;
+        ip: string;
+        parameters: Partial<E>;
+    }, IApiSubscriberRouteExecutionContextData<E, undefined>>): Promise<{
+        authenticationRequest?: IApiAuthenticationRequest;
+        headers: Record<string, string>;
+        ip: string;
+        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>;
+    onBeforeErrorPartialUpdate?(context: IApiSubscriberRouteErrorExecutionContext<E, IApiSubscriberRouteExecutionContextData<E, E>>, error: Error): Promise<void>;
+    onBeforeErrorUpdate?(context: IApiSubscriberRouteErrorExecutionContext<E, IApiSubscriberRouteExecutionContextData<E, E>>, error: Error): Promise<void>;
+    onBeforeGet?(context: IApiSubscriberRouteExecutionContext<E, {
+        authenticationRequest?: IApiAuthenticationRequest;
+        headers: Record<string, string>;
+        ip: string;
+        parameters: Partial<E>;
+    }, IApiSubscriberRouteExecutionContextData<E, E>>): Promise<{
+        authenticationRequest?: IApiAuthenticationRequest;
+        headers: Record<string, string>;
+        ip: string;
+        parameters: Partial<E>;
+    } | undefined>;
+    onBeforeGetList?(context: IApiSubscriberRouteExecutionContext<E, {
+        authenticationRequest?: IApiAuthenticationRequest;
+        headers: Record<string, string>;
+        ip: string;
+        query: TApiControllerGetListQuery<E>;
+    }, IApiSubscriberRouteExecutionContextData<E, IApiGetListResponseResult<E>>>): Promise<{
+        authenticationRequest?: IApiAuthenticationRequest;
+        headers: Record<string, string>;
+        ip: string;
+        query: TApiControllerGetListQuery<E>;
+    } | undefined>;
+    onBeforePartialUpdate?(context: IApiSubscriberRouteExecutionContext<E, {
+        authenticationRequest?: IApiAuthenticationRequest;
+        body: DeepPartial<E>;
+        headers: Record<string, string>;
+        ip: string;
+        parameters: Partial<E>;
+    }, IApiSubscriberRouteExecutionContextData<E, E>>): Promise<{
+        authenticationRequest?: IApiAuthenticationRequest;
+        body: DeepPartial<E>;
+        headers: Record<string, string>;
+        ip: string;
+        parameters: Partial<E>;
+    } | undefined>;
+    onBeforeUpdate?(context: IApiSubscriberRouteExecutionContext<E, {
+        authenticationRequest?: IApiAuthenticationRequest;
+        body: DeepPartial<E>;
+        headers: Record<string, string>;
+        ip: string;
+        parameters: Partial<E>;
+    }, IApiSubscriberRouteExecutionContextData<E, E>>): Promise<{
+        authenticationRequest?: IApiAuthenticationRequest;
+        body: DeepPartial<E>;
+        headers: Record<string, string>;
+        ip: string;
+        parameters: Partial<E>;
+    } | undefined>;
+}

package/dist/esm/interface/class/dto-strategy.interface.d.ts

@@ -0,0 +1,5 @@
+import type { EApiRouteType } from '../../src/enum/decorator/api/index';
+import type { TApiPropertyDescribeDtoProperties, TApiPropertyDescribeProperties } from '../../src/type/decorator/api/property/index';
+export interface IDtoStrategy {
+    getDecoratorConfig(method: EApiRouteType, metadata: TApiPropertyDescribeProperties): TApiPropertyDescribeDtoProperties;
+}

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

@@ -0,0 +1,3 @@
+export type * from "./api";
+export { type IDtoStrategy } from "./dto-strategy.interface";
+export { type IMetadataEntry } from "./metadata-entry.interface";

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

@@ -0,0 +1,4 @@
+import type { ApiServiceBase } from '../../../../src/class/api/index';
+export interface IApiControllerBase<E> {
+    service: ApiServiceBase<E>;
+}

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

@@ -0,0 +1,3 @@
+export { type IApiControllerBase } from "./base.interface";
+export type * from "./properties";
+export { type IApiControllerProperties } from "./properties.interface";

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

@@ -0,0 +1,8 @@
+import type { EApiAuthorizationMode } from '../../../../../src/enum/class/authorization/index';
+import type { IApiBaseEntity } from '../../../../../src/interface/api-base-entity.interface';
+import type { IApiAuthorizationResourceDefinition } from '../../../../../src/interface/class/api/authorization/index';
+export interface IApiControllerAuthorizationProperties<E extends IApiBaseEntity> {
+    defaultMode: EApiAuthorizationMode;
+    policyNamespace?: string;
+    resourceDefinition?: IApiAuthorizationResourceDefinition<E>;
+}

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

@@ -0,0 +1,2 @@
+export { type IApiControllerAuthorizationProperties } from "./authorization.interface";
+export type * from "./route";

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

@@ -0,0 +1,9 @@
+import type { EApiAuthenticationType } from '../../../../../../src/enum/decorator/api/index';
+import type { Type } from "@nestjs/common";
+import type { IAuthGuard } from "@nestjs/passport";
+export interface IApiControllerPropertiesRouteAuthentication {
+    bearerStrategies?: Array<string>;
+    guard: Type<IAuthGuard>;
+    securityStrategies?: Array<string>;
+    type: EApiAuthenticationType | string;
+}

package/dist/esm/interface/decorator/api/controller/properties/route/auto-dto-config.interface.d.ts

@@ -0,0 +1,4 @@
+import type { IApiDtoValidator } from '../../../../../../src/interface/api/dto-validator.interface';
+export interface IApiControllerPropertiesRouteAutoDtoConfig {
+    validators?: Array<IApiDtoValidator>;
+}

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

@@ -0,0 +1,4 @@
+import type { EApiAuthorizationMode } from '../../../../../../../src/enum/class/authorization/index';
+export interface IApiControllerRouteAuthorizationProperties {
+    mode?: EApiAuthorizationMode;
+}

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

@@ -0,0 +1,7 @@
+export { type IApiControllerRouteAuthorizationProperties } from "./authorization.interface";
+export { type IApiControllerPropertiesRouteBaseGeneration } from "./generation.interface";
+export { type IApiControllerPropertiesRouteBase } from "./interface";
+export type * from "./relations";
+export type * from "./request";
+export type * from "./response";
+export { type IApiControllerPropertiesRouteBaseSecurity } from "./security.interface";

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

@@ -0,0 +1,9 @@
+import type { EApiRouteType } from '../../../../../../../src/enum/decorator/api/index';
+import type { IApiControllerPropertiesRouteBaseGeneration, IApiControllerPropertiesRouteBaseRelations, IApiControllerPropertiesRouteBaseRequest, IApiControllerPropertiesRouteBaseResponse, IApiControllerPropertiesRouteBaseSecurity } from '../../../../../../../src/interface/decorator/api/index';
+export interface IApiControllerPropertiesRouteBase<E, R extends EApiRouteType> {
+    generation?: IApiControllerPropertiesRouteBaseGeneration;
+    relations?: IApiControllerPropertiesRouteBaseRelations<E>;
+    request?: IApiControllerPropertiesRouteBaseRequest<E, R>;
+    response?: IApiControllerPropertiesRouteBaseResponse<E, R>;
+    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";
+export type * from "./response";

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

@@ -0,0 +1,6 @@
+import type { IApiControllerPropertiesRouteBaseRelationsRequest } from "./request";
+import type { IApiControllerPropertiesRouteBaseRelationsResponse } from "./response";
+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 '../../../../../../../../src/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 '../../../../../../../../../src/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/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 '../../../../../../../../src/enum/decorator/api/index';
+import type { TApiControllerAllowedRequestTarget } from '../../../../../../../../src/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 '../../../../../../../../src/interface/api/request-validator.interface';
+import type { TApiRequestTransformer } from '../../../../../../../../src/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 '../../../../../../../../src/enum/decorator/api/index';
+import type { IApiRouteResponseSerializationProperties } from '../../../../../../../../src/interface/decorator/api/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 '../../../../../../../../src/type/api-request-transformer.type';
+export interface IApiControllerPropertiesRouteBaseResponseTarget<E> {
+    transformers?: Array<TApiRequestTransformer<E>>;
+}

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

@@ -0,0 +1,6 @@
+import type { IApiControllerPropertiesRouteAuthentication } from "../authentication.interface";
+import type { IApiControllerRouteAuthorizationProperties } from "./authorization.interface";
+export interface IApiControllerPropertiesRouteBaseSecurity {
+    authentication?: IApiControllerPropertiesRouteAuthentication;
+    authorization?: IApiControllerRouteAuthorizationProperties;
+}

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

@@ -0,0 +1,5 @@
+export { type IApiControllerPropertiesRouteAuthentication } from "./authentication.interface";
+export { type IApiControllerPropertiesRouteAutoDtoConfig } from "./auto-dto-config.interface";
+export type * from "./base";
+export { type IApiControllerPropertiesRouteGetListResponseDtoConfig } from "./list-response-dto-config.interface";
+export type * from "./with";

package/dist/esm/interface/decorator/api/controller/properties/route/with/auto-dto.interface.d.ts

@@ -0,0 +1,6 @@
+import type { EApiDtoType, EApiRouteType } from '../../../../../../../src/enum/decorator/api/index';
+import type { IApiControllerPropertiesRouteAutoDtoConfig, IApiControllerPropertiesRouteBase } from '../../../../../../../src/interface/decorator/api/index';
+export interface IApiControllerPropertiesRouteWithAutoDto<E, R extends EApiRouteType> extends IApiControllerPropertiesRouteBase<E, R> {
+    autoDto?: Partial<Record<EApiDtoType, IApiControllerPropertiesRouteAutoDtoConfig>>;
+    dto?: never;
+}

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

@@ -0,0 +1,12 @@
+import type { EApiDtoType, EApiRouteType } from '../../../../../../../src/enum/decorator/api/index';
+import type { IApiControllerPropertiesRouteBase } from '../../../../../../../src/interface/decorator/api/controller/properties/route/base/index';
+import type { IApiControllerPropertiesRouteGetListResponseDtoConfig } from '../../../../../../../src/interface/decorator/api/controller/properties/route/list-response-dto-config.interface';
+import type { Type } from "@nestjs/common";
+export interface IApiControllerPropertiesRouteWithDto<E, R extends EApiRouteType> extends IApiControllerPropertiesRouteBase<E, R> {
+    autoDto?: never;
+    dto?: TApiControllerPropertiesRouteDto<R>;
+}
+type TApiControllerPropertiesRouteDto<R extends EApiRouteType> = Partial<{
+    [EApiDtoType.RESPONSE]: R extends EApiRouteType.GET_LIST ? IApiControllerPropertiesRouteGetListResponseDtoConfig | Type<unknown> : Type<unknown>;
+} & Record<EApiDtoType.BODY | EApiDtoType.PARAMETERS | EApiDtoType.QUERY, Type<unknown>>>;
+export {};

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

@@ -0,0 +1,2 @@
+export { type IApiControllerPropertiesRouteWithAutoDto } from "./auto-dto.interface";
+export { type IApiControllerPropertiesRouteWithDto } from "./dto.interface";