arkos 2.0.0-next.16 → 2.0.0-next.18

package/dist/cjs/types/new-arkos-config.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"new-arkos-config.js","sourceRoot":"","sources":["../../../src/types/new-arkos-config.ts"],"names":[],"mappings":"","sourcesContent":["import cors from \"cors\";\nimport express, { CookieOptions } from \"express\";\nimport { Options as RateLimitOptions } from \"express-rate-limit\";\nimport cookieParser from \"cookie-parser\";\nimport compression from \"compression\";\nimport { Options as QueryParserOptions } from \"../utils/helpers/query-parser.helpers\";\nimport { ValidatorOptions } from \"class-validator\";\nimport { MsDuration } from \"../modules/auth/utils/helpers/auth.controller.helpers\";\nimport { OpenAPIV3 } from \"openapi-types\";\nimport type { ApiReferenceConfiguration } from \"@scalar/express-api-reference\" with { \"resolution-mode\": \"import\" };\nimport nodemailer from \"nodemailer\";\nimport { ArkosRequestHandler } from \".\";\nimport { PrismaClient } from \"../generated\";\nimport {\n  AuthenticateHookHandler,\n  AuthenticateAfterHookHandler,\n  AuthenticateErrorHookHandler,\n  AuthorizeHookHandler,\n  AuthorizeAfterHookHandler,\n  AuthorizeErrorHookHandler,\n} from \"./arkos-config/utils\";\n\n/**\n * Defines the initial configs of the api to be loaded at startup when arkos.init() is called.\n */\nexport type ArkosConfig = {\n  /**\n   * Configuration for resolving your Arkos application's source files at runtime.\n   *\n   * @since 1.6.1-canary.2\n   *\n   */\n  source?: {\n    /**\n     * The entry point file of your Arkos application, resolved at runtime.\n     *\n     * This should point to the file where `app.listen()` or `app.listen(server)`\n     * is called to start the HTTP server.\n     *\n     * Supports both TypeScript and JavaScript projects.\n     *\n     * @type {string}\n     *\n     * @default \"src/app.ts\" (TypeScript) | \"src/app.js\" (JavaScript)\n     *\n     * @since 1.6.1-canary.2\n     *\n     * @example\n     * ```ts\n     * // TypeScript project\n     * entryPoint: \"src/app.ts\"\n     *\n     * // JavaScript project\n     * entryPoint: \"src/app.js\"\n     *\n     * // Custom path\n     * entryPoint: \"src/server/main.ts\"\n     * ```\n     */\n    entryPoint?: string;\n  };\n  /**\n   * The global prefixer for the whole application\n   *\n   * @default \"/api\"\n   */\n  readonly globalPrefix?: string;\n  /**\n   * Allows to configure request configs\n   */\n  request?: {\n    /**\n     * Allows to configure request parameters\n     */\n    parameters?: {\n      /**\n       * Toggles allowing `VERY DANGEROUS` request paramateres under `req.query` for passing prisma query options.\n       *\n       * See more\n       */\n      allowDangerousPrismaQueryOptions?: boolean;\n    };\n  };\n  /** Message you would like to send, as Json and 200 response when\n   * ```curl\n   * GET /api\n   * ```\n   *\n   * ```json\n   * { \"message\": \"Welcome to YourAppName\" }\n   * ```\n   *\n   * default message is: Welcome to our Rest API generated by Arkos, find more about Arkos at www.arkosjs.com.\n   *\n   *\n   *  */\n  welcomeMessage?: string;\n  /**\n   * Port where the application will run, can be set in 3 ways:\n   *\n   * 1. default is 8000\n   * 2. PORT under environment variables (Lower precedence)\n   * 3. this config option (Higher precedence)\n   */\n  port?: number | undefined;\n  /**\n   * Allows to listen on a different host than localhost only\n   */\n  host?: string;\n  /**\n   * Defines authentication related configurations, by default is undefined.\n   *\n   * See [www.arkosjs.com/docs/core-concepts/authentication/setup](https://www.arkosjs.com/docs/core-concepts/authentication/setup) for details.\n   */\n  authentication?: {\n    /**\n     * Lifecycle hooks for the built-in authentication and authorization pipeline.\n     *\n     * These hooks only apply to **auto-generated Arkos routes**. On custom routes using\n     * `authService.authenticate` directly, chain them manually as standard middlewares.\n     *\n     * Hooks run as standard Express middlewares — call `next()` to continue or\n     * `next(error)` to abort and forward to the global error handler.\n     *\n     * @see {@link https://www.arkosjs.com/docs/core-concepts/authentication/hooks}\n     */\n    hooks?: {\n      authenticate?: {\n        /**\n         * Runs before JWT extraction and verification.\n         *\n         * @example\n         * ```ts\n         * before: ({ req, skip, action, resource, rule }) => {\n         *   req.authContext = { startedAt: Date.now() };\n         * }\n         * ```\n         *\n         * @example Skip core logic entirely (e.g. custom auth)\n         * ```ts\n         * before: ({ req, skip, action, resource, rule }) => {\n         *   req.user = myCustomAuth(req);\n         *   skip();\n         * }\n         * ```\n         */\n        before?: AuthenticateHookHandler | AuthenticateHookHandler[];\n\n        /**\n         * Runs after `req.user` has been set.\n         *\n         * @example\n         * ```ts\n         * after: ({ req }) => {\n         *   if (!req.user.hasChangedPassword) {\n         *     throw new AppError(\"Password change required.\", 403, \"PasswordChangeRequired\");\n         *   }\n         * }\n         * ```\n         */\n        after?: AuthenticateAfterHookHandler | AuthenticateAfterHookHandler[];\n\n        /**\n         * Runs when authentication throws — invalid token, expired token, user not found, etc.\n         * Throw to forward to the global error handler, or call `skip()` to suppress and jump to `after` hooks.\n         *\n         * @example\n         * ```ts\n         * onError: ({ req, error, skip, action, resource, rule }) => {\n         *   console.warn(`Auth failed:`, error);\n         *   throw error;\n         * }\n         * ```\n         *\n         * @example Suppress error and continue\n         * ```ts\n         * onError: ({ req, skip, action, resource, rule }) => {\n         *   req.user = guestUser;\n         *   skip();\n         * }\n         * ```\n         */\n        onError?: AuthenticateErrorHookHandler | AuthenticateErrorHookHandler[];\n      };\n\n      authorize?: {\n        /**\n         * Runs before the role/permission check.\n         *\n         * @example\n         * ```ts\n         * before: ({ req }) => {\n         *   if (req.headers[\"x-elevated-access\"] === process.env.ELEVATION_KEY) {\n         *     req.user.role = \"admin\";\n         *   }\n         * }\n         * ```\n         *\n         * @example Skip permission check entirely\n         * ```ts\n         * before: ({ req, skip, action, resource, rule }) => {\n         *   req.user.role = myCustomRoleResolver(req);\n         *   skip();\n         * }\n         * ```\n         */\n        before?: AuthorizeHookHandler | AuthorizeHookHandler[];\n\n        /**\n         * Runs after the permission check passes.\n         *\n         * @example\n         * ```ts\n         * after: ({ req }) => {\n         *   auditLog.record({ userId: req.user.id, path: req.path });\n         * }\n         * ```\n         */\n        after?: AuthorizeAfterHookHandler | AuthorizeAfterHookHandler[];\n\n        /**\n         * Runs when the user lacks sufficient permissions (403).\n         * Throw to forward to the global error handler, or call `skip()` to suppress and jump to `after` hooks.\n         *\n         * @example\n         * ```ts\n         * onError: ({ req, error, action, resource, rule }) => {\n         *   auditLog.record({ userId: req.user?.id, reason: \"insufficient_permissions\" });\n         *   throw error;\n         * }\n         * ```\n         *\n         * @example Suppress error and continue\n         * ```ts\n         * onError: ({ req, skip, action, resource, rule }) => {\n         *   req.user.role = \"guest\";\n         *   skip();\n         * }\n         * ```\n         */\n        onError?: AuthorizeErrorHookHandler | AuthorizeErrorHookHandler[];\n      };\n    };\n    enabled?: boolean;\n    /**\n     * Defines whether to use Static or Dynamic Role-Based Acess Control\n     *\n     * Visit [www.arkosjs.com/docs/core-concepts/authentication/setup](https://www.arkosjs.com/docs/core-concepts/authentication/setup) for more details.\n     */\n    mode: \"static\" | \"dynamic\";\n    /**\n     * Defines auth login related configurations to customize the api.\n     */\n    login?: {\n      /**\n       * Defines the field that will be used as username by the built-in auth system, by default arkos will look for the field \"username\" in your model User, hence when making login for example you must send:\n       *\n       * ```json\n       *  {\n       *    \"username\": \"johndoe\",\n       *    \"password\": \"somePassword123\"\n       *  }\n       * ```\n       *\n       * **Note:** You can also modify the usernameField on the fly by passing it to the request query parameters. example:\n       *\n       * ```curl\n       * POST /api/auth/login?usernameField=email\n       * ```\n       *\n       * See more at [www.arkosjs.com/docs/core-concepts/authentication/setup#login-with-different-fileds](https://www.arkosjs.com/docs/core-concepts/authentication/setup#login-with-different-fileds)\n       *\n       * By specifing here another field for username, for example passing \"email\", \"companyCode\" or something else your json will be like:\n       *\n       * **Example with email**\n       *\n       * ```json\n       *  {\n       *    \"email\": \"john.doe@example.com\",\n       *    \"password\": \"somePassword123\"\n       *  }\n       * ```\n       */\n      allowedUsernames?: string[];\n      /** Defines wether to send the access token in response after login or only send as cookie, defeault is both.*/\n      sendAccessTokenThrough?: \"cookie-only\" | \"response-only\" | \"both\";\n    };\n    /**\n     * Specifies the regex pattern used by the authentication system to enforce password strength requirements.\n     *\n     * **Important**: If using validation libraries like Zod or class-validator, this will be completely overwritten.\n     *\n     * **Default**: ```/^(?=.*[A-Z])(?=.*[a-z])(?=.*\\d).+$/``` - Ensures the password contains at least one uppercase letter, one lowercase letter, and one numeric digit.\n     *\n     * **message**: (Optional) A custom error message to display when the password does not meet the required strength criteria.\n     * @deprecated will stop working on v2.0\n     */\n    passwordValidation?: { regex: RegExp; message?: string };\n    /**\n     * Allows to specify the request rate limit for all authentication endpoints but `/api/users/me`.\n     * \n     * #### Default\n     *{\n        windowMs: 5000,\n        limit: 10,\n        standardHeaders: \"draft-7\",\n        legacyHeaders: false,\n      }\n     * \n     * Passing an object not overriding all the default options will only\n     * cause it to be deepmerged and not actually replace with empty fields\n     * \n     *@see This is are the options used on the `express-rate-limit` npm package used on epxress. read more about [https://www.npmjs.com/package/express-rate-limit](https://www.npmjs.com/package/express-rate-limit)\n     */\n    rateLimit?: Partial<RateLimitOptions>;\n    /**\n     * JWT (JSON Web Token) authentication configuration.\n     *\n     * You can override these values directly in code, or use environment variables:\n     *\n     * - `JWT_SECRET`: Secret used to sign and verify JWT tokens.\n     * - `JWT_EXPIRES_IN`: Duration string or number indicating when the token should expire (e.g. \"30d\", 3600).\n     * - `JWT_COOKIE_SECURE`: Whether the cookie is sent only over HTTPS. Default: `true` in production.\n     * - `JWT_COOKIE_HTTP_ONLY`: Whether the cookie is HTTP-only. Default: `true`.\n     * - `JWT_COOKIE_SAME_SITE`: Can be \"lax\", \"strict\", or \"none\". Defaults to \"lax\" in dev, \"none\" in prod.\n     *\n     *@see Values passed here take precedence over environment variables.\n     */\n    jwt?: {\n      /** Secret key used for signing and verifying JWT tokens */\n      secret?: string;\n      /**\n       * Duration after which the JWT token expires.\n       * Accepts either a duration string (e.g. \"30d\", \"1h\") or a number in milliseconds.\n       * Defaults to \"30d\" if not provided.\n       */\n      expiresIn?: MsDuration | number;\n      /**\n       * Configuration for the JWT cookie sent to the client\n       */\n      cookie?: {\n        /**\n         * Whether the cookie should be marked as secure (sent only over HTTPS).\n         * Defaults to `true` in production and `false` in development.\n         *\n         * @env `JWT_COOKIE_SECURE`\n         */\n        secure?: boolean;\n        /**\n         * Whether the cookie should be marked as HTTP-only.\n         * Default is `true` to prevent access via JavaScript.\n         *\n         * @env `JWT_COOKIE_HTTP_ONLY`\n         */\n        httpOnly?: boolean;\n        /**\n         * Controls the SameSite attribute of the cookie.\n         * Defaults to \"none\" in production and \"lax\" in development.\n         * Options: \"lax\" | \"strict\" | \"none\"\n         *\n         * @env `JWT_COOKIE_SAME_SITE`\n         */\n        sameSite?: \"lax\" | \"strict\" | \"none\";\n        /**\n         * Expiry date of the cookie in GMT. If not specified (undefined), creates a session cookie.\n         *\n         * @default `now() + authentication.jwt.expireIn | JWT_EXPIRES_IN`\n         *\n         * @since 1.5.11-beta\n         */\n        expires?: Date | undefined;\n        /**\n         * Domain for the cookie. Use a leading dot (e.g. `.example.com`) to include all subdomains.\n         *\n         * @env `JWT_COOKIE_DOMAIN`\n         *\n         * @since 1.5.11-beta\n         */\n        domain?: string | undefined;\n      } & Omit<\n        CookieOptions,\n        \"secure\" | \"httpOnly\" | \"sameSite\" | \"expires\" | \"domain\"\n      >;\n    };\n  };\n  /** Allows to customize and toggle the built-in validation, by default it is set to `false`. If true is passed it will use validation with the default resolver set to `class-validator` if you intend to change the resolver to `zod` do the following:\n   *\n   *```ts\n   * // src/app.ts\n   * import arkos from 'arkos'\n   *\n   * arkos.init({\n   *    validation: {\n   *        resolver: \"zod\"\n   *    }\n   * })\n   * ```\n   *\n   * @See [www.arkosjs.com/docs/guides/validation/setup](https://www.arkosjs.com/docs/guides/validation/setup) for more details.\n   */\n  validation?: {\n    /**\n     * Defines whether to use strict request validation, it means in every request using `ArkosRouter()` you must pass the validation options with all options (e.g: query, params, body, etc.).\n     *\n     * **How It Works:**\n     * - If it is true, Arkos will require all the options a stated above on the routes and if you don't pass it will throw an error.\n     * **What if you don't want to pass a validator to some options?**\n     * - You will need to pass `undefined` to the validator option (see example below), this way Arkos will throw an error if something is passed to `req.query` if you passed undefined as validator into `validation.query`\n     *\n     * ```ts\n     * import { ArkosRouter } from \"arkos\"\n     *\n     * const router = ArkosRouter()\n     *\n     * router.get({\n     *  route: \"/api/posts\",\n     *  validation: {\n     *    query: undefined\n     *  }\n     * })\n     *\n     * ```\n     *\n     * @since 1.4.0-beta\n     */\n    strict?: boolean;\n  } & (\n    | {\n        resolver: \"class-validator\";\n        /**\n         * ValidatorOptions to used while validating request data.\n         *\n         * **Default**:\n         * ```ts\n         * {\n         *  whitelist: true\n         *  forbidNonWhitelisted: true\n         * }\n         * ```\n         */\n        validationOptions?: ValidatorOptions;\n      }\n    | {\n        resolver: \"zod\";\n        /**\n         * @since v1.5.0-beta\n         */\n        validationOptions?: {\n          /**\n           * Throws an error for know whitelisted fields\n           *\n           * @default true\n           */\n          forbidNonWhitelisted?: boolean;\n        };\n      }\n  );\n  /**\n   * Defines file upload configurations\n   *\n   * See {@link https://www.arkosjs.com/docs/guides/file-handling/file-uploads/setup}\n   */\n  fileUpload?: {\n    /**\n     * Disables built-in file upload\n     *\n     * @since 1.5.11-beta\n     */\n    enabled?: boolean;\n    /**\n     * Defiens the base file upload directory, default is set to /uploads (on root directory)\n     *\n     * When setting up a path dir always now that root directory will be the starting reference.\n     *\n     * #### Example\n     * passing `../my-arkos-uploaded-files`\n     *\n     * Will save uploaded files one level outside the root dir inside `my-arkos-uploaded-files`\n     *\n     * NB: You must be aware of permissions on your server to acess files outside your project directory.\n     *\n     */\n    baseUploadDir?: string;\n    /**\n     * Changes the default `/api/uploads` base route for accessing file upload route.\n     *\n     * #### IMPORTANT\n     * Changing this will not affect the `baseUploadDir` folder. You can\n     * pass here `/api/files/my-user-files` and `baseUploadDir` be `/uploaded-files`.\n     *\n     */\n    baseRoute?: string;\n    /**\n     * Defines options for `express.static(somePath, someOptions)`\n     *\n     * #### Default:\n     *\n     * ```ts\n     *{\n          maxAge: \"1y\",\n          etag: true,\n          lastModified: true,\n          dotfiles: \"ignore\",\n          fallthrough: true,\n          index: false,\n          cacheControl: true,\n        }\n     * ```\n     * \n     * By passing your custom options have in mind that it\n     * will be deepmerged with the default.\n     * \n     * Visit [https://expressjs.com/en/4x/api.html#express.static](https://expressjs.com/en/4x/api.html#express.static) for more understanding.\n     * \n     */\n    expressStatic?: Parameters<typeof express.static>[1];\n    /**\n     * Defines upload restrictions for each file type: image, video, document or other.\n     *\n     * #### Important:\n     * Passing an object without overriding everything will only cause it\n     * to be deepmerged with the default options.\n     *\n     * See [www.arkosjs.com/docs/reference/default-supported-upload-files](https://www.arkosjs.com/docs/reference/default-supported-upload-files) for detailed explanation about default values.\n     * ```\n     */\n    restrictions?: {\n      images?: {\n        maxCount?: number;\n        maxSize?: number;\n        supportedFilesRegex?: RegExp;\n      };\n      videos?: {\n        maxCount?: number;\n        maxSize?: number;\n        supportedFilesRegex?: RegExp;\n      };\n      documents?: {\n        maxCount?: number;\n        maxSize?: number;\n        supportedFilesRegex?: RegExp;\n      };\n      files?: {\n        maxCount?: number;\n        maxSize?: number;\n        supportedFilesRegex?: RegExp;\n      };\n    };\n  };\n  /**\n   * Defines express middlewares configurations\n   */\n  middlewares?: {\n    /**\n     * Allows to define options for npm package compression\n     * Nothing is passed by default.\n     *\n     * See [www.npmjs.com/package/compression](https://www.npmjs.com/package/compression) for further details.\n     */\n    compression?: false | compression.CompressionOptions | ArkosRequestHandler;\n    /**\n   * Allows to specify the request rate limit for all endpoints.\n   * \n   * #### Default\n   *```ts\n   *{\n      windowMs: 60 * 1000,\n      limit: 1000,\n      standardHeaders: \"draft-7\",\n      legacyHeaders: false,\n    }\n    ```\n   * \n   * Passing an object not overriding all the default options will only\n   * cause it to be deepmerged and not actually replace with empty fields\n   * \n   * This is are the options used on the `express-rate-limit` npm package used on epxress. read more about [https://www.npmjs.com/package/express-rate-limit](https://www.npmjs.com/package/express-rate-limit)\n   */\n    rateLimit?: false | Partial<RateLimitOptions> | ArkosRequestHandler;\n    /**\n     * Configuration for CORS (Cross-Origin Resource Sharing).\n     *\n     * Accepts:\n     * - `false` — disables CORS middleware entirely.\n     * - `cors.CorsOptions` — passed directly to the `cors` middleware.\n     * - `cors.CorsOptionsDelegate` — a delegate function passed directly to the `cors` middleware.\n     * - `ArkosRequestHandler` — a full Express middleware that replaces the cors middleware entirely.\n     * - An object with deprecated `allowedOrigins`, `options`, and `customHandler` properties.\n     *\n     * In development, defaults to `origin: true, credentials: true`.\n     * In production, defaults to `origin: \"*\"` (equivalent to plain `cors()`).\n     *\n     * See https://www.npmjs.com/package/cors\n     */\n    cors?:\n      | false\n      | cors.CorsOptions\n      | cors.CorsOptionsDelegate\n      | {\n          /**\n           * Defines allowed origins to access the API.\n           *\n           * @deprecated Use `cors: { origin: string | string[] }` (cors.CorsOptions) directly instead.\n           */\n          allowedOrigins?: string | string[] | \"*\" | true;\n          /**\n           * Additional cors options.\n           *\n           * @deprecated Pass cors.CorsOptions directly instead: `cors: { origin: \"...\", credentials: true }`.\n           */\n          options?: cors.CorsOptions;\n          /**\n           * If you would like to override the entire middleware.\n           *\n           * @deprecated Pass the handler directly instead: `cors: myCorsHandler`.\n           */\n          customHandler?: cors.CorsOptionsDelegate;\n        }\n      | ArkosRequestHandler;\n    /**\n     * Defines options for the built-in express.json() middleware\n     * Nothing is passed by default.\n     */\n    expressJson?:\n      | false\n      | Parameters<typeof express.json>[0]\n      | ArkosRequestHandler;\n    /**\n     * Allows to pass paremeters to cookieParser from npm package cookie-parser\n     * Nothing is passed by default.\n     *\n     * See [www.npmjs.com/package/cookie-parser](https://www.npmjs.com/package/cookie-parser) for further details.\n     */\n    cookieParser?:\n      | false\n      | {\n          secret?: string | string[];\n          options?: Parameters<typeof cookieParser>[1];\n        }\n      | ArkosRequestHandler;\n    /**\n   * Options to define how query must be parsed.\n   *\n   * #### for 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      parseNumber: true,\n    }\n   * \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?: false | QueryParserOptions | ArkosRequestHandler;\n    /**\n     * Configuration for request logger middleware.\n     *\n     * Logs incoming HTTP requests with details such as method, URL, status code, and response time.\n     * Useful for debugging and monitoring API traffic.\n     */\n    requestLogger?: false | ArkosRequestHandler;\n    /**\n     * Configuration for global error handler middleware.\n     *\n     * Catches and processes errors thrown in route handlers and other middlewares.\n     * Provides a centralized way to format error responses and log errors.\n     */\n    errorHandler?: false | express.ErrorRequestHandler;\n  };\n  /**\n   * Defines express/arkos routers configurations\n   */\n  routers?: {\n    /**\n     * Strict mode configuration for routing security\n     *\n     * @default false\n     * - all CRUD + Auth (if using auth) endpoits are enabled and avialable by default.\n     *\n     * When enabled:\n     * - If `true`: All CRUD endpoints start disabled and must be explicitly enabled\n     *   in each model's router configuration\n     * - If `'no-bulk'`: Bulk operations (createMany, updateMany, deleteMany) are disabled\n     *   by default, while individual operations can be enabled per model\n     *\n     * This provides enhanced security by ensuring no routes are accidentally exposed.\n     * Use this in production environments to follow the principle of least privilege.\n     *\n     * See documentation: https://www.arkosjs.com/docs/guide/security#strict-mode\n     */\n    strict?: boolean | \"no-bulk\";\n    /**\n     * Replace the default welcome endpoint handler\n     * @param req Express request object\n     * @param res Express response object\n     * @param next Express next function\n     */\n    welcomeRoute?: false | ArkosRequestHandler;\n  };\n  /**\n   * Allows to configure email configurations for sending emails through `emailService`\n   *\n   * See [www.arkosjs.com/docs/guides/email-service](https://www.arkosjs.com/docs/guides/email-service)\n   */\n  email?: {\n    /**\n     * Email name to used like:\n     *\n     * John Doe\\<john.doe@gmail.com>\n     */\n    name?: string;\n    /**\n     * Your email provider url\n     */\n    host: string;\n    /**\n     * Email provider SMTP port, Default is `465`\n     */\n    port?: number;\n    /**\n     * If smtp connection must be secure, Default is `true`\n     */\n    secure?: boolean;\n    /**\n     * Used to authenticate in your smtp server\n     */\n    auth: {\n      /**\n       * Email used for auth as well as sending emails\n       */\n      user: string;\n      /**\n       * Your SMTP password\n       */\n      pass: string;\n    };\n  } & Parameters<typeof nodemailer.createTransport>[0];\n  /**\n   * Defines Swagger and OpenApi specifications for auto generating swagger documentation UI using whether it is Prisma Schemas, Class-validator DTOs, Zod Schemas or JSON-Schemas.\n   *\n   * **Important**: Is worth mentioning that this works alongside `@scalar/express-api-reference` npm package, you define it's ApiReferenceConfiguration under ``. also consider checking the package documentation at []\n   *\n   * **Usage**\n   *\n   * ```ts\n   * // src/app.ts\n   *\n   * import arkos from \"arkos\"\n   *\n   *  arkos.init({\n   *    // other configs\n   *    swagger: {\n   *      mode: \"zod\",\n   *      options: {\n   *        defintion: {\n   *          info: {\n   *            openapi: \"3.0.0\",\n   *            title: \"API Generated By Arkos.js\",\n   *            description: \"This API was automatically generated by Arkos.js read more about at www.arkosjs.com\"\n   *          }\n   *       }\n   *    }\n   *  }\n   * })\n   * ```\n   * @see {@link https://www.arkosjs.com/docs/guides/open-api-documentation/setup}\n   */\n  swagger?: {\n    /**\n     * By default Arkos will disable API Documentation when the project is built `npm run build`, it does not matter what node environment is set. If you want to use it even after the `arkos build` command just set this to `true`.\n     * */\n    enableAfterBuild?: boolean;\n    /**\n     * Whether to require superUser authentication to access docs in production.\n     * Default: true after build\n     */\n    authenticate?: boolean;\n    /**\n     * Endpoint where the Swagger UI will be available.\n     *\n     * @default \"/api/api-docs\"\n     */\n    endpoint?: string;\n    /**\n     * Allows `Arkos.js` to fallback to prisma schema and use them as json schema for defining request body and response data\n     * when a given zod Schema or class-validator Class is not found to be transformed to json schema.\n     *\n     * @default false\n     */\n    strict?: boolean;\n    /**\n     * Defines your swagger configurations\n     */\n    options?: {\n      /**\n       * Swagger definition according to OpenAPI Specification.\n       */\n      definition?: {\n        /**\n         * OpenAPI version.\n         *\n         * @default \"3.0.0\"\n         */\n        openapi?: string;\n\n        /**\n         * Information about your API.\n         */\n        info?: {\n          /**\n           * Title of the API documentation.\n           *\n           *\n           * @example \"My API\"\n           *\n           * @default \"API Generated By Arkos.js\"\n           */\n          title?: string;\n\n          /**\n           * Version of the API.\n           *\n           * @example \"1.0.0\"\n           */\n          version?: string;\n\n          /**\n           * Description of the API.\n           *\n           * @default \"This API was automatically generated by Arkos.js read more about at www.arkosjs.com\"\n           */\n          description?: string;\n        };\n\n        /**\n         * Server configurations for the API.\n         *\n         * @default [{ url: \"http://localhost:8000\", description: \"Development server\" }]\n         *\n         * This can be overridden automatically by Arkos based on CLI, .env, or `arkos.init()`.\n         */\n        servers?: {\n          /**\n           * Base URL of the server.\n           *\n           * @example \"http://localhost:8000\"\n           */\n          url: string;\n\n          /**\n           * Human-readable description of the server.\n           *\n           * @example \"Development Server\"\n           */\n          description?: string;\n        }[];\n        /**\n         * Allows adding more paths for your OpenAPI documentation\n         *\n         * */\n        paths?: OpenAPIV3.PathsObject;\n        /**\n         * (Optional) Additional metadata such as terms of service, contact, or license.\n         *\n         * See: https://swagger.io/specification/#infoObject\n         */\n        termsOfService?: string;\n        contact?: {\n          name?: string;\n          url?: string;\n          email?: string;\n        };\n        license?: {\n          name: string;\n          url?: string;\n        };\n\n        /**\n         * Tags to group and describe endpoints.\n         */\n        tags?: {\n          name: string;\n          description?: string;\n        }[];\n\n        /**\n         * Security definitions (e.g., Bearer Auth).\n         */\n        components?: {\n          securitySchemes?: Record<string, any>;\n          schemas?: Record<string, any>;\n        };\n\n        /**\n         * Global security requirements.\n         */\n        security?: Array<Record<string, string[]>>;\n      };\n\n      /**\n       * Glob patterns defining where Swagger should look for API route definitions and comments.\n       *\n       * @default \n       * ```ts\n       *  [\"./src/routers/*.router.{ts,js}\", \"./src/modules/**\\/*.router.{ts,js}\"]\n        ```\n       *\n       * Adjust depending on TypeScript or JavaScript usage.\n       */\n      apis?: string[];\n\n      /**\n       * Enables deep linking in the Swagger UI.\n       *\n       * @default true\n       */\n      deepLinking?: boolean;\n\n      /**\n       * Enable/disable the \"Try it out\" button globally.\n       *\n       * @default true\n       */\n      tryItOutEnabled?: boolean;\n\n      /**\n       * Whether to persist authorization data across page reloads.\n       *\n       * @default false\n       */\n      persistAuthorization?: boolean;\n    };\n    /**\n     * Custom `@scalar/express-api-reference` package options.\n     *\n     * @see {@link https://guides.scalar.com/scalar/scalar-api-references/integrations/express}\n     */\n    scalarApiReferenceConfiguration?: Partial<ApiReferenceConfiguration>;\n  };\n  /**\n   * Helps in debugging some of the variables values that are used inside arkos from dynamic loaded components towhat is used into the generated api.\n   *\n   */\n  debugging?: {\n    /**\n     * Controls debugging over HTTP request level\n     */\n    requests?: {\n      level?: 0 | 1 | 2 | 3;\n      filter?: (\n        | \"Query\"\n        | \"Body\"\n        | \"Params\"\n        | \"TransformedQuery\"\n        | \"ServiceArgs\"\n        | \"PrismaFinalQueryArgs\"\n      )[];\n    };\n  };\n  /**\n   * Defines Prisma-related configurations for Arkos to communicate with your database.\n   */\n  prisma: {\n    /**\n     * Your PrismaClient instance. Required for Arkos to communicate with your database.\n     *\n     * @example\n     * ```ts\n     * import { PrismaClient } from \"@prisma/client\";\n     *\n     * const prisma = new PrismaClient();\n     *\n     * export default defineConfig({\n     *   prisma: { instance: prisma },\n     * });\n     * ```\n     */\n    instance: PrismaClient;\n  };\n  /**\n   * Allows to suppress specific warnings emitted by Arkos at startup or runtime.\n   *\n   * @since 1.5.10-beta\n   */\n  warnings?: {\n    /**\n     * Suppresses specific warning messages.\n     */\n    suppress?: {\n      /**\n       * Suppresses Prisma-related warnings.\n       */\n      prisma?: {\n        /**\n         * Suppresses the warning emitted when no Prisma instance is found.\n         */\n        noInstanceFound?: boolean;\n        /**\n         * Suppresses the warning emitted when no Prisma schema is found.\n         */\n        noSchemaFound?: boolean;\n      };\n    };\n  };\n  /**\n   * Defines static file serving configurations.\n   *\n   * Arkos will automatically serve files from the configured folder using `express.static`.\n   * If the folder does not exist at startup, a warning will be emitted.\n   *\n   * **Note:** The static files route is **not** prefixed with the `globalPrefix`.\n   *\n   * @since 1.7.0-canary.16\n   *\n   * @example\n   * ```ts\n   * import { defineConfig } from \"arkos\"\n   *\n   * export default defineConfig({\n   *   staticFiles: {\n   *     folder: \"assets\",\n   *     prefix: \"/static\",\n   *   }\n   * })   */\n  staticFiles?: {\n    /**\n     * Whether to enable static file serving.\n     *\n     * Set to `false` to disable static file serving entirely and suppress\n     * the warning when the folder is not found.\n     *\n     * @default true\n     */\n    enabled?: boolean;\n\n    /**\n     * The folder to serve static files from, relative to the project root.\n     *\n     * @default \"public\"\n     */\n    folder?: string;\n\n    /**\n     * The URL path prefix under which static files will be served.\n     *\n     * **Note:** This is not affected by `globalPrefix`.\n     *\n     * @default \"/\"\n     *\n     * @example \"/static\" // files served at /static/image.png\n     */\n    prefix?: string;\n\n    /**\n     * Options passed directly to `express.static()`.\n     *\n     * By passing custom options, they will be deep merged with the defaults.\n     *\n     * #### Default:\n     * ```ts\n     * {\n     *   maxAge: \"1y\",\n     *   etag: true,\n     *   lastModified: true,\n     *   dotfiles: \"ignore\",\n     *   fallthrough: true,\n     *   index: false,\n     *   cacheControl: true,\n     * }\n     * ```\n     *\n     * @see {@link https://expressjs.com/en/4x/api.html#express.static}\n     */\n    expressStatic?: Parameters<typeof express.static>[1];\n  };\n};\n"]}

