arkos 2.0.0-next.13 → 2.0.0-next.16

package/dist/cjs/utils/arkos-router/utils/helpers/apply-arkos-router-proxy.js

@@ -13,7 +13,11 @@ const error_handler_1 = require("../../../../exports/error-handler/index.js");
 const deepmerge_helper_1 = __importDefault(require("../../../helpers/deepmerge.helper.js"));
 const exit_error_1 = __importDefault(require("../../../helpers/exit-error.js"));
 const upload_manager_1 = __importDefault(require("./upload-manager.js"));
-function applyArkosRouterProxy(target, options, name = "ArkosRouter()") {
+function applyArkosRouterProxy(target, options, component = "router") {
+    target._arkos = {
+        options,
+        routes: [],
+    };
     return new Proxy(target, {
         get(target, prop, receiver) {
             const originalMethod = Reflect.get(target, prop, receiver);
@@ -30,17 +34,20 @@ function applyArkosRouterProxy(target, options, name = "ArkosRouter()") {
             ];
             if (prop === "use") {
                 return function (config, ...handlers) {
-                    if (!config ||
+                    if (typeof config === "function" || Array.isArray(config)) {
+                        handlers = [config, ...handlers];
+                        config = {};
+                    }
+                    else if (!config ||
                         typeof config !== "object" ||
-                        Array.isArray(config) ||
-                        typeof config === "function")
-                        return originalMethod.call(target, config, ...handlers);
+                        typeof config === "string" ||
+                        config instanceof RegExp) {
+                        throw (0, exit_error_1.default)(`First argument of ${component}.use() must be a valid ArkosRouteConfig object or a middleware function, but received ${typeof config === "object" ? JSON.stringify(config, null, 2) : config}.`);
+                    }
                     if (config.disabled)
                         return;
                     const useConfig = config;
-                    const path = useConfig.path
-                        ? (0, _1.applyPrefix)(options?.prefix, useConfig.path)
-                        : undefined;
+                    const path = (0, _1.applyPrefix)(options?.prefix, useConfig.path ?? "/");
                     const arkosConfig = (0, server_1.getArkosConfig)();
                     const authenticationConfig = arkosConfig.authentication;
                     if (useConfig.authentication && !authenticationConfig?.mode)
@@ -49,9 +56,7 @@ function applyArkosRouterProxy(target, options, name = "ArkosRouter()") {
 For further help see https://www.arkosjs.com/docs/core-concepts/authentication/setup.`);
                     const middlewareStack = (0, _1.getMiddlewareStack)(useConfig);
                     const allHandlers = [...middlewareStack, ...handlers];
-                    return path
-                        ? originalMethod.call(target, path, ...allHandlers)
-                        : originalMethod.call(target, ...allHandlers);
+                    return originalMethod.call(target, path, ...allHandlers);
                 };
             }
             if (prop === "route") {
@@ -59,15 +64,10 @@ For further help see https://www.arkosjs.com/docs/core-concepts/authentication/s
                     const routeChain = {};
                     httpMethods.forEach((method) => {
                         routeChain[method] = function (config, ...handlers) {
+                            if (typeof config === "function" || Array.isArray(config))
+                                throw (0, exit_error_1.default)(`First argument of ${component}.route("${path}").${method}() must be a valid ArkosRouteConfig object without path field, but received ${typeof config === "object" ? JSON.stringify(config, null, 2) : config}`);
                             const fullConfig = {
                                 ...config,
-                                ...(options?.openapi
-                                    ? {
-                                        experimental: {
-                                            openapi: options.openapi,
-                                        },
-                                    }
-                                    : {}),
                                 path,
                             };
                             receiver[method](fullConfig, ...handlers);
@@ -79,10 +79,10 @@ For further help see https://www.arkosjs.com/docs/core-concepts/authentication/s
             }
             if (httpMethods.includes(prop)) {
                 return function (config, ...handlers) {
-                    if (config.disabled)
+                    if (!config || !route_config_validator_1.default.isArkosRouteConfig(config))
+                        throw (0, exit_error_1.default)(`First argument of ${component}.${prop}() must be a valid ArkosRouteConfig object with path field, but recevied ${typeof config === "object" ? JSON.stringify(config, null, 2) : config}`);
+                    if (config?.disabled)
                         return;
-                    if (!route_config_validator_1.default.isArkosRouteConfig(config))
-                        throw Error(`First argument of ${name}.${prop}() must be a valid ArkosRouteConfig object with path field, but recevied ${typeof config === "object" ? JSON.stringify(config, null, 2) : config}`);
                     const path = (0, _1.applyPrefix)(options?.prefix, config.path);
                     config = {
                         ...config,
@@ -97,9 +97,9 @@ For further help see https://www.arkosjs.com/docs/core-concepts/authentication/s
                         path,
                     };
                     if ([null, undefined].includes(path))
-                        throw Error("Please pass valid value for path field to use in your route");
+                        throw new Error("Please pass valid value for path field to use in your route");
                     const method = prop;
-                    const UndefinedHandlerError = (handler) => Error(`Wrong value for handler in route ${method.toUpperCase()} ${path}, recevied ${handler}.`);
+                    const UndefinedHandlerError = (handler) => (0, exit_error_1.default)(`Wrong value for handler in route ${method.toUpperCase()} ${path}, recevied ${handler}.`);
                     if (handlers.length > 0) {
                         const flattenHandlers = (arr) => {
                             return arr.reduce((flat, item) => {
@@ -110,15 +110,19 @@ For further help see https://www.arkosjs.com/docs/core-concepts/authentication/s
                         handlers = flatHandlers.map((handler) => {
                             if (!handler)
                                 throw UndefinedHandlerError(handler);
-                            if (typeof handler !== "function") {
+                            if (typeof handler !== "function")
                                 throw UndefinedHandlerError(handler);
-                            }
                             return (0, error_handler_1.catchAsync)(handler, {
                                 type: handler.length > 3 ? "error" : "normal",
                             });
                         });
                         const finalHandler = handlers[handlers.length - 1];
                         route_config_registry_1.default.register(finalHandler, config, method);
+                        target._arkos.routes.push({
+                            handler: finalHandler,
+                            config,
+                            method,
+                        });
                     }
                     const arkosConfig = (0, server_1.getArkosConfig)();
                     const validationConfig = arkosConfig.validation;
@@ -130,15 +134,17 @@ For further help see https://www.arkosjs.com/docs/core-concepts/authentication/s
                             ("validation" in config &&
                                 !config.validation &&
                                 config.validation !== undefined)))
-                        throw Error("When using strict validation you must either pass { validation: false } in order to explicitly tell that no input will be received, or pass `undefined` for each input type e.g { validation: { query: undefined } } in order to deny the input of given request input.");
+                        throw (0, exit_error_1.default)("When using strict validation you must either pass { validation: false } in order to explicitly tell that no input will be received, or pass `undefined` for each input type e.g { validation: { query: undefined } } in order to deny the input of given request input.");
                     if (!validationConfig?.resolver &&
                         Object.keys(config.validation || {}).length > 0)
-                        throw Error(`Trying to pass validators into route ${route} config validation option without choosing a validation resolver under arkos.init({ validation: { resolver: '' } })`);
+                        throw (0, exit_error_1.default)(`Trying to pass validators into route ${route} config validation option without choosing a validation resolver under arkos.init({ validation: { resolver: '' } })`);
                     if (config.authentication && !authenticationConfig?.mode)
-                        throw Error(`Trying to authenticate route ${route} without choosing an authentication mode under arkos.config.${(0, fs_helpers_1.getUserFileExtension)()}
+                        throw (0, exit_error_1.default)(`Trying to authenticate route ${route} without choosing an authentication mode under arkos.config.${(0, fs_helpers_1.getUserFileExtension)()}
 
 For further help see https://www.arkosjs.com/docs/core-concepts/authentication/setup.`);
                     handlers = [...(0, _1.getMiddlewareStack)(config), ...handlers];
+                    if (handlers.length === 0)
+                        throw (0, exit_error_1.default)(`No handlers provided for route ${method.toUpperCase()} ${path}.`);
                     if (config.experimental?.uploads &&
                         config.experimental.uploads.deleteOnError !== false)
                         handlers.push((0, error_handler_1.catchAsync)(upload_manager_1.default.handleFileCleanup(config.experimental.uploads), { type: "error" }));

package/dist/cjs/utils/arkos-router/utils/helpers/apply-arkos-router-proxy.js.map

@@ -1 +1 @@
-{"version":3,"file":"apply-arkos-router-proxy.js","sourceRoot":"","sources":["../../../../../../src/utils/arkos-router/utils/helpers/apply-arkos-router-proxy.ts"],"names":[],"mappings":"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","sourcesContent":["import { RouterOptions } from \"express\";\nimport {\n  ArkosAnyRequestHandler,\n  ArkosRouteConfig,\n  ArkosUseConfig,\n  IArkosRoute,\n  PathParams,\n} from \"../../types\";\nimport RouteConfigValidator from \"../../route-config-validator\";\nimport { applyPrefix, getMiddlewareStack } from \".\";\nimport { getUserFileExtension } from \"../../../helpers/fs.helpers\";\nimport { getArkosConfig } from \"../../../../server\";\nimport RouteConfigRegistry from \"../../route-config-registry\";\nimport { catchAsync } from \"../../../../exports/error-handler\";\nimport deepmerge from \"../../../helpers/deepmerge.helper\";\nimport ExitError from \"../../../helpers/exit-error\";\nimport uploadManager from \"./upload-manager\";\n\nexport function applyArkosRouterProxy<T extends object>(\n  target: T,\n  options?: RouterOptions & {\n    prefix?: string | RegExp | Array<string | RegExp>;\n    openapi?: { tags?: string[] };\n  },\n  name: \"app\" | \"ArkosRouter()\" = \"ArkosRouter()\"\n): T {\n  return new Proxy(target, {\n    get(target, prop, receiver) {\n      const originalMethod = Reflect.get(target, prop, receiver) as Function;\n\n      const httpMethods = [\n        \"get\",\n        \"post\",\n        \"put\",\n        \"patch\",\n        \"delete\",\n        \"all\",\n        \"head\",\n        \"trace\",\n        \"options\",\n      ] as const;\n\n      if (prop === \"use\") {\n        return function (\n          config: ArkosUseConfig | PathParams | ArkosAnyRequestHandler,\n          ...handlers: ArkosAnyRequestHandler[]\n        ) {\n          // if not an ArkosUseConfig object, fall through to native Express use\n          if (\n            !config ||\n            typeof config !== \"object\" ||\n            Array.isArray(config) ||\n            typeof config === \"function\"\n          )\n            return originalMethod.call(target, config, ...handlers);\n\n          if ((config as ArkosUseConfig).disabled) return;\n\n          const useConfig = config as ArkosUseConfig;\n          const path = useConfig.path\n            ? applyPrefix(options?.prefix, useConfig.path)\n            : undefined;\n\n          const arkosConfig = getArkosConfig();\n          const authenticationConfig = arkosConfig.authentication;\n\n          if (useConfig.authentication && !authenticationConfig?.mode)\n            throw ExitError(\n              `Trying to authenticate route use${path ? ` ${path}` : \"\"} without choosing an authentication mode under arkos.config.${getUserFileExtension()}\n\nFor further help see https://www.arkosjs.com/docs/core-concepts/authentication/setup.`\n            );\n\n          const middlewareStack = getMiddlewareStack(useConfig);\n\n          const allHandlers = [...middlewareStack, ...handlers];\n\n          return path\n            ? originalMethod.call(target, path, ...allHandlers)\n            : originalMethod.call(target, ...allHandlers);\n        };\n      }\n\n      if (prop === \"route\") {\n        return function (path: PathParams) {\n          const routeChain: any = {};\n\n          httpMethods.forEach((method) => {\n            routeChain[method] = function (\n              config: ArkosAnyRequestHandler | Omit<ArkosRouteConfig, \"path\">,\n              ...handlers: ArkosAnyRequestHandler[]\n            ) {\n              const fullConfig: ArkosRouteConfig = {\n                ...config,\n                ...(options?.openapi\n                  ? {\n                      experimental: {\n                        openapi: options.openapi,\n                      },\n                    }\n                  : {}),\n                path,\n              };\n\n              receiver[method](fullConfig, ...handlers);\n\n              return routeChain as IArkosRoute;\n            };\n          });\n\n          return routeChain;\n        };\n      }\n\n      if (httpMethods.includes(prop as any)) {\n        return function (\n          config: ArkosRouteConfig,\n          ...handlers: ArkosAnyRequestHandler[]\n        ) {\n          if (config.disabled) return;\n\n          if (!RouteConfigValidator.isArkosRouteConfig(config))\n            throw Error(\n              `First argument of ${name}.${prop as string}() must be a valid ArkosRouteConfig object with path field, but recevied ${typeof config === \"object\" ? JSON.stringify(config, null, 2) : config}`\n            );\n\n          const path = applyPrefix(options?.prefix, config.path);\n\n          config = {\n            ...config,\n            ...(options?.openapi\n              ? {\n                  experimental: {\n                    ...config?.experimental,\n                    openapi: deepmerge(\n                      options.openapi || {},\n                      config?.experimental?.openapi || {}\n                    ),\n                  },\n                }\n              : {}),\n            path,\n          };\n\n          if ([null, undefined].includes(path as any))\n            throw Error(\n              \"Please pass valid value for path field to use in your route\"\n            );\n\n          const method = prop as string;\n          const UndefinedHandlerError = (handler: any) =>\n            Error(\n              `Wrong value for handler in route ${method.toUpperCase()} ${path}, recevied ${handler}.`\n            );\n\n          if (handlers.length > 0) {\n            const flattenHandlers = (arr: any[]): ArkosAnyRequestHandler[] => {\n              return arr.reduce((flat, item) => {\n                return flat.concat(\n                  Array.isArray(item) ? flattenHandlers(item) : item\n                );\n              }, []);\n            };\n\n            const flatHandlers = flattenHandlers(handlers);\n\n            handlers = flatHandlers.map((handler: ArkosAnyRequestHandler) => {\n              if (!handler) throw UndefinedHandlerError(handler);\n\n              if (typeof handler !== \"function\") {\n                throw UndefinedHandlerError(handler);\n              }\n\n              return catchAsync(handler, {\n                type: handler.length > 3 ? \"error\" : \"normal\",\n              });\n            });\n\n            const finalHandler = handlers[handlers.length - 1];\n            RouteConfigRegistry.register(finalHandler, config, method);\n          }\n\n          const arkosConfig = getArkosConfig();\n          const validationConfig = arkosConfig.validation;\n          const authenticationConfig = arkosConfig.authentication;\n          const strictValidation = validationConfig?.strict;\n          const route = `${method.toUpperCase()} ${path}`;\n\n          if (\n            strictValidation &&\n            (!(\"validation\" in config) ||\n              (\"validation\" in config &&\n                !config.validation &&\n                config.validation !== undefined))\n          )\n            throw Error(\n              \"When using strict validation you must either pass { validation: false } in order to explicitly tell that no input will be received, or pass `undefined` for each input type e.g { validation: { query: undefined } } in order to deny the input of given request input.\"\n            );\n\n          if (\n            !validationConfig?.resolver &&\n            Object.keys(config.validation || {}).length > 0\n          )\n            throw Error(\n              `Trying to pass validators into route ${route} config validation option without choosing a validation resolver under arkos.init({ validation: { resolver: '' } })`\n            );\n\n          if (config.authentication && !authenticationConfig?.mode)\n            throw Error(\n              `Trying to authenticate route ${route} without choosing an authentication mode under arkos.config.${getUserFileExtension()}\n\nFor further help see https://www.arkosjs.com/docs/core-concepts/authentication/setup.`\n            );\n\n          handlers = [...getMiddlewareStack(config), ...handlers];\n\n          if (\n            config.experimental?.uploads &&\n            config.experimental.uploads.deleteOnError !== false\n          )\n            handlers.push(\n              catchAsync(\n                uploadManager.handleFileCleanup(config.experimental.uploads),\n                { type: \"error\" }\n              )\n            );\n\n          return originalMethod.call(target, path, ...handlers);\n        };\n      }\n      // }\n      return originalMethod;\n    },\n  });\n}\n"]}
+{"version":3,"file":"apply-arkos-router-proxy.js","sourceRoot":"","sources":["../../../../../../src/utils/arkos-router/utils/helpers/apply-arkos-router-proxy.ts"],"names":[],"mappings":"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","sourcesContent":["import { RouterOptions } from \"express\";\nimport {\n  ArkosAnyRequestHandler,\n  ArkosRouteConfig,\n  ArkosUseConfig,\n  IArkosRoute,\n  InternalIArkosRouter,\n  PathParams,\n} from \"../../types\";\nimport RouteConfigValidator from \"../../route-config-validator\";\nimport { applyPrefix, getMiddlewareStack } from \".\";\nimport { getUserFileExtension } from \"../../../helpers/fs.helpers\";\nimport { getArkosConfig } from \"../../../../server\";\nimport RouteConfigRegistry from \"../../route-config-registry\";\nimport { catchAsync } from \"../../../../exports/error-handler\";\nimport deepmerge from \"../../../helpers/deepmerge.helper\";\nimport ExitError from \"../../../helpers/exit-error\";\nimport uploadManager from \"./upload-manager\";\n\nexport function applyArkosRouterProxy<T extends object>(\n  target: T,\n  options?: RouterOptions & {\n    prefix?: string | RegExp | Array<string | RegExp>;\n    openapi?: { tags?: string[] };\n  },\n  component: \"app\" | \"router\" = \"router\"\n): T {\n  (target as InternalIArkosRouter)._arkos = {\n    options,\n    routes: [],\n  };\n\n  return new Proxy(target, {\n    get(target, prop, receiver) {\n      const originalMethod = Reflect.get(target, prop, receiver) as Function;\n\n      const httpMethods = [\n        \"get\",\n        \"post\",\n        \"put\",\n        \"patch\",\n        \"delete\",\n        \"all\",\n        \"head\",\n        \"trace\",\n        \"options\",\n      ] as const;\n\n      if (prop === \"use\") {\n        return function (\n          config: ArkosUseConfig | PathParams | ArkosAnyRequestHandler,\n          ...handlers: ArkosAnyRequestHandler[]\n        ) {\n          // normalize function/router to ArkosUseConfig\n          if (typeof config === \"function\" || Array.isArray(config)) {\n            handlers = [config as ArkosAnyRequestHandler, ...handlers];\n            config = {} as ArkosUseConfig;\n          } else if (\n            !config ||\n            typeof config !== \"object\" ||\n            typeof config === \"string\" ||\n            config instanceof RegExp\n          ) {\n            throw ExitError(\n              `First argument of ${component}.use() must be a valid ArkosRouteConfig object or a middleware function, but received ${typeof config === \"object\" ? JSON.stringify(config, null, 2) : config}.`\n            );\n          }\n\n          if ((config as ArkosUseConfig).disabled) return;\n\n          const useConfig = config as ArkosUseConfig;\n          const path = applyPrefix(options?.prefix, useConfig.path ?? \"/\");\n\n          const arkosConfig = getArkosConfig();\n          const authenticationConfig = arkosConfig.authentication;\n\n          if (useConfig.authentication && !authenticationConfig?.mode)\n            throw ExitError(\n              `Trying to authenticate route use${path ? ` ${path}` : \"\"} without choosing an authentication mode under arkos.config.${getUserFileExtension()}\n\nFor further help see https://www.arkosjs.com/docs/core-concepts/authentication/setup.`\n            );\n\n          const middlewareStack = getMiddlewareStack(useConfig);\n          const allHandlers = [...middlewareStack, ...handlers];\n\n          return originalMethod.call(target, path, ...allHandlers);\n        };\n      }\n\n      if (prop === \"route\") {\n        return function (path: PathParams) {\n          const routeChain: any = {};\n\n          httpMethods.forEach((method) => {\n            routeChain[method] = function (\n              config: ArkosAnyRequestHandler | Omit<ArkosRouteConfig, \"path\">,\n              ...handlers: ArkosAnyRequestHandler[]\n            ) {\n              if (typeof config === \"function\" || Array.isArray(config))\n                throw ExitError(\n                  `First argument of ${component}.route(\"${path}\").${method}() must be a valid ArkosRouteConfig object without path field, but received ${typeof config === \"object\" ? JSON.stringify(config, null, 2) : config}`\n                );\n\n              const fullConfig: ArkosRouteConfig = {\n                ...config,\n                path,\n              };\n\n              receiver[method](fullConfig, ...handlers);\n              return routeChain as IArkosRoute;\n            };\n          });\n\n          return routeChain;\n        };\n      }\n\n      if (httpMethods.includes(prop as any)) {\n        return function (\n          config: ArkosRouteConfig,\n          ...handlers: ArkosAnyRequestHandler[]\n        ) {\n          if (!config || !RouteConfigValidator.isArkosRouteConfig(config))\n            throw ExitError(\n              `First argument of ${component}.${prop as string}() must be a valid ArkosRouteConfig object with path field, but recevied ${typeof config === \"object\" ? JSON.stringify(config, null, 2) : config}`\n            );\n\n          if (config?.disabled) return;\n\n          const path = applyPrefix(options?.prefix, config.path);\n\n          config = {\n            ...config,\n            ...(options?.openapi\n              ? {\n                  experimental: {\n                    ...config?.experimental,\n                    openapi: deepmerge(\n                      options.openapi || {},\n                      config?.experimental?.openapi || {}\n                    ),\n                  },\n                }\n              : {}),\n            path,\n          };\n\n          if ([null, undefined].includes(path as any))\n            throw new Error(\n              \"Please pass valid value for path field to use in your route\"\n            );\n\n          const method = prop as string;\n          const UndefinedHandlerError = (handler: any) =>\n            ExitError(\n              `Wrong value for handler in route ${method.toUpperCase()} ${path}, recevied ${handler}.`\n            );\n\n          if (handlers.length > 0) {\n            const flattenHandlers = (arr: any[]): ArkosAnyRequestHandler[] => {\n              return arr.reduce((flat, item) => {\n                return flat.concat(\n                  Array.isArray(item) ? flattenHandlers(item) : item\n                );\n              }, []);\n            };\n\n            const flatHandlers = flattenHandlers(handlers);\n\n            handlers = flatHandlers.map((handler: ArkosAnyRequestHandler) => {\n              if (!handler) throw UndefinedHandlerError(handler);\n\n              if (typeof handler !== \"function\")\n                throw UndefinedHandlerError(handler);\n\n              return catchAsync(handler, {\n                type: handler.length > 3 ? \"error\" : \"normal\",\n              });\n            });\n\n            const finalHandler = handlers[handlers.length - 1];\n            RouteConfigRegistry.register(finalHandler, config, method);\n            (target as InternalIArkosRouter)._arkos.routes.push({\n              handler: finalHandler,\n              config,\n              method,\n            });\n          }\n\n          const arkosConfig = getArkosConfig();\n          const validationConfig = arkosConfig.validation;\n          const authenticationConfig = arkosConfig.authentication;\n          const strictValidation = validationConfig?.strict;\n          const route = `${method.toUpperCase()} ${path}`;\n\n          if (\n            strictValidation &&\n            (!(\"validation\" in config) ||\n              (\"validation\" in config &&\n                !config.validation &&\n                config.validation !== undefined))\n          )\n            throw ExitError(\n              \"When using strict validation you must either pass { validation: false } in order to explicitly tell that no input will be received, or pass `undefined` for each input type e.g { validation: { query: undefined } } in order to deny the input of given request input.\"\n            );\n\n          if (\n            !validationConfig?.resolver &&\n            Object.keys(config.validation || {}).length > 0\n          )\n            throw ExitError(\n              `Trying to pass validators into route ${route} config validation option without choosing a validation resolver under arkos.init({ validation: { resolver: '' } })`\n            );\n\n          if (config.authentication && !authenticationConfig?.mode)\n            throw ExitError(\n              `Trying to authenticate route ${route} without choosing an authentication mode under arkos.config.${getUserFileExtension()}\n\nFor further help see https://www.arkosjs.com/docs/core-concepts/authentication/setup.`\n            );\n\n          handlers = [...getMiddlewareStack(config), ...handlers];\n\n          if (handlers.length === 0)\n            throw ExitError(\n              `No handlers provided for route ${method.toUpperCase()} ${path}.`\n            );\n\n          if (\n            config.experimental?.uploads &&\n            config.experimental.uploads.deleteOnError !== false\n          )\n            handlers.push(\n              catchAsync(\n                uploadManager.handleFileCleanup(config.experimental.uploads),\n                { type: \"error\" }\n              )\n            );\n\n          return originalMethod.call(target, path, ...handlers);\n        };\n      }\n\n      return originalMethod;\n    },\n  });\n}\n"]}

package/dist/cjs/utils/arkos-router/utils/helpers/index.js

@@ -19,22 +19,23 @@ const multer_1 = __importDefault(require("multer"));
 const error_handler_1 = require("../../../../exports/error-handler/index.js");
 function extractArkosRoutes(app, basePath = "") {
     const routes = [];
-    function extractFromStack(stack, prefix = "") {
+    function extractFromStack(stack, prefix = "", inheritedRouteOptions) {
+        if (Object.keys(inheritedRouteOptions || {}).length === 0)
+            inheritedRouteOptions = undefined;
         stack.forEach((layer) => {
             if (layer.route) {
                 const fullPath = prefix + layer.route.path;
                 const methods = Object.keys(layer.route.methods);
                 methods.forEach((method) => {
                     const handlers = layer.route.stack || [];
-                    let config;
                     for (const handler of handlers) {
                         const foundConfig = route_config_registry_1.default.get(handler.handle);
                         if (foundConfig) {
-                            config = foundConfig;
                             routes.push({
                                 path: fullPath,
                                 method: method.toUpperCase(),
-                                config,
+                                config: foundConfig,
+                                routeOptions: inheritedRouteOptions,
                             });
                             break;
                         }
@@ -54,13 +55,15 @@ function extractArkosRoutes(app, basePath = "") {
                             .replace(/\/$/, "");
                     }
                 }
-                extractFromStack(layer.handle.stack, nestedPrefix);
+                extractFromStack(layer.handle.stack, nestedPrefix, layer.handle._arkos?.options?.openapi
+                    ? layer.handle._arkos.options
+                    : inheritedRouteOptions);
             }
         });
     }
     const stack = app._router?.stack || app.stack;
     if (stack)
-        extractFromStack(stack, basePath);
+        extractFromStack(stack, basePath, app._arkos?.options || undefined);
     return routes;
 }
 function getMiddlewareStack(config) {

package/dist/cjs/utils/arkos-router/utils/helpers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/utils/arkos-router/utils/helpers/index.ts"],"names":[],"mappings":"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","sourcesContent":["import rateLimit from \"express-rate-limit\";\nimport authService from \"../../../../modules/auth/auth.service\";\nimport { validateRequestInputs } from \"../../../../modules/base/base.middlewares\";\nimport RouteConfigRegistry from \"../../route-config-registry\";\nimport { ArkosRouteConfig } from \"../../types\";\nimport express from \"express\";\nimport compression from \"compression\";\nimport { queryParser } from \"../../../helpers/query-parser.helpers\";\nimport uploadManager from \"./upload-manager\";\nimport multer from \"multer\";\nimport { catchAsync } from \"../../../../exports/error-handler\";\n\nexport function extractArkosRoutes(\n  app: any,\n  basePath = \"\"\n): Array<{\n  path: string;\n  method: string;\n  config?: ArkosRouteConfig;\n}> {\n  const routes: Array<{\n    path: string;\n    method: string;\n    config?: ArkosRouteConfig;\n  }> = [];\n\n  function extractFromStack(stack: any[], prefix = \"\") {\n    stack.forEach((layer: any) => {\n      if (layer.route) {\n        const fullPath = prefix + layer.route.path;\n        const methods = Object.keys(layer.route.methods);\n\n        methods.forEach((method) => {\n          const handlers = layer.route.stack || [];\n          let config: ArkosRouteConfig | undefined;\n\n          for (const handler of handlers) {\n            const foundConfig = RouteConfigRegistry.get(handler.handle);\n\n            if (foundConfig) {\n              config = foundConfig;\n              routes.push({\n                path: fullPath,\n                method: method.toUpperCase(),\n                config,\n              });\n\n              break;\n            }\n          }\n        });\n      } else if (layer.name === \"router\" && layer.handle?.stack) {\n        let nestedPrefix = prefix;\n\n        if (layer.regexp) {\n          const match = layer.regexp\n            .toString()\n            .match(/\\/\\^?(\\\\\\/[^?]+|\\/[^?]+)/);\n          if (match) {\n            nestedPrefix = prefix + \"/\" + match[1].replace(/\\\\\\//g, \"/\");\n            nestedPrefix = nestedPrefix\n              .replace(/\\/\\//g, \"/\")\n              .replace(/\\/$/, \"\");\n          }\n        }\n\n        extractFromStack(layer.handle.stack, nestedPrefix);\n      }\n    });\n  }\n\n  const stack = app._router?.stack || app.stack;\n  if (stack) extractFromStack(stack, basePath);\n\n  return routes;\n}\n\nexport function getMiddlewareStack(\n  config: ArkosRouteConfig | Omit<ArkosRouteConfig, \"path\">\n) {\n  const middlewares = [];\n\n  if (config.authentication) middlewares.push(authService.authenticate);\n\n  if (\n    typeof config.authentication === \"object\" &&\n    config.authentication.action &&\n    config.authentication.resource\n  )\n    middlewares.push(\n      authService.authorize(\n        config.authentication.action,\n        config.authentication.resource,\n        config.authentication?.rule\n      )\n    );\n\n  if (config.rateLimit) middlewares.push(rateLimit(config.rateLimit));\n  if (config.compression) middlewares.push(compression(config.compression));\n  if (config.queryParser) middlewares.push(queryParser(config.queryParser));\n\n  if (config?.bodyParser) {\n    const parsers = Array.isArray(config.bodyParser)\n      ? config.bodyParser\n      : [config.bodyParser];\n\n    parsers.forEach((parser) => {\n      if (typeof parser === \"object\" && parser.parser)\n        if (parser.parser !== \"multipart\")\n          middlewares.push(catchAsync(express[parser.parser](parser.options)));\n        else if (parser.parser === \"multipart\")\n          middlewares.push(\n            catchAsync(multer({ limits: parser.options }).none())\n          );\n    });\n  }\n\n  if (config.experimental?.uploads) {\n    const uploadConfig = config.experimental.uploads;\n    middlewares.push(uploadManager.handleUpload(uploadConfig));\n    middlewares.push(uploadManager.validateRequiredFiles(uploadConfig));\n\n    middlewares.push(validateRequestInputs(config as ArkosRouteConfig));\n\n    middlewares.push(\n      uploadManager.handlePostUpload(config.experimental.uploads)\n    );\n  } else middlewares.push(validateRequestInputs(config as ArkosRouteConfig));\n\n  return middlewares;\n}\n\n/**\n * Extracts path parameters from an Express route path\n *\n * @param path - Express route path with :param syntax\n * @returns Array of parameter names\n *\n * @example\n * extractPathParams('/api/users/:userId/posts/:postId')\n * // => ['userId', 'postId']\n *\n */\nexport function extractPathParams(path: string): string[] {\n  const params: string[] = [];\n  const segments = path.split(\"/\");\n  let wildcardCount = 0;\n\n  for (const segment of segments) {\n    if (segment === \"*\") {\n      wildcardCount++;\n    } else if (segment.startsWith(\":\")) {\n      const clean = segment.substring(1).replace(/\\(.*\\)$/, \"\");\n      params.push(clean);\n    }\n  }\n\n  if (wildcardCount === 1) {\n    params.push(\"path\");\n  } else {\n    for (let i = 1; i <= wildcardCount; i++) {\n      params.push(`path${i}`);\n    }\n  }\n\n  return params;\n}\n\ntype PathLike = string | RegExp;\ntype PathInput = PathLike | PathLike[];\n\nexport function applyPrefix(\n  prefix: PathInput = \"\",\n  path: PathInput\n): PathInput {\n  if (!prefix) return path;\n\n  const prefixArr = Array.isArray(prefix) ? prefix : [prefix];\n  const pathArr = Array.isArray(path) ? path : [path];\n\n  const result: PathLike[] = [];\n\n  for (const pfx of prefixArr) {\n    for (const pth of pathArr) {\n      result.push(applySinglePrefix(pfx, pth));\n    }\n  }\n\n  return result.length === 1 ? result[0] : result;\n}\n\nfunction applySinglePrefix(prefix: PathLike, path: PathLike): PathLike {\n  const isPrefixRegex = prefix instanceof RegExp;\n  const isPathRegex = path instanceof RegExp;\n\n  if (typeof prefix === \"string\" && typeof path === \"string\") {\n    const normalizedPrefix = prefix.endsWith(\"/\")\n      ? prefix.slice(0, -1)\n      : prefix;\n\n    return `${normalizedPrefix}${path.startsWith(\"/\") ? \"\" : \"/\"}${path}`;\n  }\n\n  if (typeof prefix === \"string\" && isPathRegex) {\n    const escapedPrefix = prefix\n      .replace(/\\/$/, \"\")\n      .replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n\n    const source = path.source.startsWith(\"^\")\n      ? path.source.slice(1)\n      : path.source;\n\n    return new RegExp(`^${escapedPrefix}${source}`, path.flags);\n  }\n\n  if (isPrefixRegex && typeof path === \"string\") {\n    const escapedPath = path.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n\n    const prefixSource = prefix.source.endsWith(\"$\")\n      ? prefix.source.slice(0, -1)\n      : prefix.source;\n\n    return new RegExp(`^${prefixSource}${escapedPath}`, prefix.flags);\n  }\n\n  if (isPrefixRegex && isPathRegex) {\n    const prefixSource = prefix.source.endsWith(\"$\")\n      ? prefix.source.slice(0, -1)\n      : prefix.source;\n\n    const pathSource = path.source.startsWith(\"^\")\n      ? path.source.slice(1)\n      : path.source;\n\n    const flags = Array.from(new Set([...prefix.flags, ...path.flags])).join(\n      \"\"\n    );\n\n    return new RegExp(`^${prefixSource}${pathSource}`, flags);\n  }\n\n  throw new TypeError(\"Invalid prefix or path\");\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/utils/arkos-router/utils/helpers/index.ts"],"names":[],"mappings":"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","sourcesContent":["import rateLimit from \"express-rate-limit\";\nimport authService from \"../../../../modules/auth/auth.service\";\nimport { validateRequestInputs } from \"../../../../modules/base/base.middlewares\";\nimport RouteConfigRegistry from \"../../route-config-registry\";\nimport { ArkosRouteConfig } from \"../../types\";\nimport express from \"express\";\nimport compression from \"compression\";\nimport { queryParser } from \"../../../helpers/query-parser.helpers\";\nimport uploadManager from \"./upload-manager\";\nimport multer from \"multer\";\nimport { catchAsync } from \"../../../../exports/error-handler\";\nimport { ArkosRouterOptions } from \"../..\";\n\nexport function extractArkosRoutes(\n  app: any,\n  basePath = \"\"\n): Array<{\n  path: string;\n  method: string;\n  config?: ArkosRouteConfig;\n  routeOptions?: ArkosRouterOptions;\n}> {\n  const routes: Array<{\n    path: string;\n    method: string;\n    config?: ArkosRouteConfig;\n    routeOptions?: ArkosRouterOptions;\n  }> = [];\n\n  function extractFromStack(\n    stack: any[],\n    prefix = \"\",\n    inheritedRouteOptions?: ArkosRouterOptions\n  ) {\n    if (Object.keys(inheritedRouteOptions || {}).length === 0)\n      inheritedRouteOptions = undefined;\n\n    stack.forEach((layer: any) => {\n      if (layer.route) {\n        const fullPath = prefix + layer.route.path;\n        const methods = Object.keys(layer.route.methods);\n\n        methods.forEach((method) => {\n          const handlers = layer.route.stack || [];\n\n          for (const handler of handlers) {\n            const foundConfig = RouteConfigRegistry.get(handler.handle);\n\n            if (foundConfig) {\n              routes.push({\n                path: fullPath,\n                method: method.toUpperCase(),\n                config: foundConfig,\n                routeOptions: inheritedRouteOptions,\n              });\n\n              break;\n            }\n          }\n        });\n      } else if (layer.name === \"router\" && layer.handle?.stack) {\n        let nestedPrefix = prefix;\n\n        if (layer.regexp) {\n          const match = layer.regexp\n            .toString()\n            .match(/\\/\\^?(\\\\\\/[^?]+|\\/[^?]+)/);\n          if (match) {\n            nestedPrefix = prefix + \"/\" + match[1].replace(/\\\\\\//g, \"/\");\n            nestedPrefix = nestedPrefix\n              .replace(/\\/\\//g, \"/\")\n              .replace(/\\/$/, \"\");\n          }\n        }\n\n        extractFromStack(\n          layer.handle.stack,\n          nestedPrefix,\n          layer.handle._arkos?.options?.openapi\n            ? layer.handle._arkos.options\n            : inheritedRouteOptions\n        );\n      }\n    });\n  }\n\n  const stack = app._router?.stack || app.stack;\n  if (stack)\n    extractFromStack(stack, basePath, app._arkos?.options || undefined);\n\n  return routes;\n}\n\nexport function getMiddlewareStack(\n  config: ArkosRouteConfig | Omit<ArkosRouteConfig, \"path\">\n) {\n  const middlewares = [];\n\n  if (config.authentication) middlewares.push(authService.authenticate);\n\n  if (\n    typeof config.authentication === \"object\" &&\n    config.authentication.action &&\n    config.authentication.resource\n  )\n    middlewares.push(\n      authService.authorize(\n        config.authentication.action,\n        config.authentication.resource,\n        config.authentication?.rule\n      )\n    );\n\n  if (config.rateLimit) middlewares.push(rateLimit(config.rateLimit));\n  if (config.compression) middlewares.push(compression(config.compression));\n  if (config.queryParser) middlewares.push(queryParser(config.queryParser));\n\n  if (config?.bodyParser) {\n    const parsers = Array.isArray(config.bodyParser)\n      ? config.bodyParser\n      : [config.bodyParser];\n\n    parsers.forEach((parser) => {\n      if (typeof parser === \"object\" && parser.parser)\n        if (parser.parser !== \"multipart\")\n          middlewares.push(catchAsync(express[parser.parser](parser.options)));\n        else if (parser.parser === \"multipart\")\n          middlewares.push(\n            catchAsync(multer({ limits: parser.options }).none())\n          );\n    });\n  }\n\n  if (config.experimental?.uploads) {\n    const uploadConfig = config.experimental.uploads;\n    middlewares.push(uploadManager.handleUpload(uploadConfig));\n    middlewares.push(uploadManager.validateRequiredFiles(uploadConfig));\n\n    middlewares.push(validateRequestInputs(config as ArkosRouteConfig));\n\n    middlewares.push(\n      uploadManager.handlePostUpload(config.experimental.uploads)\n    );\n  } else middlewares.push(validateRequestInputs(config as ArkosRouteConfig));\n\n  return middlewares;\n}\n\n/**\n * Extracts path parameters from an Express route path\n *\n * @param path - Express route path with :param syntax\n * @returns Array of parameter names\n *\n * @example\n * extractPathParams('/api/users/:userId/posts/:postId')\n * // => ['userId', 'postId']\n *\n */\nexport function extractPathParams(path: string): string[] {\n  const params: string[] = [];\n  const segments = path.split(\"/\");\n  let wildcardCount = 0;\n\n  for (const segment of segments) {\n    if (segment === \"*\") {\n      wildcardCount++;\n    } else if (segment.startsWith(\":\")) {\n      const clean = segment.substring(1).replace(/\\(.*\\)$/, \"\");\n      params.push(clean);\n    }\n  }\n\n  if (wildcardCount === 1) {\n    params.push(\"path\");\n  } else {\n    for (let i = 1; i <= wildcardCount; i++) {\n      params.push(`path${i}`);\n    }\n  }\n\n  return params;\n}\n\ntype PathLike = string | RegExp;\ntype PathInput = PathLike | PathLike[];\n\nexport function applyPrefix(\n  prefix: PathInput = \"\",\n  path: PathInput\n): PathInput {\n  if (!prefix) return path;\n\n  const prefixArr = Array.isArray(prefix) ? prefix : [prefix];\n  const pathArr = Array.isArray(path) ? path : [path];\n\n  const result: PathLike[] = [];\n\n  for (const pfx of prefixArr) {\n    for (const pth of pathArr) {\n      result.push(applySinglePrefix(pfx, pth));\n    }\n  }\n\n  return result.length === 1 ? result[0] : result;\n}\n\nfunction applySinglePrefix(prefix: PathLike, path: PathLike): PathLike {\n  const isPrefixRegex = prefix instanceof RegExp;\n  const isPathRegex = path instanceof RegExp;\n\n  if (typeof prefix === \"string\" && typeof path === \"string\") {\n    const normalizedPrefix = prefix.endsWith(\"/\")\n      ? prefix.slice(0, -1)\n      : prefix;\n\n    return `${normalizedPrefix}${path.startsWith(\"/\") ? \"\" : \"/\"}${path}`;\n  }\n\n  if (typeof prefix === \"string\" && isPathRegex) {\n    const escapedPrefix = prefix\n      .replace(/\\/$/, \"\")\n      .replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n\n    const source = path.source.startsWith(\"^\")\n      ? path.source.slice(1)\n      : path.source;\n\n    return new RegExp(`^${escapedPrefix}${source}`, path.flags);\n  }\n\n  if (isPrefixRegex && typeof path === \"string\") {\n    const escapedPath = path.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n\n    const prefixSource = prefix.source.endsWith(\"$\")\n      ? prefix.source.slice(0, -1)\n      : prefix.source;\n\n    return new RegExp(`^${prefixSource}${escapedPath}`, prefix.flags);\n  }\n\n  if (isPrefixRegex && isPathRegex) {\n    const prefixSource = prefix.source.endsWith(\"$\")\n      ? prefix.source.slice(0, -1)\n      : prefix.source;\n\n    const pathSource = path.source.startsWith(\"^\")\n      ? path.source.slice(1)\n      : path.source;\n\n    const flags = Array.from(new Set([...prefix.flags, ...path.flags])).join(\n      \"\"\n    );\n\n    return new RegExp(`^${prefixSource}${pathSource}`, flags);\n  }\n\n  throw new TypeError(\"Invalid prefix or path\");\n}\n"]}