@elsikora/nestjs-crud-automator 2.10.0 → 3.0.0-dev.1

package/dist/esm/type/class/api/subscriber/function/after/create-context.type.d.ts

@@ -1,5 +1,5 @@
 import { EApiFunctionSubscriberTransactionExpectation } from '../../../../../../enum/decorator/api';
 import { IApiBaseEntity } from '../../../../../../interface/api-base-entity.interface';
 import { IApiSubscriberFunctionExecutionContext } from '../../../../../../interface/class/api/subscriber/function/execution/context';
-import { TApiSubscriberFunctionExecutionContextData } from '../execution/context';
+import { TApiSubscriberFunctionExecutionContextData } from '../execution-context-data.type';
 export type TApiSubscriberFunctionAfterCreateContext<E extends IApiBaseEntity, TTransactionExpectation extends EApiFunctionSubscriberTransactionExpectation = EApiFunctionSubscriberTransactionExpectation.SUPPORTS> = IApiSubscriberFunctionExecutionContext<E, E, TApiSubscriberFunctionExecutionContextData<E, TTransactionExpectation>>;

package/dist/esm/type/class/api/subscriber/function/after/delete-context.type.d.ts

@@ -1,5 +1,5 @@
 import { EApiFunctionSubscriberTransactionExpectation } from '../../../../../../enum/decorator/api';
 import { IApiBaseEntity } from '../../../../../../interface/api-base-entity.interface';
 import { IApiSubscriberFunctionExecutionContext } from '../../../../../../interface/class/api/subscriber/function/execution/context';
-import { TApiSubscriberFunctionExecutionContextData } from '../execution/context';
+import { TApiSubscriberFunctionExecutionContextData } from '../execution-context-data.type';
 export type TApiSubscriberFunctionAfterDeleteContext<E extends IApiBaseEntity, TTransactionExpectation extends EApiFunctionSubscriberTransactionExpectation = EApiFunctionSubscriberTransactionExpectation.SUPPORTS> = IApiSubscriberFunctionExecutionContext<E, E, TApiSubscriberFunctionExecutionContextData<E, TTransactionExpectation>>;

package/dist/esm/type/class/api/subscriber/function/after/get/context.type.d.ts

@@ -1,5 +1,5 @@
 import { EApiFunctionSubscriberTransactionExpectation } from '../../../../../../../enum/decorator/api';
 import { IApiBaseEntity } from '../../../../../../../interface/api-base-entity.interface';
 import { IApiSubscriberFunctionExecutionContext } from '../../../../../../../interface/class/api/subscriber/function/execution/context';
-import { TApiSubscriberFunctionExecutionContextData } from '../../execution/context';
+import { TApiSubscriberFunctionExecutionContextData } from '../../execution-context-data.type';
 export type TApiSubscriberFunctionAfterGetContext<E extends IApiBaseEntity, TTransactionExpectation extends EApiFunctionSubscriberTransactionExpectation = EApiFunctionSubscriberTransactionExpectation.SUPPORTS> = IApiSubscriberFunctionExecutionContext<E, E, TApiSubscriberFunctionExecutionContextData<E, TTransactionExpectation>>;

package/dist/esm/type/class/api/subscriber/function/after/get/list-context.type.d.ts

@@ -2,5 +2,5 @@ import { EApiFunctionSubscriberTransactionExpectation } from '../../../../../../
 import { IApiBaseEntity } from '../../../../../../../interface/api-base-entity.interface';
 import { IApiSubscriberFunctionExecutionContext } from '../../../../../../../interface/class/api/subscriber/function/execution/context';
 import { IApiGetListResponseResult } from '../../../../../../../interface/decorator/api';
-import { TApiSubscriberFunctionExecutionContextData } from '../../execution/context';
+import { TApiSubscriberFunctionExecutionContextData } from '../../execution-context-data.type';
 export type TApiSubscriberFunctionAfterGetListContext<E extends IApiBaseEntity, TTransactionExpectation extends EApiFunctionSubscriberTransactionExpectation = EApiFunctionSubscriberTransactionExpectation.SUPPORTS> = IApiSubscriberFunctionExecutionContext<E, IApiGetListResponseResult<E>, TApiSubscriberFunctionExecutionContextData<E, TTransactionExpectation>>;

package/dist/esm/type/class/api/subscriber/function/after/get/many-context.type.d.ts

@@ -1,5 +1,5 @@
 import { EApiFunctionSubscriberTransactionExpectation } from '../../../../../../../enum/decorator/api';
 import { IApiBaseEntity } from '../../../../../../../interface/api-base-entity.interface';
 import { IApiSubscriberFunctionExecutionContext } from '../../../../../../../interface/class/api/subscriber/function/execution/context';
-import { TApiSubscriberFunctionExecutionContextData } from '../../execution/context';
+import { TApiSubscriberFunctionExecutionContextData } from '../../execution-context-data.type';
 export type TApiSubscriberFunctionAfterGetManyContext<E extends IApiBaseEntity, TTransactionExpectation extends EApiFunctionSubscriberTransactionExpectation = EApiFunctionSubscriberTransactionExpectation.SUPPORTS> = IApiSubscriberFunctionExecutionContext<E, Array<E>, TApiSubscriberFunctionExecutionContextData<E, TTransactionExpectation>>;

package/dist/esm/type/class/api/subscriber/function/after/update-context.type.d.ts

@@ -1,5 +1,5 @@
 import { EApiFunctionSubscriberTransactionExpectation } from '../../../../../../enum/decorator/api';
 import { IApiBaseEntity } from '../../../../../../interface/api-base-entity.interface';
 import { IApiSubscriberFunctionExecutionContext } from '../../../../../../interface/class/api/subscriber/function/execution/context';
