arkos 2.0.0-next.16 → 2.0.0-next.17

package/dist/cjs/modules/auth/utils/auth-hooks-manager.js

@@ -0,0 +1,153 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const arkos_config_helpers_1 = require("../../../utils/helpers/arkos-config.helpers.js");
+const errors_1 = require("../../error-handler/utils/errors.js");
+const auth_service_1 = __importDefault(require("../auth.service.js"));
+class AuthHookManager {
+    async runAuthenticate(adapter, getUser, keyName = "user") {
+        const { context, done } = adapter;
+        const hooks = (0, arkos_config_helpers_1.getArkosConfig)()?.authentication?.hooks?.authenticate;
+        const before = await this.runHooks(hooks?.before, context);
+        if (before.error) {
+            const onError = await this.runErrorHooks(hooks?.onError, before.error, context);
+            if (onError.skipped) {
+                const after = await this.runAfterHooks(hooks?.after, context);
+                return after.error ? done(after.error) : done();
+            }
+            return done(onError.error);
+        }
+        if (!before.skipped) {
+            try {
+                const user = await getUser(context);
+                context[keyName] = user ?? undefined;
+            }
+            catch (err) {
+                const onError = await this.runErrorHooks(hooks?.onError, err, context);
+                if (onError.skipped) {
+                    const after = await this.runAfterHooks(hooks?.after, context);
+                    return after.error ? done(after.error) : done();
+                }
+                return done(onError.error);
+            }
+        }
+        const after = await this.runAfterHooks(hooks?.after, context);
+        if (after.error)
+            return done(after.error);
+        done();
+    }
+    async runAuthorize(adapter, authAction, keyName = "user") {
+        const { context, done } = adapter;
+        const hooks = (0, arkos_config_helpers_1.getArkosConfig)()?.authentication?.hooks?.authorize;
+        const { action, resource, ...rule } = authAction;
+        const hooksMeta = { action, resource, rule };
+        const before = await this.runHooks(hooks?.before, context, hooksMeta);
+        if (before.error) {
+            const onError = await this.runErrorHooks(hooks?.onError, before.error, context, hooksMeta);
+            if (onError.skipped) {
+                const after = await this.runAfterHooks(hooks?.after, context, hooksMeta);
+                return after.error ? done(after.error) : done();
+            }
+            return done(onError.error);
+        }
+        if (!before.skipped) {
+            try {
+                if (context[keyName]) {
+                    const user = context[keyName];
+                    const configs = (0, arkos_config_helpers_1.getArkosConfig)();
+                    if (!user.isSuperUser) {
+                        const notEnoughPermissionsError = new errors_1.ForbiddenError(authAction.errorMessage, "NotEnoughPermissions");
+                        if (configs?.authentication?.mode === "dynamic") {
+                            const hasPermission = await auth_service_1.default.checkDynamicAccessControl(user.id, action, resource);
+                            if (!hasPermission)
+                                throw notEnoughPermissionsError;
+                        }
+                        else if (configs?.authentication?.mode === "static") {
+                            const hasPermission = auth_service_1.default.checkStaticAccessControl(user, action, { [action]: rule });
+                            if (!hasPermission)
+                                throw notEnoughPermissionsError;
+                        }
+                    }
+                }
+            }
+            catch (err) {
+                const onError = await this.runErrorHooks(hooks?.onError, err, context, hooksMeta);
+                if (onError.skipped) {
+                    const after = await this.runAfterHooks(hooks?.after, context, hooksMeta);
+                    return after.error ? done(after.error) : done();
+                }
+                return done(onError.error);
+            }
+        }
+        const after = await this.runAfterHooks(hooks?.after, context, hooksMeta);
+        if (after.error)
+            return done(after.error);
+        done();
+    }
+    async runAfterHooks(hooks, req, ctx) {
+        if (!hooks)
+            return {};
+        const hookArray = Array.isArray(hooks) ? hooks : [hooks];
+        for (const hook of hookArray) {
+            try {
+                await hook({ req, ...ctx });
+            }
+            catch (err) {
+                return { error: err };
+            }
+        }
+        return {};
+    }
+    async runHooks(hooks, req, ctx) {
+        if (!hooks)
+            return { skipped: false };
+        const hookArray = Array.isArray(hooks) ? hooks : [hooks];
+        for (const hook of hookArray) {
+            let skipCalled = false;
+            try {
+                await hook({
+                    req,
+                    skip: () => {
+                        skipCalled = true;
+                    },
+                    ...ctx,
+                });
+            }
+            catch (err) {
+                return { skipped: false, error: err };
+            }
+            if (skipCalled)
+                return { skipped: true };
+        }
+        return { skipped: false };
+    }
+    async runErrorHooks(hooks, error, req, ctx) {
+        if (!hooks)
+            return { skipped: false, error };
+        const hookArray = Array.isArray(hooks) ? hooks : [hooks];
+        for (const hook of hookArray) {
+            let skipCalled = false;
+            try {
+                await hook({
+                    req,
+                    error,
+                    skip: () => {
+                        skipCalled = true;
+                    },
+                    ...ctx,
+                });
+            }
+            catch (err) {
+                return { skipped: false, error: err };
+            }
+            if (skipCalled)
+                return { skipped: true };
+        }
+        return { skipped: false, error };
+    }
+}
+const authHookManager = new AuthHookManager();
+exports.default = authHookManager;
+//# sourceMappingURL=auth-hooks-manager.js.map

package/dist/cjs/modules/auth/utils/auth-hooks-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-hooks-manager.js","sourceRoot":"","sources":["../../../../../src/modules/auth/utils/auth-hooks-manager.ts"],"names":[],"mappings":"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","sourcesContent":["import { ArkosSocket } from \"../../../components/arkos-gateway/types\";\nimport { ArkosRequest, User } from \"../../../types\";\nimport {\n  AuthenticateAfterHookHandler,\n  AuthenticateErrorHookHandler,\n  AuthenticateHookHandler,\n  AuthorizeAfterHookHandler,\n  AuthorizeErrorHookHandler,\n  AuthorizeHookHandler,\n} from \"../../../types/arkos-config/utils\";\nimport { AccessAction, DetailedAccessControlRule } from \"../../../types/auth\";\nimport { getArkosConfig } from \"../../../utils/helpers/arkos-config.helpers\";\nimport { ForbiddenError } from \"../../error-handler/utils/errors\";\nimport authService from \"../auth.service\";\nimport { AuthAction } from \"./services/auth-action.service\";\n\ntype ArkosBaseContext = ArkosRequest | ArkosSocket;\n\ninterface ArkosMiddlewareAdapter<TContext extends ArkosBaseContext> {\n  context: TContext;\n  done: (error?: unknown | any) => void; // replaces next()\n}\n\nclass AuthHookManager {\n  /**\n   * Runs the full authenticate pipeline — before hooks, core user resolution,\n   * after hooks — and calls `done` when finished.\n   *\n   * Shared by the HTTP authenticate middleware and the WebSocket auth ns.use().\n   *\n   * @param adapter.context - The request or socket being authenticated.\n   * @param adapter.done - Called with no args on success, or with an error to propagate.\n   * @param getUser - Async function that resolves the user from the context.\n   */\n  async runAuthenticate<TContext extends ArkosBaseContext>(\n    adapter: ArkosMiddlewareAdapter<TContext>,\n    getUser: (context: TContext) => Promise<User | null>,\n    keyName: \"user\" | \"currentUser\" = \"user\"\n  ): Promise<void> {\n    const { context, done } = adapter;\n    const hooks = getArkosConfig()?.authentication?.hooks?.authenticate;\n\n    const before = await this.runHooks(hooks?.before, context);\n    if (before.error) {\n      const onError = await this.runErrorHooks(\n        hooks?.onError,\n        before.error,\n        context\n      );\n      if (onError.skipped) {\n        const after = await this.runAfterHooks(hooks?.after, context);\n        return after.error ? done(after.error) : done();\n      }\n      return done(onError.error);\n    }\n\n    if (!before.skipped) {\n      try {\n        const user = await getUser(context);\n        (context as any)[keyName] = user ?? undefined;\n      } catch (err) {\n        const onError = await this.runErrorHooks(hooks?.onError, err, context);\n        if (onError.skipped) {\n          const after = await this.runAfterHooks(hooks?.after, context);\n          return after.error ? done(after.error) : done();\n        }\n        return done(onError.error);\n      }\n    }\n\n    const after = await this.runAfterHooks(hooks?.after, context);\n    if (after.error) return done(after.error);\n    done();\n  }\n\n  /**\n   * Runs the full authorize pipeline — before hooks, core permission check,\n   * after hooks — and calls `done` when finished.\n   *\n   * Shared by the HTTP `authorize()` middleware and WebSocket per-event authorization.\n   *\n   * @param adapter.context - The request or socket being authorized.\n   * @param authAction {AuthAction}\n   * @param keyName {\"user\" | \"currentUser\"}\n   */\n  async runAuthorize<TContext extends ArkosBaseContext>(\n    adapter: ArkosMiddlewareAdapter<TContext>,\n    authAction: Required<AuthAction>,\n    keyName: \"user\" | \"currentUser\" = \"user\"\n  ): Promise<void> {\n    const { context, done } = adapter;\n    const hooks = getArkosConfig()?.authentication?.hooks?.authorize;\n    const { action, resource, ...rule } = authAction;\n    const hooksMeta = { action, resource, rule };\n\n    const before = await this.runHooks(hooks?.before, context, hooksMeta);\n    if (before.error) {\n      const onError = await this.runErrorHooks(\n        hooks?.onError,\n        before.error,\n        context,\n        hooksMeta\n      );\n      if (onError.skipped) {\n        const after = await this.runAfterHooks(\n          hooks?.after,\n          context,\n          hooksMeta\n        );\n        return after.error ? done(after.error) : done();\n      }\n      return done(onError.error);\n    }\n\n    if (!before.skipped) {\n      try {\n        if ((context as any)[keyName]) {\n          const user = (context as any)[keyName] as User;\n          const configs = getArkosConfig();\n          if (!user.isSuperUser) {\n            const notEnoughPermissionsError = new ForbiddenError(\n              authAction.errorMessage,\n              \"NotEnoughPermissions\"\n            );\n            if (configs?.authentication?.mode === \"dynamic\") {\n              const hasPermission = await authService.checkDynamicAccessControl(\n                user.id,\n                action,\n                resource\n              );\n              if (!hasPermission) throw notEnoughPermissionsError;\n            } else if (configs?.authentication?.mode === \"static\") {\n              const hasPermission = authService.checkStaticAccessControl(\n                user,\n                action,\n                { [action]: rule }\n              );\n              if (!hasPermission) throw notEnoughPermissionsError;\n            }\n          }\n        }\n      } catch (err) {\n        const onError = await this.runErrorHooks(\n          hooks?.onError,\n          err,\n          context,\n          hooksMeta\n        );\n        if (onError.skipped) {\n          const after = await this.runAfterHooks(\n            hooks?.after,\n            context,\n            hooksMeta\n          );\n          return after.error ? done(after.error) : done();\n        }\n        return done(onError.error);\n      }\n    }\n\n    const after = await this.runAfterHooks(hooks?.after, context, hooksMeta);\n    if (after.error) return done(after.error);\n    done();\n  }\n\n  /**\n   * Runs a chain of `after` hooks in sequence.\n   *\n   * - If a hook throws — chain aborts, error is forwarded to the global error handler.\n   * - If a hook returns — next hook in chain runs.\n   *\n   * @returns Promise resolving to `{ error? }`\n   */\n  private async runAfterHooks(\n    hooks:\n      | AuthenticateAfterHookHandler\n      | AuthenticateAfterHookHandler[]\n      | AuthorizeAfterHookHandler\n      | AuthorizeAfterHookHandler[]\n      | undefined,\n    req: ArkosBaseContext,\n    ctx?: {\n      action?: AccessAction;\n      resource?: string;\n      rule?: string[] | DetailedAccessControlRule | \"*\";\n    }\n  ): Promise<{ error?: unknown }> {\n    if (!hooks) return {};\n\n    const hookArray = Array.isArray(hooks) ? hooks : [hooks];\n\n    for (const hook of hookArray) {\n      try {\n        await (hook as any)({ req, ...ctx });\n      } catch (err) {\n        return { error: err };\n      }\n    }\n\n    return {};\n  }\n\n  /**\n   * Runs a chain of `before` hooks in sequence.\n   *\n   * - If a hook throws — chain aborts, error is forwarded to `onError` hooks.\n   * - If a hook calls `skip()` — chain stops, core logic is bypassed, jumps to `after` hooks.\n   * - If a hook returns — next hook in chain runs.\n   *\n   * @returns Promise resolving to `{ skipped, error? }`\n   */\n  private async runHooks(\n    hooks:\n      | AuthenticateHookHandler\n      | AuthenticateHookHandler[]\n      | AuthorizeHookHandler\n      | AuthorizeHookHandler[]\n      | undefined,\n    req: ArkosBaseContext,\n    ctx?: {\n      action?: AccessAction;\n      resource?: string;\n      rule?: string[] | DetailedAccessControlRule | \"*\";\n    }\n  ): Promise<{ skipped: boolean; error?: unknown }> {\n    if (!hooks) return { skipped: false };\n\n    const hookArray = Array.isArray(hooks) ? hooks : [hooks];\n\n    for (const hook of hookArray) {\n      let skipCalled = false;\n\n      try {\n        await (hook as any)({\n          req,\n          skip: () => {\n            skipCalled = true;\n          },\n          ...ctx,\n        });\n      } catch (err) {\n        return { skipped: false, error: err };\n      }\n\n      if (skipCalled) return { skipped: true };\n    }\n\n    return { skipped: false };\n  }\n\n  /**\n   * Runs a chain of `onError` hooks in sequence.\n   *\n   * - If a hook throws — chain aborts, error is forwarded to the global error handler.\n   * - If a hook calls `skip()` — suppresses the error and jumps to `after` hooks.\n   * - If a hook returns — next hook in chain runs.\n   *\n   * @returns Promise resolving to `{ skipped, error? }`\n   */\n  private async runErrorHooks(\n    hooks:\n      | AuthenticateErrorHookHandler\n      | AuthenticateErrorHookHandler[]\n      | AuthorizeErrorHookHandler\n      | AuthorizeErrorHookHandler[]\n      | undefined,\n    error: unknown,\n    req: ArkosBaseContext,\n    ctx?: {\n      action?: AccessAction;\n      resource?: string;\n      rule?: string[] | DetailedAccessControlRule | \"*\";\n    }\n  ): Promise<{ skipped: boolean; error?: unknown }> {\n    if (!hooks) return { skipped: false, error };\n\n    const hookArray = Array.isArray(hooks) ? hooks : [hooks];\n\n    for (const hook of hookArray) {\n      let skipCalled = false;\n\n      try {\n        await (hook as any)({\n          req,\n          error,\n          skip: () => {\n            skipCalled = true;\n          },\n          ...ctx,\n        });\n      } catch (err) {\n        return { skipped: false, error: err };\n      }\n\n      if (skipCalled) return { skipped: true };\n    }\n\n    return { skipped: false, error };\n  }\n}\n\nconst authHookManager = new AuthHookManager();\n\nexport default authHookManager;\n"]}