package/dist/cjs/types/router-config.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=router-config.js.map

package/dist/cjs/types/router-config.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"router-config.js","sourceRoot":"","sources":["../../../src/types/router-config.ts"],"names":[],"mappings":"","sourcesContent":["import { ArkosRouteConfig } from \"../exports\";\n\nexport type RouterEndpoint =\n  | \"createOne\"\n  | \"findOne\"\n  | \"updateOne\"\n  | \"deleteOne\"\n  | \"findMany\"\n  | \"createMany\"\n  | \"updateMany\"\n  | \"deleteMany\";\n\nexport type AuthRouterEndpoint =\n  | \"getMe\"\n  | \"updateMe\"\n  | \"deleteMe\"\n  | \"login\"\n  | \"logout\"\n  | \"signup\"\n  | \"updatePassword\"\n  | \"findManyAuthAction\"\n  | \"findOneAuthAction\";\n\nexport type FileUploadRouterEndpoint =\n  | \"findFile\"\n  | \"uploadFile\"\n  | \"updateFile\"\n  | \"deleteFile\";\n\ntype BaseRouterConfig = {\n  /**\n   * Backward compatibility (prior 1.4.0-beta) - disables/enables endpoints\n   *\n   * prefer to rather to use the following:\n   *\n   * ```ts\n   * export const config = {\n   *  findMany: {\n   *    disabled: true\n   *  }\n   * }\n   * ```\n   */\n  disable?:\n    | boolean\n    | {\n        [K in RouterEndpoint]?: boolean;\n      };\n} & {\n  [K in RouterEndpoint]?: Omit<ArkosRouteConfig, \"path\">;\n};\n\ntype AuthRouterConfig = {\n  /**\n   * Backward compatibility (prior 1.4.0-beta) - disables/enables endpoints\n   *\n   * prefer to rather to use the following:\n   *\n   * ```ts\n   * export const config = {\n   *  getMe: {\n   *    disabled: true\n   *  }\n   * }\n   * ```\n   */\n  disable?:\n    | boolean\n    | {\n        [K in AuthRouterEndpoint]?: boolean;\n      };\n} & {\n  [K in AuthRouterEndpoint]?: Omit<ArkosRouteConfig, \"path\">;\n};\n\ntype FileUploadRouterConfig = {\n  /**\n   * Backward compatibility (prior 1.4.0-beta) - disables/enables endpoints\n   *\n   * prefer to rather to use the following:\n   *\n   * ```ts\n   * export const config = {\n   *  deleteFile: {\n   *    disabled: true\n   *  }\n   * }\n   * ```\n   */\n  disable?:\n    | boolean\n    | {\n        [K in FileUploadRouterEndpoint]?: boolean;\n      };\n} & {\n  [K in FileUploadRouterEndpoint]?: Omit<ArkosRouteConfig, \"path\" | \"uploads\">;\n};\n\n/**\n * @deprecated use 'import { RouteHook } from \"arkos\"' instead\n */\nexport type RouterConfig<T extends string = string> = T extends \"auth\"\n  ? AuthRouterConfig\n  : T extends \"file-upload\"\n    ? FileUploadRouterConfig\n    : BaseRouterConfig;\n\n/**\n * Represents a Route Hook configuration for Arkos auto-generated routes.\n *\n * Route Hooks allow you to customize built-in routes (e.g. CRUD, auth, file upload)\n * without modifying the route definitions themselves. Each key in the hook maps\n * to a specific operation and accepts the same configuration object used by ArkosRouter.\n *\n * @template T - The hook type:\n * - `\"auth\"` → Uses {@link AuthRouterConfig} for authentication routes\n * - `\"file-upload\"` → Uses {@link FileUploadRouterConfig} for file upload routes\n * - `string` (default) → Uses {@link BaseRouterConfig} for standard model routes\n *\n * @example\n * ```ts\n * export const hook: RouteHook = {\n *   findMany: { authentication: false },\n *   createOne: { authentication: true },\n *   deleteOne: { disabled: true },\n * };\n * ```\n *\n * @example\n * ```ts\n * export const hook: RouteHook<\"auth\"> = {\n *   login: { rateLimit: { windowMs: 15 * 60_000, max: 10 } },\n *   signup: { disabled: true },\n * };\n * ```\n *\n * @example\n * ```ts\n * export const hook: RouteHook<\"file-upload\"> = {\n *   uploadFile: { authentication: true },\n *   deleteFile: { disabled: true },\n * };\n * ```\n *\n * @remarks\n * - This replaces the deprecated `RouterConfig` export (since v1.6.0-beta).\n * - The hook must be exported as `export const hook` inside a `*.router.ts` file.\n * - Each property corresponds to a predefined route operation depending on the hook type.\n *\n * @since v1.6.0-beta\n */\nexport type RouteHook<T extends string = string> = T extends \"auth\"\n  ? AuthRouterConfig\n  : T extends \"file-upload\"\n    ? FileUploadRouterConfig\n    : BaseRouterConfig;\n"]}

