@elsikora/nestjs-crud-automator 2.3.0 → 2.4.0

package/dist/esm/decorator/api/service/decorator.js

@@ -1,3 +1,4 @@
+import { ApiServiceBase } from '../../../class/api/service-base.class.js';
 import '../../../class/api/function/context-storage.class.js';
 import '../../../class/api/subscriber/executor.class.js';
 import '../../../enum/decorator/api/action.enum.js';
@@ -36,7 +37,7 @@ import { ApiFunction } from '../function/decorator.js';
  * @see {@link https://elsikora.com/docs/nestjs-crud-automator/core-concepts/services | Core Concepts - Services}
  */
 function ApiService(properties) {
-    const { entity } = properties;
+    const { entity, functions } = properties;
     // eslint-disable-next-line @elsikora/typescript/no-explicit-any
     return function (target) {
         const originalConstructor = target;
@@ -46,7 +47,7 @@ function ApiService(properties) {
             constructor(..._arguments) {
                 // eslint-disable-next-line @elsikora/typescript/no-unsafe-argument
                 super(..._arguments);
-                if (!Object.prototype.hasOwnProperty.call(this, EApiFunctionType.GET_LIST)) {
+                if (ApiServiceShouldDefineFunction(this, originalConstructor.prototype, EApiFunctionType.GET_LIST)) {
                     Object.defineProperty(this, EApiFunctionType.GET_LIST, {
                         // eslint-disable-next-line @elsikora/typescript/naming-convention
                         configurable: true,
@@ -55,6 +56,7 @@ function ApiService(properties) {
                         value: async function (properties) {
                             const apiFunctionDecorator = ApiFunction({
                                 entity,
+                                transaction: functions?.[EApiFunctionType.GET_LIST]?.transaction,
                                 type: EApiFunctionType.GET_LIST,
                             });
                             const descriptor = {
@@ -74,7 +76,7 @@ function ApiService(properties) {
                         writable: true,
                     });
                 }
-                if (!Object.prototype.hasOwnProperty.call(this, EApiFunctionType.GET)) {
+                if (ApiServiceShouldDefineFunction(this, originalConstructor.prototype, EApiFunctionType.GET)) {
                     Object.defineProperty(this, EApiFunctionType.GET, {
                         // eslint-disable-next-line @elsikora/typescript/naming-convention
                         configurable: true,
@@ -83,6 +85,7 @@ function ApiService(properties) {
                         value: async function (properties) {
                             const apiFunctionDecorator = ApiFunction({
                                 entity,
+                                transaction: functions?.[EApiFunctionType.GET]?.transaction,
                                 type: EApiFunctionType.GET,
                             });
                             const descriptor = {
@@ -102,7 +105,7 @@ function ApiService(properties) {
                         writable: true,
                     });
                 }
-                if (!Object.prototype.hasOwnProperty.call(this, EApiFunctionType.GET_MANY)) {
+                if (ApiServiceShouldDefineFunction(this, originalConstructor.prototype, EApiFunctionType.GET_MANY)) {
                     Object.defineProperty(this, EApiFunctionType.GET_MANY, {
                         // eslint-disable-next-line @elsikora/typescript/naming-convention
                         configurable: true,
@@ -111,6 +114,7 @@ function ApiService(properties) {
                         value: async function (properties) {
                             const apiFunctionDecorator = ApiFunction({
                                 entity,
+                                transaction: functions?.[EApiFunctionType.GET_MANY]?.transaction,
                                 type: EApiFunctionType.GET_MANY,
                             });
                             const descriptor = {
@@ -130,7 +134,7 @@ function ApiService(properties) {
                         writable: true,
                     });
                 }
-                if (!Object.prototype.hasOwnProperty.call(this, EApiFunctionType.CREATE)) {
+                if (ApiServiceShouldDefineFunction(this, originalConstructor.prototype, EApiFunctionType.CREATE)) {
                     Object.defineProperty(this, EApiFunctionType.CREATE, {
                         // eslint-disable-next-line @elsikora/typescript/naming-convention
                         configurable: true,
@@ -139,6 +143,7 @@ function ApiService(properties) {
                         value: async function (properties) {
                             const apiFunctionDecorator = ApiFunction({
                                 entity,
+                                transaction: functions?.[EApiFunctionType.CREATE]?.transaction,
                                 type: EApiFunctionType.CREATE,
                             });
                             const descriptor = {
@@ -158,7 +163,7 @@ function ApiService(properties) {
                         writable: true,
                     });
                 }
-                if (!Object.prototype.hasOwnProperty.call(this, EApiFunctionType.UPDATE)) {
+                if (ApiServiceShouldDefineFunction(this, originalConstructor.prototype, EApiFunctionType.UPDATE)) {
                     Object.defineProperty(this, EApiFunctionType.UPDATE, {
                         // eslint-disable-next-line @elsikora/typescript/naming-convention
                         configurable: true,
@@ -167,6 +172,7 @@ function ApiService(properties) {
                         value: async function (criteria, properties) {
                             const apiFunctionDecorator = ApiFunction({
                                 entity,
+                                transaction: functions?.[EApiFunctionType.UPDATE]?.transaction,
                                 type: EApiFunctionType.UPDATE,
                             });
                             const descriptor = {
@@ -186,7 +192,7 @@ function ApiService(properties) {
                         writable: true,
                     });
                 }
-                if (!Object.prototype.hasOwnProperty.call(this, EApiFunctionType.DELETE)) {
+                if (ApiServiceShouldDefineFunction(this, originalConstructor.prototype, EApiFunctionType.DELETE)) {
                     Object.defineProperty(this, EApiFunctionType.DELETE, {
                         // eslint-disable-next-line @elsikora/typescript/naming-convention
                         configurable: true,
@@ -195,6 +201,7 @@ function ApiService(properties) {
                         value: async function (criteria) {
                             const apiFunctionDecorator = ApiFunction({
                                 entity,
+                                transaction: functions?.[EApiFunctionType.DELETE]?.transaction,
                                 type: EApiFunctionType.DELETE,
                             });
                             const descriptor = {
@@ -208,7 +215,7 @@ function ApiService(properties) {
                                 writable: true,
                             };
                             const decoratedDescriptor = apiFunctionDecorator(this, EApiFunctionType.DELETE, descriptor);
-                            return decoratedDescriptor.value.call(this, criteria);
+                            await decoratedDescriptor.value.call(this, criteria);
                         },
                         // eslint-disable-next-line @elsikora/typescript/naming-convention
                         writable: true,
@@ -220,6 +227,26 @@ function ApiService(properties) {
         return ExtendedClass;
     };
 }
+/**
+ * Checks whether ApiService should define a generated function on the instance.
+ * @param {unknown} instance - Service instance after constructor field initializers ran.
+ * @param {unknown} prototype - Original service prototype.
+ * @param {EApiFunctionType} functionName - Generated function name.
+ * @returns {boolean} True when no direct implementation exists.
+ */
+function ApiServiceShouldDefineFunction(instance, prototype, functionName) {
+    if (Object.prototype.hasOwnProperty.call(instance, functionName)) {
+        return false;
+    }
+    let currentPrototype = typeof prototype === "object" && prototype !== null ? prototype : null;
+    while (currentPrototype && currentPrototype !== Object.prototype) {
+        if (Object.prototype.hasOwnProperty.call(currentPrototype, functionName)) {
+            return currentPrototype === ApiServiceBase.prototype;
+        }
+        currentPrototype = Object.getPrototypeOf(currentPrototype);
+    }
+    return true;
+}
 
 export { ApiService };
 //# sourceMappingURL=decorator.js.map

package/dist/esm/decorator/api/service/decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"decorator.js","sources":["../../../../../../src/decorator/api/service/decorator.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"decorator.js","sources":["../../../../../../src/decorator/api/service/decorator.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AASA;;;;;;;AAOG;AACG,SAAU,UAAU,CAA2B,UAAoC,EAAA;AACxF,IAAA,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAA6B,UAAU;;AAGlE,IAAA,OAAO,UAAuE,MAAiB,EAAA;QAC9F,MAAM,mBAAmB,GAAc,MAAM;;AAG7C,QAAA,MAAM,aAAa,GAAmE,cAAc,mBAAmB,CAAA;;AAEtH,YAAA,WAAA,CAAY,GAAG,UAAsB,EAAA;;AAEpC,gBAAA,KAAK,CAAC,GAAG,UAAU,CAAC;AAEpB,gBAAA,IAAI,8BAA8B,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EAAE;oBACnG,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,gBAAgB,CAAC,QAAQ,EAAE;;AAEtD,wBAAA,YAAY,EAAE,IAAI;;AAElB,wBAAA,UAAU,EAAE,IAAI;wBAChB,KAAK,EAAE,gBAAgB,UAA4C,EAAA;4BAClE,MAAM,oBAAoB,GAAmG,WAAW,CAAC;gCACxI,MAAM;gCACN,WAAW,EAAE,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,EAAE,WAAW;gCAChE,IAAI,EAAE,gBAAgB,CAAC,QAAQ;AAC/B,6BAAA,CAAC;AAEF,4BAAA,MAAM,UAAU,GAQZ;;AAEH,gCAAA,YAAY,EAAE,IAAI;;AAElB,gCAAA,UAAU,EAAE,IAAI;;AAEhB,gCAAA,KAAK,EAAE,MAAM,MAAM;;AAEnB,gCAAA,QAAQ,EAAE,IAAI;6BACd;AAED,4BAAA,MAAM,mBAAmB,GAAuB,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,CAAC,QAAQ,EAAE,UAAU,CAAC;4BAEjH,OAAQ,mBAAmB,CAAC,KAAgH,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC;wBACpK,CAAC;;AAED,wBAAA,QAAQ,EAAE,IAAI;AACd,qBAAA,CAAC;gBACH;AAEA,gBAAA,IAAI,8BAA8B,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,CAAC,GAAG,CAAC,EAAE;oBAC9F,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,gBAAgB,CAAC,GAAG,EAAE;;AAEjD,wBAAA,YAAY,EAAE,IAAI;;AAElB,wBAAA,UAAU,EAAE,IAAI;wBAChB,KAAK,EAAE,gBAAgB,UAAwC,EAAA;4BAC9D,MAAM,oBAAoB,GAAkG,WAAW,CAAC;gCACvI,MAAM;gCACN,WAAW,EAAE,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,EAAE,WAAW;gCAC3D,IAAI,EAAE,gBAAgB,CAAC,GAAG;AAC1B,6BAAA,CAAC;AAEF,4BAAA,MAAM,UAAU,GAQZ;;AAEH,gCAAA,YAAY,EAAE,IAAI;;AAElB,gCAAA,UAAU,EAAE,IAAI;;AAEhB,gCAAA,KAAK,EAAE,MAAM,MAAM;;AAEnB,gCAAA,QAAQ,EAAE,IAAI;6BACd;AAED,4BAAA,MAAM,mBAAmB,GAAuB,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,CAAC,GAAG,EAAE,UAAU,CAAC;4BAE5G,OAAQ,mBAAmB,CAAC,KAAiF,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC;wBACrI,CAAC;;AAED,wBAAA,QAAQ,EAAE,IAAI;AACd,qBAAA,CAAC;gBACH;AAEA,gBAAA,IAAI,8BAA8B,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EAAE;oBACnG,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,gBAAgB,CAAC,QAAQ,EAAE;;AAEtD,wBAAA,YAAY,EAAE,IAAI;;AAElB,wBAAA,UAAU,EAAE,IAAI;wBAChB,KAAK,EAAE,gBAAgB,UAA4C,EAAA;4BAClE,MAAM,oBAAoB,GAAkG,WAAW,CAAC;gCACvI,MAAM;gCACN,WAAW,EAAE,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,EAAE,WAAW;gCAChE,IAAI,EAAE,gBAAgB,CAAC,QAAQ;AAC/B,6BAAA,CAAC;AAEF,4BAAA,MAAM,UAAU,GAQZ;;AAEH,gCAAA,YAAY,EAAE,IAAI;;AAElB,gCAAA,UAAU,EAAE,IAAI;;AAEhB,gCAAA,KAAK,EAAE,MAAM,MAAM;;AAEnB,gCAAA,QAAQ,EAAE,IAAI;6BACd;AAED,4BAAA,MAAM,mBAAmB,GAAuB,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,CAAC,QAAQ,EAAE,UAAU,CAAC;4BAEjH,OAAQ,mBAAmB,CAAC,KAA4F,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC;wBAChJ,CAAC;;AAED,wBAAA,QAAQ,EAAE,IAAI;AACd,qBAAA,CAAC;gBACH;AAEA,gBAAA,IAAI,8BAA8B,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAAE;oBACjG,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,gBAAgB,CAAC,MAAM,EAAE;;AAEpD,wBAAA,YAAY,EAAE,IAAI;;AAElB,wBAAA,UAAU,EAAE,IAAI;wBAChB,KAAK,EAAE,gBAAgB,UAA2C,EAAA;4BACjE,MAAM,oBAAoB,GAAkG,WAAW,CAAC;gCACvI,MAAM;gCACN,WAAW,EAAE,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,EAAE,WAAW;gCAC9D,IAAI,EAAE,gBAAgB,CAAC,MAAM;AAC7B,6BAAA,CAAC;AAEF,4BAAA,MAAM,UAAU,GAQZ;;AAEH,gCAAA,YAAY,EAAE,IAAI;;AAElB,gCAAA,UAAU,EAAE,IAAI;;AAEhB,gCAAA,KAAK,EAAE,MAAM,MAAM;;AAEnB,gCAAA,QAAQ,EAAE,IAAI;6BACd;AAED,4BAAA,MAAM,mBAAmB,GAAuB,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,CAAC,MAAM,EAAE,UAAU,CAAC;4BAE/G,OAAQ,mBAAmB,CAAC,KAAoF,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC;wBACxI,CAAC;;AAED,wBAAA,QAAQ,EAAE,IAAI;AACd,qBAAA,CAAC;gBACH;AAEA,gBAAA,IAAI,8BAA8B,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAAE;oBACjG,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,gBAAgB,CAAC,MAAM,EAAE;;AAEpD,wBAAA,YAAY,EAAE,IAAI;;AAElB,wBAAA,UAAU,EAAE,IAAI;AAChB,wBAAA,KAAK,EAAE,gBAAgB,QAAuC,EAAE,UAA2C,EAAA;4BAC1G,MAAM,oBAAoB,GAAkG,WAAW,CAAC;gCACvI,MAAM;gCACN,WAAW,EAAE,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,EAAE,WAAW;gCAC9D,IAAI,EAAE,gBAAgB,CAAC,MAAM;AAC7B,6BAAA,CAAC;AAEF,4BAAA,MAAM,UAAU,GAQZ;;AAEH,gCAAA,YAAY,EAAE,IAAI;;AAElB,gCAAA,UAAU,EAAE,IAAI;;AAEhB,gCAAA,KAAK,EAAE,MAAM,MAAM;;AAEnB,gCAAA,QAAQ,EAAE,IAAI;6BACd;AAED,4BAAA,MAAM,mBAAmB,GAAuB,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,CAAC,MAAM,EAAE,UAAU,CAAC;AAE/G,4BAAA,OAAQ,mBAAmB,CAAC,KAA6H,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC;wBAC3L,CAAC;;AAED,wBAAA,QAAQ,EAAE,IAAI;AACd,qBAAA,CAAC;gBACH;AAEA,gBAAA,IAAI,8BAA8B,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAAE;oBACjG,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,gBAAgB,CAAC,MAAM,EAAE;;AAEpD,wBAAA,YAAY,EAAE,IAAI;;AAElB,wBAAA,UAAU,EAAE,IAAI;wBAChB,KAAK,EAAE,gBAAgB,QAAuC,EAAA;4BAC7D,MAAM,oBAAoB,GAAkG,WAAW,CAAC;gCACvI,MAAM;gCACN,WAAW,EAAE,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,EAAE,WAAW;gCAC9D,IAAI,EAAE,gBAAgB,CAAC,MAAM;AAC7B,6BAAA,CAAC;AAEF,4BAAA,MAAM,UAAU,GAQZ;;AAEH,gCAAA,YAAY,EAAE,IAAI;;AAElB,gCAAA,UAAU,EAAE,IAAI;;AAEhB,gCAAA,KAAK,EAAE,MAAM,MAAM;;AAEnB,gCAAA,QAAQ,EAAE,IAAI;6BACd;AAED,4BAAA,MAAM,mBAAmB,GAAuB,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,CAAC,MAAM,EAAE,UAAU,CAAC;4BAE/G,MAAO,mBAAmB,CAAC,KAAsF,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;wBACvI,CAAC;;AAED,wBAAA,QAAQ,EAAE,IAAI;AACd,qBAAA,CAAC;gBACH;YACD;SACA;AAED,QAAA,MAAM,CAAC,cAAc,CAAC,aAAa,EAAE,mBAAmB,CAAC;AAEzD,QAAA,OAAO,aAA0B;AAClC,IAAA,CAAC;AACF;AAEA;;;;;;AAMG;AACH,SAAS,8BAA8B,CAAC,QAAiB,EAAE,SAAkB,EAAE,YAA8B,EAAA;AAC5G,IAAA,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,EAAE;AACjE,QAAA,OAAO,KAAK;IACb;AAEA,IAAA,IAAI,gBAAgB,GAAkB,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,GAAG,SAAS,GAAG,IAAI;IAE5G,OAAO,gBAAgB,IAAI,gBAAgB,KAAK,MAAM,CAAC,SAAS,EAAE;AACjE,QAAA,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAC,EAAE;AACzE,YAAA,OAAO,gBAAgB,KAAK,cAAc,CAAC,SAAS;QACrD;AAEA,QAAA,gBAAgB,GAAG,MAAM,CAAC,cAAc,CAAC,gBAAgB,CAAkB;IAC5E;AAEA,IAAA,OAAO,IAAI;AACZ;;;;"}

package/dist/esm/type/decorator/api/service/function/index.d.ts

@@ -0,0 +1,2 @@
+export { type TApiServiceFunctionPropertiesMap } from './map.type';
+export { type TApiServiceFunctionProperties } from './properties.type';

package/dist/esm/type/decorator/api/service/function/map.type.d.ts

@@ -0,0 +1,5 @@
+import { EApiFunctionType } from '../../../../../enum/decorator/api';
+import { TApiServiceFunctionProperties } from './properties.type';
+export type TApiServiceFunctionPropertiesMap = {
+    [EApiFunctionType.CUSTOM]?: never;
+} & Partial<Record<Exclude<EApiFunctionType, EApiFunctionType.CUSTOM>, TApiServiceFunctionProperties>>;

package/dist/esm/type/decorator/api/service/function/properties.type.d.ts

@@ -0,0 +1,6 @@
+import { EApiFunctionTransactionMode } from '../../../../../enum/decorator/api';
+export type TApiServiceFunctionProperties = {
+    transaction: {
+        mode: EApiFunctionTransactionMode;
+    };
+};

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

@@ -1,2 +1,3 @@
+export type * from './function';
 export { type TApiServiceKeys } from './keys.type';
 export { type TApiServiceProperties } from './properties.type';

package/dist/esm/type/decorator/api/service/properties.type.d.ts

@@ -1,3 +1,5 @@
+import { TApiServiceFunctionPropertiesMap } from './function';
 export type TApiServiceProperties<E> = {
     entity: new () => E;
+    functions?: TApiServiceFunctionPropertiesMap;
 };

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

@@ -1,4 +1,6 @@
 import { IApiEntity } from '../../../../../interface/entity';
+import { Type } from '@nestjs/common';
+import { IAuthGuard } from '@nestjs/passport';
 import { FindOptionsWhere } from '../../../../../../node_modules/typeorm/index';
 /**
  * Transforms query parameters into TypeORM FindOptionsWhere filter objects.
@@ -6,7 +8,8 @@ import { FindOptionsWhere } from '../../../../../../node_modules/typeorm/index';
  * Handles special cases for relation properties.
  * @param {Record<string, unknown>} query - The query parameters from the HTTP request
  * @param {IApiEntity<E>} entityMetadata - The entity metadata containing column information
+ * @param {Type<IAuthGuard>} currentGuard - Optional guard used to mirror generated query DTO visibility.
  * @returns {FindOptionsWhere<E>} The TypeORM filter object for the query
  * @template E - The entity type
  */
-export declare function ApiControllerGetListTransformFilter<E>(query: Record<string, unknown>, entityMetadata: IApiEntity<E>): FindOptionsWhere<E>;
+export declare function ApiControllerGetListTransformFilter<E>(query: Record<string, unknown>, entityMetadata: IApiEntity<E>, currentGuard?: Type<IAuthGuard>): FindOptionsWhere<E>;

package/dist/esm/utility/api/controller/get-list/transform/filter.utility.js

@@ -7,7 +7,7 @@ import '../../../../../enum/decorator/api/controller/relation-reference-shape.en
 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 '../../../../../enum/decorator/api/dto-type.enum.js';
+import { EApiDtoType } from '../../../../../enum/decorator/api/dto-type.enum.js';
 import '../../../../../enum/decorator/api/function-transaction-mode.enum.js';
 import '../../../../../enum/decorator/api/function-type.enum.js';
 import '../../../../../enum/decorator/api/on-type.enum.js';
@@ -17,7 +17,8 @@ import '../../../../../enum/decorator/api/property/date/type.enum.js';
 import { EApiPropertyDescribeType } from '../../../../../enum/decorator/api/property/desribe-type.enum.js';
 import '../../../../../enum/decorator/api/property/number-type.enum.js';
 import '../../../../../enum/decorator/api/property/string-type.enum.js';
-import '../../../../../enum/decorator/api/route-type.enum.js';
+import { EApiRouteType } from '../../../../../enum/decorator/api/route-type.enum.js';
+import { DtoIsPropertyShouldBeMarked } from '../../../../dto/is/property/should-be-marked.utility.js';
 import { GenerateEntityInformation } from '../../../../generate-entity-information.utility.js';
 import { ApiControllerGetListTransformOperation } from './operation.utility.js';
 
@@ -27,10 +28,11 @@ import { ApiControllerGetListTransformOperation } from './operation.utility.js';
  * Handles special cases for relation properties.
  * @param {Record<string, unknown>} query - The query parameters from the HTTP request
  * @param {IApiEntity<E>} entityMetadata - The entity metadata containing column information
+ * @param {Type<IAuthGuard>} currentGuard - Optional guard used to mirror generated query DTO visibility.
  * @returns {FindOptionsWhere<E>} The TypeORM filter object for the query
  * @template E - The entity type
  */
-function ApiControllerGetListTransformFilter(query, entityMetadata) {
+function ApiControllerGetListTransformFilter(query, entityMetadata, currentGuard) {
     const filter = {};
     const filterRecord = filter;
     for (const fullKey of Object.keys(query)) {
@@ -49,7 +51,7 @@ function ApiControllerGetListTransformFilter(query, entityMetadata) {
             if (path.length === 1) {
                 const column = entityMetadata.columns.find((column) => column.name == key);
                 const columnMetadata = column?.metadata?.[PROPERTY_DESCRIBE_DECORATOR_API_CONSTANT.METADATA_KEY];
-                if (!columnMetadata || columnMetadata.type === EApiPropertyDescribeType.RELATION)
+                if (!column || !columnMetadata || !DtoIsPropertyShouldBeMarked(EApiRouteType.GET_LIST, EApiDtoType.QUERY, key, columnMetadata, column.isPrimary, currentGuard) || columnMetadata.type === EApiPropertyDescribeType.RELATION)
                     continue;
                 filterRecord[key] = ApiControllerGetListTransformOperation(operation, value);
             }
@@ -62,7 +64,7 @@ function ApiControllerGetListTransformFilter(query, entityMetadata) {
                     continue;
                 const relationColumn = entityMetadata.columns.find((column) => column.name == relationName);
                 const relationMetadata = relationColumn?.metadata?.[PROPERTY_DESCRIBE_DECORATOR_API_CONSTANT.METADATA_KEY];
-                if (relationMetadata?.type !== EApiPropertyDescribeType.RELATION || !relationColumn?.relation?.target)
+                if (!relationColumn || relationMetadata?.type !== EApiPropertyDescribeType.RELATION || !relationColumn.relation?.target || !DtoIsPropertyShouldBeMarked(EApiRouteType.GET_LIST, EApiDtoType.QUERY, relationName, relationMetadata, relationColumn.isPrimary, currentGuard))
                     continue;
                 let relationEntityMetadata;
                 try {
@@ -73,7 +75,9 @@ function ApiControllerGetListTransformFilter(query, entityMetadata) {
                 }
                 const nestedColumn = relationEntityMetadata.columns.find((column) => column.name == nestedPropertyName);
                 const nestedColumnMetadata = nestedColumn?.metadata?.[PROPERTY_DESCRIBE_DECORATOR_API_CONSTANT.METADATA_KEY];
-                if (!nestedColumnMetadata || nestedColumnMetadata.type === EApiPropertyDescribeType.RELATION || nestedColumnMetadata.type === EApiPropertyDescribeType.OBJECT)
+                if (!nestedColumn || !nestedColumnMetadata || nestedColumnMetadata.type === EApiPropertyDescribeType.RELATION || nestedColumnMetadata.type === EApiPropertyDescribeType.OBJECT)
+                    continue;
+                if (!nestedColumn.isPrimary && !DtoIsPropertyShouldBeMarked(EApiRouteType.GET_LIST, EApiDtoType.QUERY, nestedPropertyName, nestedColumnMetadata, nestedColumn.isPrimary, currentGuard))
                     continue;
                 const relationFilter = (filterRecord[relationName] ?? {});
                 relationFilter[nestedPropertyName] = ApiControllerGetListTransformOperation(operation, value);

package/dist/esm/utility/api/controller/get-list/transform/filter.utility.js.map

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

package/dist/esm/utility/api/function-transaction.utility.d.ts

@@ -9,12 +9,14 @@ import { EApiFunctionTransactionMode } from '../../enum/decorator/api';
  * @param {(eventManager: EntityManager | undefined) => Promise<R>} options.callback - Function body to run with the resolved transaction manager.
  * @param {new (...arguments_: Array<unknown>) => E} options.entity - Entity constructor associated with the function.
  * @param {EApiFunctionTransactionMode} options.mode - Transaction mode to enforce.
- * @param {Repository<E>} options.repository - Repository used to open new transactions when required.
+ * @param {(eventManager: EntityManager | undefined, error: Error) => Promise<void>} [options.onPreflightError] - Error hook for transaction mode conflicts before the function body starts.
+ * @param {Repository<E>} [options.repository] - Repository used to open new transactions when required.
  * @returns {Promise<R>} Callback result.
  */
 export declare function ApiFunctionExecuteWithTransaction<E extends IApiBaseEntity, R>(options: {
     callback: (eventManager: EntityManager | undefined) => Promise<R>;
     entity: new (...arguments_: Array<unknown>) => E;
     mode: EApiFunctionTransactionMode;
-    repository: Repository<E>;
+    onPreflightError?: (eventManager: EntityManager | undefined, error: Error) => Promise<void>;
+    repository?: Repository<E>;
 }): Promise<R>;

package/dist/esm/utility/api/function-transaction.utility.js

@@ -28,19 +28,29 @@ import { ErrorException } from '../error/exception.utility.js';
  * @param {(eventManager: EntityManager | undefined) => Promise<R>} options.callback - Function body to run with the resolved transaction manager.
  * @param {new (...arguments_: Array<unknown>) => E} options.entity - Entity constructor associated with the function.
  * @param {EApiFunctionTransactionMode} options.mode - Transaction mode to enforce.
- * @param {Repository<E>} options.repository - Repository used to open new transactions when required.
+ * @param {(eventManager: EntityManager | undefined, error: Error) => Promise<void>} [options.onPreflightError] - Error hook for transaction mode conflicts before the function body starts.
+ * @param {Repository<E>} [options.repository] - Repository used to open new transactions when required.
  * @returns {Promise<R>} Callback result.
  */
 async function ApiFunctionExecuteWithTransaction(options) {
     const activeEventManager = ApiFunctionContextStorage.get()?.eventManager;
     if (options.mode === EApiFunctionTransactionMode.NONE && activeEventManager) {
-        throw ErrorException("ApiFunction transaction mode NONE cannot run inside an active transaction");
+        const error = ErrorException("ApiFunction transaction mode NONE cannot run inside an active transaction");
+        await options.onPreflightError?.(activeEventManager, error);
+        throw error;
     }
     if (options.mode === EApiFunctionTransactionMode.MANDATORY && !activeEventManager) {
-        throw ErrorException("ApiFunction transaction mode MANDATORY requires an active transaction");
+        const error = ErrorException("ApiFunction transaction mode MANDATORY requires an active transaction");
+        await options.onPreflightError?.(undefined, error);
+        throw error;
     }
     const eventManager = options.mode === EApiFunctionTransactionMode.NONE ? undefined : activeEventManager;
     if (options.mode === EApiFunctionTransactionMode.REQUIRED && !eventManager) {
+        if (!options.repository) {
+            const error = ErrorException("Repository is not available in this context");
+            await options.onPreflightError?.(undefined, error);
+            throw error;
+        }
         return await options.repository.manager.transaction(async (transactionManager) => await ApiFunctionTransactionScope.runWithEntityManager(transactionManager, async () => await options.callback(transactionManager)));
     }
     return await options.callback(eventManager);

package/dist/esm/utility/api/function-transaction.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"function-transaction.utility.js","sources":["../../../../../src/utility/api/function-transaction.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAQA;;;;;;;;;;AAUG;AACI,eAAe,iCAAiC,CAA8B,OAA8L,EAAA;IAClR,MAAM,kBAAkB,GAA8B,yBAAyB,CAAC,GAAG,EAAK,EAAE,YAAY;IAEtG,IAAI,OAAO,CAAC,IAAI,KAAK,2BAA2B,CAAC,IAAI,IAAI,kBAAkB,EAAE;AAC5E,QAAA,MAAM,cAAc,CAAC,2EAA2E,CAAC;IAClG;IAEA,IAAI,OAAO,CAAC,IAAI,KAAK,2BAA2B,CAAC,SAAS,IAAI,CAAC,kBAAkB,EAAE;AAClF,QAAA,MAAM,cAAc,CAAC,uEAAuE,CAAC;IAC9F;AAEA,IAAA,MAAM,YAAY,GAA8B,OAAO,CAAC,IAAI,KAAK,2BAA2B,CAAC,IAAI,GAAG,SAAS,GAAG,kBAAkB;IAElI,IAAI,OAAO,CAAC,IAAI,KAAK,2BAA2B,CAAC,QAAQ,IAAI,CAAC,YAAY,EAAE;AAC3E,QAAA,OAAO,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,kBAAiC,KAAiB,MAAM,2BAA2B,CAAC,oBAAoB,CAAC,kBAAkB,EAAE,YAAwB,MAAM,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAC7P;AAEA,IAAA,OAAO,MAAM,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;AAC5C;;;;"}
+{"version":3,"file":"function-transaction.utility.js","sources":["../../../../../src/utility/api/function-transaction.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAQA;;;;;;;;;;;AAWG;AACI,eAAe,iCAAiC,CAA8B,OAA4R,EAAA;IAChX,MAAM,kBAAkB,GAA8B,yBAAyB,CAAC,GAAG,EAAK,EAAE,YAAY;IAEtG,IAAI,OAAO,CAAC,IAAI,KAAK,2BAA2B,CAAC,IAAI,IAAI,kBAAkB,EAAE;AAC5E,QAAA,MAAM,KAAK,GAAU,cAAc,CAAC,2EAA2E,CAAC;QAEhH,MAAM,OAAO,CAAC,gBAAgB,GAAG,kBAAkB,EAAE,KAAK,CAAC;AAE3D,QAAA,MAAM,KAAK;IACZ;IAEA,IAAI,OAAO,CAAC,IAAI,KAAK,2BAA2B,CAAC,SAAS,IAAI,CAAC,kBAAkB,EAAE;AAClF,QAAA,MAAM,KAAK,GAAU,cAAc,CAAC,uEAAuE,CAAC;QAE5G,MAAM,OAAO,CAAC,gBAAgB,GAAG,SAAS,EAAE,KAAK,CAAC;AAElD,QAAA,MAAM,KAAK;IACZ;AAEA,IAAA,MAAM,YAAY,GAA8B,OAAO,CAAC,IAAI,KAAK,2BAA2B,CAAC,IAAI,GAAG,SAAS,GAAG,kBAAkB;IAElI,IAAI,OAAO,CAAC,IAAI,KAAK,2BAA2B,CAAC,QAAQ,IAAI,CAAC,YAAY,EAAE;AAC3E,QAAA,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE;AACxB,YAAA,MAAM,KAAK,GAAU,cAAc,CAAC,6CAA6C,CAAC;YAElF,MAAM,OAAO,CAAC,gBAAgB,GAAG,SAAS,EAAE,KAAK,CAAC;AAElD,YAAA,MAAM,KAAK;QACZ;AAEA,QAAA,OAAO,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,kBAAiC,KAAiB,MAAM,2BAA2B,CAAC,oBAAoB,CAAC,kBAAkB,EAAE,YAAwB,MAAM,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAC7P;AAEA,IAAA,OAAO,MAAM,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;AAC5C;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@elsikora/nestjs-crud-automator",
-	"version": "2.3.0",
+	"version": "2.4.0",
 	"description": "A library for automating the creation of CRUD operations in NestJS.",
 	"keywords": [
 		"NestJS",