package/dist/cjs/modules/auth/utils/docs-links.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.authenticationDocsLinks = void 0;
+const docs_links_1 = require("../../../utils/docs-links.js");
+const base = `${docs_links_1.baseDocsLink}/core-concepts/authentication`;
+exports.authenticationDocsLinks = {
+    setup: `${base}/setup`,
+};
+//# sourceMappingURL=docs-links.js.map

package/dist/cjs/modules/auth/utils/docs-links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-links.js","sourceRoot":"","sources":["../../../../../src/modules/auth/utils/docs-links.ts"],"names":[],"mappings":";;;AAAA,0DAAyD;AAEzD,MAAM,IAAI,GAAG,GAAG,yBAAY,+BAA+B,CAAC;AAE/C,QAAA,uBAAuB,GAAG;IACrC,KAAK,EAAE,GAAG,IAAI,QAAQ;CACvB,CAAC","sourcesContent":["import { baseDocsLink } from \"../../../utils/docs-links\";\n\nconst base = `${baseDocsLink}/core-concepts/authentication`;\n\nexport const authenticationDocsLinks = {\n  setup: `${base}/setup`,\n};\n"]}

package/dist/cjs/modules/auth/utils/services/auth-action.service.js

@@ -12,7 +12,7 @@ class AuthActionService {
                 resource: "auth-action",
                 name: "View auth action",
                 description: "View an auth action",
-                errorMessage: "You do not have permission to perform this operation",
+                errorMessage: "You cannot perform view for auth action",
             },
         ];
     }