package/dist/cjs/utils/arkos-env.js

@@ -1,9 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const arkosEnv = {
-    JWT_SECRET: "13a9279eedb286f756212511267152e9585055809ec0606ea9f7eb98a87660c1616fbd39c44d4238a82f29df90b529e24bfdf72a480d1149d79c991c863a22b5ae0fb3ae6f5323bfd6664faef99792637477c38da488e7aa0d39b83ba99aba8e8a20efde7fd5c7ba21a6c938e17a9f99f73226dc61e89cd63f159257841194323f100d1a49b88ce4fdcdf2b066a5f32f88ee12f6487b55b4b5687d7c0caffdd8524e2adc4b941cf52e948f5b330f527eb1354341c876eed12dfa92cef3c341d030d05e6beb1e0a7f6d3e08e7b1aac045130457fd3a53ee469fecdd20fdd2c7a6a72b07cbcb1157c5b1cc581e6767bea32be8e125016a48951e85c7bdb961d9c9fab28444499ce063664fe0bd1a05d60294323bdd69af6d6ff1a2533dac8d4a869f76dbc746ee12f144e0af41029f620471817843140c23d036e731f3ebee21a70ff1549e97486fdf9cbef132ff2ced59fde9be35dd04b358c9a25ec4fd9cc0e36dae651e626d8c13b0c6d2a21f237517a05059680173e71817597062c792ea9c66030ca0d8ed82987e29189947692a0be5fffac4c988ca33f14ce96349661ef850dbff6909c7797676c90a5e47655346f59759482ef8a3a948e97e30f889bd4571610fd19e8ea4818651d37f6529cf32f0fc805bc053e911f0fe96f52b4420d54bd1f40739a95f5853b036c86ab9a51bed57fa9bd48607b5302e88db00900adf",
-    JWT_EXPIRES_IN: "30d",
-    PRISMA_SCHEMA_PATH: `./prisma/schema`,
-};
-exports.default = arkosEnv;
-//# sourceMappingURL=arkos-env.js.map

