arkos 2.0.0-next.3 → 2.0.0-next.30

package/dist/esm/utils/arkos-router/index.js

@@ -1,144 +1,29 @@
-import { Router } from "express";
-import RouteConfigValidator from "./route-config-validator.js";
-import RouteConfigRegistry from "./route-config-registry.js";
-import { applyPrefix, extractArkosRoutes, extractPathParams, getMiddlewareStack, } from "./utils/helpers/index.js";
-import { getArkosConfig } from "../../exports/index.js";
-import { catchAsync } from "../../exports/error-handler/index.js";
-import zodToJsonSchema from "zod-to-json-schema";
-import classValidatorToJsonSchema from "../../modules/swagger/utils/helpers/class-validator-to-json-schema.js";
-import openApiSchemaConverter from "../../modules/swagger/utils/helpers/openapi-schema-converter.js";
-import uploadManager from "./utils/helpers/upload-manager.js";
-import { getUserFileExtension } from "../helpers/fs.helpers.js";
-import arkosRouterOpenApiManager from "./arkos-router-openapi-manager.js";
-import deepmerge from "../helpers/deepmerge.helper.js";
+import { Router } from 'express';
+import { extractArkosRoutes, extractPathParams } from './utils/helpers/index.js';
+import openApiSchemaConverter from '../../modules/swagger/utils/helpers/openapi-schema-converter.js';
+import arkosRouterOpenApiManager from './arkos-router-openapi-manager.js';
+import { applyArkosRouterProxy } from './utils/helpers/apply-arkos-router-proxy.js';
+import uploadManager from './utils/helpers/upload-manager.js';
 export default function ArkosRouter(options) {
     const router = Router(options);
-    return new Proxy(router, {
-        get(target, prop, receiver) {
-            const originalMethod = Reflect.get(target, prop, receiver);
-            const httpMethods = [
-                "get",
-                "post",
-                "put",
-                "patch",
-                "delete",
-                "all",
-                "head",
-                "trace",
-                "options",
-            ];
-            if (prop === "route") {
-                return function (path) {
-                    const routeChain = {};
-                    httpMethods.forEach((method) => {
-                        routeChain[method] = function (config, ...handlers) {
-                            const fullConfig = {
-                                authentication: true,
-                                ...config,
-                                ...(options?.openapi
-                                    ? {
-                                        experimental: {
-                                            openapi: options.openapi,
-                                        },
-                                    }
-                                    : {}),
-                                path,
-                            };
-                            receiver[method](fullConfig, ...handlers);
-                            return routeChain;
-                        };
-                    });
-                    return routeChain;
-                };
-            }
-            if (httpMethods.includes(prop)) {
-                return function (config, ...handlers) {
-                    if (config.disabled)
-                        return;
-                    if (!RouteConfigValidator.isArkosRouteConfig(config))
-                        throw Error(`First argument of ArkosRouter().${prop}() must be a valid ArkosRouteConfig object with path field, but recevied ${typeof config === "object" ? JSON.stringify(config, null, 2) : config}`);
-                    const path = applyPrefix(options?.prefix, config.path);
-                    config = {
-                        authentication: true,
-                        ...config,
-                        ...(options?.openapi
-                            ? {
-                                experimental: {
-                                    ...config?.experimental,
-                                    openapi: deepmerge(options.openapi || {}, config?.experimental?.openapi || {}),
-                                },
-                            }
-                            : {}),
-                        path,
-                    };
-                    if ([null, undefined].includes(path))
-                        throw 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}.`);
-                    if (handlers.length > 0) {
-                        const flattenHandlers = (arr) => {
-                            return arr.reduce((flat, item) => {
-                                return flat.concat(Array.isArray(item) ? flattenHandlers(item) : item);
-                            }, []);
-                        };
-                        const flatHandlers = flattenHandlers(handlers);
-                        handlers = flatHandlers.map((handler) => {
-                            if (!handler)
-                                throw UndefinedHandlerError(handler);
-                            if (typeof handler !== "function") {
-                                throw UndefinedHandlerError(handler);
-                            }
-                            return catchAsync(handler, {
-                                type: handler.length > 3 ? "error" : "normal",
-                            });
-                        });
-                        const finalHandler = handlers[handlers.length - 1];
-                        RouteConfigRegistry.register(finalHandler, config, method);
-                    }
-                    const arkosConfig = getArkosConfig();
-                    const validationConfig = arkosConfig.validation;
-                    const authenticationConfig = arkosConfig.authentication;
-                    const strictValidation = validationConfig?.strict;
-                    const route = `${method.toUpperCase()} ${path}`;
-                    if (strictValidation &&
-                        (!("validation" in config) ||
-                            ("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.");
-                    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: '' } })`);
-                    if (config.authentication && !authenticationConfig?.mode)
-                        throw Error(`Trying to authenticate route ${route} without choosing an authentication mode under arkos.config.${getUserFileExtension()}
-
-For further help see https://www.arkosjs.com/docs/core-concepts/authentication-system.`);
-                    handlers = [...getMiddlewareStack(config), ...handlers];
-                    if (config.experimental?.uploads &&
-                        config.experimental.uploads.deleteOnError !== false)
-                        handlers.push(catchAsync(uploadManager.handleFileCleanup(config.experimental.uploads), { type: "error" }));
-                    return originalMethod.call(target, path, ...handlers);
-                };
-            }
-            return originalMethod;
-        },
-    });
+    return applyArkosRouterProxy(router, options);
 }