@@ -23,7 +23,7 @@ class AuthActionService {
             const inconsistencies = [];
             const defaultName = `${(0, text_helpers_1.capitalize)((0, utils_1.kebabCase)(action).replace(/-/g, " "))} ${(0, text_helpers_1.capitalize)((0, utils_1.kebabCase)(resource).replace(/-/g, " "))}`;
             const defaultDescription = `${(0, text_helpers_1.capitalize)((0, utils_1.kebabCase)(action).replace(/-/g, " "))} ${(0, text_helpers_1.capitalize)((0, utils_1.kebabCase)(resource).replace(/-/g, " "))}`;
-            const defaultErrorMessage = "You do not have permission to perform this operation";
+            const defaultErrorMessage = `You cannot perform ${(0, utils_1.sentenceCase)(action).toLowerCase()} for ${(0, utils_1.sentenceCase)(resource).toLowerCase()}`;
             const isNonDefault = (value, defaultValue) => {
                 return value !== undefined && value !== defaultValue;
             };
@@ -67,12 +67,14 @@ class AuthActionService {
             };
             this.remove(action, resource);
             this.authActions.push(merged);
+            return merged;
         }
         else {
             if (transformedAction.roles) {
                 transformedAction.roles = [...transformedAction.roles].sort();
             }
             this.authActions.push(transformedAction);
+            return transformedAction;
         }
     }
     remove(action, resource) {
@@ -100,7 +102,7 @@ class AuthActionService {
             resource,
             name: `${(0, text_helpers_1.capitalize)((0, utils_1.kebabCase)(action).replace(/-/g, " "))} ${(0, text_helpers_1.capitalize)((0, utils_1.kebabCase)(resource).replace(/-/g, " "))}`,
             description: `${(0, text_helpers_1.capitalize)((0, utils_1.kebabCase)(action).replace(/-/g, " "))} ${(0, text_helpers_1.capitalize)((0, utils_1.kebabCase)(resource).replace(/-/g, " "))}`,
-            errorMessage: `You do not have permission to perform this operation`,
+            errorMessage: `You cannot perform ${(0, utils_1.sentenceCase)(action).toLowerCase()} for ${(0, utils_1.sentenceCase)(resource).toLowerCase()}`,
         };
         const config = (0, arkos_config_helpers_1.getArkosConfig)();
         if (config?.authentication?.mode === "dynamic")

package/dist/cjs/modules/auth/utils/services/auth-action.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth-action.service.js","sourceRoot":"","sources":["../../../../../../src/modules/auth/utils/services/auth-action.service.ts"],"names":[],"mappings":";;AAAA,qDAAsD;AAKtD,yFAAgF;AAChF,yEAAoE;AAWpE,MAAM,iBAAiB;IAAvB;QACE,gBAAW,GAAiB;YAC1B;gBACE,KAAK,EAAE,EAAE;gBACT,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,aAAa;gBACvB,IAAI,EAAE,kBAAkB;gBACxB,WAAW,EAAE,qBAAqB;gBAClC,YAAY,EAAE,sDAAsD;aACrE;SACF,CAAC;IAoMJ,CAAC;IAlMC,GAAG,CAAC,MAAc,EAAE,QAAgB,EAAE,aAAmC;QACvE,MAAM,iBAAiB,GAAG,IAAI,CAAC,uCAAuC,CACpE,MAAM,EACN,QAAQ,EACR,aAAa,CACd,CAAC;QACF,MAAM,kBAAkB,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAEzD,IAAI,kBAAkB,EAAE,CAAC;YACvB,MAAM,eAAe,GAAa,EAAE,CAAC;YAErC,MAAM,WAAW,GAAG,GAAG,IAAA,yBAAU,EAAC,IAAA,iBAAS,EAAC,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,IAAA,yBAAU,EAAC,IAAA,iBAAS,EAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;YAChI,MAAM,kBAAkB,GAAG,GAAG,IAAA,yBAAU,EAAC,IAAA,iBAAS,EAAC,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,IAAA,yBAAU,EAAC,IAAA,iBAAS,EAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;YACvI,MAAM,mBAAmB,GACvB,sDAAsD,CAAC;YAEzD,MAAM,YAAY,GAAG,CACnB,KAAyB,EACzB,YAAoB,EACX,EAAE;gBACX,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,YAAY,CAAC;YACvD,CAAC,CAAC;YAEF,IACE,YAAY,CAAC,kBAAkB,CAAC,IAAI,EAAE,WAAW,CAAC;gBAClD,YAAY,CAAC,iBAAiB,CAAC,IAAI,EAAE,WAAW,CAAC;gBACjD,kBAAkB,CAAC,IAAI,KAAK,iBAAiB,CAAC,IAAI,EAClD,CAAC;gBACD,eAAe,CAAC,IAAI,CAClB,cAAc,kBAAkB,CAAC,IAAI,SAAS,iBAAiB,CAAC,IAAI,GAAG,CACxE,CAAC;YACJ,CAAC;YAED,IACE,YAAY,CAAC,kBAAkB,CAAC,WAAW,EAAE,kBAAkB,CAAC;gBAChE,YAAY,CAAC,iBAAiB,CAAC,WAAW,EAAE,kBAAkB,CAAC;gBAC/D,kBAAkB,CAAC,WAAW,KAAK,iBAAiB,CAAC,WAAW,EAChE,CAAC;gBACD,eAAe,CAAC,IAAI,CAClB,qBAAqB,kBAAkB,CAAC,WAAW,SAAS,iBAAiB,CAAC,WAAW,GAAG,CAC7F,CAAC;YACJ,CAAC;YAED,IACE,YAAY,CAAC,kBAAkB,CAAC,YAAY,EAAE,mBAAmB,CAAC;gBAClE,YAAY,CAAC,iBAAiB,CAAC,YAAY,EAAE,mBAAmB,CAAC;gBACjE,kBAAkB,CAAC,YAAY,KAAK,iBAAiB,CAAC,YAAY,EAClE,CAAC;gBACD,eAAe,CAAC,IAAI,CAClB,sBAAsB,kBAAkB,CAAC,YAAY,SAAS,iBAAiB,CAAC,YAAY,GAAG,CAChG,CAAC;YACJ,CAAC;YACD,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CACb,yCAAyC,MAAM,IAAI,QAAQ,KAAK;oBAC9D,gFAAgF;oBAChF,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;oBAC1B,yCAAyC,MAAM,IAAI,QAAQ,6DAA6D,CAC3H,CAAC;YACJ,CAAC;YAED,MAAM,WAAW,GACf,kBAAkB,CAAC,KAAK,IAAI,iBAAiB,CAAC,KAAK;gBACjD,CAAC,CAAC;oBACE,GAAG,CAAC,kBAAkB,CAAC,KAAK,IAAI,EAAE,CAAC;oBACnC,GAAG,CAAC,iBAAiB,CAAC,KAAK,IAAI,EAAE,CAAC;iBACnC;gBACH,CAAC,CAAC,SAAS,CAAC;YAEhB,MAAM,WAAW,GAAG,WAAW;gBAC7B,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE;gBAClC,CAAC,CAAC,SAAS,CAAC;YAEd,MAAM,MAAM,GAAe;gBACzB,MAAM,EAAE,kBAAkB,CAAC,MAAM;gBACjC,QAAQ,EAAE,kBAAkB,CAAC,QAAQ;gBACrC,KAAK,EAAE,WAAW;gBAClB,IAAI,EAAE,kBAAkB,CAAC,IAAI,IAAI,iBAAiB,CAAC,IAAI;gBACvD,WAAW,EACT,kBAAkB,CAAC,WAAW,IAAI,iBAAiB,CAAC,WAAW;gBACjE,YAAY,EACV,kBAAkB,CAAC,YAAY,IAAI,iBAAiB,CAAC,YAAY;aACpE,CAAC;YAEF,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC9B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,IAAI,iBAAiB,CAAC,KAAK,EAAE,CAAC;gBAC5B,iBAAiB,CAAC,KAAK,GAAG,CAAC,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;YAChE,CAAC;YACD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,MAAM,CAAC,MAAc,EAAE,QAAgB;QACrC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CACxC,CAAC,UAAU,EAAE,EAAE,CACb,CAAC,CAAC,UAAU,CAAC,MAAM,KAAK,MAAM,IAAI,UAAU,CAAC,QAAQ,KAAK,QAAQ,CAAC,CACtE,CAAC;IACJ,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,MAAc,EAAE,QAAgB;QACrC,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAC1B,CAAC,UAAU,EAAE,EAAE,CACb,UAAU,CAAC,MAAM,KAAK,MAAM,IAAI,UAAU,CAAC,QAAQ,KAAK,QAAQ,CACnE,CAAC;IACJ,CAAC;IAEO,uCAAuC,CAC7C,MAAc,EACd,QAAgB,EAChB,aAAmC;QAEnC,MAAM,cAAc,GAAe;YACjC,KAAK,EACH,CAAC,aAAa;gBACZ,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC;oBAC3B,CAAC,CAAC,aAAa;oBACf,CAAC,CAAC,OAAO,aAAa,KAAK,QAAQ;wBACjC,CAAC,CAAC,CAAC,aAAa,CAAC;wBACjB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;4BAC5C,CAAC,CAAE,aAAa,CAAC,MAAM,CAAc;4BACrC,CAAC,CAAE,aAAa,CAAC,MAAM,CAA+B;gCAClD,EAAE,KAAK,CAAC,CAAC;gBACrB,EAAE;YACJ,MAAM;YACN,QAAQ;YACR,IAAI,EAAE,GAAG,IAAA,yBAAU,EAAC,IAAA,iBAAS,EAAC,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,IAAA,yBAAU,EAAC,IAAA,iBAAS,EAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,EAAE;YACjH,WAAW,EAAE,GAAG,IAAA,yBAAU,EAAC,IAAA,iBAAS,EAAC,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,IAAA,yBAAU,EAAC,IAAA,iBAAS,EAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,EAAE;YACxH,YAAY,EAAE,sDAAsD;SACrE,CAAC;QAEF,MAAM,MAAM,GAAG,IAAA,qCAAc,GAAE,CAAC;QAEhC,IAAI,MAAM,EAAE,cAAc,EAAE,IAAI,KAAK,SAAS;YAAE,OAAO,cAAc,CAAC,KAAK,CAAC;QAE5E,IAAI,CAAC,aAAa;YAAE,OAAO,cAAc,CAAC;QAE1C,IAAI,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC;YAAE,OAAO,cAAc,CAAC;QAExD,MAAM,UAAU,GACb,aAAqB,KAAK,GAAG;YAC5B,CAAC,CAAE,aAAqB,CAAC,MAAM,CAAC;YAChC,CAAC,CAAC,SAAS,CAAC;QAEhB,IAAI,MAAM,EAAE,cAAc,EAAE,IAAI,KAAK,QAAQ;YAAE,OAAO,cAAc,CAAC,KAAK,CAAC;QAE3E,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC9B,OAAO,cAAc,CAAC;YACxB,CAAC;iBAAM,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;gBAC1C,OAAO;oBACL,GAAG,cAAc;oBACjB,IAAI,EAAE,UAAU,CAAC,IAAI,IAAI,cAAc,CAAC,IAAI;oBAC5C,WAAW,EAAE,UAAU,EAAE,WAAW,IAAI,cAAc,CAAC,WAAW;oBAClE,YAAY,EAAE,UAAU,EAAE,YAAY,IAAI,cAAc,CAAC,YAAY;iBACtE,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,gBAAgB;QACd,OAAO;YACL,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;SACpE,CAAC;IACJ,CAAC;IAED,kBAAkB;QAChB,OAAO;YACL,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;SACtE,CAAC;IACJ,CAAC;IAED,aAAa,CAAC,QAAgB;QAC5B,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAC5B,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,KAAK,QAAQ,CACjD,CAAC;IACJ,CAAC;IAED,WAAW,CAAC,MAAc;QACxB,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAC5B,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,KAAK,MAAM,CAC7C,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,MAAc,EAAE,QAAgB;QACrC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACzC,CAAC;CACF;AAED,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,EAAE,CAAC;AAElD,kBAAe,iBAAiB,CAAC","sourcesContent":["import { kebabCase } from \"../../../../exports/utils\";\nimport {\n  AccessControlConfig,\n  DetailedAccessControlRule,\n} from \"../../../../types/auth\";\nimport { getArkosConfig } from \"../../../../utils/helpers/arkos-config.helpers\";\nimport { capitalize } from \"../../../../utils/helpers/text.helpers\";\n\ninterface AuthAction {\n  roles?: string[] | \"*\";\n  action: string;\n  resource: string;\n  name?: string;\n  description?: string;\n  errorMessage?: string;\n}\n\nclass AuthActionService {\n  authActions: AuthAction[] = [\n    {\n      roles: [],\n      action: \"View\",\n      resource: \"auth-action\",\n      name: \"View auth action\",\n      description: \"View an auth action\",\n      errorMessage: \"You do not have permission to perform this operation\",\n    },\n  ];\n\n  add(action: string, resource: string, accessControl?: AccessControlConfig) {\n    const transformedAction = this.transformAccessControlToValidAuthAction(\n      action,\n      resource,\n      accessControl\n    );\n    const existingAuthAction = this.getOne(action, resource);\n\n    if (existingAuthAction) {\n      const inconsistencies: string[] = [];\n\n      const defaultName = `${capitalize(kebabCase(action).replace(/-/g, \" \"))} ${capitalize(kebabCase(resource).replace(/-/g, \" \"))}`;\n      const defaultDescription = `${capitalize(kebabCase(action).replace(/-/g, \" \"))} ${capitalize(kebabCase(resource).replace(/-/g, \" \"))}`;\n      const defaultErrorMessage =\n        \"You do not have permission to perform this operation\";\n\n      const isNonDefault = (\n        value: string | undefined,\n        defaultValue: string\n      ): boolean => {\n        return value !== undefined && value !== defaultValue;\n      };\n\n      if (\n        isNonDefault(existingAuthAction.name, defaultName) &&\n        isNonDefault(transformedAction.name, defaultName) &&\n        existingAuthAction.name !== transformedAction.name\n      ) {\n        inconsistencies.push(\n          `  - name: \"${existingAuthAction.name}\" vs \"${transformedAction.name}\"`\n        );\n      }\n\n      if (\n        isNonDefault(existingAuthAction.description, defaultDescription) &&\n        isNonDefault(transformedAction.description, defaultDescription) &&\n        existingAuthAction.description !== transformedAction.description\n      ) {\n        inconsistencies.push(\n          `  - description: \"${existingAuthAction.description}\" vs \"${transformedAction.description}\"`\n        );\n      }\n\n      if (\n        isNonDefault(existingAuthAction.errorMessage, defaultErrorMessage) &&\n        isNonDefault(transformedAction.errorMessage, defaultErrorMessage) &&\n        existingAuthAction.errorMessage !== transformedAction.errorMessage\n      ) {\n        inconsistencies.push(\n          `  - errorMessage: \"${existingAuthAction.errorMessage}\" vs \"${transformedAction.errorMessage}\"`\n        );\n      }\n      if (inconsistencies.length > 0) {\n        throw new Error(\n          `Inconsistent metadata for permission \"${action}:${resource}\". ` +\n            `The same action+resource combination is being defined with different values:\\n` +\n            inconsistencies.join(\"\\n\") +\n            `\\n\\nPlease ensure all definitions of \"${action}:${resource}\" have the same name, description, and errorMessage values.`\n        );\n      }\n\n      const mergedRoles =\n        existingAuthAction.roles || transformedAction.roles\n          ? [\n              ...(existingAuthAction.roles || []),\n              ...(transformedAction.roles || []),\n            ]\n          : undefined;\n\n      const uniqueRoles = mergedRoles\n        ? [...new Set(mergedRoles)].sort()\n        : undefined;\n\n      const merged: AuthAction = {\n        action: existingAuthAction.action,\n        resource: existingAuthAction.resource,\n        roles: uniqueRoles,\n        name: existingAuthAction.name ?? transformedAction.name,\n        description:\n          existingAuthAction.description ?? transformedAction.description,\n        errorMessage:\n          existingAuthAction.errorMessage ?? transformedAction.errorMessage,\n      };\n\n      this.remove(action, resource);\n      this.authActions.push(merged);\n    } else {\n      if (transformedAction.roles) {\n        transformedAction.roles = [...transformedAction.roles].sort();\n      }\n      this.authActions.push(transformedAction);\n    }\n  }\n\n  remove(action: string, resource: string) {\n    this.authActions = this.authActions.filter(\n      (authAction) =>\n        !(authAction.action === action && authAction.resource === resource)\n    );\n  }\n\n  getAll(): AuthAction[] {\n    return this.authActions;\n  }\n\n  getOne(action: string, resource: string): AuthAction | undefined {\n    return this.authActions.find(\n      (authAction) =>\n        authAction.action === action && authAction.resource === resource\n    );\n  }\n\n  private transformAccessControlToValidAuthAction(\n    action: string,\n    resource: string,\n    accessControl?: AccessControlConfig\n  ): AuthAction {\n    const baseAuthAction: AuthAction = {\n      roles:\n        (accessControl &&\n          (Array.isArray(accessControl)\n            ? accessControl\n            : typeof accessControl === \"string\"\n              ? [accessControl]\n              : Array.isArray(accessControl?.[action] || {})\n                ? (accessControl[action] as string[])\n                : (accessControl[action] as DetailedAccessControlRule)\n                    ?.roles)) ||\n        [],\n      action,\n      resource,\n      name: `${capitalize(kebabCase(action).replace(/-/g, \" \"))} ${capitalize(kebabCase(resource).replace(/-/g, \" \"))}`,\n      description: `${capitalize(kebabCase(action).replace(/-/g, \" \"))} ${capitalize(kebabCase(resource).replace(/-/g, \" \"))}`,\n      errorMessage: `You do not have permission to perform this operation`,\n    };\n\n    const config = getArkosConfig();\n\n    if (config?.authentication?.mode === \"dynamic\") delete baseAuthAction.roles;\n\n    if (!accessControl) return baseAuthAction;\n\n    if (Array.isArray(accessControl)) return baseAuthAction;\n\n    const actionRule =\n      (accessControl as any) !== \"*\"\n        ? (accessControl as any)[action]\n        : undefined;\n\n    if (config?.authentication?.mode !== \"static\") delete baseAuthAction.roles;\n\n    if (actionRule) {\n      if (Array.isArray(actionRule)) {\n        return baseAuthAction;\n      } else if (typeof actionRule === \"object\") {\n        return {\n          ...baseAuthAction,\n          name: actionRule.name || baseAuthAction.name,\n          description: actionRule?.description || baseAuthAction.description,\n          errorMessage: actionRule?.errorMessage || baseAuthAction.errorMessage,\n        };\n      }\n    }\n\n    return baseAuthAction;\n  }\n\n  getUniqueActions(): string[] {\n    return [\n      ...new Set(this.authActions.map((authAction) => authAction.action)),\n    ];\n  }\n\n  getUniqueResources(): string[] {\n    return [\n      ...new Set(this.authActions.map((authAction) => authAction.resource)),\n    ];\n  }\n\n  getByResource(resource: string): AuthAction[] | undefined {\n    return this.authActions.filter(\n      (authAction) => authAction.resource === resource\n    );\n  }\n\n  getByAction(action: string): AuthAction[] {\n    return this.authActions.filter(\n      (authAction) => authAction.action === action\n    );\n  }\n\n  exists(action: string, resource: string): boolean {\n    return !!this.getOne(action, resource);\n  }\n}\n\nconst authActionService = new AuthActionService();\n\nexport default authActionService;\n"]}
+{"version":3,"file":"auth-action.service.js","sourceRoot":"","sources":["../../../../../../src/modules/auth/utils/services/auth-action.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { kebabCase, sentenceCase } from \"../../../../exports/utils\";\nimport {\n  AccessControlConfig,\n  DetailedAccessControlRule,\n} from \"../../../../types/auth\";\nimport { getArkosConfig } from \"../../../../utils/helpers/arkos-config.helpers\";\nimport { capitalize } from \"../../../../utils/helpers/text.helpers\";\n\nexport interface AuthAction {\n  roles?: string[] | \"*\";\n  action: string;\n  resource: string;\n  name?: string;\n  description?: string;\n  errorMessage?: string;\n}\n\nclass AuthActionService {\n  authActions: AuthAction[] = [\n    {\n      roles: [],\n      action: \"View\",\n      resource: \"auth-action\",\n      name: \"View auth action\",\n      description: \"View an auth action\",\n      errorMessage: \"You cannot perform view for auth action\",\n    },\n  ];\n\n  add(\n    action: string,\n    resource: string,\n    accessControl?: AccessControlConfig\n  ): Required<AuthAction> {\n    const transformedAction = this.transformAccessControlToValidAuthAction(\n      action,\n      resource,\n      accessControl\n    );\n    const existingAuthAction = this.getOne(action, resource);\n\n    if (existingAuthAction) {\n      const inconsistencies: string[] = [];\n\n      const defaultName = `${capitalize(kebabCase(action).replace(/-/g, \" \"))} ${capitalize(kebabCase(resource).replace(/-/g, \" \"))}`;\n      const defaultDescription = `${capitalize(kebabCase(action).replace(/-/g, \" \"))} ${capitalize(kebabCase(resource).replace(/-/g, \" \"))}`;\n      const defaultErrorMessage = `You cannot perform ${sentenceCase(action).toLowerCase()} for ${sentenceCase(resource).toLowerCase()}`;\n\n      const isNonDefault = (\n        value: string | undefined,\n        defaultValue: string\n      ): boolean => {\n        return value !== undefined && value !== defaultValue;\n      };\n\n      if (\n        isNonDefault(existingAuthAction.name, defaultName) &&\n        isNonDefault(transformedAction.name, defaultName) &&\n        existingAuthAction.name !== transformedAction.name\n      ) {\n        inconsistencies.push(\n          `  - name: \"${existingAuthAction.name}\" vs \"${transformedAction.name}\"`\n        );\n      }\n\n      if (\n        isNonDefault(existingAuthAction.description, defaultDescription) &&\n        isNonDefault(transformedAction.description, defaultDescription) &&\n        existingAuthAction.description !== transformedAction.description\n      ) {\n        inconsistencies.push(\n          `  - description: \"${existingAuthAction.description}\" vs \"${transformedAction.description}\"`\n        );\n      }\n\n      if (\n        isNonDefault(existingAuthAction.errorMessage, defaultErrorMessage) &&\n        isNonDefault(transformedAction.errorMessage, defaultErrorMessage) &&\n        existingAuthAction.errorMessage !== transformedAction.errorMessage\n      ) {\n        inconsistencies.push(\n          `  - errorMessage: \"${existingAuthAction.errorMessage}\" vs \"${transformedAction.errorMessage}\"`\n        );\n      }\n      if (inconsistencies.length > 0) {\n        throw new Error(\n          `Inconsistent metadata for permission \"${action}:${resource}\". ` +\n            `The same action+resource combination is being defined with different values:\\n` +\n            inconsistencies.join(\"\\n\") +\n            `\\n\\nPlease ensure all definitions of \"${action}:${resource}\" have the same name, description, and errorMessage values.`\n        );\n      }\n\n      const mergedRoles =\n        existingAuthAction.roles || transformedAction.roles\n          ? [\n              ...(existingAuthAction.roles || []),\n              ...(transformedAction.roles || []),\n            ]\n          : undefined;\n\n      const uniqueRoles = mergedRoles\n        ? [...new Set(mergedRoles)].sort()\n        : undefined;\n\n      const merged: Required<AuthAction> = {\n        action: existingAuthAction.action,\n        resource: existingAuthAction.resource,\n        roles: uniqueRoles,\n        name: existingAuthAction.name ?? transformedAction.name,\n        description:\n          existingAuthAction.description ?? transformedAction.description,\n        errorMessage:\n          existingAuthAction.errorMessage ?? transformedAction.errorMessage,\n      } as any;\n\n      this.remove(action, resource);\n      this.authActions.push(merged);\n      return merged;\n    } else {\n      if (transformedAction.roles) {\n        transformedAction.roles = [...transformedAction.roles].sort();\n      }\n      this.authActions.push(transformedAction);\n      return transformedAction;\n    }\n  }\n\n  remove(action: string, resource: string) {\n    this.authActions = this.authActions.filter(\n      (authAction) =>\n        !(authAction.action === action && authAction.resource === resource)\n    );\n  }\n\n  getAll(): AuthAction[] {\n    return this.authActions;\n  }\n\n  getOne(action: string, resource: string): AuthAction | undefined {\n    return this.authActions.find(\n      (authAction) =>\n        authAction.action === action && authAction.resource === resource\n    );\n  }\n\n  private transformAccessControlToValidAuthAction(\n    action: string,\n    resource: string,\n    accessControl?: AccessControlConfig\n  ): Required<AuthAction> {\n    const baseAuthAction: Required<AuthAction> = {\n      roles:\n        (accessControl &&\n          (Array.isArray(accessControl)\n            ? accessControl\n            : typeof accessControl === \"string\"\n              ? [accessControl]\n              : Array.isArray(accessControl?.[action] || {})\n                ? (accessControl[action] as string[])\n                : (accessControl[action] as DetailedAccessControlRule)\n                    ?.roles)) ||\n        [],\n      action,\n      resource,\n      name: `${capitalize(kebabCase(action).replace(/-/g, \" \"))} ${capitalize(kebabCase(resource).replace(/-/g, \" \"))}`,\n      description: `${capitalize(kebabCase(action).replace(/-/g, \" \"))} ${capitalize(kebabCase(resource).replace(/-/g, \" \"))}`,\n      errorMessage: `You cannot perform ${sentenceCase(action).toLowerCase()} for ${sentenceCase(resource).toLowerCase()}`,\n    };\n\n    const config = getArkosConfig();\n\n    if (config?.authentication?.mode === \"dynamic\")\n      delete (baseAuthAction as any).roles;\n\n    if (!accessControl) return baseAuthAction;\n\n    if (Array.isArray(accessControl)) return baseAuthAction;\n\n    const actionRule =\n      (accessControl as any) !== \"*\"\n        ? (accessControl as any)[action]\n        : undefined;\n\n    if (config?.authentication?.mode !== \"static\")\n      delete (baseAuthAction as any).roles;\n\n    if (actionRule) {\n      if (Array.isArray(actionRule)) {\n        return baseAuthAction;\n      } else if (typeof actionRule === \"object\") {\n        return {\n          ...baseAuthAction,\n          name: actionRule.name || baseAuthAction.name,\n          description: actionRule?.description || baseAuthAction.description,\n          errorMessage: actionRule?.errorMessage || baseAuthAction.errorMessage,\n        };\n      }\n    }\n\n    return baseAuthAction;\n  }\n\n  getUniqueActions(): string[] {\n    return [\n      ...new Set(this.authActions.map((authAction) => authAction.action)),\n    ];\n  }\n\n  getUniqueResources(): string[] {\n    return [\n      ...new Set(this.authActions.map((authAction) => authAction.resource)),\n    ];\n  }\n\n  getByResource(resource: string): AuthAction[] | undefined {\n    return this.authActions.filter(\n      (authAction) => authAction.resource === resource\n    );\n  }\n\n  getByAction(action: string): AuthAction[] {\n    return this.authActions.filter(\n      (authAction) => authAction.action === action\n    );\n  }\n\n  exists(action: string, resource: string): boolean {\n    return !!this.getOne(action, resource);\n  }\n}\n\nconst authActionService = new AuthActionService();\n\nexport default authActionService;\n"]}