-import { TApiSubscriberFunctionExecutionContextData } from '../execution/context';
+import { TApiSubscriberFunctionExecutionContextData } from '../execution-context-data.type';
 export type TApiSubscriberFunctionAfterUpdateContext<E extends IApiBaseEntity, TTransactionExpectation extends EApiFunctionSubscriberTransactionExpectation = EApiFunctionSubscriberTransactionExpectation.SUPPORTS> = IApiSubscriberFunctionExecutionContext<E, E, TApiSubscriberFunctionExecutionContextData<E, TTransactionExpectation>>;

package/dist/esm/type/class/api/subscriber/function/before/create-context.type.d.ts

@@ -1,6 +1,6 @@
 import { EApiFunctionSubscriberTransactionExpectation } from '../../../../../../enum/decorator/api';
 import { IApiBaseEntity } from '../../../../../../interface/api-base-entity.interface';
 import { IApiSubscriberFunctionExecutionContext } from '../../../../../../interface/class/api/subscriber/function/execution/context';
-import { TApiSubscriberFunctionExecutionContextData } from '../execution/context';
+import { TApiSubscriberFunctionExecutionContextData } from '../execution-context-data.type';
 import { TApiFunctionCreateProperties } from '../../../../../decorator/api/function';
 export type TApiSubscriberFunctionBeforeCreateContext<E extends IApiBaseEntity, Result extends TApiFunctionCreateProperties<E> = TApiFunctionCreateProperties<E>, TTransactionExpectation extends EApiFunctionSubscriberTransactionExpectation = EApiFunctionSubscriberTransactionExpectation.SUPPORTS> = IApiSubscriberFunctionExecutionContext<E, Result, TApiSubscriberFunctionExecutionContextData<E, TTransactionExpectation>>;

package/dist/esm/type/class/api/subscriber/function/before/delete-context.type.d.ts

@@ -1,6 +1,6 @@
 import { EApiFunctionSubscriberTransactionExpectation } from '../../../../../../enum/decorator/api';
 import { IApiBaseEntity } from '../../../../../../interface/api-base-entity.interface';
 import { IApiSubscriberFunctionExecutionContext } from '../../../../../../interface/class/api/subscriber/function/execution/context';
-import { TApiSubscriberFunctionExecutionContextData } from '../execution/context';
+import { TApiSubscriberFunctionExecutionContextData } from '../execution-context-data.type';
 import { TApiFunctionDeleteCriteria } from '../../../../../decorator/api/function';
 export type TApiSubscriberFunctionBeforeDeleteContext<E extends IApiBaseEntity, Result extends TApiFunctionDeleteCriteria<E> = TApiFunctionDeleteCriteria<E>, TTransactionExpectation extends EApiFunctionSubscriberTransactionExpectation = EApiFunctionSubscriberTransactionExpectation.SUPPORTS> = IApiSubscriberFunctionExecutionContext<E, Result, TApiSubscriberFunctionExecutionContextData<E, TTransactionExpectation>>;

package/dist/esm/type/class/api/subscriber/function/before/get/context.type.d.ts

@@ -1,6 +1,6 @@
 import { EApiFunctionSubscriberTransactionExpectation } from '../../../../../../../enum/decorator/api';
 import { IApiBaseEntity } from '../../../../../../../interface/api-base-entity.interface';
 import { IApiSubscriberFunctionExecutionContext } from '../../../../../../../interface/class/api/subscriber/function/execution/context';
-import { TApiSubscriberFunctionExecutionContextData } from '../../execution/context';
+import { TApiSubscriberFunctionExecutionContextData } from '../../execution-context-data.type';
 import { TApiFunctionGetProperties } from '../../../../../../decorator/api/function';
 export type TApiSubscriberFunctionBeforeGetContext<E extends IApiBaseEntity, Result extends TApiFunctionGetProperties<E> = TApiFunctionGetProperties<E>, TTransactionExpectation extends EApiFunctionSubscriberTransactionExpectation = EApiFunctionSubscriberTransactionExpectation.SUPPORTS> = IApiSubscriberFunctionExecutionContext<E, Result, TApiSubscriberFunctionExecutionContextData<E, TTransactionExpectation>>;

package/dist/esm/type/class/api/subscriber/function/before/get/list-context.type.d.ts

@@ -1,6 +1,6 @@
 import { EApiFunctionSubscriberTransactionExpectation } from '../../../../../../../enum/decorator/api';
 import { IApiBaseEntity } from '../../../../../../../interface/api-base-entity.interface';
 import { IApiSubscriberFunctionExecutionContext } from '../../../../../../../interface/class/api/subscriber/function/execution/context';
-import { TApiSubscriberFunctionExecutionContextData } from '../../execution/context';
+import { TApiSubscriberFunctionExecutionContextData } from '../../execution-context-data.type';
 import { TApiFunctionGetListProperties } from '../../../../../../decorator/api/function';
 export type TApiSubscriberFunctionBeforeGetListContext<E extends IApiBaseEntity, Result extends TApiFunctionGetListProperties<E> = TApiFunctionGetListProperties<E>, TTransactionExpectation extends EApiFunctionSubscriberTransactionExpectation = EApiFunctionSubscriberTransactionExpectation.SUPPORTS> = IApiSubscriberFunctionExecutionContext<E, Result, TApiSubscriberFunctionExecutionContextData<E, TTransactionExpectation>>;

package/dist/esm/type/class/api/subscriber/function/before/get/many-context.type.d.ts

@@ -1,6 +1,6 @@
 import { EApiFunctionSubscriberTransactionExpectation } from '../../../../../../../enum/decorator/api';
 import { IApiBaseEntity } from '../../../../../../../interface/api-base-entity.interface';
 import { IApiSubscriberFunctionExecutionContext } from '../../../../../../../interface/class/api/subscriber/function/execution/context';