+const hasDuplicatedPath = (path) => /^(\/.+)\1/.test(path);
 export function generateOpenAPIFromApp(app) {
     const routes = extractArkosRoutes(app);
-    const arkosConfig = getArkosConfig();
     let paths = {};
-    routes.forEach(({ path, method, config }) => {
-        if (config?.experimental?.openapi === false)
+    routes.forEach(({ path, method, config, routeOptions }) => {
+        if (config?.experimental?.openapi === false || hasDuplicatedPath(path))
             return;
         const originalPath = path;
         const pathParatemersFromRoutePath = extractPathParams(path);
         for (const parameter of pathParatemersFromRoutePath) {
-            path = path.replaceAll(`:${parameter}`, parameter.endsWith("?") ? `{${parameter}}?` : `{${parameter}}`);
+            path = path.replaceAll(`:${parameter}`, parameter.endsWith('?') ? `{${parameter}}?` : `{${parameter}}`);
+            path = path.replaceAll(`*${parameter}`, parameter.endsWith('?') ? `{${parameter}}?` : `{${parameter}}`);
         }
         if (!paths[path])
             paths[path] = {};
-        if (typeof config?.experimental?.openapi === "boolean") {
+        if (typeof config?.experimental?.openapi === 'boolean') {
             config = {
                 ...config,
                 experimental: {
@@ -147,26 +32,23 @@ export function generateOpenAPIFromApp(app) {
                 },
             };
         }
-        const openapi = typeof config?.experimental?.openapi === "object" &&
+        const openapi = typeof config?.experimental?.openapi === 'object' &&
             config.experimental.openapi !== null
             ? config.experimental.openapi
             : {};
-        const validatorToJsonSchema = arkosConfig?.validation?.resolver === "zod"
-            ? zodToJsonSchema
-            : classValidatorToJsonSchema;
         let parameters = [];
         const validationToParameterMapping = {
-            query: "query",
-            params: "path",
-            headers: "header",
-            cookies: "cookie",
+            query: 'query',
+            params: 'path',
+            headers: 'header',
+            cookies: 'cookie',
         };
-        if (typeof config?.validation !== "boolean" && config?.validation) {
+        if (typeof config?.validation !== 'boolean' && config?.validation) {
             for (const [key, val] of Object.entries(config?.validation)) {
-                if (["body"].includes(key))
+                if (['body'].includes(key))
                     continue;
                 if ((config?.validation)[key]) {
-                    const jsonSchema = validatorToJsonSchema(val);
+                    const jsonSchema = openApiSchemaConverter.validatorToJsonSchema(val);
                     const params = openApiSchemaConverter.jsonSchemaToOpenApiParameters(validationToParameterMapping[key], jsonSchema);
                     parameters.push(...params);
                 }
@@ -178,67 +60,85 @@ export function generateOpenAPIFromApp(app) {
             ...parameters,
         ];
         for (const parameter of pathParatemersFromRoutePath) {
-            if (!allParameters.find(({ name, in: paramIn }) => name === parameter.replace("?", "") && paramIn === "path"))
+            if (!allParameters.find(({ name, in: paramIn }) => name === parameter.replace('?', '') && paramIn === 'path'))
                 allParameters.push({
                     name: parameter,
-                    in: "path",
-                    required: !parameter.includes("?"),
-                    schema: { type: "string" },
+                    in: 'path',
+                    required: !parameter.includes('?'),
+                    schema: { type: 'string' },
                 });
         }
         for (const param of allParameters) {
             if (!pathParatemersFromRoutePath.includes(param.name) &&
                 !pathParatemersFromRoutePath.includes(`${param.name}?`) &&
-                param.in === "path")
+                param.in === 'path' &&
+                param.name !== '*')
                 throw new Error(`ValidationError: Trying to define path parameter '${param.name}' but it is not present in your pathname ${originalPath}`);
         }
         delete convertedOpenAPI.parameters;
         const hasUploadFields = Object.keys(config?.experimental?.uploads || {}).length > 0;
-        const multipartFormSchema = convertedOpenAPI?.requestBody?.content?.["multipart/form-data"];
+        const multipartFormSchema = convertedOpenAPI?.requestBody?.content?.['multipart/form-data'];
+        const allUploadFieldsAreRequired = hasUploadFields
+            ? uploadManager.isAllFieldRequired(config?.experimental?.uploads)
+            : false;
         if (hasUploadFields && multipartFormSchema)
             arkosRouterOpenApiManager.validateMultipartFormDocs(multipartFormSchema, path, config?.experimental?.uploads);
         paths[path][method.toLowerCase()] = {
+            ...convertedOpenAPI,
             summary: openapi?.summary || `${path}`,
             description: openapi?.description || `${method} ${path}`,
-            tags: openapi?.tags || ["Defaults"],
-            operationId: `${method.toLowerCase()}:${path}`,
+            servers: openapi?.servers || routeOptions?.openapi?.servers || undefined,
+            security: openapi?.security || routeOptions?.openapi?.security || undefined,
+            externalDocs: openapi?.externalDocs ||
+                routeOptions?.openapi?.externalDocs ||
+                undefined,
+            tags: openapi?.tags || routeOptions?.openapi?.tags || ['Defaults'],
+            operationId: openapi.operationId || `${method.toLowerCase()}:${path}`,
             parameters: allParameters,
             ...(!convertedOpenAPI.requestBody &&
                 config?.validation &&
                 config?.validation?.body && {
                 requestBody: {
                     content: (() => {
-                        const schema = validatorToJsonSchema(config?.validation?.body);
+                        const schema = openApiSchemaConverter.validatorToJsonSchema(config?.validation?.body);
                         return {
+                            ...convertedOpenAPI?.requestBody?.content,
                             ...(hasUploadFields && {
-                                "multipart/form-data": {
+                                'multipart/form-data': {
                                     schema: openApiSchemaConverter.flattenSchema(arkosRouterOpenApiManager.addUploadFields(config.experimental?.uploads, schema)),
                                 },
                             }),
-                            "application/json": {
-                                schema,
-                            },
+                            ...(!allUploadFieldsAreRequired && {
+                                'application/json': {
+                                    schema,
+                                },
+                            }),
                         };
                     })(),
                 },
             }),
-            ...(convertedOpenAPI?.requestBody?.content?.["application/json"] &&
-                !multipartFormSchema &&
+            ...(!multipartFormSchema &&
                 !config?.validation?.body &&
                 hasUploadFields && {
                 requestBody: {
                     content: (() => {
-                        const schema = convertedOpenAPI?.requestBody?.content?.["application/json"];
+                        const schema = convertedOpenAPI?.requestBody?.content?.['application/json']
+                            ?.schema || {};
+                        delete convertedOpenAPI?.requestBody?.content?.['application/json'];
                         return {
-                            "multipart/form-data": {
+                            'multipart/form-data': {
                                 schema: openApiSchemaConverter.flattenSchema(arkosRouterOpenApiManager.addUploadFields(config?.experimental?.uploads || {}, schema)),
                             },
-                            ...convertedOpenAPI?.requestBody,
+                            ...convertedOpenAPI?.requestBody?.content,
+                            ...(!allUploadFieldsAreRequired && {
+                                'application/json': {
+                                    schema,
+                                },
+                            }),
                         };
                     })(),
                 },
             }),
-            ...convertedOpenAPI,
         };
     });
     return paths;

package/dist/esm/utils/arkos-router/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/arkos-router/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { Router, RouterOptions } from \"express\";\nimport {\n  IArkosRouter,\n  ArkosRouteConfig,\n  ArkosAnyRequestHandler,\n  PathParams,\n  ArkosIRoute,\n} from \"./types\";\nimport { OpenAPIV3 } from \"openapi-types\";\nimport RouteConfigValidator from \"./route-config-validator\";\nimport RouteConfigRegistry from \"./route-config-registry\";\nimport {\n  applyPrefix,\n  extractArkosRoutes,\n  extractPathParams,\n  getMiddlewareStack,\n} from \"./utils/helpers\";\nimport { getArkosConfig } from \"../../exports\";\nimport { catchAsync } from \"../../exports/error-handler\";\nimport zodToJsonSchema from \"zod-to-json-schema\";\nimport classValidatorToJsonSchema from \"../../modules/swagger/utils/helpers/class-validator-to-json-schema\";\nimport openApiSchemaConverter from \"../../modules/swagger/utils/helpers/openapi-schema-converter\";\nimport uploadManager from \"./utils/helpers/upload-manager\";\nimport { getUserFileExtension } from \"../helpers/fs.helpers\";\nimport arkosRouterOpenApiManager from \"./arkos-router-openapi-manager\";\nimport deepmerge from \"../helpers/deepmerge.helper\";\n\n/**\n * Creates an enhanced Express Router with features like OpenAPI documentation capabilities and smart data validation.\n *\n * The ArkosRouter extends the standard Express Router with the ability to\n * automatically capture OpenAPI metadata from route configurations.\n *\n * @example\n * const router = ArkosRouter();\n *\n * router.get(\n *   {\n *     path: \"/users/:id\",\n *     openapi: {\n *       summary: \"Get user by ID\",\n *       tags: [\"Users\"]\n *     }\n *   },\n *   (req, res) => { ... }\n * );\n *\n * @returns {IArkosRouter} A proxied Express Router instance with enhanced OpenAPI capabilities\n *\n * @see {@link ArkosRouteConfig} for configuration options\n */\nexport default function ArkosRouter(\n  options?: RouterOptions & {\n    prefix?: string | RegExp | Array<string | RegExp>;\n    openapi?: { tags?: string[] };\n  }\n): IArkosRouter {\n  const router = Router(options);\n\n  return new Proxy(router, {\n    get(target, prop, receiver) {\n      const originalMethod = Reflect.get(target, prop, receiver);\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 === \"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                authentication: true,\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 ArkosIRoute;\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 ArkosRouter().${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            authentication: true,\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-system.`\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  }) as IArkosRouter;\n}\n\nexport function generateOpenAPIFromApp(app: any) {\n  const routes = extractArkosRoutes(app);\n  const arkosConfig = getArkosConfig();\n\n  let paths: Record<\n    string,\n    Record<string, Partial<OpenAPIV3.OperationObject>>\n  > = {};\n\n  routes.forEach(({ path, method, config }) => {\n    if (config?.experimental?.openapi === false) return;\n    const originalPath = path;\n\n    const pathParatemersFromRoutePath = extractPathParams(path);\n    for (const parameter of pathParatemersFromRoutePath) {\n      path = path.replaceAll(\n        `:${parameter}`,\n        parameter.endsWith(\"?\") ? `{${parameter}}?` : `{${parameter}}`\n      );\n    }\n\n    if (!paths[path]) paths[path] = {};\n\n    if (typeof config?.experimental?.openapi === \"boolean\") {\n      config = {\n        ...config,\n        experimental: {\n          ...config.experimental,\n          openapi: {},\n        },\n      };\n    }\n\n    const openapi =\n      typeof config?.experimental?.openapi === \"object\" &&\n      config.experimental.openapi !== null\n        ? config.experimental.openapi\n        : {};\n\n    const validatorToJsonSchema =\n      arkosConfig?.validation?.resolver === \"zod\"\n        ? zodToJsonSchema\n        : classValidatorToJsonSchema;\n\n    let parameters = [];\n    const validationToParameterMapping = {\n      query: \"query\",\n      params: \"path\",\n      headers: \"header\",\n      cookies: \"cookie\",\n    };\n\n    if (typeof config?.validation !== \"boolean\" && config?.validation) {\n      for (const [key, val] of Object.entries(config?.validation)) {\n        if ([\"body\"].includes(key)) continue;\n        if ((config?.validation as any)[key]) {\n          const jsonSchema = validatorToJsonSchema(val as any);\n          const params = openApiSchemaConverter.jsonSchemaToOpenApiParameters(\n            (validationToParameterMapping as any)[key],\n            jsonSchema\n          );\n          parameters.push(...params);\n        }\n      }\n    }\n\n    const convertedOpenAPI =\n      openApiSchemaConverter.convertOpenAPIConfig(openapi);\n\n    const allParameters: OpenAPIV3.ParameterObject[] = [\n      ...(convertedOpenAPI.parameters || []),\n      ...parameters,\n    ];\n\n    for (const parameter of pathParatemersFromRoutePath) {\n      if (\n        !allParameters.find(\n          ({ name, in: paramIn }) =>\n            name === parameter.replace(\"?\", \"\") && paramIn === \"path\"\n        )\n      )\n        allParameters.push({\n          name: parameter,\n          in: \"path\",\n          required: !parameter.includes(\"?\"),\n          schema: { type: \"string\" },\n        });\n    }\n\n    for (const param of allParameters) {\n      if (\n        !pathParatemersFromRoutePath.includes(param.name) &&\n        !pathParatemersFromRoutePath.includes(`${param.name}?`) &&\n        param.in === \"path\"\n      )\n        throw new Error(\n          `ValidationError: Trying to define path parameter '${param.name}' but it is not present in your pathname ${originalPath}`\n        );\n    }\n\n    delete convertedOpenAPI.parameters;\n    const hasUploadFields =\n      Object.keys(config?.experimental?.uploads || {}).length > 0;\n    const multipartFormSchema =\n      convertedOpenAPI?.requestBody?.content?.[\"multipart/form-data\"];\n\n    if (hasUploadFields && multipartFormSchema)\n      arkosRouterOpenApiManager.validateMultipartFormDocs(\n        multipartFormSchema,\n        path,\n        config?.experimental?.uploads\n      );\n\n    (paths as any)[path][method.toLowerCase()] = {\n      summary: openapi?.summary || `${path}`,\n      description: openapi?.description || `${method} ${path}`,\n      tags: openapi?.tags || [\"Defaults\"],\n      operationId: `${method.toLowerCase()}:${path}`,\n      parameters: allParameters,\n      ...(!convertedOpenAPI.requestBody &&\n        config?.validation &&\n        config?.validation?.body && {\n          requestBody: {\n            content: (() => {\n              const schema = validatorToJsonSchema(\n                config?.validation?.body as any\n              );\n\n              return {\n                ...(hasUploadFields && {\n                  \"multipart/form-data\": {\n                    schema: openApiSchemaConverter.flattenSchema(\n                      arkosRouterOpenApiManager.addUploadFields(\n                        config.experimental?.uploads!,\n                        schema\n                      )\n                    ),\n                  },\n                }),\n                \"application/json\": {\n                  schema,\n                },\n              };\n            })(),\n          },\n        }),\n      ...(convertedOpenAPI?.requestBody?.content?.[\"application/json\"] &&\n        !multipartFormSchema &&\n        !(config as any)?.validation?.body &&\n        hasUploadFields && {\n          requestBody: {\n            content: (() => {\n              const schema =\n                convertedOpenAPI?.requestBody?.content?.[\"application/json\"];\n\n              return {\n                \"multipart/form-data\": {\n                  schema: openApiSchemaConverter.flattenSchema(\n                    arkosRouterOpenApiManager.addUploadFields(\n                      config?.experimental?.uploads! || {},\n                      schema\n                    )\n                  ),\n                },\n                ...convertedOpenAPI?.requestBody,\n              };\n            })(),\n          },\n        }),\n      ...convertedOpenAPI,\n    };\n  });\n\n  return paths;\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/arkos-router/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { Router, RouterOptions } from 'express';\nimport { IArkosRouter } from './types';\nimport { OpenAPIV3 } from 'openapi-types';\nimport { extractArkosRoutes, extractPathParams } from './utils/helpers';\nimport openApiSchemaConverter from '../../modules/swagger/utils/helpers/openapi-schema-converter';\nimport arkosRouterOpenApiManager from './arkos-router-openapi-manager';\nimport { applyArkosRouterProxy } from './utils/helpers/apply-arkos-router-proxy';\nimport { Arkos } from '../../types/arkos';\nimport { ArkosRouterBaseUploadConfig } from './types/upload-config';\nimport uploadManager from './utils/helpers/upload-manager';\n\nexport type ArkosRouterOptions = {\n  /**\n   * Prefix to apply to all routes in this router.\n   * Nested routers inherit and concatenate prefixes from parent routers.\n   *\n   * @since 1.5.0-beta\n   * @example\n   * // All routes in this router will be prefixed with \"/api\"\n   * prefix: \"/api\"\n   */\n  prefix?: string | RegExp | Array<string | RegExp>;\n  /**\n   * OpenAPI metadata to apply to all routes in this router.\n   * Nested routers inherit from parent routers unless explicitly overridden.\n   * Route-level openapi config fully replaces inherited values when defined.\n   *\n   * @since 1.6.0-beta\n   * @example\n   * openapi: {\n   *   tags: [\"Users\"],\n   *   security: [{ bearerAuth: [] }]\n   * }\n   */\n  openapi?: {\n    /**\n     * Tags to apply to all routes in this router, used to group them in OpenAPI documentation.\n     * Route-level tags fully replaces this value when defined.\n     *\n     * @since 1.6.0-beta\n     * @example\n     * // Group all routes in this router under \"Users\"\n     * tags: [\"Users\"]\n     */\n    tags?: string[];\n    /**\n     * Security requirements to apply to all routes in this router.\n     * Route-level security fully replaces this value when defined.\n     *\n     * @since 1.6.2-canary.1\n     * @example\n     * // Require bearer auth for all routes in this router\n     * security: [{ bearerAuth: [] }]\n     *\n     * // Explicitly make all routes public (overridable per route)\n     * security: []\n     */\n    security?: OpenAPIV3.SecurityRequirementObject[];\n\n    /**\n     * Server definitions to apply to all routes in this router.\n     * Follows the OpenAPI 3.0 Server Object specification.\n     * Route-level servers fully replaces this value when defined.\n     *\n     * @since 1.6.2-canary.1\n     * @example\n     * servers: [{ url: \"https://api.example.com/v2\", description: \"V2 API\" }]\n     */\n    servers?: OpenAPIV3.ServerObject[];\n    /**\n     * External documentation to apply to all routes in this router.\n     * Route-level externalDocs fully replaces this value when defined.\n     *\n     * @since 1.6.2-canary.1\n     * @example\n     * externalDocs: {\n     *   description: \"Find more information here\",\n     *   url: \"https://docs.example.com/users\"\n     * }\n     */\n    externalDocs?: OpenAPIV3.ExternalDocumentationObject;\n  };\n  /**\n   * Allow customizing uploads on route level\n   *\n   * @since 1.7.0-canary.39\n   */\n  uploads?: ArkosRouterBaseUploadConfig;\n};\n\n/**\n * Creates an enhanced Express Router with features like OpenAPI documentation capabilities and smart data validation.\n *\n * The ArkosRouter extends the standard Express Router with the ability to\n * automatically capture OpenAPI metadata from route configurations.\n *\n * @example\n * const router = ArkosRouter();\n *\n * router.get(\n *   {\n *     path: \"/users/:id\",\n *     openapi: {\n *       summary: \"Get user by ID\",\n *       tags: [\"Users\"]\n *     }\n *   },\n *   (req, res) => { ... }\n * );\n *\n * @returns {IArkosRouter} A proxied Express Router instance with enhanced OpenAPI capabilities\n *\n * @see {@link https://www.arkosjs.com/docs/reference/arkos-router} for configuration options\n * @since 1.4.0-beta\n */\nexport default function ArkosRouter(\n  options?: RouterOptions & ArkosRouterOptions,\n): IArkosRouter {\n  const router = Router(options);\n  return applyArkosRouterProxy(router, options);\n}\n\nconst hasDuplicatedPath = (path: string) => /^(\\/.+)\\1/.test(path);\n\nexport function generateOpenAPIFromApp(app: Arkos) {\n  const routes = extractArkosRoutes(app);\n\n  let paths: Record<\n    string,\n    Record<string, Partial<OpenAPIV3.OperationObject>>\n  > = {};\n\n  routes.forEach(({ path, method, config, routeOptions }) => {\n    if (config?.experimental?.openapi === false || hasDuplicatedPath(path))\n      return;\n    const originalPath = path;\n\n    const pathParatemersFromRoutePath = extractPathParams(path);\n    for (const parameter of pathParatemersFromRoutePath) {\n      path = path.replaceAll(\n        `:${parameter}`,\n        parameter.endsWith('?') ? `{${parameter}}?` : `{${parameter}}`,\n      );\n      path = path.replaceAll(\n        `*${parameter}`,\n        parameter.endsWith('?') ? `{${parameter}}?` : `{${parameter}}`,\n      );\n    }\n\n    if (!paths[path]) paths[path] = {};\n\n    if (typeof config?.experimental?.openapi === 'boolean') {\n      config = {\n        ...config,\n        experimental: {\n          ...config.experimental,\n          openapi: {},\n        },\n      };\n    }\n\n    const openapi =\n      typeof config?.experimental?.openapi === 'object' &&\n      config.experimental.openapi !== null\n        ? config.experimental.openapi\n        : {};\n\n    let parameters: {\n      in: string;\n      name: string;\n      required: boolean;\n      schema: any;\n    }[] = [];\n    const validationToParameterMapping = {\n      query: 'query',\n      params: 'path',\n      headers: 'header',\n      cookies: 'cookie',\n    };\n\n    if (typeof config?.validation !== 'boolean' && config?.validation) {\n      for (const [key, val] of Object.entries(config?.validation)) {\n        if (['body'].includes(key)) continue;\n        if ((config?.validation as any)[key]) {\n          const jsonSchema = openApiSchemaConverter.validatorToJsonSchema(\n            val as any,\n          );\n          const params = openApiSchemaConverter.jsonSchemaToOpenApiParameters(\n            (validationToParameterMapping as any)[key],\n            jsonSchema,\n          );\n          parameters.push(...params);\n        }\n      }\n    }\n\n    const convertedOpenAPI =\n      openApiSchemaConverter.convertOpenAPIConfig(openapi);\n\n    const allParameters: OpenAPIV3.ParameterObject[] = [\n      ...(convertedOpenAPI.parameters || []),\n      ...parameters,\n    ];\n\n    for (const parameter of pathParatemersFromRoutePath) {\n      if (\n        !allParameters.find(\n          ({ name, in: paramIn }) =>\n            name === parameter.replace('?', '') && paramIn === 'path',\n        )\n      )\n        allParameters.push({\n          name: parameter,\n          in: 'path',\n          required: !parameter.includes('?'),\n          schema: { type: 'string' },\n        });\n    }\n\n    for (const param of allParameters) {\n      if (\n        !pathParatemersFromRoutePath.includes(param.name) &&\n        !pathParatemersFromRoutePath.includes(`${param.name}?`) &&\n        param.in === 'path' &&\n        param.name !== '*'\n      )\n        throw new Error(\n          `ValidationError: Trying to define path parameter '${param.name}' but it is not present in your pathname ${originalPath}`,\n        );\n    }\n\n    delete convertedOpenAPI.parameters;\n    const hasUploadFields =\n      Object.keys(config?.experimental?.uploads || {}).length > 0;\n    const multipartFormSchema =\n      convertedOpenAPI?.requestBody?.content?.['multipart/form-data'];\n\n    const allUploadFieldsAreRequired = hasUploadFields\n      ? uploadManager.isAllFieldRequired(config?.experimental?.uploads!)\n      : false;\n\n    if (hasUploadFields && multipartFormSchema)\n      arkosRouterOpenApiManager.validateMultipartFormDocs(\n        multipartFormSchema,\n        path,\n        config?.experimental?.uploads,\n      );\n\n    (paths as any)[path][method.toLowerCase()] = {\n      ...convertedOpenAPI,\n      summary: openapi?.summary || `${path}`,\n      description: openapi?.description || `${method} ${path}`,\n      servers: openapi?.servers || routeOptions?.openapi?.servers || undefined,\n      security:\n        openapi?.security || routeOptions?.openapi?.security || undefined,\n      externalDocs:\n        openapi?.externalDocs ||\n        routeOptions?.openapi?.externalDocs ||\n        undefined,\n      tags: openapi?.tags || routeOptions?.openapi?.tags || ['Defaults'],\n      operationId: openapi.operationId || `${method.toLowerCase()}:${path}`,\n      parameters: allParameters,\n      ...(!convertedOpenAPI.requestBody &&\n        config?.validation &&\n        config?.validation?.body && {\n          requestBody: {\n            content: (() => {\n              const schema = openApiSchemaConverter.validatorToJsonSchema(\n                config?.validation?.body as any,\n              );\n\n              return {\n                ...convertedOpenAPI?.requestBody?.content,\n                ...(hasUploadFields && {\n                  'multipart/form-data': {\n                    schema: openApiSchemaConverter.flattenSchema(\n                      arkosRouterOpenApiManager.addUploadFields(\n                        config.experimental?.uploads!,\n                        schema,\n                      ),\n                    ),\n                  },\n                }),\n                ...(!allUploadFieldsAreRequired && {\n                  'application/json': {\n                    schema,\n                  },\n                }),\n              };\n            })(),\n          },\n        }),\n      ...(!multipartFormSchema &&\n        !(config as any)?.validation?.body &&\n        hasUploadFields && {\n          requestBody: {\n            content: (() => {\n              const schema =\n                convertedOpenAPI?.requestBody?.content?.['application/json']\n                  ?.schema || {};\n\n              delete convertedOpenAPI?.requestBody?.content?.[\n                'application/json'\n              ];\n\n              return {\n                'multipart/form-data': {\n                  schema: openApiSchemaConverter.flattenSchema(\n                    arkosRouterOpenApiManager.addUploadFields(\n                      config?.experimental?.uploads! || {},\n                      schema,\n                    ),\n                  ),\n                },\n                ...convertedOpenAPI?.requestBody?.content,\n                ...(!allUploadFieldsAreRequired && {\n                  'application/json': {\n                    schema,\n                  },\n                }),\n              };\n            })(),\n          },\n        }),\n    } as OpenAPIV3.PathItemObject;\n  });\n\n  return paths;\n}\n\n"]}

package/dist/esm/utils/arkos-router/route-config-registry.js

@@ -1,4 +1,5 @@
-class RouteConfigRegistry {
+export default class RouteConfigRegistry {
+    static configs = new WeakMap();
     static register(handler, config, method) {
         this.configs.set(handler, { ...config, method });
     }
@@ -9,6 +10,4 @@ class RouteConfigRegistry {
         return this.configs;
     }
 }
-RouteConfigRegistry.configs = new WeakMap();
-export default RouteConfigRegistry;
 //# sourceMappingURL=route-config-registry.js.map

package/dist/esm/utils/arkos-router/route-config-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"route-config-registry.js","sourceRoot":"","sources":["../../../../src/utils/arkos-router/route-config-registry.ts"],"names":[],"mappings":"AAEA,MAAqB,mBAAmB;IAMtC,MAAM,CAAC,QAAQ,CACb,OAAmC,EACnC,MAAwB,EACxB,MAAc;QAEd,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,CAAC,GAAG,CAAC,OAAiB;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;;AAnBc,2BAAO,GAAG,IAAI,OAAO,EAGjC,CAAC;eAJe,mBAAmB","sourcesContent":["import { ArkosRouteConfig } from \"./types\";\n\nexport default class RouteConfigRegistry {\n  private static configs = new WeakMap<\n    Function | Array<Function>,\n    ArkosRouteConfig & { method: string }\n  >();\n\n  static register(\n    handler: Function | Array<Function>,\n    config: ArkosRouteConfig,\n    method: string\n  ) {\n    this.configs.set(handler, { ...config, method });\n  }\n\n  static get(handler: Function) {\n    return this.configs.get(handler);\n  }\n\n  static getAll() {\n    return this.configs;\n  }\n}\n"]}
+{"version":3,"file":"route-config-registry.js","sourceRoot":"","sources":["../../../../src/utils/arkos-router/route-config-registry.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,OAAO,OAAO,mBAAmB;IAC9B,MAAM,CAAC,OAAO,GAAG,IAAI,OAAO,EAGjC,CAAC;IAEJ,MAAM,CAAC,QAAQ,CACb,OAAmC,EACnC,MAAwB,EACxB,MAAc;QAEd,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,CAAC,GAAG,CAAC,OAAiB;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC","sourcesContent":["import { ArkosRouteConfig } from \"./types\";\n\nexport default class RouteConfigRegistry {\n  private static configs = new WeakMap<\n    Function | Array<Function>,\n    ArkosRouteConfig & { method: string }\n  >();\n\n  static register(\n    handler: Function | Array<Function>,\n    config: ArkosRouteConfig,\n    method: string\n  ) {\n    this.configs.set(handler, { ...config, method });\n  }\n\n  static get(handler: Function) {\n    return this.configs.get(handler);\n  }\n\n  static getAll() {\n    return this.configs;\n  }\n}\n"]}

package/dist/esm/utils/arkos-router/route-config-validator.js

@@ -5,7 +5,7 @@ export default class RouteConfigValidator {
         return typeof arg === "object" && arg !== null && "path" in arg;
     }
     static validate(config) {
-        const swaggerMode = getArkosConfig()?.validation?.resolver;
+        const resolver = getArkosConfig()?.validation?.resolver;
         if (config.validation) {
             const validators = [
                 { key: "query", schema: config.validation?.query },
@@ -17,13 +17,14 @@ export default class RouteConfigValidator {
                     continue;
                 const isZod = isZodSchema(schema);
                 const isClassValidator = isClass(schema);
-                if (isZod && swaggerMode !== "zod") {
-                    throw new Error(`Zod schema used in validation.${key} but Swagger mode is '${swaggerMode}'. ` +
-                        `Zod schemas are only supported when swagger.mode is 'zod'.`);
+                if (isZod && !["hybrid", "zod"].includes(resolver)) {
+                    throw new Error(`Zod schema used in validation.${key} but validation.resolver is '${resolver}'. ` +
+                        `Zod schemas are only supported when validation.resolver is 'zod' or 'hybrid'.`);
                 }
-                if (isClassValidator && swaggerMode !== "class-validator") {
-                    throw new Error(`Class validator used in validation.${key} but Swagger mode is '${swaggerMode}'. ` +
-                        `Class validators are only supported when swagger.mode is 'class-validator'.`);
+                if (isClassValidator &&
+                    !["hybrid", "class-validator"].includes(resolver)) {
+                    throw new Error(`Class validator used in validation.${key} but validation.resolver is '${resolver}'. ` +
+                        `Class validators are only supported when validation.resolver is 'class-validator' or 'hybrid'.`);
                 }
             }
         }
@@ -32,18 +33,18 @@ export default class RouteConfigValidator {
                 .openapi;
             if (config.validation.query &&
                 openapi.parameters?.some((p) => p.in === "query")) {
-                throw new Error("Duplicate query validation definitions. " +
+                throw new Error(`Duplicate query validation definitions for route "${config.path}". ` +
                     "When using validation.query, do not define query parameters in openapi.parameters. " +
                     "They will be automatically migrated to OpenAPI specification.");
             }
             if (config.validation.params &&
                 openapi.parameters?.some((p) => p.in === "params")) {
-                throw new Error("Duplicate path parameter validation definitions. " +
+                throw new Error(`Duplicate path parameter validation definitions for route "${config.path}". ` +
                     "When using validation.params, do not define path parameters in openapi.parameters. " +
                     "They will be automatically migrated to OpenAPI specification.");
             }
             if (config.validation.body && openapi.requestBody) {
-                throw new Error("Duplicate request body validation definitions. " +
+                throw new Error(`Duplicate request body validation definitions for route "${config.path}". ` +
                     "When using validation.body, do not define openapi.requestBody in openapi. " +
                     "It will be automatically migrated to OpenAPI specification.");
             }

package/dist/esm/utils/arkos-router/route-config-validator.js.map

@@ -1 +1 @@
-{"version":3,"file":"route-config-validator.js","sourceRoot":"","sources":["../../../../src/utils/arkos-router/route-config-validator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,MAAM,CAAC,OAAO,OAAO,oBAAoB;IACvC,MAAM,CAAC,kBAAkB,CAAC,GAAQ;QAChC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,MAAM,IAAI,GAAG,CAAC;IAClE,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,MAAwB;QACtC,MAAM,WAAW,GAAG,cAAc,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC;QAE3D,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,MAAM,UAAU,GAAG;gBACjB,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE;gBAClD,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE;gBAChD,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE;aACrD,CAAC;YAEF,KAAK,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;gBACzC,IAAI,CAAC,MAAM;oBAAE,SAAS;gBAEtB,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;gBAClC,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;gBAEzC,IAAI,KAAK,IAAI,WAAW,KAAK,KAAK,EAAE,CAAC;oBACnC,MAAM,IAAI,KAAK,CACb,iCAAiC,GAAG,yBAAyB,WAAW,KAAK;wBAC3E,4DAA4D,CAC/D,CAAC;gBACJ,CAAC;gBAED,IAAI,gBAAgB,IAAI,WAAW,KAAK,iBAAiB,EAAE,CAAC;oBAC1D,MAAM,IAAI,KAAK,CACb,sCAAsC,GAAG,yBAAyB,WAAW,KAAK;wBAChF,6EAA6E,CAChF,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,UAAU,IAAI,OAAO,MAAM,CAAC,YAAY,EAAE,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC1E,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY;iBAChC,OAA6C,CAAC;YAEjD,IACE,MAAM,CAAC,UAAU,CAAC,KAAK;gBACvB,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,EACtD,CAAC;gBACD,MAAM,IAAI,KAAK,CACb,0CAA0C;oBACxC,qFAAqF;oBACrF,+DAA+D,CAClE,CAAC;YACJ,CAAC;YAED,IACE,MAAM,CAAC,UAAU,CAAC,MAAM;gBACxB,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,EACvD,CAAC;gBACD,MAAM,IAAI,KAAK,CACb,mDAAmD;oBACjD,qFAAqF;oBACrF,+DAA+D,CAClE,CAAC;YACJ,CAAC;YAED,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;gBAClD,MAAM,IAAI,KAAK,CACb,iDAAiD;oBAC/C,4EAA4E;oBAC5E,6DAA6D,CAChE,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;CACF","sourcesContent":["import { ArkosRouteConfig } from \"./types\";\nimport { isClass, isZodSchema } from \"../dynamic-loader\";\nimport { getArkosConfig } from \"../../exports\";\nimport { OpenAPIV3 } from \"openapi-types\";\n\nexport default class RouteConfigValidator {\n  static isArkosRouteConfig(arg: any): arg is ArkosRouteConfig {\n    return typeof arg === \"object\" && arg !== null && \"path\" in arg;\n  }\n\n  static validate(config: ArkosRouteConfig) {\n    const swaggerMode = getArkosConfig()?.validation?.resolver;\n\n    if (config.validation) {\n      const validators = [\n        { key: \"query\", schema: config.validation?.query },\n        { key: \"body\", schema: config.validation?.body },\n        { key: \"params\", schema: config.validation?.params },\n      ];\n\n      for (const { key, schema } of validators) {\n        if (!schema) continue;\n\n        const isZod = isZodSchema(schema);\n        const isClassValidator = isClass(schema);\n\n        if (isZod && swaggerMode !== \"zod\") {\n          throw new Error(\n            `Zod schema used in validation.${key} but Swagger mode is '${swaggerMode}'. ` +\n              `Zod schemas are only supported when swagger.mode is 'zod'.`\n          );\n        }\n\n        if (isClassValidator && swaggerMode !== \"class-validator\") {\n          throw new Error(\n            `Class validator used in validation.${key} but Swagger mode is '${swaggerMode}'. ` +\n              `Class validators are only supported when swagger.mode is 'class-validator'.`\n          );\n        }\n      }\n    }\n\n    if (config.validation && typeof config.experimental?.openapi === \"object\") {\n      const openapi = config.experimental\n        .openapi as Partial<OpenAPIV3.OperationObject>;\n\n      if (\n        config.validation.query &&\n        openapi.parameters?.some((p: any) => p.in === \"query\")\n      ) {\n        throw new Error(\n          \"Duplicate query validation definitions. \" +\n            \"When using validation.query, do not define query parameters in openapi.parameters. \" +\n            \"They will be automatically migrated to OpenAPI specification.\"\n        );\n      }\n\n      if (\n        config.validation.params &&\n        openapi.parameters?.some((p: any) => p.in === \"params\")\n      ) {\n        throw new Error(\n          \"Duplicate path parameter validation definitions. \" +\n            \"When using validation.params, do not define path parameters in openapi.parameters. \" +\n            \"They will be automatically migrated to OpenAPI specification.\"\n        );\n      }\n\n      if (config.validation.body && openapi.requestBody) {\n        throw new Error(\n          \"Duplicate request body validation definitions. \" +\n            \"When using validation.body, do not define openapi.requestBody in openapi. \" +\n            \"It will be automatically migrated to OpenAPI specification.\"\n        );\n      }\n    }\n  }\n}\n"]}
+{"version":3,"file":"route-config-validator.js","sourceRoot":"","sources":["../../../../src/utils/arkos-router/route-config-validator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,MAAM,CAAC,OAAO,OAAO,oBAAoB;IACvC,MAAM,CAAC,kBAAkB,CAAC,GAAQ;QAChC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,MAAM,IAAI,GAAG,CAAC;IAClE,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,MAAwB;QACtC,MAAM,QAAQ,GAAG,cAAc,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC;QAExD,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,MAAM,UAAU,GAAG;gBACjB,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE;gBAClD,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE;gBAChD,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE;aACrD,CAAC;YAEF,KAAK,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;gBACzC,IAAI,CAAC,MAAM;oBAAE,SAAS;gBAEtB,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;gBAClC,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;gBAEzC,IAAI,KAAK,IAAI,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAkB,CAAC,EAAE,CAAC;oBAC7D,MAAM,IAAI,KAAK,CACb,iCAAiC,GAAG,gCAAgC,QAAQ,KAAK;wBAC/E,+EAA+E,CAClF,CAAC;gBACJ,CAAC;gBAED,IACE,gBAAgB;oBAChB,CAAC,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC,QAAQ,CAAC,QAAkB,CAAC,EAC3D,CAAC;oBACD,MAAM,IAAI,KAAK,CACb,sCAAsC,GAAG,gCAAgC,QAAQ,KAAK;wBACpF,gGAAgG,CACnG,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,UAAU,IAAI,OAAO,MAAM,CAAC,YAAY,EAAE,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC1E,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY;iBAChC,OAA6C,CAAC;YAEjD,IACE,MAAM,CAAC,UAAU,CAAC,KAAK;gBACvB,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,EACtD,CAAC;gBACD,MAAM,IAAI,KAAK,CACb,qDAAqD,MAAM,CAAC,IAAI,KAAK;oBACnE,qFAAqF;oBACrF,+DAA+D,CAClE,CAAC;YACJ,CAAC;YAED,IACE,MAAM,CAAC,UAAU,CAAC,MAAM;gBACxB,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,EACvD,CAAC;gBACD,MAAM,IAAI,KAAK,CACb,8DAA8D,MAAM,CAAC,IAAI,KAAK;oBAC5E,qFAAqF;oBACrF,+DAA+D,CAClE,CAAC;YACJ,CAAC;YAED,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;gBAClD,MAAM,IAAI,KAAK,CACb,4DAA4D,MAAM,CAAC,IAAI,KAAK;oBAC1E,4EAA4E;oBAC5E,6DAA6D,CAChE,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;CACF","sourcesContent":["import { ArkosRouteConfig } from \"./types\";\nimport { isClass, isZodSchema } from \"../dynamic-loader\";\nimport { getArkosConfig } from \"../../exports\";\nimport { OpenAPIV3 } from \"openapi-types\";\n\nexport default class RouteConfigValidator {\n  static isArkosRouteConfig(arg: any): arg is ArkosRouteConfig {\n    return typeof arg === \"object\" && arg !== null && \"path\" in arg;\n  }\n\n  static validate(config: ArkosRouteConfig) {\n    const resolver = getArkosConfig()?.validation?.resolver;\n\n    if (config.validation) {\n      const validators = [\n        { key: \"query\", schema: config.validation?.query },\n        { key: \"body\", schema: config.validation?.body },\n        { key: \"params\", schema: config.validation?.params },\n      ];\n\n      for (const { key, schema } of validators) {\n        if (!schema) continue;\n\n        const isZod = isZodSchema(schema);\n        const isClassValidator = isClass(schema);\n\n        if (isZod && ![\"hybrid\", \"zod\"].includes(resolver as string)) {\n          throw new Error(\n            `Zod schema used in validation.${key} but validation.resolver is '${resolver}'. ` +\n              `Zod schemas are only supported when validation.resolver is 'zod' or 'hybrid'.`,\n          );\n        }\n\n        if (\n          isClassValidator &&\n          ![\"hybrid\", \"class-validator\"].includes(resolver as string)\n        ) {\n          throw new Error(\n            `Class validator used in validation.${key} but validation.resolver is '${resolver}'. ` +\n              `Class validators are only supported when validation.resolver is 'class-validator' or 'hybrid'.`,\n          );\n        }\n      }\n    }\n\n    if (config.validation && typeof config.experimental?.openapi === \"object\") {\n      const openapi = config.experimental\n        .openapi as Partial<OpenAPIV3.OperationObject>;\n\n      if (\n        config.validation.query &&\n        openapi.parameters?.some((p: any) => p.in === \"query\")\n      ) {\n        throw new Error(\n          `Duplicate query validation definitions for route \"${config.path}\". ` +\n            \"When using validation.query, do not define query parameters in openapi.parameters. \" +\n            \"They will be automatically migrated to OpenAPI specification.\",\n        );\n      }\n\n      if (\n        config.validation.params &&\n        openapi.parameters?.some((p: any) => p.in === \"params\")\n      ) {\n        throw new Error(\n          `Duplicate path parameter validation definitions for route \"${config.path}\". ` +\n            \"When using validation.params, do not define path parameters in openapi.parameters. \" +\n            \"They will be automatically migrated to OpenAPI specification.\",\n        );\n      }\n\n      if (config.validation.body && openapi.requestBody) {\n        throw new Error(\n          `Duplicate request body validation definitions for route \"${config.path}\". ` +\n            \"When using validation.body, do not define openapi.requestBody in openapi. \" +\n            \"It will be automatically migrated to OpenAPI specification.\",\n        );\n      }\n    }\n  }\n}\n\n"]}

package/dist/esm/utils/arkos-router/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/utils/arkos-router/types/index.ts"],"names":[],"mappings":"","sourcesContent":["import { IRoute, IRouter } from \"express\";\nimport { ZodSchema } from \"zod\";\nimport { Options as RateLimitOptions } from \"express-rate-limit\";\nimport { Options as QueryParserOptions } from \"../../../utils/helpers/query-parser.helpers\";\nimport { DetailedAccessControlRule } from \"../../../types/auth\";\nimport { ArkosErrorRequestHandler, ArkosRequestHandler } from \"../../../types\";\nimport compression from \"compression\";\nimport { OpenApiConfig } from \"./openapi-config\";\nimport { UploadConfig } from \"./upload-config\";\nimport { BodyParserConfig } from \"./body-parser-config\";\n\nexport type PathParams = string | RegExp | Array<string | RegExp>;\n\nexport type ArkosAnyRequestHandler =\n  | ArkosRequestHandler\n  | ArkosErrorRequestHandler\n  | Array<ArkosRequestHandler | ArkosErrorRequestHandler>;\n\n/**\n * Handler function for HTTP methods that accepts route configuration and request handlers.\n *\n * @param {ArkosRouteConfig} config - The route configuration object.\n * @param {...(ArkosRequestHandler | ArkosErrorRequestHandler)[]} handlers - Request and error handlers for the route.\n * @returns {IRouter} The Express router instance.\n */\ntype RouterMethodHandler<T> = (\n  config: ArkosRouteConfig | PathParams,\n  ...handlers: Array<ArkosAnyRequestHandler>\n) => T;\n\nexport type ArkosRouteMethodHandler<T> = (\n  config: ArkosAnyRequestHandler | Omit<ArkosRouteConfig, \"path\">,\n  ...handlers: Array<\n    | ArkosRequestHandler\n    | ArkosErrorRequestHandler\n    | Array<ArkosRequestHandler | ArkosErrorRequestHandler>\n  >\n) => T;\n\nexport interface ArkosIRoute extends IRoute {\n  /** GET method handler with route configuration support */\n  get: ArkosRouteMethodHandler<this>;\n  /** POST method handler with route configuration support */\n  post: ArkosRouteMethodHandler<this>;\n  /** PUT method handler with route configuration support */\n  put: ArkosRouteMethodHandler<this>;\n  /** PATCH method handler with route configuration support */\n  patch: ArkosRouteMethodHandler<this>;\n  /** DELETE method handler with route configuration support */\n  delete: ArkosRouteMethodHandler<this>;\n  /** OPTIONS method handler with route configuration support */\n  options: ArkosRouteMethodHandler<this>;\n  /** HEAD method handler with route configuration support */\n  head: ArkosRouteMethodHandler<this>;\n  // /** TRACE method handler with route configuration support */\n  trace: ArkosRouteMethodHandler<this>;\n  /** ALL methods handler with route configuration support */\n  all: ArkosRouteMethodHandler<this>;\n}\n\n/**\n * Creates an enhanced Express Router with features like OpenAPI documentation capabilities and smart data validation.\n *\n * The ArkosRouter extends the standard Express Router with the ability to\n * automatically capture OpenAPI metadata from route configurations.\n *\n * @example\n * const router = ArkosRouter();\n *\n * router.get(\n *   {\n *     path: \"/users/:id\",\n *     openapi: {\n *       summary: \"Get user by ID\",\n *       tags: [\"Users\"]\n *     }\n *   },\n *   (req, res) => { ... }\n * );\n *\n * @returns {IArkosRouter} A proxied Express Router instance with enhanced OpenAPI capabilities\n *\n * @see {@link ArkosRouteConfig} for configuration options\n */\nexport interface IArkosRouter extends IRouter {\n  /** GET method handler with route configuration support */\n  get: RouterMethodHandler<this>;\n  /** POST method handler with route configuration support */\n  post: RouterMethodHandler<this>;\n  /** PUT method handler with route configuration support */\n  put: RouterMethodHandler<this>;\n  /** PATCH method handler with route configuration support */\n  patch: RouterMethodHandler<this>;\n  /** DELETE method handler with route configuration support */\n  delete: RouterMethodHandler<this>;\n  /** OPTIONS method handler with route configuration support */\n  options: RouterMethodHandler<this>;\n  /** HEAD method handler with route configuration support */\n  head: RouterMethodHandler<this>;\n  // /** TRACE method handler with route configuration support */\n  trace: RouterMethodHandler<this>;\n  /** ALL methods handler with route configuration support */\n  all: RouterMethodHandler<this>;\n\n  route<T extends string>(prefix: T): ArkosIRoute;\n  route(prefix: PathParams): ArkosIRoute;\n}\n\n/**\n * Configuration object for defining routes in Arkos.js.\n */\nexport type ArkosRouteConfig = {\n  /**\n   * Disables the route by not mounting it internally.\n   */\n  disabled?: boolean;\n  /**\n   * The URL path pattern for the route.\n   *\n   * @example \"/api/users/:id\"\n   */\n  path: PathParams;\n  /**\n   * Authentication and authorization configuration.\n   *\n   * @remarks\n   * - Set to `true` to require authentication without specific permissions.\n   * - Set to `false` or omit to allow unauthenticated access.\n   * - Provide an object to specify resource-based access control with resource name, action, and optional custom rules.\n   */\n  authentication?:\n    | boolean\n    | {\n        resource: string;\n        action: string;\n        rule?: DetailedAccessControlRule | string[] | \"*\";\n      };\n  /**\n   * Request validation configuration using Zod schemas or class constructors.\n   *\n   * @remarks\n   * - Set to `false` to disable all validation.\n   * - Provide an object with `query`, `body`, and/or `params` properties to validate specific parts of the request.\n   * - Each property accepts a Zod schema, a class constructor, or `false` to disable validation for that part.\n   */\n  validation?:\n    | false\n    | {\n        query?: ZodSchema | (new (...args: any[]) => object) | false;\n        body?: ZodSchema | (new (...args: any[]) => object) | false;\n        params?: ZodSchema | (new (...args: any[]) => object) | false;\n      };\n\n  /**\n   * Rate limiting configuration for this route.\n   *\n   * @see {@link https://www.npmjs.com/package/express-rate-limit express-rate-limit} for available options.\n   */\n  rateLimit?: Partial<RateLimitOptions>;\n\n  /**\n   * Allows to define options for npm package compression.\n   * Nothing is passed by default.\n   *\n   * @see {@link https://www.npmjs.com/package/compression compression} for further details.\n   */\n  compression?: compression.CompressionOptions;\n  /**\n   * Options to define how query must be parsed.\n   *\n   * @example\n   * ```\n   * GET /api/product?saleId=null\n   * ```\n   *\n   * Normally would parsed to { saleId: \"null\" } so query parser\n   * trough setting option `parseNull` will transform { saleId: null }\n   *\n   * @default\n   * ```\n   * {\n   *   parseNull: true,\n   *   parseUndefined: true,\n   *   parseBoolean: true,\n   * }\n   * ```\n   *\n   * @remarks\n   * parseNumber may convert fields that are string but you only passed\n   * numbers to query pay attention to this.\n   *\n   * Soon a feature to converted the query to the end prisma type will be added.\n   */\n  queryParser?: QueryParserOptions;\n  /**\n   * Configuration for request body parsing.\n   *\n   * @property {(\"json\" | \"urlencoded\" | \"raw\" | \"text\")} parser - The type of body parser to use.\n   * @property {object} [options] - Parser-specific options passed to the corresponding Express body parser middleware.\n   *\n   * @remarks\n   * - When `parser` is `\"json\"`, options are passed to `express.json()`.\n   * - When `parser` is `\"urlencoded\"`, options are passed to `express.urlencoded()`.\n   * - When `parser` is `\"raw\"`, options are passed to `express.raw()`.\n   * - When `parser` is `\"text\"`, options are passed to `express.text()`.\n   * - Set to `false` to disable body parsing for this route.\n   *\n   * @see {@link https://expressjs.com/en/api.html#express.json Express body parser documentation}\n   */\n  bodyParser?: BodyParserConfig | BodyParserConfig[] | false;\n  /**\n   * Experimental features to be battled tested before being stable\n   *\n   * PS: These features may be changed without any previous warning.\n   */\n  experimental?: {\n    /**\n     * OpenAPI specification for this route.\n     *\n     * @remarks\n     * - Set to `false` to exclude this route from OpenAPI documentation.\n     * - Provide a partial OpenAPI operation object to document the route.\n     */\n    openapi?: false | OpenApiConfig;\n    /**\n     * Configuration for file upload handling in routes.\n     * Supports single file, multiple files from same field, or multiple fields with files.\n     */\n    uploads?: UploadConfig;\n  };\n};\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/utils/arkos-router/types/index.ts"],"names":[],"mappings":"","sourcesContent":["import {\n  Application,\n  IRoute,\n  IRouter,\n  IRouterHandler,\n  IRouterMatcher,\n  Locals,\n} from 'express';\nimport z, { ZodType } from 'zod';\nimport { Options as RateLimitOptions } from 'express-rate-limit';\nimport { Options as QueryParserOptions } from '../../../utils/helpers/query-parser.helpers';\nimport { DetailedAccessControlRule } from '../../../types/auth';\nimport {\n  ArkosAnyRequestHandler,\n  ArkosErrorRequestHandler,\n  ArkosRequestHandler,\n} from '../../../types';\nimport compression from 'compression';\nimport { OpenApiConfig } from './openapi-config';\nimport { UploadConfig } from './upload-config';\nimport { BodyParserConfig } from './body-parser-config';\nimport { ArkosRouterOptions } from '..';\nimport { Validator } from '../../../types/validation/validator';\nimport { ArkosLoadable } from '../../../exports';\n\nexport type ArkosUseConfig = Pick<\n  ArkosRouteConfig,\n  | 'authentication'\n  | 'rateLimit'\n  | 'compression'\n  | 'queryParser'\n  | 'bodyParser'\n  | 'disabled'\n> & {\n  path?: PathParams;\n};\n\nexport type InferValidationType<T, Fallback> = T extends ZodType\n  ? unknown extends z.infer<T>\n    ? Fallback\n    : z.infer<T>\n  : T extends new (...args: any[]) => infer I\n    ? unknown extends I\n      ? Fallback\n      : I\n    : Fallback;\n\nexport type PathParams = string | RegExp | Array<string | RegExp>;\n\nexport type InternalIArkosRouter = IArkosRouter & {\n  _arkos: {\n    options?: ArkosRouterOptions;\n    routes: Array<{\n      handler: ArkosAnyRequestHandler;\n      config: ArkosRouteConfig;\n      method: string;\n    }>;\n  };\n};\n\n/**\n * Handler function for HTTP methods that accepts route configuration and request handlers.\n *\n * @param {ArkosRouteConfig} config - The route configuration object.\n * @param {...(ArkosRequestHandler | ArkosErrorRequestHandler)[]} handlers - Request and error handlers for the route.\n * @returns {IRouter} The Express router instance.\n */\ntype IArkosRouterMethodHandler<T> = IRouterHandler<T> &\n  IRouterMatcher<T> & {\n    <\n      TQuery extends Validator = any,\n      TBody extends Validator = any,\n      TParams extends Validator = any,\n    >(\n      config: ArkosRouteConfig<TQuery, TBody, TParams>,\n      ...handlers: Array<\n        | ArkosRequestHandler<\n            InferValidationType<TParams, Record<string, string>>,\n            any,\n            InferValidationType<TBody, any>,\n            InferValidationType<TQuery, qs.ParsedQs>,\n            any\n          >\n        | Array<\n            ArkosRequestHandler<\n              InferValidationType<TParams, Record<string, string>>,\n              any,\n              InferValidationType<TBody, any>,\n              InferValidationType<TQuery, qs.ParsedQs>,\n              any\n            >\n          >\n      >\n    ): T;\n    <\n      TQuery extends Validator = any,\n      TBody extends Validator = any,\n      TParams extends Validator = any,\n    >(\n      config: ArkosRouteConfig<TQuery, TBody, TParams> | PathParams,\n      ...handlers: Array<\n        | ArkosAnyRequestHandler<\n            InferValidationType<TParams, Record<string, string>>,\n            any,\n            InferValidationType<TBody, any>,\n            InferValidationType<TQuery, qs.ParsedQs>,\n            any\n          >\n        | Array<\n            | ArkosAnyRequestHandler<\n                InferValidationType<TParams, Record<string, string>>,\n                any,\n                InferValidationType<TBody, any>,\n                InferValidationType<TQuery, qs.ParsedQs>,\n                any\n              >\n            | Array<\n                ArkosErrorRequestHandler<\n                  InferValidationType<TParams, Record<string, string>>,\n                  any,\n                  InferValidationType<TBody, any>,\n                  InferValidationType<TQuery, qs.ParsedQs>,\n                  any\n                >\n              >\n          >\n      >\n    ): T;\n\n    <\n      TQuery extends Validator = any,\n      TBody extends Validator = any,\n      TParams extends Validator = any,\n    >(\n      config: ArkosRouteConfig<TQuery, TBody, TParams>,\n      subApplication: Application,\n    ): T;\n  };\n\nexport type ArkosRouteMethodHandler<T> = {\n  <\n    TQuery extends Validator = any,\n    TBody extends Validator = any,\n    TParams extends Validator = any,\n  >(\n    config: ArkosAnyRequestHandler | Omit<ArkosRouteConfig, 'path'>,\n    ...handlers: Array<\n      ArkosAnyRequestHandler<\n        InferValidationType<TParams, Record<string, string>>,\n        any,\n        InferValidationType<TBody, any>,\n        InferValidationType<TQuery, qs.ParsedQs>,\n        Locals\n      >\n    >\n  ): T;\n  <\n    TQuery extends Validator = any,\n    TBody extends Validator = any,\n    TParams extends Validator = any,\n  >(\n    config: Omit<ArkosRouteConfig<TQuery, TBody, TParams>, 'path'>,\n    ...handlers: Array<\n      | ArkosAnyRequestHandler<\n          InferValidationType<TParams, Record<string, string>>,\n          any,\n          InferValidationType<TBody, any>,\n          InferValidationType<TQuery, qs.ParsedQs>,\n          Locals\n        >\n      | Array<\n          ArkosRequestHandler<\n            InferValidationType<TParams, Record<string, string>>,\n            any,\n            InferValidationType<TBody, any>,\n            InferValidationType<TQuery, qs.ParsedQs>,\n            Locals\n          >\n        >\n    >\n  ): T;\n  <\n    TQuery extends Validator = any,\n    TBody extends Validator = any,\n    TParams extends Validator = any,\n  >(\n    config: Omit<ArkosRouteConfig<TQuery, TBody, TParams>, 'path'>,\n    ...handlers: Array<\n      | ArkosAnyRequestHandler<\n          InferValidationType<TParams, Record<string, string>>,\n          any,\n          InferValidationType<TBody, any>,\n          InferValidationType<TQuery, qs.ParsedQs>,\n          Locals\n        >\n      | Array<\n          ArkosAnyRequestHandler<\n            InferValidationType<TParams, Record<string, string>>,\n            any,\n            InferValidationType<TBody, any>,\n            InferValidationType<TQuery, qs.ParsedQs>,\n            Locals\n          >\n        >\n    >\n  ): T;\n};\n\n/**\n * Handler function for `use` that accepts route configuration and middleware handlers.\n *\n * @param {ArkosUseConfig} config - The use configuration object or path.\n * @param {...ArkosAnyRequestHandler} handlers - Middleware handlers.\n * @returns {T} The router instance.\n */\n\nexport type UseMethodHandler<T> = IRouterHandler<T> &\n  IRouterMatcher<T> & {\n    (config: ArkosUseConfig, router: IArkosRouter | Application): T;\n    (\n      config: ArkosUseConfig,\n      ...handlers: Array<ArkosRequestHandler | Array<ArkosRequestHandler>>\n    ): T;\n    (\n      config: ArkosUseConfig,\n      ...handlers: Array<\n        ArkosErrorRequestHandler | Array<ArkosErrorRequestHandler>\n      >\n    ): T;\n    (\n      config: ArkosUseConfig,\n      ...handlers: Array<\n        | ArkosRequestHandler\n        | ArkosErrorRequestHandler\n        | Array<ArkosRequestHandler | ArkosErrorRequestHandler>\n      >\n    ): T;\n    (\n      ...handlers: Array<\n        | ArkosRequestHandler\n        | ArkosErrorRequestHandler\n        | Array<ArkosRequestHandler | ArkosErrorRequestHandler>\n      >\n    ): T;\n  };\n\nexport interface IArkosRoute extends IRoute {\n  /** GET method handler with route configuration support */\n  get: ArkosRouteMethodHandler<this>;\n  /** POST method handler with route configuration support */\n  post: ArkosRouteMethodHandler<this>;\n  /** PUT method handler with route configuration support */\n  put: ArkosRouteMethodHandler<this>;\n  /** PATCH method handler with route configuration support */\n  patch: ArkosRouteMethodHandler<this>;\n  /** DELETE method handler with route configuration support */\n  delete: ArkosRouteMethodHandler<this>;\n  /** OPTIONS method handler with route configuration support */\n  options: ArkosRouteMethodHandler<this>;\n  /** HEAD method handler with route configuration support */\n  head: ArkosRouteMethodHandler<this>;\n  // /** TRACE method handler with route configuration support */\n  trace: ArkosRouteMethodHandler<this>;\n  /** ALL methods handler with route configuration support */\n  all: ArkosRouteMethodHandler<this>;\n}\n\n/**\n * Creates an enhanced Express Router with features like OpenAPI documentation capabilities and smart data validation.\n *\n * The ArkosRouter extends the standard Express Router with the ability to\n * automatically capture OpenAPI metadata from route configurations.\n *\n * @example\n * const router = ArkosRouter();\n *\n * router.get(\n *   {\n *     path: \"/users/:id\",\n *     openapi: {\n *       summary: \"Get user by ID\",\n *       tags: [\"Users\"]\n *     }\n *   },\n *   (req, res) => { ... }\n * );\n *\n * @returns {IArkosRouter} A proxied Express Router instance with enhanced OpenAPI capabilities\n *\n * @see {@link ArkosRouteConfig} for configuration options\n */\nexport interface IArkosRouter extends IRouter {\n  /** GET method handler with route configuration support */\n  get: IArkosRouterMethodHandler<this>;\n  /** POST method handler with route configuration support */\n  post: IArkosRouterMethodHandler<this>;\n  /** PUT method handler with route configuration support */\n  put: IArkosRouterMethodHandler<this>;\n  /** PATCH method handler with route configuration support */\n  patch: IArkosRouterMethodHandler<this>;\n  /** DELETE method handler with route configuration support */\n  delete: IArkosRouterMethodHandler<this>;\n  /** OPTIONS method handler with route configuration support */\n  options: IArkosRouterMethodHandler<this>;\n  /** HEAD method handler with route configuration support */\n  head: IArkosRouterMethodHandler<this>;\n  // /** TRACE method handler with route configuration support */\n  trace: IArkosRouterMethodHandler<this>;\n  /** ALL methods handler with route configuration support */\n  all: IArkosRouterMethodHandler<this>;\n  use: UseMethodHandler<this>;\n  route<T extends string>(prefix: T): IArkosRoute;\n  route(prefix: PathParams): IArkosRoute;\n  /**\n   * Loads Arkos-specific instances into the app for internal usage.\n   * Unlike use(), load() has no order — it simply makes the loaded\n   * data available for Arkos to apply where needed.\n   */\n  load(...items: ArkosLoadable[]): this;\n  /**\n   * Loads Arkos-specific instances into the app for internal usage.\n   * Unlike use(), load() has no order — it simply makes the loaded\n   * data available for Arkos to apply where needed.\n   */\n  load(items: ArkosLoadable[] | ArkosLoadable): this;\n}\n\n/**\n * Configuration object for defining routes in Arkos.js.\n */\nexport type ArkosRouteConfig<\n  TQuery extends Validator = any,\n  TBody extends Validator = any,\n  TParams extends Validator = any,\n> = {\n  /**\n   * Disables the route by not mounting it internally.\n   */\n  disabled?: boolean;\n  /**\n   * The URL path pattern for the route.\n   *\n   * @example \"/api/users/:id\"\n   */\n  path: PathParams;\n  /**\n   * Authentication and authorization configuration.\n   *\n   * @remarks\n   * - Set to `true` to require authentication without specific permissions.\n   * - Set to `false` or omit to allow unauthenticated access.\n   * - Provide an object to specify resource-based access control with resource name, action, and optional custom rules.\n   */\n  authentication?:\n    | boolean\n    | {\n        resource: string;\n        action: string;\n        rule?: DetailedAccessControlRule | string[] | '*';\n      };\n  /**\n   * Request validation configuration using Zod schemas or class constructors.\n   *\n   * @remarks\n   * - Set to `false` to disable all validation.\n   * - Set to `null` to forbidden all request inputs.\n   * - Provide an object with `query`, `body`, and/or `params` properties to validate specific parts of the request.\n   * - Each property accepts a Zod schema, a class constructor, or `false` to disable validation for that part.\n   */\n  validation?:\n    | false\n    | null\n    | {\n        query?: TQuery;\n        body?: TBody;\n        params?: TParams;\n      };\n  /**\n   * Rate limiting configuration for this route.\n   *\n   * @see {@link https://www.npmjs.com/package/express-rate-limit express-rate-limit} for available options.\n   */\n  rateLimit?: Partial<RateLimitOptions>;\n\n  /**\n   * Allows to define options for npm package compression.\n   * Nothing is passed by default.\n   *\n   * @see {@link https://www.npmjs.com/package/compression compression} for further details.\n   */\n  compression?: compression.CompressionOptions;\n  /**\n   * Options to define how query must be parsed.\n   *\n   * @example\n   * ```\n   * GET /api/product?saleId=null\n   * ```\n   *\n   * Normally would parsed to { saleId: \"null\" } so query parser\n   * trough setting option `parseNull` will transform { saleId: null }\n   *\n   * @default\n   * ```\n   * {\n   *   parseNull: true,\n   *   parseUndefined: true,\n   *   parseBoolean: true,\n   * }\n   * ```\n   *\n   * @remarks\n   * parseNumber may convert fields that are string but you only passed\n   * numbers to query pay attention to this.\n   *\n   * Soon a feature to converted the query to the end prisma type will be added.\n   */\n  queryParser?: QueryParserOptions;\n  /**\n   * Configuration for request body parsing.\n   *\n   * @property {(\"json\" | \"urlencoded\" | \"raw\" | \"text\")} parser - The type of body parser to use.\n   * @property {object} [options] - Parser-specific options passed to the corresponding Express body parser middleware.\n   *\n   * @remarks\n   * - When `parser` is `\"json\"`, options are passed to `express.json()`.\n   * - When `parser` is `\"urlencoded\"`, options are passed to `express.urlencoded()`.\n   * - When `parser` is `\"raw\"`, options are passed to `express.raw()`.\n   * - When `parser` is `\"text\"`, options are passed to `express.text()`.\n   * - Set to `false` to disable body parsing for this route.\n   *\n   * @see {@link https://expressjs.com/en/api.html#express.json Express body parser documentation}\n   */\n  bodyParser?: BodyParserConfig | BodyParserConfig[] | false;\n  /**\n   * Experimental features to be battled tested before being stable\n   *\n   * PS: These features may be changed without any previous warning.\n   */\n  experimental?: {\n    /**\n     * OpenAPI specification for this route.\n     *\n     * @remarks\n     * - Set to `false` to exclude this route from OpenAPI documentation.\n     * - Provide a partial OpenAPI operation object to document the route.\n     */\n    openapi?: false | OpenApiConfig;\n    /**\n     * Configuration for file upload handling in routes.\n     * Supports single file, multiple files from same field, or multiple fields with files.\n     */\n    uploads?: UploadConfig;\n  };\n};\n\n"]}

package/dist/esm/utils/arkos-router/types/openapi-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"openapi-config.js","sourceRoot":"","sources":["../../../../../src/utils/arkos-router/types/openapi-config.ts"],"names":[],"mappings":"","sourcesContent":["import { OpenAPIV3 } from \"openapi-types\";\nimport { ZodSchema } from \"zod\";\n\n/**\n * Represents a schema-like object that can be used for OpenAPI documentation.\n * Accepts Zod schemas, class constructors (DTOs), or plain JSON Schema objects.\n */\ntype SchemaLike =\n  | ZodSchema\n  | (new (...args: any[]) => object)\n  | OpenAPIV3.SchemaObject;\n\n/**\n * Extended media type object that accepts SchemaLike in addition to standard OpenAPI schemas.\n */\ntype ExtendedMediaTypeObject = Omit<OpenAPIV3.MediaTypeObject, \"schema\"> & {\n  schema: SchemaLike;\n};\n\n/**\n * Represents a parameter object with support for Zod schemas, class constructors, or JSON Schema.\n * Extends OpenAPI's ParameterObject to accept SchemaLike types for the schema field.\n *\n * @example\n * // Using JSON Schema (standard OpenAPI)\n * {\n *   name: \"userId\",\n *   in: \"path\",\n *   required: true,\n *   schema: { type: \"string\", format: \"uuid\" }\n * }\n *\n * @example\n * // Using Zod schema\n * {\n *   name: \"limit\",\n *   in: \"query\",\n *   schema: z.number().int().min(1).max(100)\n * }\n *\n * @example\n * // Using class constructor (DTO)\n * {\n *   name: \"filter\",\n *   in: \"query\",\n *   schema: FilterDto\n * }\n */\nexport type ExtendedParameterObject = Omit<\n  OpenAPIV3.ParameterObject,\n  \"schema\"\n> & {\n  /**\n   * The schema defining the type used for the parameter.\n   * Can be a Zod schema, class constructor, or standard JSON Schema object.\n   */\n  schema?: SchemaLike;\n};\n\n/**\n * Shorthand response definition. Can be:\n * - A SchemaLike (assumes application/json content-type and default description)\n * - An object with `content` as SchemaLike and optional `description`\n * - A full OpenAPI response object with custom content-types\n *\n * @example\n * // Shorthand: Just the schema (assumes application/json + \"Success\" description)\n * 200: ProfileDto\n *\n * @example\n * // Medium: Schema with custom description\n * 404: {\n *   content: ErrorDto,\n *   description: \"User not found\"\n * }\n *\n * @example\n * // Full: Multiple content-types with custom configuration\n * 500: {\n *   content: {\n *     \"application/json\": { schema: ErrorDto },\n *     \"text/plain\": { schema: PlainErrorDto }\n *   },\n *   description: \"Internal server error\"\n * }\n */\ntype ResponseDefinition =\n  | SchemaLike\n  | {\n      content: SchemaLike;\n      description?: string;\n    }\n  | (Omit<OpenAPIV3.ResponseObject, \"content\"> & {\n      content?: {\n        [media: string]: ExtendedMediaTypeObject;\n      };\n    });\n\n/**\n * Shorthand request body definition. Can be:\n * - A SchemaLike (assumes application/json content-type)\n * - An object with `content` as SchemaLike and optional configuration\n * - A full OpenAPI request body object with custom content-types\n *\n * @example\n * // Shorthand: Just the schema (assumes application/json)\n * requestBody: CreateUserDto\n *\n * @example\n * // Medium: Schema with configuration\n * requestBody: {\n *   content: CreateUserDto,\n *   required: true,\n *   description: \"User creation payload\"\n * }\n *\n * @example\n * // Full: Multiple content-types\n * requestBody: {\n *   content: {\n *     \"application/json\": { schema: CreateUserDto },\n *     \"multipart/form-data\": { schema: CreateUserFormDto }\n *   },\n *   required: true\n * }\n */\ntype RequestBodyDefinition =\n  | SchemaLike\n  | {\n      content: SchemaLike;\n      required?: boolean;\n      description?: string;\n    }\n  | (Omit<OpenAPIV3.RequestBodyObject, \"content\"> & {\n      content: {\n        [media: string]: ExtendedMediaTypeObject;\n      };\n    });\n\n/**\n * Extended OpenAPI Operation object with enhanced requestBody and responses.\n *\n * NOTE: If you define validation in the `validation` field, DO NOT redefine\n * the same schemas here. The framework will automatically generate OpenAPI docs\n * from your validation schemas. This field is only for:\n * - Endpoints that don't use validation (docs-only)\n * - Additional metadata (summary, description, tags, etc.)\n *\n * Defining both validation and openapi schemas for the same field will cause\n * a startup error to prevent documentation drift.\n */\ntype ExtendedOperationObject = Omit<\n  OpenAPIV3.OperationObject,\n  \"responses\" | \"requestBody\"\n> & {\n  /**\n   * Response definitions keyed by HTTP status code.\n   * Supports shorthand, medium, and full OpenAPI formats.\n   */\n  responses?: {\n    [statusCode: number]: ResponseDefinition;\n  };\n\n  /**\n   * Request body definition.\n   * Supports shorthand, medium, and full OpenAPI formats.\n   *\n   * WARNING: Do not define this if you're using `validation.body` -\n   * it will be auto-generated from your validation schema.\n   */\n  requestBody?: RequestBodyDefinition;\n  /**\n   * Array of parameter definitions for path, query, header, and cookie parameters.\n   * Each parameter's schema can be a Zod schema, class constructor, or JSON Schema.\n   *\n   * WARNING: Do NOT define parameters here if you're using `validation.query`,\n   * `validation.params`, `validation.headers`, or `validation.cookies`.\n   * Those validation schemas will automatically generate parameter documentation.\n   * Defining both will cause a startup error.\n   *\n   * Only use this field for:\n   * - Documentation-only endpoints (no validation)\n   * - Routes where you explicitly don't want validation\n   *\n   * Note: In practice, documenting parameters without validation is rare.\n   * Most APIs validate their inputs, so you'll typically use the `validation` field instead.\n   *\n   * @example\n   * // Standard JSON Schema (most common for parameters)\n   * parameters: [\n   *   {\n   *     name: \"userId\",\n   *     in: \"path\",\n   *     required: true,\n   *     schema: { type: \"string\", format: \"uuid\" }\n   *   },\n   *   {\n   *     name: \"limit\",\n   *     in: \"query\",\n   *     schema: { type: \"integer\", minimum: 1, maximum: 100 }\n   *   }\n   * ]\n   *\n   * @example\n   * // Using Zod (less common for parameters, but supported)\n   * parameters: [\n   *   {\n   *     name: \"page\",\n   *     in: \"query\",\n   *     schema: z.number().int().positive()\n   *   }\n   * ]\n   */\n  parameters?: (ExtendedParameterObject | OpenAPIV3.ReferenceObject)[];\n};\n\n/**\n * OpenAPI configuration for a route.\n * Set to `false` to exclude this route from OpenAPI documentation.\n * Otherwise, provide operation metadata and schema definitions.\n *\n * @example\n * // Exclude from docs\n * openapi: false\n *\n * @example\n * // Simple documentation with shorthand\n * openapi: {\n *   summary: \"Get user profile\",\n *   responses: {\n *     200: ProfileDto,\n *     404: ErrorDto\n *   }\n * }\n *\n * @example\n * // Complex documentation with multiple content-types\n * openapi: {\n *   summary: \"Upload file\",\n *   requestBody: {\n *     content: {\n *       \"multipart/form-data\": { schema: FileUploadDto }\n *     },\n *     required: true\n *   },\n *   responses: {\n *     200: {\n *       content: {\n *         \"application/json\": { schema: UploadResultDto }\n *       },\n *       description: \"File uploaded successfully\"\n *     }\n *   }\n * }\n */\nexport type OpenApiConfig = false | Partial<ExtendedOperationObject>;\n"]}
+{"version":3,"file":"openapi-config.js","sourceRoot":"","sources":["../../../../../src/utils/arkos-router/types/openapi-config.ts"],"names":[],"mappings":"","sourcesContent":["import { OpenAPIV3 } from \"openapi-types\";\nimport { ZodSchema } from \"zod\";\nimport { JsonSchema } from \"../../prisma/types\";\n\n/**\n * Represents a schema-like object that can be used for OpenAPI documentation.\n * Accepts Zod schemas, class constructors (DTOs), or plain JSON Schema objects.\n */\ntype SchemaLike =\n  | ZodSchema\n  | (new (...args: any[]) => object)\n  | OpenAPIV3.SchemaObject\n  | JsonSchema;\n\n/**\n * Extended media type object that accepts SchemaLike in addition to standard OpenAPI schemas.\n */\ntype ExtendedMediaTypeObject = Omit<OpenAPIV3.MediaTypeObject, \"schema\"> & {\n  schema: SchemaLike;\n};\n\n/**\n * Represents a parameter object with support for Zod schemas, class constructors, or JSON Schema.\n * Extends OpenAPI's ParameterObject to accept SchemaLike types for the schema field.\n *\n * @example\n * // Using JSON Schema (standard OpenAPI)\n * {\n *   name: \"userId\",\n *   in: \"path\",\n *   required: true,\n *   schema: { type: \"string\", format: \"uuid\" }\n * }\n *\n * @example\n * // Using Zod schema\n * {\n *   name: \"limit\",\n *   in: \"query\",\n *   schema: z.number().int().min(1).max(100)\n * }\n *\n * @example\n * // Using class constructor (DTO)\n * {\n *   name: \"filter\",\n *   in: \"query\",\n *   schema: FilterDto\n * }\n */\nexport type ExtendedParameterObject = Omit<\n  OpenAPIV3.ParameterObject,\n  \"schema\"\n> & {\n  /**\n   * The schema defining the type used for the parameter.\n   * Can be a Zod schema, class constructor, or standard JSON Schema object.\n   */\n  schema?: SchemaLike;\n};\n\n/**\n * Shorthand response definition. Can be:\n * - A SchemaLike (assumes application/json content-type and default description)\n * - An object with `content` as SchemaLike and optional `description`\n * - A full OpenAPI response object with custom content-types\n *\n * @example\n * // Shorthand: Just the schema (assumes application/json + \"Success\" description)\n * 200: ProfileDto\n *\n * @example\n * // Medium: Schema with custom description\n * 404: {\n *   content: ErrorDto,\n *   description: \"User not found\"\n * }\n *\n * @example\n * // Full: Multiple content-types with custom configuration\n * 500: {\n *   content: {\n *     \"application/json\": { schema: ErrorDto },\n *     \"text/plain\": { schema: PlainErrorDto }\n *   },\n *   description: \"Internal server error\"\n * }\n */\ntype ResponseDefinition =\n  | SchemaLike\n  | {\n      content: SchemaLike;\n      description?: string;\n    }\n  | (Omit<OpenAPIV3.ResponseObject, \"content\"> & {\n      content?: {\n        [media: string]: ExtendedMediaTypeObject;\n      };\n    });\n\n/**\n * Shorthand request body definition. Can be:\n * - A SchemaLike (assumes application/json content-type)\n * - An object with `content` as SchemaLike and optional configuration\n * - A full OpenAPI request body object with custom content-types\n *\n * @example\n * // Shorthand: Just the schema (assumes application/json)\n * requestBody: CreateUserDto\n *\n * @example\n * // Medium: Schema with configuration\n * requestBody: {\n *   content: CreateUserDto,\n *   required: true,\n *   description: \"User creation payload\"\n * }\n *\n * @example\n * // Full: Multiple content-types\n * requestBody: {\n *   content: {\n *     \"application/json\": { schema: CreateUserDto },\n *     \"multipart/form-data\": { schema: CreateUserFormDto }\n *   },\n *   required: true\n * }\n */\ntype RequestBodyDefinition =\n  | SchemaLike\n  | {\n      content: SchemaLike;\n      required?: boolean;\n      description?: string;\n    }\n  | (Omit<OpenAPIV3.RequestBodyObject, \"content\"> & {\n      content: {\n        [media: string]: ExtendedMediaTypeObject;\n      };\n    });\n\n/**\n * Extended OpenAPI Operation object with enhanced requestBody and responses.\n *\n * NOTE: If you define validation in the `validation` field, DO NOT redefine\n * the same schemas here. The framework will automatically generate OpenAPI docs\n * from your validation schemas. This field is only for:\n * - Endpoints that don't use validation (docs-only)\n * - Additional metadata (summary, description, tags, etc.)\n *\n * Defining both validation and openapi schemas for the same field will cause\n * a startup error to prevent documentation drift.\n */\nexport type ExtendedOperationObject = Omit<\n  OpenAPIV3.OperationObject,\n  \"responses\" | \"requestBody\"\n> & {\n  /**\n   * Response definitions keyed by HTTP status code.\n   * Supports shorthand, medium, and full OpenAPI formats.\n   */\n  responses?: {\n    [statusCode: number]: ResponseDefinition;\n  };\n\n  /**\n   * Request body definition.\n   * Supports shorthand, medium, and full OpenAPI formats.\n   *\n   * WARNING: Do not define this if you're using `validation.body` -\n   * it will be auto-generated from your validation schema.\n   */\n  requestBody?: RequestBodyDefinition;\n  /**\n   * Array of parameter definitions for path, query, header, and cookie parameters.\n   * Each parameter's schema can be a Zod schema, class constructor, or JSON Schema.\n   *\n   * WARNING: Do NOT define parameters here if you're using `validation.query`,\n   * `validation.params`, `validation.headers`, or `validation.cookies`.\n   * Those validation schemas will automatically generate parameter documentation.\n   * Defining both will cause a startup error.\n   *\n   * Only use this field for:\n   * - Documentation-only endpoints (no validation)\n   * - Routes where you explicitly don't want validation\n   *\n   * Note: In practice, documenting parameters without validation is rare.\n   * Most APIs validate their inputs, so you'll typically use the `validation` field instead.\n   *\n   * @example\n   * // Standard JSON Schema (most common for parameters)\n   * parameters: [\n   *   {\n   *     name: \"userId\",\n   *     in: \"path\",\n   *     required: true,\n   *     schema: { type: \"string\", format: \"uuid\" }\n   *   },\n   *   {\n   *     name: \"limit\",\n   *     in: \"query\",\n   *     schema: { type: \"integer\", minimum: 1, maximum: 100 }\n   *   }\n   * ]\n   *\n   * @example\n   * // Using Zod (less common for parameters, but supported)\n   * parameters: [\n   *   {\n   *     name: \"page\",\n   *     in: \"query\",\n   *     schema: z.number().int().positive()\n   *   }\n   * ]\n   */\n  parameters?: (ExtendedParameterObject | OpenAPIV3.ReferenceObject)[];\n};\n\n/**\n * OpenAPI configuration for a route.\n * Set to `false` to exclude this route from OpenAPI documentation.\n * Otherwise, provide operation metadata and schema definitions.\n *\n * @example\n * // Exclude from docs\n * openapi: false\n *\n * @example\n * // Simple documentation with shorthand\n * openapi: {\n *   summary: \"Get user profile\",\n *   responses: {\n *     200: ProfileDto,\n *     404: ErrorDto\n *   }\n * }\n *\n * @example\n * // Complex documentation with multiple content-types\n * openapi: {\n *   summary: \"Upload file\",\n *   requestBody: {\n *     content: {\n *       \"multipart/form-data\": { schema: FileUploadDto }\n *     },\n *     required: true\n *   },\n *   responses: {\n *     200: {\n *       content: {\n *         \"application/json\": { schema: UploadResultDto }\n *       },\n *       description: \"File uploaded successfully\"\n *     }\n *   }\n * }\n */\nexport type OpenApiConfig = false | Partial<ExtendedOperationObject>;\n"]}