package/dist/cjs/modules/base/base.controller.js

@@ -52,8 +52,15 @@ class BaseController {
                 let serviceArgs = this.buildServiceArgs(config, req, where, queryOptions);
                 if (config.hooks?.beforeService)
                     serviceArgs = await config.hooks.beforeService(serviceArgs, req);
-                const serviceMethod = this.service[config.serviceMethod];
-                let result = await serviceMethod.apply(this.service, serviceArgs);
+                const routeHook = this.getRouteHook();
+                const isRouteHookMethod = routeHook.service &&
+                    routeHook.service[config.serviceMethod]
+                    ? true
+                    : false;
+                const serviceMethod = (isRouteHookMethod
+                    ? routeHook.service[config.serviceMethod]
+                    : this.service[config.serviceMethod]);
+                let result = await serviceMethod.apply(isRouteHookMethod ? routeHook.service : this.service, serviceArgs);
                 if (config.hooks?.afterService)
                     result = await config.hooks.afterService(result, req);
                 let data = result;
@@ -92,7 +99,6 @@ class BaseController {
                     : this.defaultResponseBuilder(data, additionalData, config.operationType);
                 if (config.hooks?.beforeResponse)
                     responseData = await config.hooks.beforeResponse(responseData, req);
-                const routeHook = this.getRouteHook();
                 if (routeHook &&
                     reader_1.routeHookReader.getHooks(this.modelName, config.operationType)
                         ?.after) {
@@ -187,7 +193,7 @@ class BaseController {
             usesRequestBody: true,
         });
         this.modelName = (0, change_case_helpers_1.kebabCase)(modelName);
-        this.service = new base_service_1.BaseService(modelName);
+        this.service = new base_service_1.ArkosPrismaService(modelName);
     }
     getRouteHook() {
         return arkos_loadable_registry_1.default.getItem("ArkosRouteHook", (0, change_case_helpers_1.kebabCase)((0, change_case_helpers_1.kebabCase)(this.modelName)));

package/dist/cjs/modules/base/base.controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.controller.js","sourceRoot":"","sources":["../../../../src/modules/base/base.controller.ts"],"names":[],"mappings":"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","sourcesContent":["import { ArkosRequest, ArkosResponse, ArkosNextFunction } from \"../../types\";\nimport catchAsync from \"../error-handler/utils/catch-async\";\nimport { BaseService } from \"./base.service\";\nimport AppError from \"../error-handler/utils/app-error\";\nimport { kebabCase, pascalCase } from \"../../utils/helpers/change-case.helpers\";\nimport pluralize from \"pluralize\";\nimport { APIFeatures } from \"../../exports/utils\";\nimport deepmerge from \"../../utils/helpers/deepmerge.helper\";\nimport loadableRegistry from \"../../components/arkos-loadable-registry\";\nimport { ArkosRouteHookInstance } from \"../../components/arkos-route-hook/types\";\nimport { routeHookReader } from \"../../components/arkos-route-hook/reader\";\nimport { PrismaModels } from \"../../generated\";\n\nexport interface OperationHooks {\n  beforeQuery?: (req: ArkosRequest) => void | Promise<void>;\n  afterQuery?: (\n    queryData: { where: any; queryOptions: any },\n    req: ArkosRequest\n  ) => void | Promise<void>;\n  beforeService?: (args: any[], req: ArkosRequest) => any[] | Promise<any[]>;\n  afterService?: (data: any, req: ArkosRequest) => any | Promise<any>;\n  beforeResponse?: (responseData: any, req: ArkosRequest) => any | Promise<any>;\n}\n\ninterface OperationConfig {\n  operationType:\n    | keyof Omit<ArkosRouteHookInstance<any>, \"__type\" | \"moduleName\">\n    | \"batchUpdate\"\n    | \"batchDelete\";\n  serviceMethod: string;\n  successStatus: number;\n  queryFeatures: (\"filter\" | \"sort\" | \"limitFields\" | \"paginate\")[];\n  requiresQueryForBulk?: boolean;\n  preventORFilter?: boolean;\n  responseBuilder?: (data: any, additionalData?: any) => any;\n  errorHandler?: (\n    data: any,\n    req: ArkosRequest,\n    modelName: string\n  ) => AppError | null;\n  usesRequestParams?: boolean;\n  usesRequestBody?: boolean;\n  hooks?: OperationHooks;\n}\n\n/**\n * The `BaseController` class provides standardized RESTful API endpoints\n * for any Prisma model based on its name. It supports automatic integration\n * with Prisma services and dynamic middleware hooks for extending behaviors.\n *\n * This controller includes:\n * - `createOne` / `createMany`\n * - `findOne` / `findMany`\n * - `updateOne` / `updateMany`\n * - `deleteOne` / `deleteMany`\n *\n * It handles:\n * - Prisma query options\n * - APIFeatures: filtering, sorting, pagination, field limiting\n * - Middleware hooks: `afterCreateOne`, `afterUpdateMany`, etc.\n *\n * @class BaseController\n *\n * @param {string} modelName - The Prisma model name this controller handles.\n *\n * @see {@link https://www.arkosjs.com/docs/reference/base-controller}\n *--\n * **See about how Arkos handles routers**\n * @see {@link https://www.arkosjs.com/docs/core-concepts/routing/setup}\n */\nexport class BaseController<TModuleName extends keyof PrismaModels<any>> {\n  /**\n   * Service instance to handle business logic operations\n   * @public\n   */\n  service: BaseService<TModuleName>;\n\n  /**\n   * Name of the model this controller handles\n   * @private\n   */\n  private modelName: string;\n\n  /**\n   * Creates a new BaseController instance\n   * @param {string} modelName - The name of the model for which this controller will handle operations\n   */\n  constructor(modelName: TModuleName) {\n    this.modelName = kebabCase(modelName);\n    this.service = new BaseService(modelName);\n  }\n\n  private getRouteHook() {\n    return loadableRegistry.getItem(\n      \"ArkosRouteHook\",\n      kebabCase(kebabCase(this.modelName))\n    ) as ArkosRouteHookInstance<TModuleName>;\n  }\n\n  private executeOperation = (config: OperationConfig) => {\n    return catchAsync(\n      async (\n        req: ArkosRequest,\n        res: ArkosResponse,\n        next: ArkosNextFunction\n      ) => {\n        if (config.hooks?.beforeQuery) await config.hooks.beforeQuery(req);\n\n        if (config.requiresQueryForBulk) {\n          if (\n            Object.keys(req.query).every((key) =>\n              [\"filterMode\", \"prismaQueryOptions\"].includes(key)\n            )\n          ) {\n            return next(\n              new AppError(\n                `Filter criteria not provided for bulk ${config.operationType.replace(/Many$/, \"\")}.`,\n                400,\n                \"MissingRequestQueryParameters\"\n              )\n            );\n          }\n        }\n\n        if (config.preventORFilter && req.query.filterMode === \"OR\") {\n          throw new AppError(\n            `req.query.filterMode === OR is not valid for ${config.operationType} operation`,\n            400\n          );\n        }\n\n        if (config.preventORFilter) req.query.filterMode = \"AND\";\n\n        let apiFeatures = new APIFeatures(req, this.modelName);\n\n        config.queryFeatures.forEach((feature) => {\n          switch (feature) {\n            case \"filter\":\n              apiFeatures = apiFeatures.filter();\n              break;\n            case \"sort\":\n              apiFeatures = apiFeatures.sort();\n              break;\n            case \"limitFields\":\n              apiFeatures = apiFeatures.limitFields();\n              break;\n            case \"paginate\":\n              apiFeatures = apiFeatures.paginate();\n              break;\n          }\n        });\n\n        const { where, ...queryOptions } = apiFeatures.filters;\n\n        if (config.hooks?.afterQuery)\n          await config.hooks.afterQuery({ where, queryOptions }, req);\n\n        let serviceArgs = this.buildServiceArgs(\n          config,\n          req,\n          where,\n          queryOptions\n        );\n\n        if (config.hooks?.beforeService)\n          serviceArgs = await config.hooks.beforeService(serviceArgs, req);\n\n        const serviceMethod = this.service[\n          config.serviceMethod as keyof BaseService<any>\n        ] as Function;\n        let result = await serviceMethod.apply(this.service, serviceArgs);\n\n        if (config.hooks?.afterService)\n          result = await config.hooks.afterService(result, req);\n\n        let data = result;\n        let additionalData: any = null;\n\n        if (config.operationType === \"findMany\") {\n          const [records, total] = await Promise.all([\n            result,\n            this.service.count(where, {\n              user: req?.user!,\n              accessToken: req?.accessToken,\n            }),\n          ]);\n\n          const take = serviceArgs[1]?.take ?? null;\n          const skip = serviceArgs[1]?.skip ?? 0;\n\n          const limit = take ?? total;\n          const currentPage = limit > 0 ? Math.floor(skip / limit) + 1 : 1;\n          const totalPages = limit > 0 ? Math.ceil(total / limit) : 1;\n\n          data = records;\n          additionalData = {\n            total,\n            results: records.length,\n            page: currentPage,\n            pages: totalPages,\n            limit,\n            hasNextPage: currentPage < totalPages,\n            hasPrevPage: currentPage > 1,\n          };\n        }\n\n        const error = config.errorHandler\n          ? config.errorHandler(data, req, this.modelName)\n          : this.defaultErrorHandler(data, req, config.operationType);\n\n        if (error) return next(error);\n\n        let responseData = config.responseBuilder\n          ? config.responseBuilder(data, additionalData)\n          : this.defaultResponseBuilder(\n              data,\n              additionalData,\n              config.operationType\n            );\n\n        if (config.hooks?.beforeResponse)\n          responseData = await config.hooks.beforeResponse(responseData, req);\n\n        const routeHook = this.getRouteHook();\n\n        if (\n          routeHook &&\n          routeHookReader.getHooks(this.modelName, config.operationType as any)\n            ?.after\n        ) {\n          this.setResponseData(req, res, responseData, config.successStatus);\n          next();\n          return;\n        }\n\n        if (config.operationType === \"deleteOne\") {\n          res.status(config.successStatus).send();\n          return;\n        }\n\n        res.status(config.successStatus).json(responseData);\n      }\n    );\n  };\n\n  /**\n   * Sets response data for both legacy (req.responseData) and modern (res.locals) support\n   */\n  private setResponseData(\n    req: ArkosRequest,\n    res: ArkosResponse,\n    data: any,\n    status: number\n  ): void {\n    (res as any).originalData = data;\n    req.responseData = data;\n    res.locals.data = data;\n    (res as any).originalStatus = status;\n    req.responseStatus = status;\n    res.locals.status = status;\n\n    // Special handling for deleteOne\n    if (status === 204) {\n      req.additionalData = data;\n      res.locals.additionalData = data;\n      (res as any).originalAdditionalData = data;\n    }\n  }\n\n  /**\n   * Builds service method arguments based on operation configuration\n   */\n  private buildServiceArgs(\n    config: OperationConfig,\n    req: ArkosRequest,\n    where: any,\n    queryOptions: any\n  ): any[] {\n    const context = { user: req?.user, accessToken: req?.accessToken };\n    const mergedOptions = deepmerge(req.prismaQueryOptions || {}, queryOptions);\n\n    switch (config.operationType) {\n      case \"createOne\":\n      case \"createMany\":\n        return [req.body, mergedOptions, context];\n\n      case \"findMany\":\n        return [where, queryOptions, context];\n\n      case \"findOne\":\n        return [{ ...req.params, ...where }, mergedOptions, context];\n\n      case \"updateOne\":\n        return [{ ...req.params, ...where }, req.body, mergedOptions, context];\n\n      case \"updateMany\":\n        // Remove include for bulk operations\n        delete queryOptions.include;\n        return [where, req.body, queryOptions, context];\n\n      case \"batchUpdate\":\n        return [req.body, mergedOptions, context];\n\n      case \"deleteOne\":\n        return [{ ...req.params, ...where }, context];\n\n      case \"deleteMany\":\n        return [where, context];\n\n      case \"batchDelete\":\n        return [req.body, context];\n\n      default:\n        throw new Error(`Unknown operation type: ${config.operationType}`);\n    }\n  }\n\n  /**\n   * Default error handler for operations\n   */\n  private defaultErrorHandler(\n    data: any,\n    req: ArkosRequest,\n    operationType: string\n  ): AppError | null {\n    if (!data || (Array.isArray(data) && data.length === 0)) {\n      // Handle different error scenarios\n      if (operationType.includes(\"create\") || operationType.includes(\"batch\")) {\n        return new AppError(\n          \"Failed to create the resources. Please check your input.\",\n          400,\n          { body: req.body }\n        );\n      }\n\n      if (\n        operationType === \"findOne\" ||\n        operationType === \"updateOne\" ||\n        operationType === \"deleteOne\"\n      ) {\n        if (\n          Object.keys(req.params).length === 1 &&\n          \"id\" in req.params &&\n          req.params.id !== \"me\"\n        ) {\n          return new AppError(\n            `${pascalCase(String(this.modelName))} with ID ${req.params?.id} not found`,\n            404,\n            {},\n            \"NotFound\"\n          );\n        } else {\n          return new AppError(\n            `${pascalCase(String(this.modelName))} not found`,\n            404,\n            {},\n            \"NotFound\"\n          );\n        }\n      }\n\n      if (operationType === \"updateMany\" || operationType === \"deleteMany\") {\n        const isUpdate = operationType === \"updateMany\";\n        return new AppError(\n          isUpdate\n            ? `${pluralize(pascalCase(String(this.modelName)))} not found`\n            : `No records found to delete`,\n          404,\n          {},\n          \"NotFound\"\n        );\n      }\n    }\n\n    // Special handling for operations that return count\n    if (\n      data &&\n      typeof data === \"object\" &&\n      \"count\" in data &&\n      data.count === 0\n    ) {\n      return new AppError(\n        operationType === \"updateMany\"\n          ? `${pluralize(pascalCase(String(this.modelName)))} not found`\n          : `No records found to delete`,\n        404,\n        {},\n        \"NotFound\"\n      );\n    }\n\n    return null;\n  }\n\n  /**\n   * Default response builder for operations\n   */\n  private defaultResponseBuilder(\n    data: any,\n    additionalData: any,\n    operationType: string\n  ): any {\n    if (operationType === \"findMany\" && additionalData)\n      return {\n        ...additionalData,\n        data,\n      };\n\n    if (\n      operationType.includes(\"Many\") &&\n      data &&\n      typeof data === \"object\" &&\n      \"count\" in data\n    )\n      return { results: data.count, data };\n\n    if (operationType.includes(\"batch\") && Array.isArray(data))\n      return { results: data.length, data };\n\n    return { data };\n  }\n\n  /**\n   * Creates a single resource\n   */\n  createOne = this.executeOperation({\n    operationType: \"createOne\",\n    serviceMethod: \"createOne\",\n    successStatus: 201,\n    queryFeatures: [\"limitFields\"],\n    usesRequestBody: true,\n  });\n\n  /**\n   * Creates multiple resources in a single operation\n   */\n  createMany = this.executeOperation({\n    operationType: \"createMany\",\n    serviceMethod: \"createMany\",\n    successStatus: 201,\n    queryFeatures: [\"limitFields\"],\n    usesRequestBody: true,\n    hooks: {\n      async beforeQuery(req) {\n        if (!req.body || (Array.isArray(req.body) && req.body.length === 0))\n          throw new AppError(\n            \"Expected request body array to contain at least on item but received none\",\n            400,\n            { body: req.body },\n            \"MissingArrayRequestBody\"\n          );\n      },\n    },\n  });\n\n  /**\n   * Retrieves multiple resources with filtering, sorting, pagination, and field selection\n   */\n  findMany = this.executeOperation({\n    operationType: \"findMany\",\n    serviceMethod: \"findMany\",\n    successStatus: 200,\n    queryFeatures: [\"filter\", \"sort\", \"limitFields\", \"paginate\"],\n  });\n\n  /**\n   * Retrieves a single resource by its identifier\n   */\n  findOne = this.executeOperation({\n    operationType: \"findOne\",\n    serviceMethod: \"findOne\",\n    successStatus: 200,\n    queryFeatures: [\"limitFields\", \"filter\"],\n    usesRequestParams: true,\n  });\n\n  /**\n   * Updates a single resource by its identifier\n   */\n  updateOne = this.executeOperation({\n    operationType: \"updateOne\",\n    serviceMethod: \"updateOne\",\n    successStatus: 200,\n    queryFeatures: [\"limitFields\", \"filter\"],\n    usesRequestParams: true,\n    usesRequestBody: true,\n  });\n\n  /**\n   * Updates multiple resources that match specified criteria\n   */\n  updateMany = this.executeOperation({\n    operationType: \"updateMany\",\n    serviceMethod: \"updateMany\",\n    successStatus: 200,\n    queryFeatures: [\"filter\", \"limitFields\"],\n    requiresQueryForBulk: true,\n    preventORFilter: true,\n    usesRequestBody: true,\n  });\n\n  /**\n   * Updates multiple resources with different data in a single transaction\n   */\n  batchUpdate = this.executeOperation({\n    operationType: \"batchUpdate\",\n    serviceMethod: \"batchUpdate\",\n    successStatus: 200,\n    queryFeatures: [\"limitFields\", \"filter\"],\n    usesRequestBody: true,\n  });\n\n  /**\n   * Deletes a single resource by its identifier\n   */\n  deleteOne = this.executeOperation({\n    operationType: \"deleteOne\",\n    serviceMethod: \"deleteOne\",\n    successStatus: 204,\n    queryFeatures: [\"filter\"],\n    usesRequestParams: true,\n  });\n\n  /**\n   * Deletes multiple resources that match specified criteria\n   */\n  deleteMany = this.executeOperation({\n    operationType: \"deleteMany\",\n    serviceMethod: \"deleteMany\",\n    successStatus: 200,\n    queryFeatures: [\"filter\"],\n    requiresQueryForBulk: true,\n    preventORFilter: true,\n  });\n\n  /**\n   * Deletes multiple resources with different filters in a single transaction\n   */\n  batchDelete = this.executeOperation({\n    operationType: \"batchDelete\",\n    serviceMethod: \"batchDelete\",\n    successStatus: 200,\n    queryFeatures: [\"filter\"],\n    usesRequestBody: true,\n  });\n}\n"]}
+{"version":3,"file":"base.controller.js","sourceRoot":"","sources":["../../../../src/modules/base/base.controller.ts"],"names":[],"mappings":";;;;;;AACA,qFAA4D;AAC5D,iDAAoD;AACpD,iFAAwD;AACxD,iFAAgF;AAChF,0DAAkC;AAClC,+CAAkD;AAClD,4FAA6D;AAC7D,uGAAwE;AAExE,qEAA2E;AA4D3E,MAAa,cAAc;IAiBzB,YAAY,SAAsB;QAY1B,qBAAgB,GAAG,CAAC,MAAuB,EAAE,EAAE;YACrD,OAAO,IAAA,qBAAU,EACf,KAAK,EACH,GAAiB,EACjB,GAAkB,EAClB,IAAuB,EACvB,EAAE;gBACF,IAAI,MAAM,CAAC,KAAK,EAAE,WAAW;oBAAE,MAAM,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;gBAEnE,IAAI,MAAM,CAAC,oBAAoB,EAAE,CAAC;oBAChC,IACE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CACnC,CAAC,YAAY,EAAE,oBAAoB,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CACnD,EACD,CAAC;wBACD,OAAO,IAAI,CACT,IAAI,mBAAQ,CACV,yCAAyC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,EACrF,GAAG,EACH,+BAA+B,CAChC,CACF,CAAC;oBACJ,CAAC;gBACH,CAAC;gBAED,IAAI,MAAM,CAAC,eAAe,IAAI,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;oBAC5D,MAAM,IAAI,mBAAQ,CAChB,gDAAgD,MAAM,CAAC,aAAa,YAAY,EAChF,GAAG,CACJ,CAAC;gBACJ,CAAC;gBAED,IAAI,MAAM,CAAC,eAAe;oBAAE,GAAG,CAAC,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC;gBAEzD,IAAI,WAAW,GAAG,IAAI,mBAAW,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;gBAEvD,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;oBACvC,QAAQ,OAAO,EAAE,CAAC;wBAChB,KAAK,QAAQ;4BACX,WAAW,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC;4BACnC,MAAM;wBACR,KAAK,MAAM;4BACT,WAAW,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;4BACjC,MAAM;wBACR,KAAK,aAAa;4BAChB,WAAW,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;4BACxC,MAAM;wBACR,KAAK,UAAU;4BACb,WAAW,GAAG,WAAW,CAAC,QAAQ,EAAE,CAAC;4BACrC,MAAM;oBACV,CAAC;gBACH,CAAC,CAAC,CAAC;gBAEH,MAAM,EAAE,KAAK,EAAE,GAAG,YAAY,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC;gBAEvD,IAAI,MAAM,CAAC,KAAK,EAAE,UAAU;oBAC1B,MAAM,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,GAAG,CAAC,CAAC;gBAE9D,IAAI,WAAW,GAAG,IAAI,CAAC,gBAAgB,CACrC,MAAM,EACN,GAAG,EACH,KAAK,EACL,YAAY,CACb,CAAC;gBAEF,IAAI,MAAM,CAAC,KAAK,EAAE,aAAa;oBAC7B,WAAW,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;gBAEnE,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;gBACtC,MAAM,iBAAiB,GACrB,SAAS,CAAC,OAAO;oBACjB,SAAS,CAAC,OAAO,CACf,MAAM,CAAC,aAA8C,CACtD;oBACC,CAAC,CAAC,IAAI;oBACN,CAAC,CAAC,KAAK,CAAC;gBAEZ,MAAM,aAAa,GAAG,CACpB,iBAAiB;oBACf,CAAC,CAAC,SAAS,CAAC,OAAQ,CAChB,MAAM,CAAC,aAA8C,CACtD;oBACH,CAAC,CAAC,IAAI,CAAC,OAAO,CACV,MAAM,CAAC,aAA8C,CACtD,CACM,CAAC;gBAEd,IAAI,MAAM,GAAG,MAAM,aAAa,CAAC,KAAK,CACpC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EACpD,WAAW,CACZ,CAAC;gBAEF,IAAI,MAAM,CAAC,KAAK,EAAE,YAAY;oBAC5B,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;gBAExD,IAAI,IAAI,GAAG,MAAM,CAAC;gBAClB,IAAI,cAAc,GAAQ,IAAI,CAAC;gBAE/B,IAAI,MAAM,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;oBACxC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;wBACzC,MAAM;wBACN,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE;4BACxB,IAAI,EAAE,GAAG,EAAE,IAAK;4BAChB,WAAW,EAAE,GAAG,EAAE,WAAW;yBAC9B,CAAC;qBACH,CAAC,CAAC;oBAEH,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC;oBAC1C,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC;oBAEvC,MAAM,KAAK,GAAG,IAAI,IAAI,KAAK,CAAC;oBAC5B,MAAM,WAAW,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBACjE,MAAM,UAAU,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBAE5D,IAAI,GAAG,OAAO,CAAC;oBACf,cAAc,GAAG;wBACf,KAAK;wBACL,OAAO,EAAE,OAAO,CAAC,MAAM;wBACvB,IAAI,EAAE,WAAW;wBACjB,KAAK,EAAE,UAAU;wBACjB,KAAK;wBACL,WAAW,EAAE,WAAW,GAAG,UAAU;wBACrC,WAAW,EAAE,WAAW,GAAG,CAAC;qBAC7B,CAAC;gBACJ,CAAC;gBAED,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY;oBAC/B,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC;oBAChD,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;gBAE9D,IAAI,KAAK;oBAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;gBAE9B,IAAI,YAAY,GAAG,MAAM,CAAC,eAAe;oBACvC,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,cAAc,CAAC;oBAC9C,CAAC,CAAC,IAAI,CAAC,sBAAsB,CACzB,IAAI,EACJ,cAAc,EACd,MAAM,CAAC,aAAa,CACrB,CAAC;gBAEN,IAAI,MAAM,CAAC,KAAK,EAAE,cAAc;oBAC9B,YAAY,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;gBAEtE,IACE,SAAS;oBACT,wBAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,aAAoB,CAAC;wBACnE,EAAE,KAAK,EACT,CAAC;oBACD,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;oBACnE,IAAI,EAAE,CAAC;oBACP,OAAO;gBACT,CAAC;gBAED,IAAI,MAAM,CAAC,aAAa,KAAK,WAAW,EAAE,CAAC;oBACzC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,CAAC;oBACxC,OAAO;gBACT,CAAC;gBAED,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACtD,CAAC,CACF,CAAC;QACJ,CAAC,CAAC;QAsLF,cAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC;YAChC,aAAa,EAAE,WAAW;YAC1B,aAAa,EAAE,WAAW;YAC1B,aAAa,EAAE,GAAG;YAClB,aAAa,EAAE,CAAC,aAAa,CAAC;YAC9B,eAAe,EAAE,IAAI;SACtB,CAAC,CAAC;QAKH,eAAU,GAAG,IAAI,CAAC,gBAAgB,CAAC;YACjC,aAAa,EAAE,YAAY;YAC3B,aAAa,EAAE,YAAY;YAC3B,aAAa,EAAE,GAAG;YAClB,aAAa,EAAE,CAAC,aAAa,CAAC;YAC9B,eAAe,EAAE,IAAI;YACrB,KAAK,EAAE;gBACL,KAAK,CAAC,WAAW,CAAC,GAAG;oBACnB,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC;wBACjE,MAAM,IAAI,mBAAQ,CAChB,2EAA2E,EAC3E,GAAG,EACH,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,EAClB,yBAAyB,CAC1B,CAAC;gBACN,CAAC;aACF;SACF,CAAC,CAAC;QAKH,aAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC;YAC/B,aAAa,EAAE,UAAU;YACzB,aAAa,EAAE,UAAU;YACzB,aAAa,EAAE,GAAG;YAClB,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,UAAU,CAAC;SAC7D,CAAC,CAAC;QAKH,YAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC;YAC9B,aAAa,EAAE,SAAS;YACxB,aAAa,EAAE,SAAS;YACxB,aAAa,EAAE,GAAG;YAClB,aAAa,EAAE,CAAC,aAAa,EAAE,QAAQ,CAAC;YACxC,iBAAiB,EAAE,IAAI;SACxB,CAAC,CAAC;QAKH,cAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC;YAChC,aAAa,EAAE,WAAW;YAC1B,aAAa,EAAE,WAAW;YAC1B,aAAa,EAAE,GAAG;YAClB,aAAa,EAAE,CAAC,aAAa,EAAE,QAAQ,CAAC;YACxC,iBAAiB,EAAE,IAAI;YACvB,eAAe,EAAE,IAAI;SACtB,CAAC,CAAC;QAKH,eAAU,GAAG,IAAI,CAAC,gBAAgB,CAAC;YACjC,aAAa,EAAE,YAAY;YAC3B,aAAa,EAAE,YAAY;YAC3B,aAAa,EAAE,GAAG;YAClB,aAAa,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC;YACxC,oBAAoB,EAAE,IAAI;YAC1B,eAAe,EAAE,IAAI;YACrB,eAAe,EAAE,IAAI;SACtB,CAAC,CAAC;QAKH,gBAAW,GAAG,IAAI,CAAC,gBAAgB,CAAC;YAClC,aAAa,EAAE,aAAa;YAC5B,aAAa,EAAE,aAAa;YAC5B,aAAa,EAAE,GAAG;YAClB,aAAa,EAAE,CAAC,aAAa,EAAE,QAAQ,CAAC;YACxC,eAAe,EAAE,IAAI;SACtB,CAAC,CAAC;QAKH,cAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC;YAChC,aAAa,EAAE,WAAW;YAC1B,aAAa,EAAE,WAAW;YAC1B,aAAa,EAAE,GAAG;YAClB,aAAa,EAAE,CAAC,QAAQ,CAAC;YACzB,iBAAiB,EAAE,IAAI;SACxB,CAAC,CAAC;QAKH,eAAU,GAAG,IAAI,CAAC,gBAAgB,CAAC;YACjC,aAAa,EAAE,YAAY;YAC3B,aAAa,EAAE,YAAY;YAC3B,aAAa,EAAE,GAAG;YAClB,aAAa,EAAE,CAAC,QAAQ,CAAC;YACzB,oBAAoB,EAAE,IAAI;YAC1B,eAAe,EAAE,IAAI;SACtB,CAAC,CAAC;QAKH,gBAAW,GAAG,IAAI,CAAC,gBAAgB,CAAC;YAClC,aAAa,EAAE,aAAa;YAC5B,aAAa,EAAE,aAAa;YAC5B,aAAa,EAAE,GAAG;YAClB,aAAa,EAAE,CAAC,QAAQ,CAAC;YACzB,eAAe,EAAE,IAAI;SACtB,CAAC,CAAC;QAzdD,IAAI,CAAC,SAAS,GAAG,IAAA,+BAAS,EAAC,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,OAAO,GAAG,IAAI,iCAAkB,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC;IAEO,YAAY;QAClB,OAAO,iCAAgB,CAAC,OAAO,CAC7B,gBAAgB,EAChB,IAAA,+BAAS,EAAC,IAAA,+BAAS,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CACE,CAAC;IAC3C,CAAC;IAwKO,eAAe,CACrB,GAAiB,EACjB,GAAkB,EAClB,IAAS,EACT,MAAc;QAEb,GAAW,CAAC,YAAY,GAAG,IAAI,CAAC;QACjC,GAAG,CAAC,YAAY,GAAG,IAAI,CAAC;QACxB,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;QACtB,GAAW,CAAC,cAAc,GAAG,MAAM,CAAC;QACrC,GAAG,CAAC,cAAc,GAAG,MAAM,CAAC;QAC5B,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QAG3B,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,GAAG,CAAC,cAAc,GAAG,IAAI,CAAC;YAC1B,GAAG,CAAC,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;YAChC,GAAW,CAAC,sBAAsB,GAAG,IAAI,CAAC;QAC7C,CAAC;IACH,CAAC;IAKO,gBAAgB,CACtB,MAAuB,EACvB,GAAiB,EACjB,KAAU,EACV,YAAiB;QAEjB,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC;QACnE,MAAM,aAAa,GAAG,IAAA,0BAAS,EAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,EAAE,YAAY,CAAC,CAAC;QAE5E,QAAQ,MAAM,CAAC,aAAa,EAAE,CAAC;YAC7B,KAAK,WAAW,CAAC;YACjB,KAAK,YAAY;gBACf,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;YAE5C,KAAK,UAAU;gBACb,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;YAExC,KAAK,SAAS;gBACZ,OAAO,CAAC,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;YAE/D,KAAK,WAAW;gBACd,OAAO,CAAC,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,KAAK,EAAE,EAAE,GAAG,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;YAEzE,KAAK,YAAY;gBAEf,OAAO,YAAY,CAAC,OAAO,CAAC;gBAC5B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;YAElD,KAAK,aAAa;gBAChB,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;YAE5C,KAAK,WAAW;gBACd,OAAO,CAAC,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;YAEhD,KAAK,YAAY;gBACf,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAE1B,KAAK,aAAa;gBAChB,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAE7B;gBACE,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAKO,mBAAmB,CACzB,IAAS,EACT,GAAiB,EACjB,aAAqB;QAErB,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;YAExD,IAAI,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACxE,OAAO,IAAI,mBAAQ,CACjB,0DAA0D,EAC1D,GAAG,EACH,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CACnB,CAAC;YACJ,CAAC;YAED,IACE,aAAa,KAAK,SAAS;gBAC3B,aAAa,KAAK,WAAW;gBAC7B,aAAa,KAAK,WAAW,EAC7B,CAAC;gBACD,IACE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC;oBACpC,IAAI,IAAI,GAAG,CAAC,MAAM;oBAClB,GAAG,CAAC,MAAM,CAAC,EAAE,KAAK,IAAI,EACtB,CAAC;oBACD,OAAO,IAAI,mBAAQ,CACjB,GAAG,IAAA,gCAAU,EAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,YAAY,GAAG,CAAC,MAAM,EAAE,EAAE,YAAY,EAC3E,GAAG,EACH,EAAE,EACF,UAAU,CACX,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,OAAO,IAAI,mBAAQ,CACjB,GAAG,IAAA,gCAAU,EAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,YAAY,EACjD,GAAG,EACH,EAAE,EACF,UAAU,CACX,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,IAAI,aAAa,KAAK,YAAY,IAAI,aAAa,KAAK,YAAY,EAAE,CAAC;gBACrE,MAAM,QAAQ,GAAG,aAAa,KAAK,YAAY,CAAC;gBAChD,OAAO,IAAI,mBAAQ,CACjB,QAAQ;oBACN,CAAC,CAAC,GAAG,IAAA,mBAAS,EAAC,IAAA,gCAAU,EAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY;oBAC9D,CAAC,CAAC,4BAA4B,EAChC,GAAG,EACH,EAAE,EACF,UAAU,CACX,CAAC;YACJ,CAAC;QACH,CAAC;QAGD,IACE,IAAI;YACJ,OAAO,IAAI,KAAK,QAAQ;YACxB,OAAO,IAAI,IAAI;YACf,IAAI,CAAC,KAAK,KAAK,CAAC,EAChB,CAAC;YACD,OAAO,IAAI,mBAAQ,CACjB,aAAa,KAAK,YAAY;gBAC5B,CAAC,CAAC,GAAG,IAAA,mBAAS,EAAC,IAAA,gCAAU,EAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY;gBAC9D,CAAC,CAAC,4BAA4B,EAChC,GAAG,EACH,EAAE,EACF,UAAU,CACX,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAKO,sBAAsB,CAC5B,IAAS,EACT,cAAmB,EACnB,aAAqB;QAErB,IAAI,aAAa,KAAK,UAAU,IAAI,cAAc;YAChD,OAAO;gBACL,GAAG,cAAc;gBACjB,IAAI;aACL,CAAC;QAEJ,IACE,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC9B,IAAI;YACJ,OAAO,IAAI,KAAK,QAAQ;YACxB,OAAO,IAAI,IAAI;YAEf,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;QAEvC,IAAI,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YACxD,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;QAExC,OAAO,EAAE,IAAI,EAAE,CAAC;IAClB,CAAC;CA6HF;AA5eD,wCA4eC","sourcesContent":["import { ArkosRequest, ArkosResponse, ArkosNextFunction } from \"../../types\";\nimport catchAsync from \"../error-handler/utils/catch-async\";\nimport { ArkosPrismaService } from \"./base.service\";\nimport AppError from \"../error-handler/utils/app-error\";\nimport { kebabCase, pascalCase } from \"../../utils/helpers/change-case.helpers\";\nimport pluralize from \"pluralize\";\nimport { APIFeatures } from \"../../exports/utils\";\nimport deepmerge from \"../../utils/helpers/deepmerge.helper\";\nimport loadableRegistry from \"../../components/arkos-loadable-registry\";\nimport { ArkosRouteHookInstance } from \"../../components/arkos-route-hook/types\";\nimport { routeHookReader } from \"../../components/arkos-route-hook/reader\";\nimport { PrismaModels } from \"../../generated\";\n\nexport interface OperationHooks {\n  beforeQuery?: (req: ArkosRequest) => void | Promise<void>;\n  afterQuery?: (\n    queryData: { where: any; queryOptions: any },\n    req: ArkosRequest\n  ) => void | Promise<void>;\n  beforeService?: (args: any[], req: ArkosRequest) => any[] | Promise<any[]>;\n  afterService?: (data: any, req: ArkosRequest) => any | Promise<any>;\n  beforeResponse?: (responseData: any, req: ArkosRequest) => any | Promise<any>;\n}\n\ninterface OperationConfig {\n  operationType:\n    | keyof Omit<ArkosRouteHookInstance<any>, \"__type\" | \"moduleName\">\n    | \"batchUpdate\"\n    | \"batchDelete\";\n  serviceMethod: string;\n  successStatus: number;\n  queryFeatures: (\"filter\" | \"sort\" | \"limitFields\" | \"paginate\")[];\n  requiresQueryForBulk?: boolean;\n  preventORFilter?: boolean;\n  responseBuilder?: (data: any, additionalData?: any) => any;\n  errorHandler?: (\n    data: any,\n    req: ArkosRequest,\n    modelName: string\n  ) => AppError | null;\n  usesRequestParams?: boolean;\n  usesRequestBody?: boolean;\n  hooks?: OperationHooks;\n}\n\n/**\n * The `BaseController` class provides standardized RESTful API endpoints\n * for any Prisma model based on its name. It supports automatic integration\n * with Prisma services and dynamic middleware hooks for extending behaviors.\n *\n * This controller includes:\n * - `createOne` / `createMany`\n * - `findOne` / `findMany`\n * - `updateOne` / `updateMany`\n * - `deleteOne` / `deleteMany`\n *\n * It handles:\n * - Prisma query options\n * - APIFeatures: filtering, sorting, pagination, field limiting\n * - Middleware hooks: `afterCreateOne`, `afterUpdateMany`, etc.\n *\n * @class BaseController\n *\n * @param {string} modelName - The Prisma model name this controller handles.\n *\n * @see {@link https://www.arkosjs.com/docs/reference/base-controller}\n *--\n * **See about how Arkos handles routers**\n * @see {@link https://www.arkosjs.com/docs/core-concepts/routing/setup}\n */\nexport class BaseController<TModuleName extends keyof PrismaModels<any>> {\n  /**\n   * Service instance to handle business logic operations\n   * @public\n   */\n  service: ArkosPrismaService<TModuleName>;\n\n  /**\n   * Name of the model this controller handles\n   * @private\n   */\n  private modelName: string;\n\n  /**\n   * Creates a new BaseController instance\n   * @param {string} modelName - The name of the model for which this controller will handle operations\n   */\n  constructor(modelName: TModuleName) {\n    this.modelName = kebabCase(modelName);\n    this.service = new ArkosPrismaService(modelName);\n  }\n\n  private getRouteHook() {\n    return loadableRegistry.getItem(\n      \"ArkosRouteHook\",\n      kebabCase(kebabCase(this.modelName))\n    ) as ArkosRouteHookInstance<TModuleName>;\n  }\n\n  private executeOperation = (config: OperationConfig) => {\n    return catchAsync(\n      async (\n        req: ArkosRequest,\n        res: ArkosResponse,\n        next: ArkosNextFunction\n      ) => {\n        if (config.hooks?.beforeQuery) await config.hooks.beforeQuery(req);\n\n        if (config.requiresQueryForBulk) {\n          if (\n            Object.keys(req.query).every((key) =>\n              [\"filterMode\", \"prismaQueryOptions\"].includes(key)\n            )\n          ) {\n            return next(\n              new AppError(\n                `Filter criteria not provided for bulk ${config.operationType.replace(/Many$/, \"\")}.`,\n                400,\n                \"MissingRequestQueryParameters\"\n              )\n            );\n          }\n        }\n\n        if (config.preventORFilter && req.query.filterMode === \"OR\") {\n          throw new AppError(\n            `req.query.filterMode === OR is not valid for ${config.operationType} operation`,\n            400\n          );\n        }\n\n        if (config.preventORFilter) req.query.filterMode = \"AND\";\n\n        let apiFeatures = new APIFeatures(req, this.modelName);\n\n        config.queryFeatures.forEach((feature) => {\n          switch (feature) {\n            case \"filter\":\n              apiFeatures = apiFeatures.filter();\n              break;\n            case \"sort\":\n              apiFeatures = apiFeatures.sort();\n              break;\n            case \"limitFields\":\n              apiFeatures = apiFeatures.limitFields();\n              break;\n            case \"paginate\":\n              apiFeatures = apiFeatures.paginate();\n              break;\n          }\n        });\n\n        const { where, ...queryOptions } = apiFeatures.filters;\n\n        if (config.hooks?.afterQuery)\n          await config.hooks.afterQuery({ where, queryOptions }, req);\n\n        let serviceArgs = this.buildServiceArgs(\n          config,\n          req,\n          where,\n          queryOptions\n        );\n\n        if (config.hooks?.beforeService)\n          serviceArgs = await config.hooks.beforeService(serviceArgs, req);\n\n        const routeHook = this.getRouteHook();\n        const isRouteHookMethod =\n          routeHook.service &&\n          routeHook.service[\n            config.serviceMethod as keyof ArkosPrismaService<any>\n          ]\n            ? true\n            : false;\n\n        const serviceMethod = (\n          isRouteHookMethod\n            ? routeHook.service![\n                config.serviceMethod as keyof ArkosPrismaService<any>\n              ]\n            : this.service[\n                config.serviceMethod as keyof ArkosPrismaService<any>\n              ]\n        ) as Function;\n\n        let result = await serviceMethod.apply(\n          isRouteHookMethod ? routeHook.service : this.service,\n          serviceArgs\n        );\n\n        if (config.hooks?.afterService)\n          result = await config.hooks.afterService(result, req);\n\n        let data = result;\n        let additionalData: any = null;\n\n        if (config.operationType === \"findMany\") {\n          const [records, total] = await Promise.all([\n            result,\n            this.service.count(where, {\n              user: req?.user!,\n              accessToken: req?.accessToken,\n            }),\n          ]);\n\n          const take = serviceArgs[1]?.take ?? null;\n          const skip = serviceArgs[1]?.skip ?? 0;\n\n          const limit = take ?? total;\n          const currentPage = limit > 0 ? Math.floor(skip / limit) + 1 : 1;\n          const totalPages = limit > 0 ? Math.ceil(total / limit) : 1;\n\n          data = records;\n          additionalData = {\n            total,\n            results: records.length,\n            page: currentPage,\n            pages: totalPages,\n            limit,\n            hasNextPage: currentPage < totalPages,\n            hasPrevPage: currentPage > 1,\n          };\n        }\n\n        const error = config.errorHandler\n          ? config.errorHandler(data, req, this.modelName)\n          : this.defaultErrorHandler(data, req, config.operationType);\n\n        if (error) return next(error);\n\n        let responseData = config.responseBuilder\n          ? config.responseBuilder(data, additionalData)\n          : this.defaultResponseBuilder(\n              data,\n              additionalData,\n              config.operationType\n            );\n\n        if (config.hooks?.beforeResponse)\n          responseData = await config.hooks.beforeResponse(responseData, req);\n\n        if (\n          routeHook &&\n          routeHookReader.getHooks(this.modelName, config.operationType as any)\n            ?.after\n        ) {\n          this.setResponseData(req, res, responseData, config.successStatus);\n          next();\n          return;\n        }\n\n        if (config.operationType === \"deleteOne\") {\n          res.status(config.successStatus).send();\n          return;\n        }\n\n        res.status(config.successStatus).json(responseData);\n      }\n    );\n  };\n\n  /**\n   * Sets response data for both legacy (req.responseData) and modern (res.locals) support\n   */\n  private setResponseData(\n    req: ArkosRequest,\n    res: ArkosResponse,\n    data: any,\n    status: number\n  ): void {\n    (res as any).originalData = data;\n    req.responseData = data;\n    res.locals.data = data;\n    (res as any).originalStatus = status;\n    req.responseStatus = status;\n    res.locals.status = status;\n\n    // Special handling for deleteOne\n    if (status === 204) {\n      req.additionalData = data;\n      res.locals.additionalData = data;\n      (res as any).originalAdditionalData = data;\n    }\n  }\n\n  /**\n   * Builds service method arguments based on operation configuration\n   */\n  private buildServiceArgs(\n    config: OperationConfig,\n    req: ArkosRequest,\n    where: any,\n    queryOptions: any\n  ): any[] {\n    const context = { user: req?.user, accessToken: req?.accessToken };\n    const mergedOptions = deepmerge(req.prismaQueryOptions || {}, queryOptions);\n\n    switch (config.operationType) {\n      case \"createOne\":\n      case \"createMany\":\n        return [req.body, mergedOptions, context];\n\n      case \"findMany\":\n        return [where, queryOptions, context];\n\n      case \"findOne\":\n        return [{ ...req.params, ...where }, mergedOptions, context];\n\n      case \"updateOne\":\n        return [{ ...req.params, ...where }, req.body, mergedOptions, context];\n\n      case \"updateMany\":\n        // Remove include for bulk operations\n        delete queryOptions.include;\n        return [where, req.body, queryOptions, context];\n\n      case \"batchUpdate\":\n        return [req.body, mergedOptions, context];\n\n      case \"deleteOne\":\n        return [{ ...req.params, ...where }, context];\n\n      case \"deleteMany\":\n        return [where, context];\n\n      case \"batchDelete\":\n        return [req.body, context];\n\n      default:\n        throw new Error(`Unknown operation type: ${config.operationType}`);\n    }\n  }\n\n  /**\n   * Default error handler for operations\n   */\n  private defaultErrorHandler(\n    data: any,\n    req: ArkosRequest,\n    operationType: string\n  ): AppError | null {\n    if (!data || (Array.isArray(data) && data.length === 0)) {\n      // Handle different error scenarios\n      if (operationType.includes(\"create\") || operationType.includes(\"batch\")) {\n        return new AppError(\n          \"Failed to create the resources. Please check your input.\",\n          400,\n          { body: req.body }\n        );\n      }\n\n      if (\n        operationType === \"findOne\" ||\n        operationType === \"updateOne\" ||\n        operationType === \"deleteOne\"\n      ) {\n        if (\n          Object.keys(req.params).length === 1 &&\n          \"id\" in req.params &&\n          req.params.id !== \"me\"\n        ) {\n          return new AppError(\n            `${pascalCase(String(this.modelName))} with ID ${req.params?.id} not found`,\n            404,\n            {},\n            \"NotFound\"\n          );\n        } else {\n          return new AppError(\n            `${pascalCase(String(this.modelName))} not found`,\n            404,\n            {},\n            \"NotFound\"\n          );\n        }\n      }\n\n      if (operationType === \"updateMany\" || operationType === \"deleteMany\") {\n        const isUpdate = operationType === \"updateMany\";\n        return new AppError(\n          isUpdate\n            ? `${pluralize(pascalCase(String(this.modelName)))} not found`\n            : `No records found to delete`,\n          404,\n          {},\n          \"NotFound\"\n        );\n      }\n    }\n\n    // Special handling for operations that return count\n    if (\n      data &&\n      typeof data === \"object\" &&\n      \"count\" in data &&\n      data.count === 0\n    ) {\n      return new AppError(\n        operationType === \"updateMany\"\n          ? `${pluralize(pascalCase(String(this.modelName)))} not found`\n          : `No records found to delete`,\n        404,\n        {},\n        \"NotFound\"\n      );\n    }\n\n    return null;\n  }\n\n  /**\n   * Default response builder for operations\n   */\n  private defaultResponseBuilder(\n    data: any,\n    additionalData: any,\n    operationType: string\n  ): any {\n    if (operationType === \"findMany\" && additionalData)\n      return {\n        ...additionalData,\n        data,\n      };\n\n    if (\n      operationType.includes(\"Many\") &&\n      data &&\n      typeof data === \"object\" &&\n      \"count\" in data\n    )\n      return { results: data.count, data };\n\n    if (operationType.includes(\"batch\") && Array.isArray(data))\n      return { results: data.length, data };\n\n    return { data };\n  }\n\n  /**\n   * Creates a single resource\n   */\n  createOne = this.executeOperation({\n    operationType: \"createOne\",\n    serviceMethod: \"createOne\",\n    successStatus: 201,\n    queryFeatures: [\"limitFields\"],\n    usesRequestBody: true,\n  });\n\n  /**\n   * Creates multiple resources in a single operation\n   */\n  createMany = this.executeOperation({\n    operationType: \"createMany\",\n    serviceMethod: \"createMany\",\n    successStatus: 201,\n    queryFeatures: [\"limitFields\"],\n    usesRequestBody: true,\n    hooks: {\n      async beforeQuery(req) {\n        if (!req.body || (Array.isArray(req.body) && req.body.length === 0))\n          throw new AppError(\n            \"Expected request body array to contain at least on item but received none\",\n            400,\n            { body: req.body },\n            \"MissingArrayRequestBody\"\n          );\n      },\n    },\n  });\n\n  /**\n   * Retrieves multiple resources with filtering, sorting, pagination, and field selection\n   */\n  findMany = this.executeOperation({\n    operationType: \"findMany\",\n    serviceMethod: \"findMany\",\n    successStatus: 200,\n    queryFeatures: [\"filter\", \"sort\", \"limitFields\", \"paginate\"],\n  });\n\n  /**\n   * Retrieves a single resource by its identifier\n   */\n  findOne = this.executeOperation({\n    operationType: \"findOne\",\n    serviceMethod: \"findOne\",\n    successStatus: 200,\n    queryFeatures: [\"limitFields\", \"filter\"],\n    usesRequestParams: true,\n  });\n\n  /**\n   * Updates a single resource by its identifier\n   */\n  updateOne = this.executeOperation({\n    operationType: \"updateOne\",\n    serviceMethod: \"updateOne\",\n    successStatus: 200,\n    queryFeatures: [\"limitFields\", \"filter\"],\n    usesRequestParams: true,\n    usesRequestBody: true,\n  });\n\n  /**\n   * Updates multiple resources that match specified criteria\n   */\n  updateMany = this.executeOperation({\n    operationType: \"updateMany\",\n    serviceMethod: \"updateMany\",\n    successStatus: 200,\n    queryFeatures: [\"filter\", \"limitFields\"],\n    requiresQueryForBulk: true,\n    preventORFilter: true,\n    usesRequestBody: true,\n  });\n\n  /**\n   * Updates multiple resources with different data in a single transaction\n   */\n  batchUpdate = this.executeOperation({\n    operationType: \"batchUpdate\",\n    serviceMethod: \"batchUpdate\",\n    successStatus: 200,\n    queryFeatures: [\"limitFields\", \"filter\"],\n    usesRequestBody: true,\n  });\n\n  /**\n   * Deletes a single resource by its identifier\n   */\n  deleteOne = this.executeOperation({\n    operationType: \"deleteOne\",\n    serviceMethod: \"deleteOne\",\n    successStatus: 204,\n    queryFeatures: [\"filter\"],\n    usesRequestParams: true,\n  });\n\n  /**\n   * Deletes multiple resources that match specified criteria\n   */\n  deleteMany = this.executeOperation({\n    operationType: \"deleteMany\",\n    serviceMethod: \"deleteMany\",\n    successStatus: 200,\n    queryFeatures: [\"filter\"],\n    requiresQueryForBulk: true,\n    preventORFilter: true,\n  });\n\n  /**\n   * Deletes multiple resources with different filters in a single transaction\n   */\n  batchDelete = this.executeOperation({\n    operationType: \"batchDelete\",\n    serviceMethod: \"batchDelete\",\n    successStatus: 200,\n    queryFeatures: [\"filter\"],\n    usesRequestBody: true,\n  });\n}\n"]}