package/dist/cjs/utils/arkos-env.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"arkos-env.js","sourceRoot":"","sources":["../../../src/utils/arkos-env.ts"],"names":[],"mappings":";;AAAA,MAAM,QAAQ,GAAG;IACf,UAAU,EACR,kgCAAkgC;IACpgC,cAAc,EAAE,KAAK;IACrB,kBAAkB,EAAE,iBAAiB;CACtC,CAAC;AAEF,kBAAe,QAAQ,CAAC","sourcesContent":["const arkosEnv = {\n  JWT_SECRET:\n    \"13a9279eedb286f756212511267152e9585055809ec0606ea9f7eb98a87660c1616fbd39c44d4238a82f29df90b529e24bfdf72a480d1149d79c991c863a22b5ae0fb3ae6f5323bfd6664faef99792637477c38da488e7aa0d39b83ba99aba8e8a20efde7fd5c7ba21a6c938e17a9f99f73226dc61e89cd63f159257841194323f100d1a49b88ce4fdcdf2b066a5f32f88ee12f6487b55b4b5687d7c0caffdd8524e2adc4b941cf52e948f5b330f527eb1354341c876eed12dfa92cef3c341d030d05e6beb1e0a7f6d3e08e7b1aac045130457fd3a53ee469fecdd20fdd2c7a6a72b07cbcb1157c5b1cc581e6767bea32be8e125016a48951e85c7bdb961d9c9fab28444499ce063664fe0bd1a05d60294323bdd69af6d6ff1a2533dac8d4a869f76dbc746ee12f144e0af41029f620471817843140c23d036e731f3ebee21a70ff1549e97486fdf9cbef132ff2ced59fde9be35dd04b358c9a25ec4fd9cc0e36dae651e626d8c13b0c6d2a21f237517a05059680173e71817597062c792ea9c66030ca0d8ed82987e29189947692a0be5fffac4c988ca33f14ce96349661ef850dbff6909c7797676c90a5e47655346f59759482ef8a3a948e97e30f889bd4571610fd19e8ea4818651d37f6529cf32f0fc805bc053e911f0fe96f52b4420d54bd1f40739a95f5853b036c86ab9a51bed57fa9bd48607b5302e88db00900adf\",\n  JWT_EXPIRES_IN: \"30d\",\n  PRISMA_SCHEMA_PATH: `./prisma/schema`,\n};\n\nexport default arkosEnv;\n"]}