-import { TApiSubscriberFunctionExecutionContextData } from '../../execution/context';
+import { TApiSubscriberFunctionExecutionContextData } from '../../execution-context-data.type';
 import { TApiFunctionGetManyProperties } from '../../../../../../decorator/api/function';
 export type TApiSubscriberFunctionBeforeGetManyContext<E extends IApiBaseEntity, Result extends TApiFunctionGetManyProperties<E> = TApiFunctionGetManyProperties<E>, TTransactionExpectation extends EApiFunctionSubscriberTransactionExpectation = EApiFunctionSubscriberTransactionExpectation.SUPPORTS> = IApiSubscriberFunctionExecutionContext<E, Result, TApiSubscriberFunctionExecutionContextData<E, TTransactionExpectation>>;

package/dist/esm/type/class/api/subscriber/function/before/update-context.type.d.ts

@@ -1,6 +1,7 @@
 import { EApiFunctionSubscriberTransactionExpectation } from '../../../../../../enum/decorator/api';
 import { IApiBaseEntity } from '../../../../../../interface/api-base-entity.interface';
 import { IApiSubscriberFunctionExecutionContext } from '../../../../../../interface/class/api/subscriber/function/execution/context';
-import { TApiSubscriberFunctionExecutionContextData } from '../execution/context';
+import { IApiSubscriberFunctionExecutionContextUpdateData } from '../../../../../../interface/class/api/subscriber/function/execution/context/update-data.interface';
+import { TApiSubscriberFunctionTransactionData } from '../transaction/data.type';
 import { TApiFunctionUpdateProperties } from '../../../../../decorator/api/function';
-export type TApiSubscriberFunctionBeforeUpdateContext<E extends IApiBaseEntity, Result extends TApiFunctionUpdateProperties<E> = TApiFunctionUpdateProperties<E>, TTransactionExpectation extends EApiFunctionSubscriberTransactionExpectation = EApiFunctionSubscriberTransactionExpectation.SUPPORTS> = IApiSubscriberFunctionExecutionContext<E, Result, TApiSubscriberFunctionExecutionContextData<E, TTransactionExpectation>>;
+export type TApiSubscriberFunctionBeforeUpdateContext<E extends IApiBaseEntity, Result extends TApiFunctionUpdateProperties<E> = TApiFunctionUpdateProperties<E>, TTransactionExpectation extends EApiFunctionSubscriberTransactionExpectation = EApiFunctionSubscriberTransactionExpectation.SUPPORTS> = IApiSubscriberFunctionExecutionContext<E, Result, IApiSubscriberFunctionExecutionContextUpdateData<E> & TApiSubscriberFunctionTransactionData<TTransactionExpectation>>;

package/dist/esm/type/class/api/subscriber/function/{execution/context/data.type.d.ts → execution-context-data.type.d.ts}

@@ -1,5 +1,5 @@
-import { EApiFunctionSubscriberTransactionExpectation } from '../../../../../../../enum/decorator/api';
-import { IApiBaseEntity } from '../../../../../../../interface/api-base-entity.interface';
-import { IApiSubscriberFunctionExecutionContextData } from '../../../../../../../interface/class/api/subscriber/function/execution/context/data';
-import { TApiSubscriberFunctionTransactionData } from '../../transaction/data.type';
+import { EApiFunctionSubscriberTransactionExpectation } from '../../../../../enum/decorator/api';
+import { IApiBaseEntity } from '../../../../../interface/api-base-entity.interface';
+import { IApiSubscriberFunctionExecutionContextData } from '../../../../../interface/class/api/subscriber/function/execution/context/data.interface';
+import { TApiSubscriberFunctionTransactionData } from './transaction/data.type';
 export type TApiSubscriberFunctionExecutionContextData<E extends IApiBaseEntity, TTransactionExpectation extends EApiFunctionSubscriberTransactionExpectation = EApiFunctionSubscriberTransactionExpectation.SUPPORTS> = IApiSubscriberFunctionExecutionContextData<E> & TApiSubscriberFunctionTransactionData<TTransactionExpectation>;

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

@@ -1,5 +1,5 @@
 export type * from './after';
 export type * from './base';
 export type * from './before';
-export type * from './execution';
+export { type TApiSubscriberFunctionExecutionContextData } from './execution-context-data.type';
 export type * from './transaction';

package/dist/esm/type/class/api/subscriber/function/transaction/data.type.d.ts

@@ -1,6 +1,6 @@
 import { EApiFunctionSubscriberTransactionExpectation } from '../../../../../../enum/decorator/api';
-import { EntityManager } from 'typeorm';
 import { TApiSubscriberFunctionRequiredTransactionExpectation } from './required-expectation.type';