package/dist/cjs/modules/base/base.middlewares.js

@@ -16,10 +16,10 @@ const validate_dto_1 = __importDefault(require("../../utils/validate-dto.js"));
 const validate_schema_1 = __importDefault(require("../../utils/validate-schema.js"));
 const base_middlewares_helpers_1 = require("./utils/helpers/base.middlewares.helpers.js");
 const text_helpers_1 = require("../../utils/helpers/text.helpers.js");
-const dynamic_loader_1 = require("../../utils/dynamic-loader.js");
 const error_prettifier_1 = __importDefault(require("./utils/error-prettifier.js"));
 const url_helpers_1 = require("../../utils/helpers/url-helpers.js");
 const utils_1 = require("../../exports/utils/index.js");
+const validation_manager_1 = __importDefault(require("../../types/validation/validation-manager.js"));
 function callNext(_, _1, next) {
     next();
 }
@@ -160,7 +160,6 @@ function handleRequestBodyValidationAndTransformation(schemaOrDtoClass, classVal
 function validateRequestInputs(routeConfig) {
     const arkosConfig = (0, server_1.getArkosConfig)();
     const validationConfig = arkosConfig.validation;
-    const strictValidation = validationConfig?.strict;
     const validators = routeConfig?.validation;
     const openapi = routeConfig?.experimental?.openapi;
     const validationToParameterMapping = {
@@ -174,15 +173,12 @@ function validateRequestInputs(routeConfig) {
         throw Error(`Trying to pass validators into route \"${routeConfig.path}\" config validation option without choosing a validation resolver under arkos config { validation: {} }.`);
     if (validators === true)
         throw Error(`Invalid value ${validators} passed to validation option, it can only receive false or object of { query, body, params }.`);
-    const validatorFn = validationConfig?.resolver == "zod" ? validate_schema_1.default : validate_dto_1.default;
     const validatorsKey = [
         "body",
         "query",
         "params",
     ];
-    const isValidValidator = validationConfig?.resolver == "zod" ? dynamic_loader_1.isZodSchema : dynamic_loader_1.isClass;
-    const validatorName = validationConfig?.resolver == "zod" ? "zod schema" : "class-validator dto";
-    const validatorNameType = validationConfig?.resolver == "zod" ? "Schema" : "Dto";
+    const { validationFn, validatorNameType, validatorName } = validation_manager_1.default;
     if (typeof validators === "object")
         validatorsKey.forEach((key) => {
             if (openapi &&
@@ -202,27 +198,22 @@ Read more about strict validation at https://www.arkosjs.com/docs/guides/validat
                 key === "body") {
                 throw Error(`When usign validation.${key} you must not define json-schema under openapi.requestBody as documentation for req.${key}, because the ${validatorName} you passed under validation.${key} will be added as json-schema into the api documenation, if you wish to define documenation by yourself do not define validation.${key}.`);
             }
-            if (key in (validators || {}) &&
-                validators?.[key] !== undefined &&
-                validators?.[key] !== false &&
-                validators?.[key] !== null &&
-                !isValidValidator(validators[key]))
-                throw Error(`Your validation resolver is set to ${arkosConfig.validation.resolver}, please provide a valid ${validatorName} in order to use in { validation: { ${key}: ${validatorNameType} } } under route ${routeConfig.path}`);
+            if (validators?.[key] &&
+                !validation_manager_1.default.isValidator(validators?.[key]))
+                throw Error(`Your validation resolver is set to ${arkosConfig?.validation?.resolver}, please provide a valid ${validatorName} in order to use in { validation: { ${key}: ${validatorNameType} } } under route ${routeConfig.path}. Received ${validators?.[key]}`);
         });
     return (0, error_handler_1.catchAsync)(async (req, _, next) => {
         for (const key of validatorsKey) {
-            const reqInput = Object.keys(req[key] || {}).length > 0;
             const validator = validators?.[key];
-            const notAllowedInputError = new error_handler_1.AppError(`Request ${key} is not allowed on this route`, 400, `Request${(0, text_helpers_1.capitalize)(key)}NotAllowed`, { [key]: req[key] });
-            if (validator === null && reqInput)
-                throw notAllowedInputError;
-            if (strictValidation && validator === undefined && reqInput)
-                throw notAllowedInputError;
-            if (validator === false)
+            const NotAllowedInputError = new error_handler_1.BadRequestError(`Request ${key} is not allowed on this route`, `Request${(0, text_helpers_1.capitalize)(key)}NotAllowed`, { [key]: req[key] });
+            const shouldValidate = validation_manager_1.default.shouldValidate(validator, req?.[key]);
+            if (shouldValidate === "prohibit")
+                throw NotAllowedInputError;
+            else if (shouldValidate === "passthrough")
                 continue;
             if (validator)
                 try {
-                    req[key] = await validatorFn(validator, req[key], arkosConfig.validation?.validationOptions);
+                    req[key] = await validationFn(validator, req[key], arkosConfig.validation?.validationOptions);
                 }
                 catch (err) {
                     const resolver = validationConfig?.resolver;