package/dist/cjs/utils/arkos-router/arkos-router-openapi-manager.js

@@ -1,184 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const deepmerge_helper_1 = __importDefault(require("../helpers/deepmerge.helper.js"));
-class ArkosRouterOpenAPIManager {
-    resolveSchemaFieldName(name) {
-        return name.replace(/\[\]/g, "[0]");
-    }
-    addUploadFields(uploadConfig, existingSchema = {}) {
-        const uploadSchema = {
-            type: "object",
-            properties: {},
-            required: [],
-        };
-        if (uploadConfig.type === "single") {
-            const schemaKey = this.resolveSchemaFieldName(uploadConfig.field);
-            uploadSchema.properties[schemaKey] = {
-                type: "string",
-                format: "binary",
-                ...(uploadConfig.maxSize && {
-                    description: `Max size: ${uploadConfig.maxSize} bytes`,
-                }),
-                ...(uploadConfig.description && {
-                    description: uploadConfig.description,
-                }),
-            };
-            if (uploadConfig.required !== false) {
-                uploadSchema.required.push(schemaKey);
-            }
-        }
-        else if (uploadConfig.type === "array") {
-            const schemaKey = this.resolveSchemaFieldName(uploadConfig.field);
-            uploadSchema.properties[schemaKey] = {
-                type: "array",
-                items: {
-                    type: "string",
-                    format: "binary",
-                },
-                ...(uploadConfig.maxCount && { maxItems: uploadConfig.maxCount }),
-                ...(uploadConfig.minCount && { minItems: uploadConfig.minCount }),
-                ...(uploadConfig.maxSize && {
-                    description: `Max size per file: ${uploadConfig.maxSize} bytes`,
-                }),
-                ...(uploadConfig.description && {
-                    description: uploadConfig.description,
-                }),
-            };
-            if (uploadConfig.required !== false) {
-                uploadSchema.required.push(schemaKey);
-            }
-        }
-        else if (uploadConfig.type === "fields") {
-            for (const field of uploadConfig.fields) {
-                uploadSchema.properties[this.resolveSchemaFieldName(field.name)] =
-                    this.buildFieldSchema(field, uploadConfig);
-                const isRequired = field.type === undefined
-                    ? uploadConfig.required !== false
-                    : field.required !== false;
-                if (isRequired) {
-                    uploadSchema.required.push(this.resolveSchemaFieldName(field.name));
-                }
-            }
-        }
-        if (uploadSchema.required.length === 0)
-            delete uploadSchema.required;
-        return (0, deepmerge_helper_1.default)(existingSchema, uploadSchema);
-    }
-    buildFieldSchema(field, config) {
-        if (field.type === "single") {
-            return {
-                type: "string",
-                format: "binary",
-                ...(field.maxSize &&
-                    !config.maxSize && {
-                    description: `Max size: ${field.maxSize} bytes`,
-                }),
-                ...(config.maxSize &&
-                    !field.maxSize && {
-                    description: `Max size: ${config.maxSize} bytes`,
-                }),
-                ...(field.description && { description: field.description }),
-            };
-        }
-        return {
-            type: "array",
-            items: {
-                type: "string",
-                format: "binary",
-            },
-            ...(field.maxCount && { maxItems: field.maxCount }),
-            ...(field.type === "array" &&
-                field.minCount && { minItems: field.minCount }),
-            ...((field.maxSize &&
-                !config.maxSize && {
-                description: `Max size per file: ${field.maxSize} bytes`,
-            }) ||
-                (config.maxSize &&
-                    !field.maxSize && {
-                    description: `Max size per file: ${config.maxSize} bytes`,
-                })),
-            ...(field.type === "array" &&
-                field.description && {
-                description: field.description,
-            }),
-        };
-    }
-    validateMultipartFormDocs(userDefinedMultipartSchema, routePath, uploadConfig) {
-        const errors = [];
-        const properties = userDefinedMultipartSchema?.properties || {};
-        const requiredFields = userDefinedMultipartSchema?.required || [];
-        const expectedFields = [];
-        if (uploadConfig?.type === "single") {
-            expectedFields.push({
-                name: uploadConfig.field,
-                required: uploadConfig.required !== false,
-                expectedType: "single",
-            });
-        }
-        else if (uploadConfig?.type === "array") {
-            expectedFields.push({
-                name: uploadConfig.field,
-                required: uploadConfig.required !== false,
-                expectedType: "array",
-            });
-        }
-        else if (uploadConfig?.type === "fields") {
-            for (const field of uploadConfig.fields) {
-                if (!("type" in field)) {
-                    expectedFields.push({
-                        name: field.name,
-                        required: uploadConfig.required ===
-                            undefined
-                            ? true
-                            : uploadConfig
-                                .required,
-                        expectedType: "array",
-                    });
-                }
-                else if (field.type)
-                    expectedFields.push({
-                        name: field.name,
-                        required: field.type === undefined ? true : field.required !== false,
-                        expectedType: field.type ?? "array",
-                    });
-            }
-        }
-        for (const { name, required, expectedType } of expectedFields) {
-            const schemaKey = this.resolveSchemaFieldName(name);
-            const fieldSchema = properties[schemaKey];
-            if (!fieldSchema) {
-                errors.push(`Missing upload field '${name}' in multipart/form-data schema`);
-                continue;
-            }
-            if (expectedType === "single") {
-                if (fieldSchema.type !== "string")
-                    errors.push(`Upload field '${name}' must have type 'string', got '${fieldSchema.type}'`);
-                if (fieldSchema.format !== "binary")
-                    errors.push(`Upload field '${name}' must have format 'binary', got '${fieldSchema.format || "undefined"}'`);
-            }
-            else if (expectedType === "array") {
-                if (fieldSchema.type !== "array") {
-                    errors.push(`Upload field '${name}' must have type 'array', got '${fieldSchema.type}'`);
-                }
-                else if (!fieldSchema.items ||
-                    fieldSchema.items.type !== "string" ||
-                    fieldSchema.items.format !== "binary")
-                    errors.push(`Upload field '${name}' must have items with type 'string' and format 'binary'`);
-            }
-            const isMarkedRequired = requiredFields.includes(schemaKey);
-            if (required && !isMarkedRequired)
-                errors.push(`Upload field '${name}' is required in config but not marked as required in schema`);
-            if (!required && isMarkedRequired)
-                errors.push(`Upload field '${name}' is not required in config but marked as required in schema`);
-        }
-        if (errors.length > 0) {
-            throw new Error(`ValidationError: Invalid multipart/form-data schema for route '${routePath}':\n${errors.map((e) => `  - ${e}`).join("\n")}`);
-        }
-    }
-}
-const arkosRouterOpenApiManager = new ArkosRouterOpenAPIManager();
-exports.default = arkosRouterOpenApiManager;
-//# sourceMappingURL=arkos-router-openapi-manager.js.map