+import { EntityManager } from 'typeorm';
 export type TApiSubscriberFunctionTransactionData<TTransactionExpectation extends EApiFunctionSubscriberTransactionExpectation = EApiFunctionSubscriberTransactionExpectation.SUPPORTS> = [TTransactionExpectation] extends [TApiSubscriberFunctionRequiredTransactionExpectation] ? {
     eventManager: EntityManager;
 } : {

package/dist/esm/type/decorator/api/controller/get-list/index.d.ts

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

package/dist/esm/type/decorator/api/controller/get-list/query/dto-contract.type.d.ts

@@ -0,0 +1,14 @@
+import { EApiControllerRequestTarget, EApiDtoType, EApiRouteType } from '../../../../../../enum/decorator/api';
+import { IApiControllerPropertiesRouteBaseRequestTarget, IApiControllerPropertiesRouteWithDto } from '../../../../../../interface/decorator/api';
+import { Type } from '@nestjs/common';
+export type TApiControllerGetListQueryDtoContract<E> = ({
+    dto: Record<EApiDtoType.QUERY, Type<unknown>>;
+    request?: {
+        [EApiControllerRequestTarget.QUERY]?: {
+            filter?: never;
+            order?: never;
+        } & IApiControllerPropertiesRouteBaseRequestTarget<E>;
+    };
+} | {
+    dto?: Partial<Record<EApiDtoType.QUERY, never>>;
+}) & IApiControllerPropertiesRouteWithDto<E, EApiRouteType.GET_LIST>;

package/dist/esm/type/decorator/api/controller/get-list/query/field/disabled.type.d.ts

@@ -0,0 +1,6 @@
+export type TApiControllerGetListQueryFieldDisabled = {
+    allowedOperations?: never;
+    defaultCondition?: never;
+    isEnabled: false;
+    missingBehavior?: never;
+};

package/dist/esm/type/decorator/api/controller/get-list/query/field/index.d.ts

@@ -0,0 +1 @@
+export { type TApiControllerGetListQueryFieldDisabled } from './disabled.type';

package/dist/esm/type/decorator/api/controller/get-list/query/filter/condition.type.d.ts

@@ -0,0 +1,19 @@
+import { EFilterOperation } from '../../../../../../../enum/filter';
+import { TNonEmptyReadonlyArray } from '../../../../../../utility';
+export type TApiControllerGetListQueryFilterCondition<TValue, TOperation extends `${EFilterOperation}`> = TOperation extends `${EFilterOperation.ISNULL | EFilterOperation.NOTNULL}` ? {
+    operator: TOperation;
+    value?: never;
+    values?: never;
+} : TOperation extends `${EFilterOperation.BETWEEN}` ? {
+    operator: TOperation;
+    value?: never;
+    values: readonly [NonNullable<TValue>, NonNullable<TValue>];
+} : TOperation extends `${EFilterOperation.IN | EFilterOperation.INL | EFilterOperation.NOTIN | EFilterOperation.NOTINL}` ? {
+    operator: TOperation;
+    value?: never;
+    values: TNonEmptyReadonlyArray<NonNullable<TValue>>;
+} : {
+    operator: TOperation;
+    value: NonNullable<TValue>;
+    values?: never;
+};

package/dist/esm/type/decorator/api/controller/get-list/query/filter/field/enabled.type.d.ts

@@ -0,0 +1,15 @@
+import { EApiControllerGetListQueryFilterMissingBehavior } from '../../../../../../../../enum/decorator/api';
+import { TNonEmptyReadonlyArray } from '../../../../../../../utility';
+import { TApiControllerGetListQueryFilterCondition } from '../condition.type';
+import { TApiControllerGetListQueryFilterOperationForValue } from '../operation-for-value.type';
+export type TApiControllerGetListQueryFilterFieldEnabled<TValue> = {
+    allowedOperations: TNonEmptyReadonlyArray<TApiControllerGetListQueryFilterOperationForValue<TValue>>;
+    defaultCondition: TApiControllerGetListQueryFilterCondition<TValue, TApiControllerGetListQueryFilterOperationForValue<TValue>>;
+    isEnabled: true;
+    missingBehavior: EApiControllerGetListQueryFilterMissingBehavior.USE_DEFAULT;
+} | {
+    allowedOperations: TNonEmptyReadonlyArray<TApiControllerGetListQueryFilterOperationForValue<TValue>>;
+    defaultCondition?: never;
+    isEnabled: true;
+    missingBehavior?: EApiControllerGetListQueryFilterMissingBehavior.OMIT | EApiControllerGetListQueryFilterMissingBehavior.REJECT;
+};

package/dist/esm/type/decorator/api/controller/get-list/query/filter/field/index.d.ts

@@ -0,0 +1,3 @@
+export { type TApiControllerGetListQueryFilterFieldEnabled } from './enabled.type';
+export { type TApiControllerGetListQueryFilterFields } from './map.type';
+export { type TApiControllerGetListQueryFilterField } from './type';

package/dist/esm/type/decorator/api/controller/get-list/query/filter/field/map.type.d.ts

@@ -0,0 +1,5 @@
+import { TApiControllerGetListQueryFilterPath, TApiControllerGetListQueryFilterPathValue } from '../../path';
+import { TApiControllerGetListQueryFilterField } from './type';
+export type TApiControllerGetListQueryFilterFields<E> = {
+    [P in TApiControllerGetListQueryFilterPath<E>]?: TApiControllerGetListQueryFilterField<TApiControllerGetListQueryFilterPathValue<E, P>>;
+};

package/dist/esm/type/decorator/api/controller/get-list/query/filter/field/type.d.ts

@@ -0,0 +1,3 @@
+import { TApiControllerGetListQueryFieldDisabled } from '../../field';
+import { TApiControllerGetListQueryFilterFieldEnabled } from './enabled.type';
+export type TApiControllerGetListQueryFilterField<TValue> = TApiControllerGetListQueryFieldDisabled | TApiControllerGetListQueryFilterFieldEnabled<TValue>;

package/dist/esm/type/decorator/api/controller/get-list/query/filter/index.d.ts

@@ -0,0 +1,3 @@
+export { type TApiControllerGetListQueryFilterCondition } from './condition.type';
+export type * from './field';
+export { type TApiControllerGetListQueryFilterOperationForValue } from './operation-for-value.type';

package/dist/esm/type/decorator/api/controller/get-list/query/filter/operation-for-value.type.d.ts

@@ -0,0 +1,2 @@
+import { EFilterOperation, EFilterOperationBoolean, EFilterOperationDate, EFilterOperationEnum, EFilterOperationNumber, EFilterOperationString, EFilterOperationUuid } from '../../../../../../../enum/filter';
+export type TApiControllerGetListQueryFilterOperationForValue<V> = ([NonNullable<V>] extends [boolean] ? Exclude<`${EFilterOperationBoolean}`, `${EFilterOperation.EXCL | EFilterOperation.ISNULL | EFilterOperation.NOTNULL}`> : [NonNullable<V>] extends [Date] ? Exclude<`${EFilterOperationDate}`, `${EFilterOperation.ISNULL | EFilterOperation.NOTNULL}`> : [NonNullable<V>] extends [number] ? Exclude<`${EFilterOperationNumber}`, `${EFilterOperation.ISNULL | EFilterOperation.NOTNULL}`> : [NonNullable<V>] extends [string] ? Exclude<`${EFilterOperationEnum | EFilterOperationString | EFilterOperationUuid}`, `${EFilterOperation.ISNULL | EFilterOperation.NOTNULL}`> : never) | (null extends V ? `${EFilterOperation.ISNULL | EFilterOperation.NOTNULL}` : undefined extends V ? `${EFilterOperation.ISNULL | EFilterOperation.NOTNULL}` : never);

package/dist/esm/type/decorator/api/controller/get-list/query/index.d.ts

@@ -0,0 +1,6 @@
+export { type TApiControllerGetListQueryDtoContract } from './dto-contract.type';
+export type * from './field';
+export type * from './filter';
+export type * from './order';
+export type * from './path';
+export { type TApiControllerGetListQuery } from './type';

package/dist/esm/type/decorator/api/controller/get-list/query/order/field/enabled.type.d.ts

@@ -0,0 +1,6 @@
+export type TApiControllerGetListQueryOrderFieldEnabled = {
+    allowedOperations?: never;
+    defaultCondition?: never;
+    isEnabled: true;
+    missingBehavior?: never;
+};

package/dist/esm/type/decorator/api/controller/get-list/query/order/field/index.d.ts

@@ -0,0 +1,3 @@
+export { type TApiControllerGetListQueryOrderFieldEnabled } from './enabled.type';
+export { type TApiControllerGetListQueryOrderFields } from './map.type';
+export { type TApiControllerGetListQueryOrderField } from './type';

package/dist/esm/type/decorator/api/controller/get-list/query/order/field/map.type.d.ts

@@ -0,0 +1,3 @@
+import { TApiControllerGetListQueryOrderPath } from '../../path';
+import { TApiControllerGetListQueryOrderField } from './type';
+export type TApiControllerGetListQueryOrderFields<E> = Partial<Record<TApiControllerGetListQueryOrderPath<E>, TApiControllerGetListQueryOrderField>>;

package/dist/esm/type/decorator/api/controller/get-list/query/order/field/type.d.ts

@@ -0,0 +1,3 @@
+import { TApiControllerGetListQueryFieldDisabled } from '../../field';
+import { TApiControllerGetListQueryOrderFieldEnabled } from './enabled.type';
+export type TApiControllerGetListQueryOrderField = TApiControllerGetListQueryFieldDisabled | TApiControllerGetListQueryOrderFieldEnabled;

package/dist/esm/type/decorator/api/controller/get-list/query/order/index.d.ts

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

package/dist/esm/type/decorator/api/controller/get-list/query/path/direct-scalar.type.d.ts

@@ -0,0 +1,4 @@
+import { TApiControllerGetListQueryScalarValue } from './scalar-value.type';
+export type TApiControllerGetListQueryDirectScalarPath<E> = {
+    [K in keyof E & string]: NonNullable<E[K]> extends TApiControllerGetListQueryScalarValue ? K : never;
+}[keyof E & string];

package/dist/esm/type/decorator/api/controller/get-list/query/path/filter.type.d.ts

@@ -0,0 +1,3 @@
+import { TApiControllerGetListQueryDirectScalarPath } from './direct-scalar.type';
+import { TApiControllerGetListQueryOneHopToOneScalarPath } from './one-hop-to-one-scalar.type';
+export type TApiControllerGetListQueryFilterPath<E> = TApiControllerGetListQueryDirectScalarPath<E> | TApiControllerGetListQueryOneHopToOneScalarPath<E>;

package/dist/esm/type/decorator/api/controller/get-list/query/path/index.d.ts

@@ -0,0 +1,7 @@
+export { type TApiControllerGetListQueryDirectScalarPath } from './direct-scalar.type';
+export { type TApiControllerGetListQueryFilterPath } from './filter.type';
+export { type TApiControllerGetListQueryOneHopToOneScalarPath } from './one-hop-to-one-scalar.type';
+export { type TApiControllerGetListQueryOrderPath } from './order.type';
+export { type TApiControllerGetListQueryScalarValue } from './scalar-value.type';
+export { type TApiControllerGetListQueryToOneRelation } from './to-one-relation.type';
+export { type TApiControllerGetListQueryFilterPathValue } from './value.type';

package/dist/esm/type/decorator/api/controller/get-list/query/path/one-hop-to-one-scalar.type.d.ts

@@ -0,0 +1,7 @@
+import { TApiControllerGetListQueryScalarValue } from './scalar-value.type';
+import { TApiControllerGetListQueryToOneRelation } from './to-one-relation.type';
+export type TApiControllerGetListQueryOneHopToOneScalarPath<E> = {
+    [K in keyof E & string]: TApiControllerGetListQueryToOneRelation<E[K]> extends infer R ? R extends object ? {
+        [N in keyof R & string]: NonNullable<R[N]> extends TApiControllerGetListQueryScalarValue ? `${K}.${N}` : never;
+    }[keyof R & string] : never : never;
+}[keyof E & string];

package/dist/esm/type/decorator/api/controller/get-list/query/path/order.type.d.ts

@@ -0,0 +1,2 @@
+import { TApiControllerGetListQueryDirectScalarPath } from './direct-scalar.type';
+export type TApiControllerGetListQueryOrderPath<E> = TApiControllerGetListQueryDirectScalarPath<E>;

package/dist/esm/type/decorator/api/controller/get-list/query/path/scalar-value.type.d.ts

@@ -0,0 +1 @@
+export type TApiControllerGetListQueryScalarValue = boolean | Date | number | string;

package/dist/esm/type/decorator/api/controller/get-list/query/path/to-one-relation.type.d.ts

@@ -0,0 +1,2 @@
+import { TApiControllerGetListQueryScalarValue } from './scalar-value.type';
+export type TApiControllerGetListQueryToOneRelation<T> = NonNullable<T> extends ReadonlyArray<unknown> | TApiControllerGetListQueryScalarValue ? never : NonNullable<T> extends object ? NonNullable<T> : never;

package/dist/esm/type/decorator/api/controller/get-list/query/path/value.type.d.ts

@@ -0,0 +1,2 @@
+import { TApiControllerGetListQueryFilterPath } from './filter.type';
+export type TApiControllerGetListQueryFilterPathValue<E, P extends TApiControllerGetListQueryFilterPath<E>> = P extends `${infer R}.${infer N}` ? (R extends keyof E ? (N extends keyof NonNullable<E[R]> & string ? NonNullable<E[R]>[N] : never) : never) : P extends keyof E & string ? E[P] : never;

package/dist/esm/type/decorator/api/controller/{get-list-query.type.d.ts → get-list/query/type.d.ts}

@@ -1,5 +1,5 @@
-import { EFilterOrderDirection } from '../../../../enum/filter';
-import { TFilterKeys } from '../../../utility';
+import { EFilterOrderDirection } from '../../../../../../enum/filter';
+import { TFilterKeys } from '../../../../../utility';
 export type TApiControllerGetListQuery<E> = {
     limit: number;
     orderBy?: keyof E;

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

@@ -1,5 +1,5 @@
 export { type TApiControllerConstructor } from './constructor.type';
-export { type TApiControllerGetListQuery } from './get-list-query.type';
+export type * from './get-list';
 export { type TApiControllerPropertiesRoute } from './properties-route.type';
 export type * from './properties/route';
 export { type TApiControllerTransformerConfig } from './transformer-config.type';

package/dist/esm/type/decorator/api/controller/properties-route.type.d.ts

@@ -1,3 +1,4 @@
 import { EApiRouteType } from '../../../../enum/decorator/api';
 import { IApiControllerPropertiesRouteWithAutoDto, IApiControllerPropertiesRouteWithDto } from '../../../../interface/decorator/api';
-export type TApiControllerPropertiesRoute<E, R extends EApiRouteType> = IApiControllerPropertiesRouteWithAutoDto<E, R> | IApiControllerPropertiesRouteWithDto<E, R>;
+import { TApiControllerGetListQueryDtoContract } from './get-list/query';
+export type TApiControllerPropertiesRoute<E, R extends EApiRouteType> = IApiControllerPropertiesRouteWithAutoDto<E, R> | (R extends EApiRouteType.GET_LIST ? TApiControllerGetListQueryDtoContract<E> : IApiControllerPropertiesRouteWithDto<E, R>);

package/dist/esm/type/decorator/api/route/{custom/dto-properties.type.d.ts → custom-dto-properties.type.d.ts}

@@ -1,7 +1,7 @@
-import { EApiDtoType } from '../../../../../enum/decorator/api';
-import { IApiControllerPropertiesRouteGetListResponseDtoConfig } from '../../../../../interface/decorator/api/controller/properties/route';
+import { EApiDtoType } from '../../../../enum/decorator/api';
+import { IApiControllerPropertiesRouteGetListResponseDtoConfig } from '../../../../interface/decorator/api/controller/properties/route';
 import { Type } from '@nestjs/common';
-import { TApiRouteDiscriminatedDtoProperties } from '../discriminated';
+import { TApiRouteDiscriminatedDtoProperties } from './discriminated-dto-properties.type';
 export type TApiRouteCustomDtoProperties = Partial<{
     [EApiDtoType.BODY]: TApiRouteDiscriminatedDtoProperties | Type<unknown>;
     [EApiDtoType.RESPONSE]: IApiControllerPropertiesRouteGetListResponseDtoConfig | Type<unknown>;

package/dist/{cjs/type/decorator/api/route/discriminated/dto-properties.type.d.ts → esm/type/decorator/api/route/discriminated-dto-properties.type.d.ts}

@@ -1,5 +1,5 @@
 import { Type } from '@nestjs/common';
-import { TTypeDiscriminator } from '../../property';
+import { TTypeDiscriminator } from '../property';
 import { ClassTransformOptions } from 'class-transformer';
 import { ValidatorOptions } from 'class-validator';
 export type TApiRouteDiscriminatedDtoProperties = {

package/dist/esm/type/decorator/api/route/index.d.ts

@@ -1,2 +1,2 @@
-export type * from './custom';
-export type * from './discriminated';
+export { type TApiRouteCustomDtoProperties } from './custom-dto-properties.type';
+export { type TApiRouteDiscriminatedDtoProperties } from './discriminated-dto-properties.type';

package/dist/{cjs/type/utility/api/discriminator/validate/config-properties.type.d.ts → esm/type/utility/api/discriminator-validate-config-properties.type.d.ts}

@@ -1,5 +1,5 @@
 import { Type } from '@nestjs/common';
-import { TTypeDiscriminator } from '../../../../decorator/api/property';
+import { TTypeDiscriminator } from '../../decorator/api/property';
 export type TApiDiscriminatorValidateConfigProperties = {
     context: string;
     discriminator: TTypeDiscriminator;

package/dist/esm/type/utility/api/get-default-string-format-properties/bigint-string/index.d.ts

@@ -1,2 +1,2 @@
 export { type TApiGetDefaultStringFormatPropertiesBigIntStringOptions } from './options.type';
-export type * from './sign';
+export { type TApiGetDefaultStringFormatPropertiesBigIntStringSignProperties } from './sign-properties.type';

package/dist/esm/type/utility/api/get-default-string-format-properties/bigint-string/options.type.d.ts

@@ -1,4 +1,4 @@
-import { TApiGetDefaultStringFormatPropertiesBigIntStringSign } from './sign';
+import { EApiGetDefaultStringFormatPropertiesBigIntStringSign } from '../../../../../enum/utility/get-default-string-format-properties-bigint-string-sign.enum';
 export type TApiGetDefaultStringFormatPropertiesBigIntStringOptions = {
-    sign?: TApiGetDefaultStringFormatPropertiesBigIntStringSign;
+    sign?: EApiGetDefaultStringFormatPropertiesBigIntStringSign;
 };

package/dist/esm/type/utility/api/get-default-string-format-properties/bigint-string/{sign/properties.type.d.ts → sign-properties.type.d.ts}

@@ -1,2 +1,2 @@
-import { TApiPropertyDefaultStringFormatProperties } from '../../../../../decorator/api/property';
+import { TApiPropertyDefaultStringFormatProperties } from '../../../../decorator/api/property';
 export type TApiGetDefaultStringFormatPropertiesBigIntStringSignProperties = Pick<TApiPropertyDefaultStringFormatProperties, "description" | "exampleValue" | "maxLength" | "minLength" | "pattern">;

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

@@ -1,3 +1,3 @@
 export type * from './controller';
-export type * from './discriminator';
+export { type TApiDiscriminatorValidateConfigProperties } from './discriminator-validate-config-properties.type';
 export type * from './get-default-string-format-properties';

package/dist/esm/type/utility/dto/index.d.ts

@@ -1,2 +1,2 @@
 export type * from './generate';
-export { type TManualDtoPropertyMetadata } from './manual/property-metadata.type';
+export { type TManualDtoPropertyMetadata } from './manual-property-metadata.type';

package/dist/esm/type/utility/dto/{manual/property-metadata.type.d.ts → manual-property-metadata.type.d.ts}

@@ -1,5 +1,5 @@
-import { EManualDtoPropertyMetadataDecorator } from '../../../../enum/utility/dto/manual/property-metadata/decorator.enum';
-import { TApiPropertyBaseProperties, TApiPropertyDateProperties, TApiPropertyEnumProperties, TApiPropertyNumberProperties, TApiPropertyObjectProperties, TApiPropertyStringProperties, TApiPropertyUuidProperties } from '../../../decorator/api/property';
+import { EManualDtoPropertyMetadataDecorator } from '../../../enum/utility/manual-dto-property-metadata-decorator.enum';
+import { TApiPropertyBaseProperties, TApiPropertyDateProperties, TApiPropertyEnumProperties, TApiPropertyNumberProperties, TApiPropertyObjectProperties, TApiPropertyStringProperties, TApiPropertyUuidProperties } from '../../decorator/api/property';
 export type TManualDtoPropertyMetadata = {
     apply: PropertyDecorator;
     decorator: EManualDtoPropertyMetadataDecorator.BOOLEAN;

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

@@ -5,3 +5,4 @@ export type * from './dto';
 export type * from './error-string';
 export { type TFilterKeys } from './filter-keys.type';
 export { type TNonDateKeys } from './non-date-keys.type';
+export { type TNonEmptyReadonlyArray } from './non-empty-readonly-array.type';

package/dist/esm/type/utility/non-empty-readonly-array.type.d.ts

@@ -0,0 +1 @@
+export type TNonEmptyReadonlyArray<T> = readonly [T, ...Array<T>];

package/dist/esm/type/validator/has-paired-custom-suffixes-fields/index.d.ts

@@ -1,2 +1 @@
-export { type THasPairedCustomSuffixesFieldsOperationConfig } from './operation-config.type';
 export { type THasPairedCustomSuffixesFieldsValidationContext } from './validation-context.type';

package/dist/esm/utility/api/controller/apply/decorators.utility.d.ts

@@ -1,4 +1,5 @@
 import { IApiBaseEntity } from '../../../../interface/api-base-entity.interface';
+import { IApiControllerGetListQueryPlan } from '../../../../interface/class/api/controller/get-list/query';
 import { IApiControllerProperties } from '../../../../interface/decorator/api';
 import { IApiEntity } from '../../../../interface/entity';
 import { TApiControllerPropertiesRoute } from '../../../../type/decorator/api/controller';
@@ -14,8 +15,9 @@ import { EApiRouteType } from '../../../../enum/decorator/api';
  * @param {string} methodName - The name of the method being decorated
  * @param {TApiControllerPropertiesRoute<E, typeof method>} routeConfig - Route-specific configuration
  * @param {Array<MethodDecorator> | Array<PropertyDecorator>} decorators - Additional decorators to apply
+ * @param {IApiControllerGetListQueryPlan} [queryPlan] - Normalized GET_LIST query plan used to emit deep-object filter documentation.
  * @returns {void}
  * @throws {Error} If the method type is not implemented
  * @template E - The entity type
  */
-export declare function ApiControllerApplyDecorators<E extends IApiBaseEntity>(targetMethod: TApiControllerMethodMap<E>[typeof method], entity: IApiEntity<E>, properties: IApiControllerProperties<E>, method: EApiRouteType, methodName: string, routeConfig: TApiControllerPropertiesRoute<E, typeof method>, decorators: Array<MethodDecorator> | Array<PropertyDecorator>): void;
+export declare function ApiControllerApplyDecorators<E extends IApiBaseEntity>(targetMethod: TApiControllerMethodMap<E>[typeof method], entity: IApiEntity<E>, properties: IApiControllerProperties<E>, method: EApiRouteType, methodName: string, routeConfig: TApiControllerPropertiesRoute<E, typeof method>, decorators: Array<MethodDecorator> | Array<PropertyDecorator>, queryPlan?: IApiControllerGetListQueryPlan): void;

package/dist/esm/utility/api/controller/apply/decorators.utility.js

@@ -1,13 +1,21 @@
 import { ApiMethod } from '../../../../decorator/api/method.decorator.js';
 import '../../../../enum/decorator/api/action.enum.js';
 import '../../../../enum/decorator/api/authentication-type.enum.js';
+import '../../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js';
+import '../../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js';
 import '../../../../enum/decorator/api/controller/relation-reference-shape.enum.js';
 import '../../../../enum/decorator/api/controller/request/target.enum.js';
 import '../../../../enum/decorator/api/controller/request/transformer-type.enum.js';
 import '../../../../enum/decorator/api/controller/response-target.enum.js';
 import { EApiDtoType } from '../../../../enum/decorator/api/dto-type.enum.js';
+import '../../../../enum/decorator/api/function/context-storage-kind.enum.js';
 import '../../../../enum/decorator/api/function/subscriber-transaction-expectation.enum.js';
-import '../../../../enum/decorator/api/function/transaction-mode.enum.js';
+import '../../../../enum/decorator/api/function/transaction/event-status.enum.js';
+import '../../../../enum/decorator/api/function/transaction/failure-stage.enum.js';
+import '../../../../enum/decorator/api/function/transaction/mode.enum.js';
+import '../../../../enum/decorator/api/function/transaction/outcome.enum.js';
+import '../../../../enum/decorator/api/function/transaction/owner-kind.enum.js';
+import '../../../../enum/decorator/api/function/transaction/trace-type.enum.js';
 import '../../../../enum/decorator/api/function/type.enum.js';
 import '../../../../enum/decorator/api/on-type.enum.js';
 import '../../../../enum/decorator/api/property/data-type.enum.js';
@@ -20,8 +28,10 @@ import '../../../../enum/decorator/api/route/subscriber-authorization-expectatio
 import { EApiRouteType } from '../../../../enum/decorator/api/route/type.enum.js';
 import { HttpStatus, RequestMethod } from '@nestjs/common';
 import { ApiControllerBuildRouteDocumentation } from '../build-route-documentation.utility.js';
-import { ApiControllerGetDto } from '../get/dto.utility.js';
+import { ApiControllerGetListQueryOpenApiDecorators } from '../get-list/query/open-api/decorators.utility.js';
 import { ErrorException } from '../../../error/exception.utility.js';
+import '../../../../constant/decorator/api/function.constant.js';
+import { ApiControllerGetDto } from '../get/dto.utility.js';
 
 /**
  * Applies appropriate decorators to controller methods based on the route type.
@@ -33,11 +43,12 @@ import { ErrorException } from '../../../error/exception.utility.js';
  * @param {string} methodName - The name of the method being decorated
  * @param {TApiControllerPropertiesRoute<E, typeof method>} routeConfig - Route-specific configuration
  * @param {Array<MethodDecorator> | Array<PropertyDecorator>} decorators - Additional decorators to apply
+ * @param {IApiControllerGetListQueryPlan} [queryPlan] - Normalized GET_LIST query plan used to emit deep-object filter documentation.
  * @returns {void}
  * @throws {Error} If the method type is not implemented
  * @template E - The entity type
  */
-function ApiControllerApplyDecorators(targetMethod, entity, properties, method, methodName, routeConfig, decorators) {
+function ApiControllerApplyDecorators(targetMethod, entity, properties, method, methodName, routeConfig, decorators, queryPlan) {
     const responseDto = ApiControllerGetDto(properties, entity, method, EApiDtoType.RESPONSE, routeConfig);
     const customDecorators = [...decorators];
     switch (method) {
@@ -56,6 +67,9 @@ function ApiControllerApplyDecorators(targetMethod, entity, properties, method,
             break;
         }
         case EApiRouteType.GET_LIST: {
+            if (queryPlan) {
+                customDecorators.push(...ApiControllerGetListQueryOpenApiDecorators(queryPlan));
+            }
             customDecorators.push(ApiMethod({
                 metadata: createRouteMetadata(properties, routeConfig, method, RequestMethod.GET, "", HttpStatus.OK, responseDto, { hasInternalServerError: true, hasNotFound: true, hasUnauthorized: true }),
             }));

package/dist/esm/utility/api/controller/apply/decorators.utility.js.map

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

package/dist/esm/utility/api/controller/apply/metadata.utility.d.ts

@@ -1,5 +1,6 @@
 import { EApiRouteType } from '../../../../enum/decorator/api';
 import { IApiBaseEntity } from '../../../../interface/api-base-entity.interface';
+import { IApiControllerGetListQueryPlan } from '../../../../interface/class/api/controller/get-list/query';
 import { IApiControllerProperties } from '../../../../interface/decorator/api';
 import { IApiEntity } from '../../../../interface/entity';
 import { TApiControllerPropertiesRoute } from '../../../../type/decorator/api/controller';
@@ -13,7 +14,8 @@ import { TApiControllerPropertiesRoute } from '../../../../type/decorator/api/co
  * @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
+ * @param {IApiControllerGetListQueryPlan} [queryPlan] - Normalized plan used to resolve the route-scoped dynamic QUERY DTO.
  * @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;
+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>, queryPlan?: IApiControllerGetListQueryPlan): void;