package/dist/cjs/utils/arkos-router/arkos-router-openapi-manager.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"arkos-router-openapi-manager.js","sourceRoot":"","sources":["../../../../src/utils/arkos-router/arkos-router-openapi-manager.ts"],"names":[],"mappings":"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","sourcesContent":["import { OpenAPIV3 } from \"openapi-types\";\nimport deepmerge from \"../helpers/deepmerge.helper\";\nimport {\n  ArkosRouterBaseUploadConfig,\n  UploadConfig,\n  UploadConfigFieldEntry,\n} from \"./types/upload-config\";\n\nclass ArkosRouterOpenAPIManager {\n  private resolveSchemaFieldName(name: string): string {\n    return name.replace(/\\[\\]/g, \"[0]\");\n  }\n  /**\n   * Generates OpenAPI schema for file upload fields in multipart/form-data requests.\n   * Converts upload configuration into OpenAPI-compliant schema and merges with existing body schema.\n   *\n   * @param {UploadConfig} uploadConfig - The upload configuration from config.experimental.uploads\n   * @param {any} existingSchema - Existing JSON schema from config.validation.body (optional)\n   * @returns {{ schema: any }} OpenAPI schema object for multipart/form-data content type\n   *\n   * @example\n   * // Single file upload\n   * addUploadFields({ type: 'single', field: 'avatar', maxSize: 5242880 })\n   * // Returns: { schema: { type: 'object', properties: { avatar: { type: 'string', format: 'binary' } } } }\n   *\n   * @example\n   * // Array file upload\n   * addUploadFields({ type: 'array', field: 'gallery', maxCount: 10 })\n   *\n   * @example\n   * // Multiple fields upload\n   * addUploadFields({\n   *   type: 'fields',\n   *   fields: [\n   *     { name: 'avatar', type: 'single', uploadDir: 'images' },\n   *     { name: 'gallery', type: 'array', maxCount: 6, uploadDir: 'gallery' },\n   *     { name: 'banners[][images]', type: 'array', maxCount: 5, uploadDir: 'banners' }\n   *   ]\n   * })\n   */\n  addUploadFields(\n    uploadConfig: UploadConfig,\n    existingSchema: OpenAPIV3.SchemaObject = {}\n  ): OpenAPIV3.SchemaObject {\n    const uploadSchema: any = {\n      type: \"object\",\n      properties: {},\n      required: [],\n    };\n\n    if (uploadConfig.type === \"single\") {\n      const schemaKey = this.resolveSchemaFieldName(uploadConfig.field);\n      uploadSchema.properties[schemaKey] = {\n        type: \"string\",\n        format: \"binary\",\n        ...(uploadConfig.maxSize && {\n          description: `Max size: ${uploadConfig.maxSize} bytes`,\n        }),\n        ...(uploadConfig.description && {\n          description: uploadConfig.description,\n        }),\n      };\n      if (uploadConfig.required !== false) {\n        uploadSchema.required.push(schemaKey);\n      }\n    } else if (uploadConfig.type === \"array\") {\n      const schemaKey = this.resolveSchemaFieldName(uploadConfig.field);\n      uploadSchema.properties[schemaKey] = {\n        type: \"array\",\n        items: {\n          type: \"string\",\n          format: \"binary\",\n        },\n        ...(uploadConfig.maxCount && { maxItems: uploadConfig.maxCount }),\n        ...(uploadConfig.minCount && { minItems: uploadConfig.minCount }),\n        ...(uploadConfig.maxSize && {\n          description: `Max size per file: ${uploadConfig.maxSize} bytes`,\n        }),\n        ...(uploadConfig.description && {\n          description: uploadConfig.description,\n        }),\n      };\n      if (uploadConfig.required !== false) {\n        uploadSchema.required.push(schemaKey);\n      }\n    } else if (uploadConfig.type === \"fields\") {\n      for (const field of uploadConfig.fields) {\n        uploadSchema.properties[this.resolveSchemaFieldName(field.name)] =\n          this.buildFieldSchema(field, uploadConfig);\n\n        // legacy shape has no type and no required — default to required\n        const isRequired =\n          (field as any).type === undefined\n            ? (uploadConfig as any).required !== false\n            : (field as any).required !== false;\n\n        if (isRequired) {\n          uploadSchema.required.push(this.resolveSchemaFieldName(field.name));\n        }\n      }\n    }\n\n    // Clean up empty required array\n    if (uploadSchema.required.length === 0) delete uploadSchema.required;\n\n    return deepmerge(existingSchema as any, uploadSchema);\n  }\n\n  /**\n   * Builds the OpenAPI property schema for a single field entry.\n   * Legacy entries (no type) are treated as array.\n   */\n  private buildFieldSchema(\n    field: UploadConfigFieldEntry,\n    config: ArkosRouterBaseUploadConfig\n  ): object {\n    if (field.type === \"single\") {\n      return {\n        type: \"string\",\n        format: \"binary\",\n        ...(field.maxSize &&\n          !config.maxSize && {\n            description: `Max size: ${field.maxSize} bytes`,\n          }),\n        ...(config.maxSize &&\n          !field.maxSize && {\n            description: `Max size: ${config.maxSize} bytes`,\n          }),\n        ...(field.description && { description: field.description }),\n      };\n    }\n\n    // type === \"array\" or legacy (no type) — both produce array schema\n    return {\n      type: \"array\",\n      items: {\n        type: \"string\",\n        format: \"binary\",\n      },\n      ...(field.maxCount && { maxItems: field.maxCount }),\n      ...(field.type === \"array\" &&\n        field.minCount && { minItems: field.minCount }),\n      ...((field.maxSize &&\n        !config.maxSize && {\n          description: `Max size per file: ${field.maxSize} bytes`,\n        }) ||\n        (config.maxSize &&\n          !field.maxSize && {\n            description: `Max size per file: ${config.maxSize} bytes`,\n          })),\n      ...(field.type === \"array\" &&\n        field.description && {\n          description: field.description,\n        }),\n    };\n  }\n\n  /**\n   * Validates that a user-defined multipart/form-data schema includes all required upload fields\n   * with correct types, formats, and required flags.\n   *\n   * @param {any} userDefinedMultipartSchema - The schema object from openapi.requestBody.content['multipart/form-data'].schema\n   * @param {UploadConfig} uploadConfig - The upload configuration from config.experimental.uploads\n   * @param {string} routePath - The route path for error context\n   * @throws {Error} If upload fields are missing or incorrectly defined\n   *\n   * @example\n   * validateMultipartFormDocs(\n   *   { type: 'object', properties: { avatar: { type: 'string', format: 'binary' } } },\n   *   { type: 'single', field: 'avatar', required: true },\n   *   '/users/:id/avatar'\n   * )\n   */\n  validateMultipartFormDocs(\n    userDefinedMultipartSchema: any,\n    routePath: string,\n    uploadConfig?: UploadConfig\n  ): void {\n    const errors: string[] = [];\n    const properties = userDefinedMultipartSchema?.properties || {};\n    const requiredFields = userDefinedMultipartSchema?.required || [];\n\n    const expectedFields: Array<{\n      name: string;\n      required: boolean;\n      expectedType: \"single\" | \"array\";\n    }> = [];\n\n    if (uploadConfig?.type === \"single\") {\n      expectedFields.push({\n        name: uploadConfig.field,\n        required: uploadConfig.required !== false,\n        expectedType: \"single\",\n      });\n    } else if (uploadConfig?.type === \"array\") {\n      expectedFields.push({\n        name: uploadConfig.field,\n        required: uploadConfig.required !== false,\n        expectedType: \"array\",\n      });\n    } else if (uploadConfig?.type === \"fields\") {\n      for (const field of uploadConfig.fields) {\n        if (!(\"type\" in field)) {\n          expectedFields.push({\n            name: field.name,\n            // legacy shape has no type and no required — default to required\n            required:\n              (uploadConfig as ArkosRouterBaseUploadConfig).required ===\n              undefined\n                ? true\n                : ((uploadConfig as ArkosRouterBaseUploadConfig)\n                    .required as boolean),\n            expectedType: \"array\",\n          });\n        } else if (field.type)\n          expectedFields.push({\n            name: field.name,\n            required:\n              field.type === undefined ? true : field.required !== false,\n            expectedType: field.type ?? \"array\",\n          });\n      }\n    }\n\n    for (const { name, required, expectedType } of expectedFields) {\n      const schemaKey = this.resolveSchemaFieldName(name);\n      const fieldSchema = properties[schemaKey];\n\n      if (!fieldSchema) {\n        errors.push(\n          `Missing upload field '${name}' in multipart/form-data schema`\n        );\n        continue;\n      }\n\n      if (expectedType === \"single\") {\n        if (fieldSchema.type !== \"string\")\n          errors.push(\n            `Upload field '${name}' must have type 'string', got '${fieldSchema.type}'`\n          );\n\n        if (fieldSchema.format !== \"binary\")\n          errors.push(\n            `Upload field '${name}' must have format 'binary', got '${fieldSchema.format || \"undefined\"}'`\n          );\n      } else if (expectedType === \"array\") {\n        if (fieldSchema.type !== \"array\") {\n          errors.push(\n            `Upload field '${name}' must have type 'array', got '${fieldSchema.type}'`\n          );\n        } else if (\n          !fieldSchema.items ||\n          fieldSchema.items.type !== \"string\" ||\n          fieldSchema.items.format !== \"binary\"\n        )\n          errors.push(\n            `Upload field '${name}' must have items with type 'string' and format 'binary'`\n          );\n      }\n\n      const isMarkedRequired = requiredFields.includes(schemaKey);\n      if (required && !isMarkedRequired)\n        errors.push(\n          `Upload field '${name}' is required in config but not marked as required in schema`\n        );\n\n      if (!required && isMarkedRequired)\n        errors.push(\n          `Upload field '${name}' is not required in config but marked as required in schema`\n        );\n    }\n\n    if (errors.length > 0) {\n      throw new Error(\n        `ValidationError: Invalid multipart/form-data schema for route '${routePath}':\\n${errors.map((e) => `  - ${e}`).join(\"\\n\")}`\n      );\n    }\n  }\n}\n\nconst arkosRouterOpenApiManager = new ArkosRouterOpenAPIManager();\n\nexport default arkosRouterOpenApiManager;\n"]}

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

@@ -1,153 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = ArkosRouter;
-exports.generateOpenAPIFromApp = generateOpenAPIFromApp;
-const express_1 = require("express");
-const helpers_1 = require("./utils/helpers/index.js");
-const exports_1 = require("../../exports/index.js");
-const zod_to_json_schema_1 = __importDefault(require("zod-to-json-schema"));
-const class_validator_to_json_schema_1 = __importDefault(require("../../modules/swagger/utils/helpers/class-validator-to-json-schema.js"));
-const openapi_schema_converter_1 = __importDefault(require("../../modules/swagger/utils/helpers/openapi-schema-converter.js"));
-const arkos_router_openapi_manager_1 = __importDefault(require("./arkos-router-openapi-manager.js"));
-const apply_arkos_router_proxy_1 = require("./utils/helpers/apply-arkos-router-proxy.js");
-function ArkosRouter(options) {
-    const router = (0, express_1.Router)(options);
-    return (0, apply_arkos_router_proxy_1.applyArkosRouterProxy)(router, options);
-}
-const hasDuplicatedPath = (path) => /^(\/.+)\1/.test(path);
-function generateOpenAPIFromApp(app) {
-    const routes = (0, helpers_1.extractArkosRoutes)(app);
-    const arkosConfig = (0, exports_1.getArkosConfig)();
-    let paths = {};
-    routes.forEach(({ path, method, config, routeOptions }) => {
-        if (config?.experimental?.openapi === false || hasDuplicatedPath(path))
-            return;
-        const originalPath = path;
-        const pathParatemersFromRoutePath = (0, helpers_1.extractPathParams)(path);
-        for (const parameter of pathParatemersFromRoutePath) {
-            path = path.replaceAll(`:${parameter}`, parameter.endsWith("?") ? `{${parameter}}?` : `{${parameter}}`);
-        }
-        let wildcardCount = (path.match(/\*/g) || []).length;
-        let wildcardIndex = 0;
-        path = path.replace(/\*/g, () => {
-            wildcardIndex++;
-            return wildcardCount === 1 ? "{path}" : `{path${wildcardIndex}}`;
-        });
-        if (!paths[path])
-            paths[path] = {};
-        if (typeof config?.experimental?.openapi === "boolean") {
-            config = {
-                ...config,
-                experimental: {
-                    ...config.experimental,
-                    openapi: {},
-                },
-            };
-        }
-        const openapi = typeof config?.experimental?.openapi === "object" &&
-            config.experimental.openapi !== null
-            ? config.experimental.openapi
-            : {};
-        const validatorToJsonSchema = arkosConfig?.validation?.resolver === "zod"
-            ? zod_to_json_schema_1.default
-            : class_validator_to_json_schema_1.default;
-        let parameters = [];
-        const validationToParameterMapping = {
-            query: "query",
-            params: "path",
-            headers: "header",
-            cookies: "cookie",
-        };
-        if (typeof config?.validation !== "boolean" && config?.validation) {
-            for (const [key, val] of Object.entries(config?.validation)) {
-                if (["body"].includes(key))
-                    continue;
-                if ((config?.validation)[key]) {
-                    const jsonSchema = validatorToJsonSchema(val);
-                    const params = openapi_schema_converter_1.default.jsonSchemaToOpenApiParameters(validationToParameterMapping[key], jsonSchema);
-                    parameters.push(...params);
-                }
-            }
-        }
-        const convertedOpenAPI = openapi_schema_converter_1.default.convertOpenAPIConfig(openapi);
-        const allParameters = [
-            ...(convertedOpenAPI.parameters || []),
-            ...parameters,
-        ];
-        for (const parameter of pathParatemersFromRoutePath) {
-            if (!allParameters.find(({ name, in: paramIn }) => name === parameter.replace("?", "") && paramIn === "path"))
-                allParameters.push({
-                    name: parameter,
-                    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.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"];
-        if (hasUploadFields && multipartFormSchema)
-            arkos_router_openapi_manager_1.default.validateMultipartFormDocs(multipartFormSchema, path, config?.experimental?.uploads);
-        paths[path][method.toLowerCase()] = {
-            ...convertedOpenAPI,
-            summary: openapi?.summary || `${path}`,
-            description: openapi?.description || `${method} ${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);
-                        return {
-                            ...convertedOpenAPI?.requestBody?.content,
-                            ...(hasUploadFields && {
-                                "multipart/form-data": {
-                                    schema: openapi_schema_converter_1.default.flattenSchema(arkos_router_openapi_manager_1.default.addUploadFields(config.experimental?.uploads, schema)),
-                                },
-                            }),
-                            "application/json": {
-                                schema,
-                            },
-                        };
-                    })(),
-                },
-            }),
-            ...(!multipartFormSchema &&
-                !config?.validation?.body &&
-                hasUploadFields && {
-                requestBody: {
-                    content: (() => {
-                        const schema = convertedOpenAPI?.requestBody?.content?.["application/json"]
-                            ?.schema || {};
-                        return {
-                            "multipart/form-data": {
-                                schema: openapi_schema_converter_1.default.flattenSchema(arkos_router_openapi_manager_1.default.addUploadFields(config?.experimental?.uploads || {}, schema)),
-                            },
-                            ...convertedOpenAPI?.requestBody?.content,
-                        };
-                    })(),
-                },
-            }),
-        };
-    });
-    return paths;
-}
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"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 { getArkosConfig } from \"../../exports\";\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 arkosRouterOpenApiManager from \"./arkos-router-openapi-manager\";\nimport { applyArkosRouterProxy } from \"./utils/helpers/apply-arkos-router-proxy\";\nimport { Arkos } from \"../../types/arkos\";\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\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) as IArkosRouter;\n}\n\nconst hasDuplicatedPath = (path: string) => /^(\\/.+)\\1/.test(path);\n\nexport function generateOpenAPIFromApp(app: Arkos) {\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, 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    }\n\n    let wildcardCount = (path.match(/\\*/g) || []).length;\n    let wildcardIndex = 0;\n    path = path.replace(/\\*/g, () => {\n      wildcardIndex++;\n      return wildcardCount === 1 ? \"{path}\" : `{path${wildcardIndex}}`;\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        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    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 = 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                \"application/json\": {\n                  schema,\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              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              };\n            })(),\n          },\n        }),\n    } as OpenAPIV3.PathItemObject;\n  });\n\n  return paths;\n}\n"]}

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

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-class RouteConfigRegistry {
-    static register(handler, config, method) {
-        this.configs.set(handler, { ...config, method });
-    }
-    static get(handler) {
-        return this.configs.get(handler);
-    }
-    static getAll() {
-        return this.configs;
-    }
-}
-RouteConfigRegistry.configs = new WeakMap();
-exports.default = RouteConfigRegistry;
-//# sourceMappingURL=route-config-registry.js.map

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

@@ -1 +0,0 @@
-{"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;kBAJe,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"]}

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

@@ -1,56 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const dynamic_loader_1 = require("../dynamic-loader.js");
-const exports_1 = require("../../exports/index.js");
-class RouteConfigValidator {
-    static isArkosRouteConfig(arg) {
-        return typeof arg === "object" && arg !== null && "path" in arg;
-    }
-    static validate(config) {
-        const swaggerMode = (0, exports_1.getArkosConfig)()?.validation?.resolver;
-        if (config.validation) {
-            const validators = [
-                { key: "query", schema: config.validation?.query },
-                { key: "body", schema: config.validation?.body },
-                { key: "params", schema: config.validation?.params },
-            ];
-            for (const { key, schema } of validators) {
-                if (!schema)
-                    continue;
-                const isZod = (0, dynamic_loader_1.isZodSchema)(schema);
-                const isClassValidator = (0, dynamic_loader_1.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 (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 (config.validation && typeof config.experimental?.openapi === "object") {
-            const openapi = config.experimental
-                .openapi;
-            if (config.validation.query &&
-                openapi.parameters?.some((p) => p.in === "query")) {
-                throw new Error("Duplicate query validation definitions. " +
-                    "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. " +
-                    "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. " +
-                    "When using validation.body, do not define openapi.requestBody in openapi. " +
-                    "It will be automatically migrated to OpenAPI specification.");
-            }
-        }
-    }
-}
-exports.default = RouteConfigValidator;
-//# sourceMappingURL=route-config-validator.js.map