arkos 1.5.15-beta → 1.5.16-beta

package/dist/cjs/exports/index.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ArkosRouter = exports.getArkosConfig = exports.loadEnvironmentVariables = exports.BaseController = void 0;
+exports.isProduction = exports.ArkosRouter = exports.getArkosConfig = exports.loadEnvironmentVariables = exports.BaseController = void 0;
 const base_controller_1 = require("./../modules/base/base.controller.js");
 Object.defineProperty(exports, "BaseController", { enumerable: true, get: function () { return base_controller_1.BaseController; } });
 const server_1 = require("../server.js");
@@ -12,6 +12,8 @@ const arkos_router_1 = __importDefault(require("../utils/arkos-router/index.js")
 exports.ArkosRouter = arkos_router_1.default;
 const dotenv_helpers_1 = require("../utils/dotenv.helpers.js");
 Object.defineProperty(exports, "loadEnvironmentVariables", { enumerable: true, get: function () { return dotenv_helpers_1.loadEnvironmentVariables; } });
+const arkos_config_helpers_1 = require("../utils/helpers/arkos-config.helpers.js");
+Object.defineProperty(exports, "isProduction", { enumerable: true, get: function () { return arkos_config_helpers_1.isProduction; } });
 const arkos = {
     init: server_1.initApp,
 };

package/dist/cjs/exports/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/exports/index.ts"],"names":[],"mappings":";;;;;;AACA,uEAAmE;AA+BjE,+FA/BO,gCAAc,OA+BP;AA9BhB,sCAAoD;AAmClD,+FAnCgB,uBAAc,OAmChB;AAlChB,yEAAgD;AA2D9C,sBA3DK,sBAAW,CA2DL;AAhDb,4DAAmE;AAsBjE,yGAtBO,yCAAwB,OAsBP;AAd1B,MAAM,KAAK,GAAG;IACZ,IAAI,EAAE,gBAAO;CACd,CAAC;AA+CF,kBAAe,KAAK,CAAC","sourcesContent":["import { RouterConfig } from \"../types/router-config\";\nimport { BaseController } from \"./../modules/base/base.controller\";\nimport { initApp, getArkosConfig } from \"../server\";\nimport ArkosRouter from \"../utils/arkos-router\";\nimport { IArkosRouter } from \"../utils/arkos-router/types\";\nimport { ArkosRouteConfig } from \"../utils/arkos-router/types\";\nimport {\n  ArkosRequest,\n  ArkosResponse,\n  ArkosNextFunction,\n  ArkosRequestHandler,\n} from \"../types\";\nimport { ArkosConfig } from \"../types/new-arkos-config\";\nimport { ArkosInitConfig } from \"../types/arkos-config\";\nimport { loadEnvironmentVariables } from \"../utils/dotenv.helpers\";\n\n/**\n * Initializes the Arkos application.\n *\n * @module arkos\n * @property {Function} init - Function to initialize the app.\n */\nconst arkos = {\n  init: initApp,\n};\n\nexport {\n  ArkosRequest,\n  ArkosResponse,\n  ArkosNextFunction,\n  ArkosRequestHandler,\n  IArkosRouter,\n  BaseController,\n  ArkosConfig,\n  ArkosInitConfig,\n  RouterConfig,\n  loadEnvironmentVariables,\n  getArkosConfig,\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   *     route: \"/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   */\n  ArkosRouter,\n  ArkosRouteConfig,\n};\n\n/**\n * Main entry point for the Arkos module.\n *\n * @module arkos\n */\nexport default arkos;\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/exports/index.ts"],"names":[],"mappings":";;;;;;AACA,uEAAmE;AAiCjE,+FAjCO,gCAAc,OAiCP;AAhChB,sCAAoD;AAqClD,+FArCgB,uBAAc,OAqChB;AApChB,yEAAgD;AAqC9C,sBArCK,sBAAW,CAqCL;AA1Bb,4DAAmE;AAwBjE,yGAxBO,yCAAwB,OAwBP;AAtB1B,gFAAqE;AA2BnE,6FA3BO,mCAAY,OA2BP;AAnBd,MAAM,KAAK,GAAG;IACZ,IAAI,EAAE,gBAAO;CACd,CAAC;AAyBF,kBAAe,KAAK,CAAC","sourcesContent":["import { RouterConfig } from \"../types/router-config\";\nimport { BaseController } from \"./../modules/base/base.controller\";\nimport { initApp, getArkosConfig } from \"../server\";\nimport ArkosRouter from \"../utils/arkos-router\";\nimport { IArkosRouter } from \"../utils/arkos-router/types\";\nimport { ArkosRouteConfig } from \"../utils/arkos-router/types\";\nimport {\n  ArkosRequest,\n  ArkosResponse,\n  ArkosNextFunction,\n  ArkosRequestHandler,\n} from \"../types\";\nimport { ArkosConfig } from \"../types/new-arkos-config\";\nimport { ArkosInitConfig } from \"../types/arkos-config\";\nimport { loadEnvironmentVariables } from \"../utils/dotenv.helpers\";\nimport { ArkosFile } from \"../types/upload\";\nimport { isProduction } from \"../utils/helpers/arkos-config.helpers\";\n\n/**\n * Initializes the Arkos application.\n *\n * @module arkos\n * @property {Function} init - Function to initialize the app.\n */\nconst arkos = {\n  init: initApp,\n};\n\nexport {\n  ArkosRequest,\n  ArkosResponse,\n  ArkosNextFunction,\n  ArkosRequestHandler,\n  IArkosRouter,\n  BaseController,\n  ArkosConfig,\n  ArkosInitConfig,\n  RouterConfig,\n  loadEnvironmentVariables,\n  getArkosConfig,\n  ArkosRouter,\n  ArkosRouteConfig,\n  ArkosFile,\n  isProduction,\n};\n\n/**\n * Main entry point for the Arkos module.\n *\n * @module arkos\n */\nexport default arkos;\n"]}

package/dist/cjs/modules/email/email.service.js

@@ -32,10 +32,10 @@ class EmailService {
         const user = emailConfigs?.auth?.user || process.env.EMAIL_USER;
         const pass = emailConfigs?.auth?.pass || process.env.EMAIL_PASSWORD;
         const name = emailConfigs?.name || process.env.EMAIL_NAME;
-        if (!host || !user || !pass) {
+        if (!host) {
             throw new app_error_1.default("You are trying to use emailService without setting email configurations. " +
-                "Please configure either arkosConfig.email or environment variables (EMAIL_HOST, EMAIL_USER, EMAIL_PASSWORD)", 500, {
-                docs: "Read more about emailService at https://www.arkosjs.com/docs/core-concepts/sending-emails",
+                "Please configure either arkosConfig.email or environment variables (EMAIL_HOST)", 500, {
+                docs: "Read more about emailService at https://www.arkosjs.com/docs/guides/email-service",
             });
         }
         return {
@@ -43,10 +43,12 @@ class EmailService {
             host,
             port: port || 465,
             secure: secure !== undefined ? secure : true,
-            auth: {
-                user,
-                pass,
-            },
+            auth: user && pass
+                ? {
+                    user,
+                    pass,
+                }
+                : undefined,
             name,
         };
     }
@@ -74,7 +76,11 @@ class EmailService {
         }
         const info = await transporter.sendMail({
             ...options,
-            from: fromAddress,
+            from: fromAddress
+                ? config.name
+                    ? `${config.name}<${fromAddress}>`
+                    : fromAddress
+                : undefined,
             text: options?.text ||
                 (typeof options.html === "string" && options.html
                     ? (0, html_to_text_1.convert)(options.html)

package/dist/cjs/modules/email/email.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"email.service.js","sourceRoot":"","sources":["../../../../src/modules/email/email.service.ts"],"names":[],"mappings":"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","sourcesContent":["import nodemailer, { SendMailOptions, Transporter } from \"nodemailer\";\nimport { convert } from \"html-to-text\";\nimport { getArkosConfig } from \"../../server\";\nimport AppError from \"../error-handler/utils/app-error\";\n\n/**\n * Defines the options for sending an email.\n */\nexport type EmailOptions = {\n  subject: string;\n} & SendMailOptions;\n\n/**\n * Defines the authentication options for SMTP.\n */\nexport type SMTPAuthOptions = {\n  user: string;\n  pass: string;\n};\n\n/**\n * Defines the connection options for SMTP server.\n */\nexport type SMTPConnectionOptions = {\n  host?: string;\n  port?: number;\n  secure?: boolean;\n  auth?: SMTPAuthOptions;\n  name?: string;\n};\n\n/**\n * A service class to handle email-related tasks, including sending emails.\n *\n * See the api reference [www.arkosjs.com/docs/api-reference/the-email-service-class](https://www.arkosjs.com/docs/api-reference/the-email-service-class)\n */\nexport class EmailService {\n  transporter: Transporter | null = null;\n  private customConfig: SMTPConnectionOptions | null = null;\n\n  /**\n   * Creates an instance of the EmailService class.\n   *\n   * @param {SMTPConnectionOptions} [config] - Optional custom SMTP configuration.\n   * If provided, these settings will be used instead of the Arkos config.\n   */\n  constructor(config?: SMTPConnectionOptions) {\n    if (config) {\n      this.customConfig = config;\n    }\n  }\n\n  /**\n   * Gets the email configuration from multiple sources with priority:\n   * 1. Constructor customConfig\n   * 2. ArkosConfig\n   * 3. Environment variables\n   * @returns Configuration object with host, port, and auth details\n   * @throws AppError if required email configuration is not set\n   */\n  private getEmailConfig(): SMTPConnectionOptions {\n    if (this.customConfig) {\n      return this.customConfig;\n    }\n\n    const { email: emailConfigs } = getArkosConfig();\n    const host = emailConfigs?.host || process.env.EMAIL_HOST;\n    const port =\n      emailConfigs?.port ||\n      (process.env.EMAIL_PORT ? parseInt(process.env.EMAIL_PORT) : undefined);\n    const secure =\n      emailConfigs?.secure !== undefined\n        ? emailConfigs.secure\n        : process.env.EMAIL_SECURE\n          ? process.env.EMAIL_SECURE === \"true\"\n          : undefined;\n    const user = emailConfigs?.auth?.user || process.env.EMAIL_USER;\n    const pass = emailConfigs?.auth?.pass || process.env.EMAIL_PASSWORD;\n    const name = emailConfigs?.name || process.env.EMAIL_NAME;\n\n    if (!host || !user || !pass) {\n      throw new AppError(\n        \"You are trying to use emailService without setting email configurations. \" +\n          \"Please configure either arkosConfig.email or environment variables (EMAIL_HOST, EMAIL_USER, EMAIL_PASSWORD)\",\n        500,\n        {\n          docs: \"Read more about emailService at https://www.arkosjs.com/docs/core-concepts/sending-emails\",\n        }\n      );\n    }\n\n    return {\n      ...emailConfigs,\n      host,\n      port: port || 465,\n      secure: secure !== undefined ? secure : true,\n      auth: {\n        user,\n        pass,\n      },\n      name,\n    };\n  }\n\n  /**\n   * Gets or creates a transporter using the email configuration\n   * @param customConfig Optional override connection settings (takes full priority if provided)\n   * @returns A configured nodemailer transporter\n   */\n  private getTransporter(customConfig?: SMTPConnectionOptions): Transporter {\n    if (customConfig) {\n      const { name, ...config } = customConfig;\n      return nodemailer.createTransport(config);\n    }\n\n    if (!this.transporter) {\n      const { name, ...config } = this.getEmailConfig() || {};\n      this.transporter = nodemailer.createTransport(config);\n    }\n    return this.transporter;\n  }\n\n  /**\n   * Sends an email with the provided options.\n   * Can use either the default configuration or custom connection options.\n   *\n   * @param {EmailOptions} options - The options for the email to be sent.\n   * @param {SMTPConnectionOptions} [connectionOptions] - Optional custom connection settings.\n   * @param {boolean} [skipVerification=false] - Whether to skip connection verification.\n   * @returns {Promise<{ success: boolean; messageId?: string } & Record<string, any>>} Result with message ID on success.\n   */\n  public async send(\n    options: EmailOptions & SendMailOptions,\n    connectionOptions?: SMTPConnectionOptions,\n    skipVerification: boolean = true\n  ): Promise<{ success: boolean; messageId?: string } & Record<string, any>> {\n    const config = this.getEmailConfig();\n    const transporter = connectionOptions\n      ? this.getTransporter(connectionOptions)\n      : this.getTransporter();\n\n    const fromAddress =\n      options.from || connectionOptions?.auth?.user || config.auth?.user;\n\n    if (connectionOptions || !skipVerification) {\n      const isConnected = await this.verifyConnection(transporter);\n      if (!isConnected) throw new Error(\"Failed to connect to email server\");\n    }\n\n    const info = await transporter.sendMail({\n      ...options,\n      from: fromAddress,\n      text:\n        options?.text ||\n        (typeof options.html === \"string\" && options.html\n          ? convert(options.html as string)\n          : undefined),\n    });\n\n    return { success: true, ...info };\n  }\n\n  /**\n   * Verifies the connection to the email server.\n   * @param {Transporter} [transporterToVerify] - Optional transporter to verify.\n   * @returns {Promise<boolean>} A promise that resolves to true if connection is valid.\n   */\n  public async verifyConnection(\n    transporterToVerify?: Transporter\n  ): Promise<boolean> {\n    try {\n      const transporter = transporterToVerify || this.getTransporter();\n      await transporter.verify();\n      return true;\n    } catch (error) {\n      console.error(\"Email Server Connection Failed\", error);\n      return false;\n    }\n  }\n\n  /**\n   * Updates the custom configuration for this email service instance.\n   * @param {SMTPConnectionOptions} config - The new connection options.\n   */\n  public updateConfig(config: SMTPConnectionOptions): void {\n    this.customConfig = config;\n    this.transporter = null; // Reset transporter so it will be recreated with new config\n  }\n\n  /**\n   * Creates a new instance of EmailService with custom configuration.\n   * @param {SMTPConnectionOptions} config - The connection options for the new instance.\n   * @returns {EmailService} A new EmailService instance.\n   */\n  public static create(config: SMTPConnectionOptions): EmailService {\n    return new EmailService(config);\n  }\n}\n\nconst emailService = new EmailService();\n\nexport default emailService;\n"]}
+{"version":3,"file":"email.service.js","sourceRoot":"","sources":["../../../../src/modules/email/email.service.ts"],"names":[],"mappings":"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","sourcesContent":["import nodemailer, { SendMailOptions, Transporter } from \"nodemailer\";\nimport { convert } from \"html-to-text\";\nimport { getArkosConfig } from \"../../server\";\nimport AppError from \"../error-handler/utils/app-error\";\n\n/**\n * Defines the options for sending an email.\n */\nexport type EmailOptions = {\n  subject: string;\n} & SendMailOptions;\n\n/**\n * Defines the authentication options for SMTP.\n */\nexport type SMTPAuthOptions = {\n  user: string;\n  pass: string;\n};\n\n/**\n * Defines the connection options for SMTP server.\n */\nexport type SMTPConnectionOptions = {\n  host?: string;\n  port?: number;\n  secure?: boolean;\n  auth?: SMTPAuthOptions;\n  name?: string;\n};\n\n/**\n * A service class to handle email-related tasks, including sending emails.\n *\n * See the api reference [www.arkosjs.com/docs/api-reference/the-email-service-class](https://www.arkosjs.com/docs/api-reference/the-email-service-class)\n */\nexport class EmailService {\n  transporter: Transporter | null = null;\n  private customConfig: SMTPConnectionOptions | null = null;\n\n  /**\n   * Creates an instance of the EmailService class.\n   *\n   * @param {SMTPConnectionOptions} [config] - Optional custom SMTP configuration.\n   * If provided, these settings will be used instead of the Arkos config.\n   */\n  constructor(config?: SMTPConnectionOptions) {\n    if (config) {\n      this.customConfig = config;\n    }\n  }\n\n  /**\n   * Gets the email configuration from multiple sources with priority:\n   * 1. Constructor customConfig\n   * 2. ArkosConfig\n   * 3. Environment variables\n   * @returns Configuration object with host, port, and auth details\n   * @throws AppError if required email configuration is not set\n   */\n  private getEmailConfig(): SMTPConnectionOptions {\n    if (this.customConfig) {\n      return this.customConfig;\n    }\n\n    const { email: emailConfigs } = getArkosConfig();\n    const host = emailConfigs?.host || process.env.EMAIL_HOST;\n    const port =\n      emailConfigs?.port ||\n      (process.env.EMAIL_PORT ? parseInt(process.env.EMAIL_PORT) : undefined);\n    const secure =\n      emailConfigs?.secure !== undefined\n        ? emailConfigs.secure\n        : process.env.EMAIL_SECURE\n          ? process.env.EMAIL_SECURE === \"true\"\n          : undefined;\n    const user = emailConfigs?.auth?.user || process.env.EMAIL_USER;\n    const pass = emailConfigs?.auth?.pass || process.env.EMAIL_PASSWORD;\n    const name = emailConfigs?.name || process.env.EMAIL_NAME;\n\n    if (!host) {\n      throw new AppError(\n        \"You are trying to use emailService without setting email configurations. \" +\n          \"Please configure either arkosConfig.email or environment variables (EMAIL_HOST)\",\n        500,\n        {\n          docs: \"Read more about emailService at https://www.arkosjs.com/docs/guides/email-service\",\n        }\n      );\n    }\n\n    return {\n      ...emailConfigs,\n      host,\n      port: port || 465,\n      secure: secure !== undefined ? secure : true,\n      auth:\n        user && pass\n          ? {\n              user,\n              pass,\n            }\n          : undefined,\n      name,\n    };\n  }\n\n  /**\n   * Gets or creates a transporter using the email configuration\n   * @param customConfig Optional override connection settings (takes full priority if provided)\n   * @returns A configured nodemailer transporter\n   */\n  private getTransporter(customConfig?: SMTPConnectionOptions): Transporter {\n    if (customConfig) {\n      const { name, ...config } = customConfig;\n      return nodemailer.createTransport(config);\n    }\n\n    if (!this.transporter) {\n      const { name, ...config } = this.getEmailConfig() || {};\n      this.transporter = nodemailer.createTransport(config);\n    }\n    return this.transporter;\n  }\n\n  /**\n   * Sends an email with the provided options.\n   * Can use either the default configuration or custom connection options.\n   *\n   * @param {EmailOptions} options - The options for the email to be sent.\n   * @param {SMTPConnectionOptions} [connectionOptions] - Optional custom connection settings.\n   * @param {boolean} [skipVerification=false] - Whether to skip connection verification.\n   * @returns {Promise<{ success: boolean; messageId?: string } & Record<string, any>>} Result with message ID on success.\n   */\n  public async send(\n    options: EmailOptions & SendMailOptions,\n    connectionOptions?: SMTPConnectionOptions,\n    skipVerification: boolean = true\n  ): Promise<{ success: boolean; messageId?: string } & Record<string, any>> {\n    const config = this.getEmailConfig();\n    const transporter = connectionOptions\n      ? this.getTransporter(connectionOptions)\n      : this.getTransporter();\n\n    const fromAddress =\n      options.from || connectionOptions?.auth?.user || config.auth?.user;\n\n    if (connectionOptions || !skipVerification) {\n      const isConnected = await this.verifyConnection(transporter);\n      if (!isConnected) throw new Error(\"Failed to connect to email server\");\n    }\n\n    const info = await transporter.sendMail({\n      ...options,\n      from: fromAddress\n        ? config.name\n          ? `${config.name}<${fromAddress}>`\n          : fromAddress\n        : undefined,\n      text:\n        options?.text ||\n        (typeof options.html === \"string\" && options.html\n          ? convert(options.html as string)\n          : undefined),\n    });\n\n    return { success: true, ...info };\n  }\n\n  /**\n   * Verifies the connection to the email server.\n   * @param {Transporter} [transporterToVerify] - Optional transporter to verify.\n   * @returns {Promise<boolean>} A promise that resolves to true if connection is valid.\n   */\n  public async verifyConnection(\n    transporterToVerify?: Transporter\n  ): Promise<boolean> {\n    try {\n      const transporter = transporterToVerify || this.getTransporter();\n      await transporter.verify();\n      return true;\n    } catch (error) {\n      console.error(\"Email Server Connection Failed\", error);\n      return false;\n    }\n  }\n\n  /**\n   * Updates the custom configuration for this email service instance.\n   * @param {SMTPConnectionOptions} config - The new connection options.\n   */\n  public updateConfig(config: SMTPConnectionOptions): void {\n    this.customConfig = config;\n    this.transporter = null; // Reset transporter so it will be recreated with new config\n  }\n\n  /**\n   * Creates a new instance of EmailService with custom configuration.\n   * @param {SMTPConnectionOptions} config - The connection options for the new instance.\n   * @returns {EmailService} A new EmailService instance.\n   */\n  public static create(config: SMTPConnectionOptions): EmailService {\n    return new EmailService(config);\n  }\n}\n\nconst emailService = new EmailService();\n\nexport default emailService;\n"]}

package/dist/cjs/modules/error-handler/error-handler.controller.js

@@ -42,8 +42,8 @@ const server_1 = require("../../server.js");
 const multer_error_handler_1 = __importDefault(require("./utils/multer-error-handler.js"));
 function errorHandler(err, req, res, _) {
     console.error("[\x1b[31mError\x1b[0m]:", err);
-    err.statusCode = err.statusCode || 500;
-    err.status = err.status || "error";
+    err.statusCode = err.isOperational ? err.statusCode : 500;
+    err.status = err.isOperational ? err.status : "error";
     let error = {
         ...err,
         message: err.message,
@@ -146,7 +146,8 @@ function sendProductionError(err, _, res) {
         });
 }
 process.on("SIGTERM", () => {
-    if (process.env.ARKOS_BUILD !== "true") {
+    if (process.env.ARKOS_BUILD !== "true" ||
+        process.env.__SKIP_LISTEN === "true") {
         process.exit();
     }
     else {

package/dist/cjs/modules/error-handler/error-handler.controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"error-handler.controller.js","sourceRoot":"","sources":["../../../../src/modules/error-handler/error-handler.controller.ts"],"names":[],"mappings":"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","sourcesContent":["import { NextFunction, Request, Response } from \"express\";\nimport AppError from \"./utils/app-error\";\nimport * as errorControllerHelper from \"./utils/error-handler.helpers\";\nimport { server } from \"../../server\";\nimport multerErrorHandler from \"./utils/multer-error-handler\";\nimport { MulterError } from \"multer\";\n\n/**\n * Error handling middleware for Express.\n *\n * This middleware function handles all errors in the Express application.\n * It checks for the environment (development or production) and sends appropriate error responses\n * based on whether the environment is production or not. It also maps specific errors such as\n * JWT errors, Prisma client errors, and database-related errors to specific helper functions for handling.\n *\n * @param {AppError} err - The error object thrown by the application.\n * @param {Request} req - The Express request object.\n * @param {Response} res - The Express response object.\n * @param {NextFunction} _ - The next middleware function in the chain.\n *\n * @returns {void} - Sends the response with the error details to the client.\n */\nexport default function errorHandler(\n  err: AppError,\n  req: Request,\n  res: Response,\n  _: NextFunction\n): void {\n  console.error(\"[\\x1b[31mError\\x1b[0m]:\", err);\n\n  err.statusCode = err.statusCode || 500;\n  err.status = err.status || \"error\";\n\n  let error: any = {\n    ...err,\n    message: err.message,\n    stack: err?.stack || undefined,\n  };\n\n  if (process.env.ARKOS_BUILD === \"true\") delete error?.stack;\n\n  switch (err.name) {\n    case \"JsonWebTokenError\":\n      error = errorControllerHelper.handleJWTError();\n      break;\n    case \"TokenExpiredError\":\n      error = errorControllerHelper.handleJWTExpired();\n      break;\n    case \"PrismaClientValidationError\":\n      error = errorControllerHelper.handlePrismaClientValidationError(err);\n      break;\n    case \"PrismaClientInitializationError\":\n      error = errorControllerHelper.handlePrismaClientInitializationError(err);\n      break;\n    case \"MulterError\":\n      error = multerErrorHandler.handle(err as unknown as MulterError);\n      break;\n  }\n\n  switch (err.code) {\n    case \"P1000\":\n      error = errorControllerHelper.handleAuthenticationError(err);\n      break;\n    case \"P1001\":\n      error = errorControllerHelper.handleServerNotReachableError(err);\n      break;\n    case \"P1002\":\n      error = errorControllerHelper.handleConnectionTimeoutError(err);\n      break;\n    case \"P1003\":\n      error = errorControllerHelper.handleDatabaseNotFoundError(err);\n      break;\n    case \"P2000\":\n      error = errorControllerHelper.handleFieldValueTooLargeError(err);\n      break;\n    case \"P2001\":\n      error = errorControllerHelper.handleRecordNotFoundError(err);\n      break;\n    case \"P2002\":\n      error = errorControllerHelper.handleUniqueConstraintError(err);\n      break;\n    case \"P2003\":\n      error = errorControllerHelper.handleForeignKeyConstraintError(err);\n      break;\n    case \"P2004\":\n      error = errorControllerHelper.handleConstraintFailedError(err);\n      break;\n    case \"P2025\":\n      error = errorControllerHelper.handleNonExistingRecord(err);\n      break;\n    case \"P3000\":\n      error = errorControllerHelper.handleSchemaCreationFailedError(err);\n      break;\n    case \"P3001\":\n      error = errorControllerHelper.handleMigrationAlreadyAppliedError(err);\n      break;\n    case \"P3002\":\n      error = errorControllerHelper.handleMigrationScriptFailedError(err);\n      break;\n    case \"P3003\":\n      error = errorControllerHelper.handleVersionMismatchError(err);\n      break;\n  }\n\n  const { message, ...rest } = error;\n  if (process.env.ARKOS_BUILD !== \"true\")\n    return sendDevelopmentError(\n      {\n        message: error.message,\n        ...rest,\n        stack: err.stack,\n        originalError: err,\n      },\n      req,\n      res\n    );\n\n  sendProductionError({ message, ...rest }, req, res);\n}\n\n/**\n * Sends a detailed error response in development mode.\n *\n * In development, the error response includes full error details, including\n * the stack trace and the complete error message.\n *\n * @param {AppError} err - The error object.\n * @param {Request} _ - The Express request object.\n * @param {Response} res - The Express response object.\n *\n * @returns {void} - Sends the response with the error details to the client.\n */\nfunction sendDevelopmentError(err: any, _: Request, res: Response): void {\n  res.status(err.statusCode).json({\n    ...err,\n    message: err.message?.split?.(\"\\n\")[err.message?.split?.(\"\\n\").length - 1],\n    stack: err?.originalError?.stack?.split?.(\"\\n\"),\n  });\n}\n\n/**\n * Sends a generic error response in production mode.\n *\n * In production, sensitive error details (such as stack traces) are not exposed\n * to the client. Only operational errors are shown with a generic message.\n *\n * @param {AppError} err - The error object.\n * @param {Request} _ - The Express request object.\n * @param {Response} res - The Express response object.\n *\n * @returns {void} - Sends the response with the error details to the client.\n */\nfunction sendProductionError(err: AppError, _: Request, res: Response): void {\n  if (err.isOperational)\n    res.status(err.statusCode).json({\n      status: err.status,\n      message: err.message,\n      meta: err.meta || {},\n      code: err.code || \"Unknown\",\n    });\n  else\n    res.status(500).json({\n      status: \"error\",\n      message: \"Internal server error, please try again later.\",\n      code: \"InternalServerError\",\n      meta: {},\n    });\n}\n\n/**\n * Gracefully handles process termination by listening for SIGTERM signal.\n *\n * - In production and staging environments, it will log a shutdown message\n *   and attempt to close the server gracefully.\n * - In development or non-production environments, it will immediately exit the process.\n *\n * @returns {void}\n */\nprocess.on(\"SIGTERM\", () => {\n  if (process.env.ARKOS_BUILD !== \"true\") {\n    process.exit();\n  } else {\n    console.error(\"SIGTERM RECEIVED in Production. Shutting down gracefully!\");\n\n    server.close(() => {\n      console.error(\"Process terminated!!!\");\n      process.exit();\n    });\n  }\n});\n"]}
+{"version":3,"file":"error-handler.controller.js","sourceRoot":"","sources":["../../../../src/modules/error-handler/error-handler.controller.ts"],"names":[],"mappings":"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","sourcesContent":["import { NextFunction, Request, Response } from \"express\";\nimport AppError from \"./utils/app-error\";\nimport * as errorControllerHelper from \"./utils/error-handler.helpers\";\nimport { server } from \"../../server\";\nimport multerErrorHandler from \"./utils/multer-error-handler\";\nimport { MulterError } from \"multer\";\n\n/**\n * Error handling middleware for Express.\n *\n * This middleware function handles all errors in the Express application.\n * It checks for the environment (development or production) and sends appropriate error responses\n * based on whether the environment is production or not. It also maps specific errors such as\n * JWT errors, Prisma client errors, and database-related errors to specific helper functions for handling.\n *\n * @param {AppError} err - The error object thrown by the application.\n * @param {Request} req - The Express request object.\n * @param {Response} res - The Express response object.\n * @param {NextFunction} _ - The next middleware function in the chain.\n *\n * @returns {void} - Sends the response with the error details to the client.\n */\nexport default function errorHandler(\n  err: AppError,\n  req: Request,\n  res: Response,\n  _: NextFunction\n): void {\n  console.error(\"[\\x1b[31mError\\x1b[0m]:\", err);\n\n  err.statusCode = err.isOperational ? err.statusCode : 500;\n  err.status = err.isOperational ? err.status : \"error\";\n\n  let error: any = {\n    ...err,\n    message: err.message,\n    stack: err?.stack || undefined,\n  };\n\n  if (process.env.ARKOS_BUILD === \"true\") delete error?.stack;\n\n  switch (err.name) {\n    case \"JsonWebTokenError\":\n      error = errorControllerHelper.handleJWTError();\n      break;\n    case \"TokenExpiredError\":\n      error = errorControllerHelper.handleJWTExpired();\n      break;\n    case \"PrismaClientValidationError\":\n      error = errorControllerHelper.handlePrismaClientValidationError(err);\n      break;\n    case \"PrismaClientInitializationError\":\n      error = errorControllerHelper.handlePrismaClientInitializationError(err);\n      break;\n    case \"MulterError\":\n      error = multerErrorHandler.handle(err as unknown as MulterError);\n      break;\n  }\n\n  switch (err.code) {\n    case \"P1000\":\n      error = errorControllerHelper.handleAuthenticationError(err);\n      break;\n    case \"P1001\":\n      error = errorControllerHelper.handleServerNotReachableError(err);\n      break;\n    case \"P1002\":\n      error = errorControllerHelper.handleConnectionTimeoutError(err);\n      break;\n    case \"P1003\":\n      error = errorControllerHelper.handleDatabaseNotFoundError(err);\n      break;\n    case \"P2000\":\n      error = errorControllerHelper.handleFieldValueTooLargeError(err);\n      break;\n    case \"P2001\":\n      error = errorControllerHelper.handleRecordNotFoundError(err);\n      break;\n    case \"P2002\":\n      error = errorControllerHelper.handleUniqueConstraintError(err);\n      break;\n    case \"P2003\":\n      error = errorControllerHelper.handleForeignKeyConstraintError(err);\n      break;\n    case \"P2004\":\n      error = errorControllerHelper.handleConstraintFailedError(err);\n      break;\n    case \"P2025\":\n      error = errorControllerHelper.handleNonExistingRecord(err);\n      break;\n    case \"P3000\":\n      error = errorControllerHelper.handleSchemaCreationFailedError(err);\n      break;\n    case \"P3001\":\n      error = errorControllerHelper.handleMigrationAlreadyAppliedError(err);\n      break;\n    case \"P3002\":\n      error = errorControllerHelper.handleMigrationScriptFailedError(err);\n      break;\n    case \"P3003\":\n      error = errorControllerHelper.handleVersionMismatchError(err);\n      break;\n  }\n\n  const { message, ...rest } = error;\n  if (process.env.ARKOS_BUILD !== \"true\")\n    return sendDevelopmentError(\n      {\n        message: error.message,\n        ...rest,\n        stack: err.stack,\n        originalError: err,\n      },\n      req,\n      res\n    );\n\n  sendProductionError({ message, ...rest }, req, res);\n}\n\n/**\n * Sends a detailed error response in development mode.\n *\n * In development, the error response includes full error details, including\n * the stack trace and the complete error message.\n *\n * @param {AppError} err - The error object.\n * @param {Request} _ - The Express request object.\n * @param {Response} res - The Express response object.\n *\n * @returns {void} - Sends the response with the error details to the client.\n */\nfunction sendDevelopmentError(err: any, _: Request, res: Response): void {\n  res.status(err.statusCode).json({\n    ...err,\n    message: err.message?.split?.(\"\\n\")[err.message?.split?.(\"\\n\").length - 1],\n    stack: err?.originalError?.stack?.split?.(\"\\n\"),\n  });\n}\n\n/**\n * Sends a generic error response in production mode.\n *\n * In production, sensitive error details (such as stack traces) are not exposed\n * to the client. Only operational errors are shown with a generic message.\n *\n * @param {AppError} err - The error object.\n * @param {Request} _ - The Express request object.\n * @param {Response} res - The Express response object.\n *\n * @returns {void} - Sends the response with the error details to the client.\n */\nfunction sendProductionError(err: AppError, _: Request, res: Response): void {\n  if (err.isOperational)\n    res.status(err.statusCode).json({\n      status: err.status,\n      message: err.message,\n      meta: err.meta || {},\n      code: err.code || \"Unknown\",\n    });\n  else\n    res.status(500).json({\n      status: \"error\",\n      message: \"Internal server error, please try again later.\",\n      code: \"InternalServerError\",\n      meta: {},\n    });\n}\n\n/**\n * Gracefully handles process termination by listening for SIGTERM signal.\n *\n * - In production and staging environments, it will log a shutdown message\n *   and attempt to close the server gracefully.\n * - In development or non-production environments, it will immediately exit the process.\n *\n * @returns {void}\n */\nprocess.on(\"SIGTERM\", () => {\n  if (\n    process.env.ARKOS_BUILD !== \"true\" ||\n    process.env.__SKIP_LISTEN === \"true\"\n  ) {\n    process.exit();\n  } else {\n    console.error(\"SIGTERM RECEIVED in Production. Shutting down gracefully!\");\n\n    server.close(() => {\n      console.error(\"Process terminated!!!\");\n      process.exit();\n    });\n  }\n});\n"]}

package/dist/cjs/modules/file-upload/file-upload.router.js

@@ -18,6 +18,7 @@ const fs_helpers_1 = require("../../utils/helpers/fs.helpers.js");
 const path_1 = __importDefault(require("path"));
 const arkos_router_1 = __importDefault(require("../../utils/arkos-router/index.js"));
 const file_upload_json_schema_generator_1 = __importDefault(require("./utils/file-upload-json-schema-generator.js"));
+const app_error_1 = __importDefault(require("../error-handler/utils/app-error.js"));
 function getFileUploadRouter(arkosConfig) {
     const router = (0, arkos_router_1.default)();
     const { fileUpload } = arkosConfig;
@@ -74,10 +75,16 @@ function getFileUploadRouter(arkosConfig) {
             etag: true,
             lastModified: true,
             dotfiles: "ignore",
-            fallthrough: true,
+            fallthrough: false,
             index: false,
             cacheControl: true,
-        }, fileUpload?.expressStatic || {})), ...(0, routers_helpers_1.processMiddleware)(interceptors?.onFindFileError, { type: "error" }));
+        }, fileUpload?.expressStatic || {})), (err, req, _res, next) => {
+            if (err.code === "ENOENT") {
+                const filepath = req.path.replace(`/api/${arkosConfig.fileUpload?.baseRoute}`.replace("//", "/"), "");
+                throw new app_error_1.default(`File ${filepath} was not found`, 404, "FileNotFound", { filepath });
+            }
+            next(err);
+        }, ...(0, routers_helpers_1.processMiddleware)(interceptors?.onFindFileError, { type: "error" }));
     }
     if (!(0, base_router_helpers_1.isEndpointDisabled)(routerConfig, "uploadFile")) {
         router.post((0, routers_helpers_1.createRouteConfig)(arkosConfig, "uploadFile", baseRoutePrefix, `:fileType`, routerConfig, "file-upload", authConfigs), ...(0, routers_helpers_1.processMiddleware)(interceptors?.beforeUploadFile), file_upload_controller_1.default.uploadFile, ...(0, routers_helpers_1.processMiddleware)(interceptors?.afterUploadFile), base_middlewares_1.sendResponse, ...(0, routers_helpers_1.processMiddleware)(interceptors?.onUploadFileError, { type: "error" }));

package/dist/cjs/modules/file-upload/file-upload.router.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-upload.router.js","sourceRoot":"","sources":["../../../../src/modules/file-upload/file-upload.router.ts"],"names":[],"mappings":"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","sourcesContent":["import { Router } from \"express\";\nimport { getModuleComponents } from \"../../utils/dynamic-loader\";\nimport fileUploadController from \"./file-upload.controller\";\nimport express from \"express\";\nimport deepmerge from \"../../utils/helpers/deepmerge.helper\";\nimport { AuthConfigs } from \"../../types/auth\";\nimport { sendResponse } from \"../base/base.middlewares\";\nimport {\n  createRouteConfig,\n  processMiddleware,\n} from \"../../utils/helpers/routers.helpers\";\nimport { adjustRequestUrl } from \"./utils/helpers/file-upload.helpers\";\nimport { isEndpointDisabled } from \"../base/utils/helpers/base.router.helpers\";\nimport debuggerService from \"../debugger/debugger.service\";\nimport routerValidator from \"../base/utils/router-validator\";\nimport { getUserFileExtension } from \"../../utils/helpers/fs.helpers\";\nimport { ArkosConfig } from \"../../exports\";\nimport path from \"path\";\nimport ArkosRouter from \"../../utils/arkos-router\";\nimport { FileUploadRouterEndpoint } from \"../../types/router-config\";\nimport fileUploadJsonSchemaGenerator from \"./utils/file-upload-json-schema-generator\";\n\nexport function getFileUploadRouter(arkosConfig: ArkosConfig) {\n  const router = ArkosRouter();\n  const { fileUpload } = arkosConfig;\n\n  if (!fileUpload?.enabled === false) return router;\n\n  const moduleComponents = getModuleComponents(\"file-upload\");\n  let {\n    interceptors = {} as any,\n    authConfigs = {} as AuthConfigs,\n    router: customRouterModule,\n  }: any = {};\n\n  if (moduleComponents)\n    ({\n      interceptors = {},\n      authConfigs = {},\n      router: customRouterModule,\n    } = moduleComponents);\n\n  const routerConfig = customRouterModule?.config || {};\n  if (routerConfig?.disable === true) return router;\n\n  const customRouter = customRouterModule?.default as Router;\n  let basePathname = fileUpload?.baseRoute || \"/api/uploads/\";\n\n  if (!basePathname.startsWith(\"/\")) basePathname = \"/\" + basePathname;\n  if (!basePathname.endsWith(\"/\")) basePathname = basePathname + \"/\";\n\n  // Strip leading slash so createRouteConfig can prepend its own \"/\"\n  // e.g. \"/api/uploads/\" → \"api/uploads/\" → createRouteConfig builds \"/api/uploads/*\"\n  const baseRoutePrefix = basePathname.slice(1);\n\n  if (customRouter && customRouterModule) {\n    if (routerValidator.isExpressRouter(customRouter))\n      router.use(basePathname, customRouter);\n    else\n      throw Error(\n        `ValidationError: The exported router from file-upload.router.${getUserFileExtension()} is not a valid express or arkos Router.`\n      );\n  }\n\n  const endpoints: FileUploadRouterEndpoint[] = [\n    \"findFile\",\n    \"uploadFile\",\n    \"updateFile\",\n    \"deleteFile\",\n  ];\n\n  for (const endpoint of endpoints) {\n    const endpointConfig = routerConfig[endpoint];\n    if (endpointConfig?.experimental?.openapi === false) continue;\n    routerConfig[endpoint] = {\n      ...(endpointConfig || {}),\n      experimental: {\n        ...(endpointConfig?.experimental || {}),\n        openapi: fileUploadJsonSchemaGenerator.getOpenApiConfig(\n          endpointConfig,\n          endpoint\n        ),\n      },\n    };\n  }\n\n  if (!isEndpointDisabled(routerConfig, \"findFile\")) {\n    const baseUploadDirFullPath = path.resolve(\n      path\n        .join(process.cwd(), fileUpload?.baseUploadDir || \"uploads\")\n        .replaceAll(\"//\", \"/\")\n    );\n    router.get(\n      createRouteConfig(\n        arkosConfig,\n        \"findFile\",\n        baseRoutePrefix,\n        `*`,\n        routerConfig,\n        \"file-upload\",\n        authConfigs\n      ),\n      ...processMiddleware(interceptors?.beforeFindFile),\n      adjustRequestUrl,\n      express.static(\n        baseUploadDirFullPath,\n        deepmerge(\n          {\n            maxAge: \"1y\",\n            etag: true,\n            lastModified: true,\n            dotfiles: \"ignore\",\n            fallthrough: true,\n            index: false,\n            cacheControl: true,\n          },\n          fileUpload?.expressStatic || {}\n        )\n      ),\n      ...processMiddleware(interceptors?.onFindFileError, { type: \"error\" })\n    );\n  }\n\n  if (!isEndpointDisabled(routerConfig, \"uploadFile\")) {\n    router.post(\n      createRouteConfig(\n        arkosConfig,\n        \"uploadFile\",\n        baseRoutePrefix,\n        `:fileType`,\n        routerConfig,\n        \"file-upload\",\n        authConfigs\n      ),\n      ...processMiddleware(interceptors?.beforeUploadFile),\n      fileUploadController.uploadFile,\n      ...processMiddleware(interceptors?.afterUploadFile),\n      sendResponse,\n      ...processMiddleware(interceptors?.onUploadFileError, { type: \"error\" })\n    );\n  }\n\n  if (!isEndpointDisabled(routerConfig, \"updateFile\")) {\n    router.patch(\n      createRouteConfig(\n        arkosConfig,\n        \"updateFile\",\n        baseRoutePrefix,\n        `:fileType/:fileName`,\n        routerConfig,\n        \"file-upload\",\n        authConfigs\n      ),\n      ...processMiddleware(interceptors?.beforeUpdateFile),\n      fileUploadController.updateFile,\n      ...processMiddleware(interceptors?.afterUpdateFile),\n      sendResponse,\n      ...processMiddleware(interceptors?.onUpdateFileError, { type: \"error\" })\n    );\n  }\n\n  if (!isEndpointDisabled(routerConfig, \"deleteFile\")) {\n    router.delete(\n      createRouteConfig(\n        arkosConfig,\n        \"deleteFile\",\n        baseRoutePrefix,\n        `:fileType/:fileName`,\n        routerConfig,\n        \"file-upload\",\n        authConfigs\n      ),\n      ...processMiddleware(interceptors?.beforeDeleteFile),\n      fileUploadController.deleteFile,\n      ...processMiddleware(interceptors?.afterDeleteFile),\n      sendResponse,\n      ...processMiddleware(interceptors?.onDeleteFileError, { type: \"error\" })\n    );\n  }\n\n  debuggerService.logModuleFinalRouter(\"file-upload\", router);\n  return router;\n}\n"]}
+{"version":3,"file":"file-upload.router.js","sourceRoot":"","sources":["../../../../src/modules/file-upload/file-upload.router.ts"],"names":[],"mappings":"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","sourcesContent":["import { Router } from \"express\";\nimport { getModuleComponents } from \"../../utils/dynamic-loader\";\nimport fileUploadController from \"./file-upload.controller\";\nimport express from \"express\";\nimport deepmerge from \"../../utils/helpers/deepmerge.helper\";\nimport { AuthConfigs } from \"../../types/auth\";\nimport { sendResponse } from \"../base/base.middlewares\";\nimport {\n  createRouteConfig,\n  processMiddleware,\n} from \"../../utils/helpers/routers.helpers\";\nimport { adjustRequestUrl } from \"./utils/helpers/file-upload.helpers\";\nimport { isEndpointDisabled } from \"../base/utils/helpers/base.router.helpers\";\nimport debuggerService from \"../debugger/debugger.service\";\nimport routerValidator from \"../base/utils/router-validator\";\nimport { getUserFileExtension } from \"../../utils/helpers/fs.helpers\";\nimport {\n  ArkosConfig,\n  ArkosNextFunction,\n  ArkosRequest,\n  ArkosResponse,\n} from \"../../exports\";\nimport path from \"path\";\nimport ArkosRouter from \"../../utils/arkos-router\";\nimport { FileUploadRouterEndpoint } from \"../../types/router-config\";\nimport fileUploadJsonSchemaGenerator from \"./utils/file-upload-json-schema-generator\";\nimport AppError from \"../error-handler/utils/app-error\";\n\nexport function getFileUploadRouter(arkosConfig: ArkosConfig) {\n  const router = ArkosRouter();\n  const { fileUpload } = arkosConfig;\n\n  if (!fileUpload?.enabled === false) return router;\n\n  const moduleComponents = getModuleComponents(\"file-upload\");\n  let {\n    interceptors = {} as any,\n    authConfigs = {} as AuthConfigs,\n    router: customRouterModule,\n  }: any = {};\n\n  if (moduleComponents)\n    ({\n      interceptors = {},\n      authConfigs = {},\n      router: customRouterModule,\n    } = moduleComponents);\n\n  const routerConfig = customRouterModule?.config || {};\n  if (routerConfig?.disable === true) return router;\n\n  const customRouter = customRouterModule?.default as Router;\n  let basePathname = fileUpload?.baseRoute || \"/api/uploads/\";\n\n  if (!basePathname.startsWith(\"/\")) basePathname = \"/\" + basePathname;\n  if (!basePathname.endsWith(\"/\")) basePathname = basePathname + \"/\";\n\n  // Strip leading slash so createRouteConfig can prepend its own \"/\"\n  // e.g. \"/api/uploads/\" → \"api/uploads/\" → createRouteConfig builds \"/api/uploads/*\"\n  const baseRoutePrefix = basePathname.slice(1);\n\n  if (customRouter && customRouterModule) {\n    if (routerValidator.isExpressRouter(customRouter))\n      router.use(basePathname, customRouter);\n    else\n      throw Error(\n        `ValidationError: The exported router from file-upload.router.${getUserFileExtension()} is not a valid express or arkos Router.`\n      );\n  }\n\n  const endpoints: FileUploadRouterEndpoint[] = [\n    \"findFile\",\n    \"uploadFile\",\n    \"updateFile\",\n    \"deleteFile\",\n  ];\n\n  for (const endpoint of endpoints) {\n    const endpointConfig = routerConfig[endpoint];\n    if (endpointConfig?.experimental?.openapi === false) continue;\n    routerConfig[endpoint] = {\n      ...(endpointConfig || {}),\n      experimental: {\n        ...(endpointConfig?.experimental || {}),\n        openapi: fileUploadJsonSchemaGenerator.getOpenApiConfig(\n          endpointConfig,\n          endpoint\n        ),\n      },\n    };\n  }\n\n  if (!isEndpointDisabled(routerConfig, \"findFile\")) {\n    const baseUploadDirFullPath = path.resolve(\n      path\n        .join(process.cwd(), fileUpload?.baseUploadDir || \"uploads\")\n        .replaceAll(\"//\", \"/\")\n    );\n    router.get(\n      createRouteConfig(\n        arkosConfig,\n        \"findFile\",\n        baseRoutePrefix,\n        `*`,\n        routerConfig,\n        \"file-upload\",\n        authConfigs\n      ),\n      ...processMiddleware(interceptors?.beforeFindFile),\n      adjustRequestUrl,\n      express.static(\n        baseUploadDirFullPath,\n        deepmerge(\n          {\n            maxAge: \"1y\",\n            etag: true,\n            lastModified: true,\n            dotfiles: \"ignore\",\n            fallthrough: false,\n            index: false,\n            cacheControl: true,\n          },\n          fileUpload?.expressStatic || {}\n        )\n      ),\n      (\n        err: any,\n        req: ArkosRequest,\n        _res: ArkosResponse,\n        next: ArkosNextFunction\n      ) => {\n        if (err.code === \"ENOENT\") {\n          const filepath = req.path.replace(\n            `/api/${arkosConfig.fileUpload?.baseRoute}`.replace(\"//\", \"/\"),\n            \"\"\n          );\n          throw new AppError(\n            `File ${filepath} was not found`,\n            404,\n            \"FileNotFound\",\n            { filepath }\n          );\n        }\n\n        next(err);\n      },\n      ...processMiddleware(interceptors?.onFindFileError, { type: \"error\" })\n    );\n  }\n\n  if (!isEndpointDisabled(routerConfig, \"uploadFile\")) {\n    router.post(\n      createRouteConfig(\n        arkosConfig,\n        \"uploadFile\",\n        baseRoutePrefix,\n        `:fileType`,\n        routerConfig,\n        \"file-upload\",\n        authConfigs\n      ),\n      ...processMiddleware(interceptors?.beforeUploadFile),\n      fileUploadController.uploadFile,\n      ...processMiddleware(interceptors?.afterUploadFile),\n      sendResponse,\n      ...processMiddleware(interceptors?.onUploadFileError, { type: \"error\" })\n    );\n  }\n\n  if (!isEndpointDisabled(routerConfig, \"updateFile\")) {\n    router.patch(\n      createRouteConfig(\n        arkosConfig,\n        \"updateFile\",\n        baseRoutePrefix,\n        `:fileType/:fileName`,\n        routerConfig,\n        \"file-upload\",\n        authConfigs\n      ),\n      ...processMiddleware(interceptors?.beforeUpdateFile),\n      fileUploadController.updateFile,\n      ...processMiddleware(interceptors?.afterUpdateFile),\n      sendResponse,\n      ...processMiddleware(interceptors?.onUpdateFileError, { type: \"error\" })\n    );\n  }\n\n  if (!isEndpointDisabled(routerConfig, \"deleteFile\")) {\n    router.delete(\n      createRouteConfig(\n        arkosConfig,\n        \"deleteFile\",\n        baseRoutePrefix,\n        `:fileType/:fileName`,\n        routerConfig,\n        \"file-upload\",\n        authConfigs\n      ),\n      ...processMiddleware(interceptors?.beforeDeleteFile),\n      fileUploadController.deleteFile,\n      ...processMiddleware(interceptors?.afterDeleteFile),\n      sendResponse,\n      ...processMiddleware(interceptors?.onDeleteFileError, { type: \"error\" })\n    );\n  }\n\n  debuggerService.logModuleFinalRouter(\"file-upload\", router);\n  return router;\n}\n"]}

package/dist/cjs/modules/swagger/utils/helpers/openapi-schema-converter.js

@@ -71,7 +71,7 @@ class OpenAPIchemaConverter {
             return flattened;
         }
         if (schema.type === "array" && schema.items) {
-            const arrayPrefix = prefix ? `${prefix}[0]` : "[0]";
+            const arrayPrefix = prefix && schema.items?.format === "binary" ? prefix : `${prefix}[0]`;
             if (schema.items.type === "array") {
                 flattened.push(...this.flattenSchemaCore(schema.items, arrayPrefix, visitedRefs));
             }
@@ -106,7 +106,9 @@ class OpenAPIchemaConverter {
                     visitedRefs.delete(refPath);
                 }
                 else if (value.type === "array" && value.items) {
-                    const arrayPrefix = `${paramName}[0]`;
+                    const arrayPrefix = paramName && value.items?.format == "binary"
+                        ? paramName
+                        : `${paramName}[0]`;
                     if (value.items.type === "array") {
                         flattened.push(...this.flattenSchemaCore(value.items, arrayPrefix, visitedRefs));
                     }

package/dist/cjs/modules/swagger/utils/helpers/openapi-schema-converter.js.map

@@ -1 +1 @@
-{"version":3,"file":"openapi-schema-converter.js","sourceRoot":"","sources":["../../../../../../src/modules/swagger/utils/helpers/openapi-schema-converter.ts"],"names":[],"mappings":"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","sourcesContent":["import { OpenAPIV3 } from \"openapi-types\";\nimport { isClass, isZodSchema } from \"../../../../utils/dynamic-loader\";\nimport zodToJsonSchema from \"zod-to-json-schema\";\nimport classValidatorToJsonSchema from \"./class-validator-to-json-schema\";\nimport { getArkosConfig } from \"../../../../server\";\n\n/**\n * Singleton class responsible for converting various schema formats (Zod, Class DTOs, JSON Schema)\n * into OpenAPI-compliant schema objects. Handles shorthand syntax for responses, request bodies,\n * and parameters.\n */\nclass OpenAPIchemaConverter {\n  private validatorToJsonSchema: (schema: any) => any;\n\n  constructor() {\n    this.validatorToJsonSchema = (schema: any) => {\n      const validationResolver = getArkosConfig()?.validation?.resolver;\n      const fn =\n        validationResolver === \"zod\"\n          ? zodToJsonSchema\n          : classValidatorToJsonSchema;\n\n      return fn(schema);\n    };\n  }\n\n  /**\n   * Checks if a value is a schema-like object (Zod, Class, or JSON Schema).\n   *\n   * @param value - The value to check\n   * @returns True if the value is a schema-like object\n   */\n  private isSchemaLike(value: any): boolean {\n    if (!value) return false;\n\n    if (isZodSchema(value)) return true;\n\n    if (isClass(value)) return true;\n\n    if (this.isPlainObject(value) && value.type) return true;\n\n    return false;\n  }\n\n  /**\n   * Checks if a value is a plain JavaScript object.\n   *\n   * @param value - The value to check\n   * @returns True if the value is a plain object\n   */\n  private isPlainObject(value: any): boolean {\n    return Object.prototype.toString.call(value) === \"[object Object]\";\n  }\n\n  /**\n   * Converts a schema-like object (Zod, Class, or JSON Schema) into a JSON Schema object.\n   *\n   * @param schema - The schema to convert\n   * @returns The JSON Schema representation, or undefined if schema is null/undefined\n   */\n  private convertToJsonSchema(schema: any): any {\n    if (this.isPlainObject(schema) && schema?.type) return schema;\n\n    if (isZodSchema(schema) || isClass(schema))\n      return this.validatorToJsonSchema(schema);\n\n    throw new Error(\n      `Unsupported schema type. Expected Zod schema, class constructor, or JSON Schema object.`\n    );\n  }\n\n  /**\n   * Gets the default description for an HTTP status code.\n   *\n   * @param statusCode - The HTTP status code\n   * @returns A human-readable default description\n   */\n  private getDefaultDescription(statusCode: string): string {\n    const defaults: Record<string, string> = {\n      \"200\": \"Success\",\n      \"201\": \"Created\",\n      \"202\": \"Accepted\",\n      \"204\": \"No Content\",\n      \"400\": \"Bad Request\",\n      \"401\": \"Unauthorized\",\n      \"403\": \"Forbidden\",\n      \"404\": \"Not Found\",\n      \"409\": \"Conflict\",\n      \"422\": \"Unprocessable Entity\",\n      \"500\": \"Internal Server Error\",\n      \"502\": \"Bad Gateway\",\n      \"503\": \"Service Unavailable\",\n    };\n\n    return defaults[statusCode] || \"Response\";\n  }\n\n  /**\n   * Core flattening logic that converts a JSON schema into bracket notation.\n   * Handles nested objects, arrays, and circular references.\n   *\n   * @param schema - The JSON schema to flatten\n   * @param prefix - Optional prefix for nested properties\n   * @param visitedRefs - Set to track circular references\n   * @returns Array of flattened field descriptors\n   */\n  flattenSchemaCore(\n    schema: any,\n    prefix = \"\",\n    visitedRefs = new Set<string>()\n  ): Array<{ name: string; schema: any; required: boolean }> {\n    const flattened: Array<{ name: string; schema: any; required: boolean }> =\n      [];\n\n    if (schema.$ref) {\n      const refPath = schema.$ref;\n      if (visitedRefs.has(refPath)) return flattened;\n\n      visitedRefs.add(refPath);\n      const resolvedSchema = this.resolveRef(schema, refPath);\n      if (resolvedSchema) {\n        flattened.push(\n          ...this.flattenSchemaCore(resolvedSchema, prefix, visitedRefs)\n        );\n      }\n      visitedRefs.delete(refPath);\n      return flattened;\n    }\n\n    if (schema.type === \"array\" && schema.items) {\n      const arrayPrefix = prefix ? `${prefix}[0]` : \"[0]\";\n\n      // Check if items is an array FIRST, before checking for object\n      if (schema.items.type === \"array\") {\n        flattened.push(\n          ...this.flattenSchemaCore(schema.items, arrayPrefix, visitedRefs)\n        );\n      } else if (schema.items.properties || schema.items.type === \"object\") {\n        flattened.push(\n          ...this.flattenSchemaCore(schema.items, arrayPrefix, visitedRefs)\n        );\n      } else if (schema.items.type || schema.items.$ref) {\n        flattened.push({\n          name: arrayPrefix,\n          schema: {\n            type: schema.items.type,\n            ...(schema.items.enum && { enum: schema.items.enum }),\n            ...(schema.items.format && { format: schema.items.format }),\n          },\n          required: false,\n        });\n      }\n\n      return flattened;\n    }\n\n    if ((schema.type === \"object\" || !schema.type) && schema.properties) {\n      for (const [key, value] of Object.entries(schema.properties) as any) {\n        const paramName = prefix ? `${prefix}[${key}]` : key;\n\n        if (value.$ref) {\n          const refPath = value.$ref;\n          if (visitedRefs.has(refPath)) continue;\n\n          visitedRefs.add(refPath);\n          const resolvedSchema = this.resolveRef(schema, refPath);\n\n          if (resolvedSchema) {\n            flattened.push(\n              ...this.flattenSchemaCore(resolvedSchema, paramName, visitedRefs)\n            );\n          }\n          visitedRefs.delete(refPath);\n        } else if (value.type === \"array\" && value.items) {\n          const arrayPrefix = `${paramName}[0]`;\n          if (value.items.type === \"array\") {\n            flattened.push(\n              ...this.flattenSchemaCore(value.items, arrayPrefix, visitedRefs)\n            );\n          } else if (value.items.type === \"object\" || value.items.properties) {\n            flattened.push(\n              ...this.flattenSchemaCore(value.items, arrayPrefix, visitedRefs)\n            );\n          } else {\n            flattened.push({\n              name: arrayPrefix,\n              schema: {\n                type: value.items.type,\n                ...(value.items.enum && { enum: value.items.enum }),\n                ...(value.items.format && { format: value.items.format }),\n              },\n              required: false,\n            });\n          }\n        } else if (value.type === \"object\" && value.properties) {\n          flattened.push(\n            ...this.flattenSchemaCore(value, paramName, visitedRefs)\n          );\n        } else {\n          flattened.push({\n            name: paramName,\n            schema: {\n              type: value.type,\n              ...(value.enum && { enum: value.enum }),\n              ...(value.format && { format: value.format }),\n            },\n            required: schema.required?.includes(key) || false,\n          });\n        }\n      }\n      return flattened;\n    }\n\n    // Handle primitive types with prefix\n    if (schema.type && prefix) {\n      flattened.push({\n        name: prefix,\n        schema: {\n          type: schema.type,\n          ...(schema.enum && { enum: schema.enum }),\n          ...(schema.format && { format: schema.format }),\n        },\n        required: false,\n      });\n    }\n\n    return flattened;\n  }\n\n  /**\n   * Flattens a JSON schema while preserving the schema structure.\n   * Converts nested objects and arrays into bracket notation properties.\n   * Used for multipart/form-data schema representation.\n   *\n   * @param schema - The JSON schema to flatten\n   * @returns A flattened schema object with bracket notation properties\n   */\n  flattenSchema(schema: any): any {\n    const flattened = this.flattenSchemaCore(schema);\n\n    // Convert the flattened array into a schema object\n    const flattenedSchema: any = {\n      ...schema,\n      properties: {},\n      required: [],\n    };\n\n    for (const item of flattened) {\n      flattenedSchema.properties[item.name] = item.schema;\n      if (item.required) {\n        flattenedSchema.required.push(item.name);\n      }\n    }\n\n    // Remove empty required array if no required fields\n    if (flattenedSchema.required.length === 0) {\n      delete flattenedSchema.required;\n    }\n\n    return flattenedSchema;\n  }\n\n  /**\n   * Converts a response definition (shorthand, medium, or full format) into a standard\n   * OpenAPI ResponseObject.\n   *\n   * Supports three formats:\n   * 1. Shorthand: ProfileDto → assumes application/json + default description\n   * 2. Medium: { content: ProfileDto, description: \"...\" } → custom description\n   * 3. Full: { content: { \"application/json\": { schema: ProfileDto } } } → full control\n   *\n   * @param statusCode - The HTTP status code for this response\n   * @param definition - The response definition to convert\n   * @returns A standard OpenAPI ResponseObject\n   */\n  convertResponseDefinition(\n    statusCode: string,\n    definition: any\n  ): OpenAPIV3.ResponseObject {\n    if (!definition.content && this.isSchemaLike(definition)) {\n      return {\n        description: this.getDefaultDescription(statusCode),\n        content: {\n          \"application/json\": {\n            schema: this.convertToJsonSchema(definition),\n          },\n        },\n      };\n    }\n\n    if (definition.content && this.isSchemaLike(definition.content)) {\n      return {\n        description:\n          definition.description || this.getDefaultDescription(statusCode),\n        content: {\n          \"application/json\": {\n            schema: this.convertToJsonSchema(definition.content),\n          },\n        },\n        ...(definition.headers && { headers: definition.headers }),\n        ...(definition.links && { links: definition.links }),\n      };\n    }\n\n    if (definition.content) {\n      const converted: OpenAPIV3.ResponseObject = {\n        description:\n          definition.description || this.getDefaultDescription(statusCode),\n        content: {},\n      };\n\n      for (const [mediaType, mediaObj] of Object.entries(\n        definition.content\n      ) as any[]) {\n        converted.content![mediaType] = {\n          ...mediaObj,\n          schema: this.convertToJsonSchema(mediaObj.schema),\n        };\n      }\n\n      if (definition.headers) converted.headers = definition.headers;\n      if (definition.links) converted.links = definition.links;\n\n      return converted;\n    }\n\n    return definition;\n  }\n\n  /**\n   * Converts a request body definition (shorthand, medium, or full format) into a standard\n   * OpenAPI RequestBodyObject.\n   *\n   * Supports three formats:\n   * 1. Shorthand: CreateUserDto → assumes application/json + required: true\n   * 2. Medium: { content: CreateUserDto, required?: boolean } → custom config\n   * 3. Full: { content: { \"application/json\": { schema: CreateUserDto } } } → full control\n   *\n   * For multipart/form-data, automatically converts the schema into an array of parameters.\n   *\n   * @param definition - The request body definition to convert\n   * @returns A standard OpenAPI RequestBodyObject, or undefined if no definition provided\n   */\n  convertRequestBodyDefinition(\n    definition: any\n  ): OpenAPIV3.RequestBodyObject | undefined {\n    if (!definition) return undefined;\n\n    if (!definition.content && this.isSchemaLike(definition)) {\n      return {\n        required: true,\n        content: {\n          \"application/json\": {\n            schema: this.convertToJsonSchema(definition),\n          },\n        },\n      };\n    }\n\n    if (definition.content && this.isSchemaLike(definition.content)) {\n      return {\n        required: definition.required === false ? false : true,\n        description: definition.description,\n        content: {\n          \"application/json\": {\n            schema: this.convertToJsonSchema(definition.content),\n          },\n        },\n      };\n    }\n\n    if (definition.content) {\n      const converted: OpenAPIV3.RequestBodyObject = {\n        required: definition.required ?? true,\n        content: {},\n      };\n\n      if (definition.description)\n        converted.description = definition.description;\n\n      for (const [mediaType, mediaObj] of Object.entries(\n        definition.content\n      ) as any[]) {\n        const jsonSchema = this.convertToJsonSchema(mediaObj.schema);\n\n        // For multipart/form-data, flatten the schema into bracket notation\n        if (mediaType === \"multipart/form-data\") {\n          converted.content[mediaType] = {\n            ...mediaObj,\n            schema: this.flattenSchema(jsonSchema),\n          };\n        } else {\n          // For other media types (like application/json), keep the full schema\n          converted.content[mediaType] = {\n            ...mediaObj,\n            schema: jsonSchema,\n          };\n        }\n      }\n\n      return converted;\n    }\n\n    return definition;\n  }\n\n  /**\n   * Converts an array of parameter definitions, transforming any Zod/Class schemas\n   * into JSON Schema objects.\n   *\n   * @param parameters - Array of parameter definitions to convert\n   * @returns Array of standard OpenAPI ParameterObjects, or undefined if no parameters provided\n   */\n  convertParameters(\n    parameters: any[] | undefined\n  ): (OpenAPIV3.ParameterObject | OpenAPIV3.ReferenceObject)[] | undefined {\n    if (!parameters) return undefined;\n\n    return parameters.map((param) => {\n      if (param.$ref) return param;\n\n      if (param.schema)\n        return {\n          ...param,\n          schema: this.convertToJsonSchema(param.schema),\n        };\n\n      return param;\n    });\n  }\n\n  /**\n   * Converts all responses in a responses object, handling shorthand, medium, and full formats.\n   *\n   * @param responses - Object containing response definitions keyed by status code\n   * @returns Object with converted OpenAPI ResponseObjects\n   */\n  convertResponses(\n    responses: Record<string, any> | undefined\n  ): Record<string, OpenAPIV3.ResponseObject> | undefined {\n    if (!responses) return undefined;\n\n    const converted: Record<string, OpenAPIV3.ResponseObject> = {};\n\n    for (const [statusCode, definition] of Object.entries(responses)) {\n      converted[statusCode] = this.convertResponseDefinition(\n        statusCode,\n        definition\n      );\n    }\n\n    return converted;\n  }\n\n  /**\n   * Converts a complete OpenAPI operation configuration, processing responses, requestBody,\n   * and parameters to handle shorthand syntax and schema conversions.\n   *\n   * @param config - The OpenAPI operation configuration to convert\n   * @returns The converted configuration with all schemas transformed to JSON Schema\n   */\n  convertOpenAPIConfig(config: any): any {\n    if (!config || config === false) return config;\n\n    const converted = { ...config };\n\n    if (config.responses)\n      converted.responses = this.convertResponses(config.responses);\n\n    if (config.requestBody)\n      converted.requestBody = this.convertRequestBodyDefinition(\n        config.requestBody\n      );\n\n    if (config.parameters)\n      converted.parameters = this.convertParameters(config.parameters);\n\n    return converted;\n  }\n\n  /**\n   * Converts a JSON schema to OpenAPI parameter objects with flattened paths.\n   * This is used for query/path/header parameters.\n   *\n   * @param paramType - The parameter location (query, path, header, cookie)\n   * @param schema - The JSON schema to convert\n   * @param prefix - Optional prefix for nested properties\n   * @param visitedRefs - Set to track circular references\n   * @returns Array of OpenAPI parameter objects\n   */\n  jsonSchemaToOpenApiParameters(\n    paramType: string,\n    schema: any,\n    prefix = \"\",\n    visitedRefs = new Set<string>()\n  ): any[] {\n    const flattened = this.flattenSchemaCore(schema, prefix, visitedRefs);\n\n    return flattened.map(({ name, schema, required }) => ({\n      in: paramType,\n      name,\n      required,\n      schema,\n    }));\n  }\n\n  resolveRef(rootSchema: any, refPath: string): any {\n    if (!refPath.startsWith(\"#/properties/\")) {\n      return null;\n    }\n\n    const path = refPath.substring(2).split(\"/\");\n    let current = rootSchema;\n\n    for (const part of path) {\n      if (current && current[part] !== undefined) {\n        current = current[part];\n      } else {\n        return null;\n      }\n    }\n\n    return current;\n  }\n}\n\nconst openApiSchemaConverter = new OpenAPIchemaConverter();\n\nexport default openApiSchemaConverter;\n"]}
+{"version":3,"file":"openapi-schema-converter.js","sourceRoot":"","sources":["../../../../../../src/modules/swagger/utils/helpers/openapi-schema-converter.ts"],"names":[],"mappings":"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","sourcesContent":["import { OpenAPIV3 } from \"openapi-types\";\nimport { isClass, isZodSchema } from \"../../../../utils/dynamic-loader\";\nimport zodToJsonSchema from \"zod-to-json-schema\";\nimport classValidatorToJsonSchema from \"./class-validator-to-json-schema\";\nimport { getArkosConfig } from \"../../../../server\";\n\n/**\n * Singleton class responsible for converting various schema formats (Zod, Class DTOs, JSON Schema)\n * into OpenAPI-compliant schema objects. Handles shorthand syntax for responses, request bodies,\n * and parameters.\n */\nclass OpenAPIchemaConverter {\n  private validatorToJsonSchema: (schema: any) => any;\n\n  constructor() {\n    this.validatorToJsonSchema = (schema: any) => {\n      const validationResolver = getArkosConfig()?.validation?.resolver;\n      const fn =\n        validationResolver === \"zod\"\n          ? zodToJsonSchema\n          : classValidatorToJsonSchema;\n\n      return fn(schema);\n    };\n  }\n\n  /**\n   * Checks if a value is a schema-like object (Zod, Class, or JSON Schema).\n   *\n   * @param value - The value to check\n   * @returns True if the value is a schema-like object\n   */\n  private isSchemaLike(value: any): boolean {\n    if (!value) return false;\n\n    if (isZodSchema(value)) return true;\n\n    if (isClass(value)) return true;\n\n    if (this.isPlainObject(value) && value.type) return true;\n\n    return false;\n  }\n\n  /**\n   * Checks if a value is a plain JavaScript object.\n   *\n   * @param value - The value to check\n   * @returns True if the value is a plain object\n   */\n  private isPlainObject(value: any): boolean {\n    return Object.prototype.toString.call(value) === \"[object Object]\";\n  }\n\n  /**\n   * Converts a schema-like object (Zod, Class, or JSON Schema) into a JSON Schema object.\n   *\n   * @param schema - The schema to convert\n   * @returns The JSON Schema representation, or undefined if schema is null/undefined\n   */\n  private convertToJsonSchema(schema: any): any {\n    if (this.isPlainObject(schema) && schema?.type) return schema;\n\n    if (isZodSchema(schema) || isClass(schema))\n      return this.validatorToJsonSchema(schema);\n\n    throw new Error(\n      `Unsupported schema type. Expected Zod schema, class constructor, or JSON Schema object.`\n    );\n  }\n\n  /**\n   * Gets the default description for an HTTP status code.\n   *\n   * @param statusCode - The HTTP status code\n   * @returns A human-readable default description\n   */\n  private getDefaultDescription(statusCode: string): string {\n    const defaults: Record<string, string> = {\n      \"200\": \"Success\",\n      \"201\": \"Created\",\n      \"202\": \"Accepted\",\n      \"204\": \"No Content\",\n      \"400\": \"Bad Request\",\n      \"401\": \"Unauthorized\",\n      \"403\": \"Forbidden\",\n      \"404\": \"Not Found\",\n      \"409\": \"Conflict\",\n      \"422\": \"Unprocessable Entity\",\n      \"500\": \"Internal Server Error\",\n      \"502\": \"Bad Gateway\",\n      \"503\": \"Service Unavailable\",\n    };\n\n    return defaults[statusCode] || \"Response\";\n  }\n\n  /**\n   * Core flattening logic that converts a JSON schema into bracket notation.\n   * Handles nested objects, arrays, and circular references.\n   *\n   * @param schema - The JSON schema to flatten\n   * @param prefix - Optional prefix for nested properties\n   * @param visitedRefs - Set to track circular references\n   * @returns Array of flattened field descriptors\n   */\n  flattenSchemaCore(\n    schema: any,\n    prefix = \"\",\n    visitedRefs = new Set<string>()\n  ): Array<{ name: string; schema: any; required: boolean }> {\n    const flattened: Array<{ name: string; schema: any; required: boolean }> =\n      [];\n\n    if (schema.$ref) {\n      const refPath = schema.$ref;\n      if (visitedRefs.has(refPath)) return flattened;\n\n      visitedRefs.add(refPath);\n      const resolvedSchema = this.resolveRef(schema, refPath);\n      if (resolvedSchema) {\n        flattened.push(\n          ...this.flattenSchemaCore(resolvedSchema, prefix, visitedRefs)\n        );\n      }\n      visitedRefs.delete(refPath);\n      return flattened;\n    }\n\n    if (schema.type === \"array\" && schema.items) {\n      const arrayPrefix =\n        prefix && schema.items?.format === \"binary\" ? prefix : `${prefix}[0]`;\n\n      // Check if items is an array FIRST, before checking for object\n      if (schema.items.type === \"array\") {\n        flattened.push(\n          ...this.flattenSchemaCore(schema.items, arrayPrefix, visitedRefs)\n        );\n      } else if (schema.items.properties || schema.items.type === \"object\") {\n        flattened.push(\n          ...this.flattenSchemaCore(schema.items, arrayPrefix, visitedRefs)\n        );\n      } else if (schema.items.type || schema.items.$ref) {\n        flattened.push({\n          name: arrayPrefix,\n          schema: {\n            type: schema.items.type,\n            ...(schema.items.enum && { enum: schema.items.enum }),\n            ...(schema.items.format && { format: schema.items.format }),\n          },\n          required: false,\n        });\n      }\n\n      return flattened;\n    }\n\n    if ((schema.type === \"object\" || !schema.type) && schema.properties) {\n      for (const [key, value] of Object.entries(schema.properties) as any) {\n        const paramName = prefix ? `${prefix}[${key}]` : key;\n\n        if (value.$ref) {\n          const refPath = value.$ref;\n          if (visitedRefs.has(refPath)) continue;\n\n          visitedRefs.add(refPath);\n          const resolvedSchema = this.resolveRef(schema, refPath);\n\n          if (resolvedSchema) {\n            flattened.push(\n              ...this.flattenSchemaCore(resolvedSchema, paramName, visitedRefs)\n            );\n          }\n          visitedRefs.delete(refPath);\n        } else if (value.type === \"array\" && value.items) {\n          const arrayPrefix =\n            paramName && value.items?.format == \"binary\"\n              ? paramName\n              : `${paramName}[0]`;\n\n          if (value.items.type === \"array\") {\n            flattened.push(\n              ...this.flattenSchemaCore(value.items, arrayPrefix, visitedRefs)\n            );\n          } else if (value.items.type === \"object\" || value.items.properties) {\n            flattened.push(\n              ...this.flattenSchemaCore(value.items, arrayPrefix, visitedRefs)\n            );\n          } else {\n            flattened.push({\n              name: arrayPrefix,\n              schema: {\n                type: value.items.type,\n                ...(value.items.enum && { enum: value.items.enum }),\n                ...(value.items.format && { format: value.items.format }),\n              },\n              required: false,\n            });\n          }\n        } else if (value.type === \"object\" && value.properties) {\n          flattened.push(\n            ...this.flattenSchemaCore(value, paramName, visitedRefs)\n          );\n        } else {\n          flattened.push({\n            name: paramName,\n            schema: {\n              type: value.type,\n              ...(value.enum && { enum: value.enum }),\n              ...(value.format && { format: value.format }),\n            },\n            required: schema.required?.includes(key) || false,\n          });\n        }\n      }\n      return flattened;\n    }\n\n    // Handle primitive types with prefix\n    if (schema.type && prefix) {\n      flattened.push({\n        name: prefix,\n        schema: {\n          type: schema.type,\n          ...(schema.enum && { enum: schema.enum }),\n          ...(schema.format && { format: schema.format }),\n        },\n        required: false,\n      });\n    }\n\n    return flattened;\n  }\n\n  /**\n   * Flattens a JSON schema while preserving the schema structure.\n   * Converts nested objects and arrays into bracket notation properties.\n   * Used for multipart/form-data schema representation.\n   *\n   * @param schema - The JSON schema to flatten\n   * @returns A flattened schema object with bracket notation properties\n   */\n  flattenSchema(schema: any): any {\n    const flattened = this.flattenSchemaCore(schema);\n\n    // Convert the flattened array into a schema object\n    const flattenedSchema: any = {\n      ...schema,\n      properties: {},\n      required: [],\n    };\n\n    for (const item of flattened) {\n      flattenedSchema.properties[item.name] = item.schema;\n      if (item.required) {\n        flattenedSchema.required.push(item.name);\n      }\n    }\n\n    // Remove empty required array if no required fields\n    if (flattenedSchema.required.length === 0) {\n      delete flattenedSchema.required;\n    }\n\n    return flattenedSchema;\n  }\n\n  /**\n   * Converts a response definition (shorthand, medium, or full format) into a standard\n   * OpenAPI ResponseObject.\n   *\n   * Supports three formats:\n   * 1. Shorthand: ProfileDto → assumes application/json + default description\n   * 2. Medium: { content: ProfileDto, description: \"...\" } → custom description\n   * 3. Full: { content: { \"application/json\": { schema: ProfileDto } } } → full control\n   *\n   * @param statusCode - The HTTP status code for this response\n   * @param definition - The response definition to convert\n   * @returns A standard OpenAPI ResponseObject\n   */\n  convertResponseDefinition(\n    statusCode: string,\n    definition: any\n  ): OpenAPIV3.ResponseObject {\n    if (!definition.content && this.isSchemaLike(definition)) {\n      return {\n        description: this.getDefaultDescription(statusCode),\n        content: {\n          \"application/json\": {\n            schema: this.convertToJsonSchema(definition),\n          },\n        },\n      };\n    }\n\n    if (definition.content && this.isSchemaLike(definition.content)) {\n      return {\n        description:\n          definition.description || this.getDefaultDescription(statusCode),\n        content: {\n          \"application/json\": {\n            schema: this.convertToJsonSchema(definition.content),\n          },\n        },\n        ...(definition.headers && { headers: definition.headers }),\n        ...(definition.links && { links: definition.links }),\n      };\n    }\n\n    if (definition.content) {\n      const converted: OpenAPIV3.ResponseObject = {\n        description:\n          definition.description || this.getDefaultDescription(statusCode),\n        content: {},\n      };\n\n      for (const [mediaType, mediaObj] of Object.entries(\n        definition.content\n      ) as any[]) {\n        converted.content![mediaType] = {\n          ...mediaObj,\n          schema: this.convertToJsonSchema(mediaObj.schema),\n        };\n      }\n\n      if (definition.headers) converted.headers = definition.headers;\n      if (definition.links) converted.links = definition.links;\n\n      return converted;\n    }\n\n    return definition;\n  }\n\n  /**\n   * Converts a request body definition (shorthand, medium, or full format) into a standard\n   * OpenAPI RequestBodyObject.\n   *\n   * Supports three formats:\n   * 1. Shorthand: CreateUserDto → assumes application/json + required: true\n   * 2. Medium: { content: CreateUserDto, required?: boolean } → custom config\n   * 3. Full: { content: { \"application/json\": { schema: CreateUserDto } } } → full control\n   *\n   * For multipart/form-data, automatically converts the schema into an array of parameters.\n   *\n   * @param definition - The request body definition to convert\n   * @returns A standard OpenAPI RequestBodyObject, or undefined if no definition provided\n   */\n  convertRequestBodyDefinition(\n    definition: any\n  ): OpenAPIV3.RequestBodyObject | undefined {\n    if (!definition) return undefined;\n\n    if (!definition.content && this.isSchemaLike(definition)) {\n      return {\n        required: true,\n        content: {\n          \"application/json\": {\n            schema: this.convertToJsonSchema(definition),\n          },\n        },\n      };\n    }\n\n    if (definition.content && this.isSchemaLike(definition.content)) {\n      return {\n        required: definition.required === false ? false : true,\n        description: definition.description,\n        content: {\n          \"application/json\": {\n            schema: this.convertToJsonSchema(definition.content),\n          },\n        },\n      };\n    }\n\n    if (definition.content) {\n      const converted: OpenAPIV3.RequestBodyObject = {\n        required: definition.required ?? true,\n        content: {},\n      };\n\n      if (definition.description)\n        converted.description = definition.description;\n\n      for (const [mediaType, mediaObj] of Object.entries(\n        definition.content\n      ) as any[]) {\n        const jsonSchema = this.convertToJsonSchema(mediaObj.schema);\n\n        // For multipart/form-data, flatten the schema into bracket notation\n        if (mediaType === \"multipart/form-data\") {\n          converted.content[mediaType] = {\n            ...mediaObj,\n            schema: this.flattenSchema(jsonSchema),\n          };\n        } else {\n          // For other media types (like application/json), keep the full schema\n          converted.content[mediaType] = {\n            ...mediaObj,\n            schema: jsonSchema,\n          };\n        }\n      }\n\n      return converted;\n    }\n\n    return definition;\n  }\n\n  /**\n   * Converts an array of parameter definitions, transforming any Zod/Class schemas\n   * into JSON Schema objects.\n   *\n   * @param parameters - Array of parameter definitions to convert\n   * @returns Array of standard OpenAPI ParameterObjects, or undefined if no parameters provided\n   */\n  convertParameters(\n    parameters: any[] | undefined\n  ): (OpenAPIV3.ParameterObject | OpenAPIV3.ReferenceObject)[] | undefined {\n    if (!parameters) return undefined;\n\n    return parameters.map((param) => {\n      if (param.$ref) return param;\n\n      if (param.schema)\n        return {\n          ...param,\n          schema: this.convertToJsonSchema(param.schema),\n        };\n\n      return param;\n    });\n  }\n\n  /**\n   * Converts all responses in a responses object, handling shorthand, medium, and full formats.\n   *\n   * @param responses - Object containing response definitions keyed by status code\n   * @returns Object with converted OpenAPI ResponseObjects\n   */\n  convertResponses(\n    responses: Record<string, any> | undefined\n  ): Record<string, OpenAPIV3.ResponseObject> | undefined {\n    if (!responses) return undefined;\n\n    const converted: Record<string, OpenAPIV3.ResponseObject> = {};\n\n    for (const [statusCode, definition] of Object.entries(responses)) {\n      converted[statusCode] = this.convertResponseDefinition(\n        statusCode,\n        definition\n      );\n    }\n\n    return converted;\n  }\n\n  /**\n   * Converts a complete OpenAPI operation configuration, processing responses, requestBody,\n   * and parameters to handle shorthand syntax and schema conversions.\n   *\n   * @param config - The OpenAPI operation configuration to convert\n   * @returns The converted configuration with all schemas transformed to JSON Schema\n   */\n  convertOpenAPIConfig(config: any): any {\n    if (!config || config === false) return config;\n\n    const converted = { ...config };\n\n    if (config.responses)\n      converted.responses = this.convertResponses(config.responses);\n\n    if (config.requestBody)\n      converted.requestBody = this.convertRequestBodyDefinition(\n        config.requestBody\n      );\n\n    if (config.parameters)\n      converted.parameters = this.convertParameters(config.parameters);\n\n    return converted;\n  }\n\n  /**\n   * Converts a JSON schema to OpenAPI parameter objects with flattened paths.\n   * This is used for query/path/header parameters.\n   *\n   * @param paramType - The parameter location (query, path, header, cookie)\n   * @param schema - The JSON schema to convert\n   * @param prefix - Optional prefix for nested properties\n   * @param visitedRefs - Set to track circular references\n   * @returns Array of OpenAPI parameter objects\n   */\n  jsonSchemaToOpenApiParameters(\n    paramType: string,\n    schema: any,\n    prefix = \"\",\n    visitedRefs = new Set<string>()\n  ): any[] {\n    const flattened = this.flattenSchemaCore(schema, prefix, visitedRefs);\n\n    return flattened.map(({ name, schema, required }) => ({\n      in: paramType,\n      name,\n      required,\n      schema,\n    }));\n  }\n\n  resolveRef(rootSchema: any, refPath: string): any {\n    if (!refPath.startsWith(\"#/properties/\")) {\n      return null;\n    }\n\n    const path = refPath.substring(2).split(\"/\");\n    let current = rootSchema;\n\n    for (const part of path) {\n      if (current && current[part] !== undefined) {\n        current = current[part];\n      } else {\n        return null;\n      }\n    }\n\n    return current;\n  }\n}\n\nconst openApiSchemaConverter = new OpenAPIchemaConverter();\n\nexport default openApiSchemaConverter;\n"]}

package/dist/cjs/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";;;AA8JA,IAAY,oBAKX;AALD,WAAY,oBAAoB;IAC9B,yCAAiB,CAAA;IACjB,qCAAa,CAAA;IACb,yCAAiB,CAAA;IACjB,yCAAiB,CAAA;AACnB,CAAC,EALW,oBAAoB,oCAApB,oBAAoB,QAK/B","sourcesContent":["import { NextFunction, Response, Request } from \"express\";\nimport { PrismaModels } from \"../generated\";\n\n/**\n * Type definition for authentication-related Prisma query operations\n * @template T - The Prisma model delegate type\n */\nexport type AuthPrismaQueryOptions<T extends Record<string, any>> = {\n  // User profile endpoints\n  /**\n   * Options for retrieving the current authenticated user's profile\n   */\n  getMe?: Partial<Parameters<T[\"findUnique\"]>[0]>;\n  /**\n   * Options for updating the current authenticated user's profile\n   */\n  updateMe?: Partial<Parameters<T[\"update\"]>[0]>;\n  /**\n   * Options for soft deleting or deactivating the current authenticated user's account\n   */\n  deleteMe?: Partial<Parameters<T[\"update\"]>[0]>;\n  // Authentication endpoints\n  /**\n   * Options for user login authentication queries\n   */\n  login?: Partial<Parameters<T[\"findFirst\"]>[0]>;\n  /**\n   * Options for user registration and account creation\n   */\n  signup?: Partial<Parameters<T[\"create\"]>[0]>;\n  /**\n   * Options for updating the current authenticated user's password\n   */\n  updatePassword?: Partial<Parameters<T[\"update\"]>[0]>;\n  /**\n   * Options for finding multiple auth actions\n   */\n  findManyAuthAction?: Partial<Parameters<T[\"findMany\"]>[0]>;\n  /**\n   * Options for finding a single auth action\n   */\n  findOneAuthAction?: Partial<Parameters<T[\"findFirst\"]>[0]>;\n};\n\n/**\n * Base Prisma query options for standard CRUD operations\n * @template T - The Prisma model delegate type\n */\ntype BasePrismaQueryOptions<T extends Record<string, any>> = {\n  /**\n   * @deprecated Use `global` instead for general query options\n   */\n  queryOptions?: Partial<Parameters<T[\"findMany\"]>[0]>;\n  /**\n   * Global query options that can be used for all operations\n   * Replaces the deprecated queryOptions\n   */\n  global?: Partial<Parameters<T[\"findMany\"]>[0]>;\n  /**\n   * General find options for findMany and findOne operations\n   */\n  find?: Partial<Parameters<T[\"findMany\"]>[0]>;\n  /**\n   * General create options for createOne and createMany operations\n   */\n  create?: Partial<Parameters<T[\"create\"]>[0]>;\n  /**\n   * General update options for updateOne and updateMany operations\n   */\n  update?: Partial<Parameters<T[\"update\"]>[0]>;\n  /**\n   * General delete options for deleteOne and deleteMany operations\n   */\n  delete?: Partial<Parameters<T[\"delete\"]>[0]>;\n  /**\n   * General save options for createOne, createMany, updateOne, updateMany operations\n   */\n  save?:\n    | Partial<Parameters<T[\"create\"]>[0]>\n    | Partial<Parameters<T[\"update\"]>[0]>;\n  /**\n   * Save options for single record operations (createOne, updateOne)\n   */\n  saveOne?:\n    | Partial<Parameters<T[\"create\"]>[0]>\n    | Partial<Parameters<T[\"update\"]>[0]>;\n  /**\n   * Save options for multiple record operations (createMany, updateMany)\n   */\n  saveMany?:\n    | Partial<Parameters<T[\"createMany\"]>[0]>\n    | Partial<Parameters<T[\"updateMany\"]>[0]>;\n  /**\n   * Options for finding a single record (first match)\n   */\n  findOne?: Partial<Parameters<T[\"findFirst\"]>[0]>;\n  /**\n   * Options for finding multiple records\n   */\n  findMany?: Partial<Parameters<T[\"findMany\"]>[0]>;\n  /**\n   * Options for creating a single record\n   */\n  createOne?: Partial<Parameters<T[\"create\"]>[0]>;\n  /**\n   * Options for creating multiple records\n   */\n  createMany?: Partial<Parameters<T[\"createMany\"]>[0]>;\n  /**\n   * Options for updating a single record\n   */\n  updateOne?: Partial<Parameters<T[\"update\"]>[0]>;\n  /**\n   * Options for updating multiple records\n   */\n  updateMany?: Partial<Parameters<T[\"updateMany\"]>[0]>;\n  /**\n   * Options for deleting a single record\n   */\n  deleteOne?: Partial<Parameters<T[\"delete\"]>[0]>;\n  /**\n   * Options for deleting multiple records\n   */\n  deleteMany?: Partial<Parameters<T[\"deleteMany\"]>[0]>;\n};\n\n/**\n * Type definition for Prisma query operations with flexible options\n * Conditionally provides auth-specific options when ModelName is \"auth\"\n * @template T - The Prisma model delegate type\n * @template ModelName - The model name (defaults to string for standard models)\n */\nexport type PrismaQueryOptions<\n  T extends Record<string, any>,\n  ModelName extends string = string,\n> = ModelName extends \"auth\"\n  ? AuthPrismaQueryOptions<T>\n  : BasePrismaQueryOptions<T>;\n\nexport interface UserRole {\n  id: string;\n  createdAt: Date;\n  deletedAt?: Date;\n  roleId: string;\n  role: AuthRole;\n  user: User;\n  userId: string;\n}\n\nexport interface AuthRole {\n  id: string;\n  createdAt: Date;\n  deletedAt?: Date;\n  name: string;\n  permissions: AuthPermission[];\n  userRoles: UserRole[];\n}\n\nexport enum AuthPermissionAction {\n  Create = \"Create\",\n  View = \"View\",\n  Update = \"Update\",\n  Delete = \"Delete\",\n}\n\nexport interface AuthPermission {\n  id: string;\n  createdAt: Date;\n  deletedAt?: Date;\n  resource: string;\n  action: AuthPermissionAction;\n  roleId: string;\n  role: AuthRole;\n}\n\nexport interface BaseUser extends Record<string, any> {\n  id: string;\n  isSuperUser: boolean;\n  password: string;\n  passwordChangedAt?: Date;\n  deletedSelfAccountAt: Date;\n  isActive: boolean;\n}\n\ntype UserModelPayload =\n  PrismaModels<{}> extends { user: infer U }\n    ? U extends { GetPayload: infer P }\n      ? P\n      : never\n    : never;\n\nexport type User = UserModelPayload extends never ? BaseUser : UserModelPayload;\n\nexport interface ArkosRequest<\n  P extends Record<string, any> = any,\n  ResBody = any,\n  ReqBody = any,\n  Query extends Record<string, any> = any,\n> extends Request<P, ResBody, ReqBody, Query> {\n  /**\n   * Authenticated user\n   */\n  user?: User;\n  /**\n   * Single uploaded file, populated when using `multer.single()`\n   */\n  file?: Express.Multer.File;\n  /**\n   * Uploaded files, populated when using `multer.array()` or `multer.fields()`.\n   */\n  files?: Express.Multer.File[] | Record<string, Express.Multer.File[]>;\n\n  /**\n   * Fields to include in relational queries\n   */\n  relationFields?: Record<string, boolean>;\n\n  /**\n   * Prisma include options for related data\n   */\n  include?: Record<string, any>;\n\n  /**\n   * Data to be sent in the response\n   */\n  responseData?: Record<string, any> | null;\n\n  /**\n   * Additional context data\n   */\n  additionalData?: Record<string, any> | null;\n\n  /**\n   * HTTP status code for the response\n   */\n  responseStatus?: number;\n\n  /**\n   * Typed request body\n   */\n  body: ReqBody;\n\n  /**\n   * Prisma query options (where, orderBy, select, etc.)\n   */\n  prismaQueryOptions?: Record<string, any>;\n\n  /**\n   * Typed query parameters\n   */\n  query: Query;\n\n  /**\n   * JWT token used in authentication process\n   */\n  accessToken?: string;\n\n  /**\n   * Query parameters after being handled and transformed by middleware\n   */\n  transformedQuery?: Record<string, any>;\n\n  /**\n   * Processed filters from APIFeatures.filters\n   */\n  filters?: Record<string, any>;\n\n  /**\n   * Name of the Prisma model being queried\n   */\n  modelName?: string;\n}\n\nexport interface ArkosResponse<\n  ResBody = any,\n  Locals extends Record<string, any> = Record<string, any>,\n> extends Response<ResBody, Locals> {}\n\nexport interface ArkosNextFunction extends NextFunction {}\n\nexport type ArkosRequestHandler<\n  P extends Record<string, any> = any,\n  ResBody = any,\n  ReqBody = any,\n  ReqQuery extends Record<string, any> = any,\n  Locals extends Record<string, any> = Record<string, any>,\n> = (\n  req: ArkosRequest<P, ResBody, ReqBody, ReqQuery>,\n  res: ArkosResponse<ResBody, Locals>,\n  next: ArkosNextFunction\n) => void | Promise<void>;\n\nexport type ArkosErrorRequestHandler<\n  P extends Record<string, any> = any,\n  ResBody = any,\n  ReqBody = any,\n  ReqQuery extends Record<string, any> = any,\n  Locals extends Record<string, any> = Record<string, any>,\n> = (\n  err: any,\n  req: ArkosRequest<P, ResBody, ReqBody, ReqQuery>,\n  res: ArkosResponse<ResBody, Locals>,\n  next: ArkosNextFunction\n) => void | Promise<void>;\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";;;AA+JA,IAAY,oBAKX;AALD,WAAY,oBAAoB;IAC9B,yCAAiB,CAAA;IACjB,qCAAa,CAAA;IACb,yCAAiB,CAAA;IACjB,yCAAiB,CAAA;AACnB,CAAC,EALW,oBAAoB,oCAApB,oBAAoB,QAK/B","sourcesContent":["import { NextFunction, Response, Request } from \"express\";\nimport { PrismaModels } from \"../generated\";\nimport { ArkosFile } from \"./upload\";\n\n/**\n * Type definition for authentication-related Prisma query operations\n * @template T - The Prisma model delegate type\n */\nexport type AuthPrismaQueryOptions<T extends Record<string, any>> = {\n  // User profile endpoints\n  /**\n   * Options for retrieving the current authenticated user's profile\n   */\n  getMe?: Partial<Parameters<T[\"findUnique\"]>[0]>;\n  /**\n   * Options for updating the current authenticated user's profile\n   */\n  updateMe?: Partial<Parameters<T[\"update\"]>[0]>;\n  /**\n   * Options for soft deleting or deactivating the current authenticated user's account\n   */\n  deleteMe?: Partial<Parameters<T[\"update\"]>[0]>;\n  // Authentication endpoints\n  /**\n   * Options for user login authentication queries\n   */\n  login?: Partial<Parameters<T[\"findFirst\"]>[0]>;\n  /**\n   * Options for user registration and account creation\n   */\n  signup?: Partial<Parameters<T[\"create\"]>[0]>;\n  /**\n   * Options for updating the current authenticated user's password\n   */\n  updatePassword?: Partial<Parameters<T[\"update\"]>[0]>;\n  /**\n   * Options for finding multiple auth actions\n   */\n  findManyAuthAction?: Partial<Parameters<T[\"findMany\"]>[0]>;\n  /**\n   * Options for finding a single auth action\n   */\n  findOneAuthAction?: Partial<Parameters<T[\"findFirst\"]>[0]>;\n};\n\n/**\n * Base Prisma query options for standard CRUD operations\n * @template T - The Prisma model delegate type\n */\ntype BasePrismaQueryOptions<T extends Record<string, any>> = {\n  /**\n   * @deprecated Use `global` instead for general query options\n   */\n  queryOptions?: Partial<Parameters<T[\"findMany\"]>[0]>;\n  /**\n   * Global query options that can be used for all operations\n   * Replaces the deprecated queryOptions\n   */\n  global?: Partial<Parameters<T[\"findMany\"]>[0]>;\n  /**\n   * General find options for findMany and findOne operations\n   */\n  find?: Partial<Parameters<T[\"findMany\"]>[0]>;\n  /**\n   * General create options for createOne and createMany operations\n   */\n  create?: Partial<Parameters<T[\"create\"]>[0]>;\n  /**\n   * General update options for updateOne and updateMany operations\n   */\n  update?: Partial<Parameters<T[\"update\"]>[0]>;\n  /**\n   * General delete options for deleteOne and deleteMany operations\n   */\n  delete?: Partial<Parameters<T[\"delete\"]>[0]>;\n  /**\n   * General save options for createOne, createMany, updateOne, updateMany operations\n   */\n  save?:\n    | Partial<Parameters<T[\"create\"]>[0]>\n    | Partial<Parameters<T[\"update\"]>[0]>;\n  /**\n   * Save options for single record operations (createOne, updateOne)\n   */\n  saveOne?:\n    | Partial<Parameters<T[\"create\"]>[0]>\n    | Partial<Parameters<T[\"update\"]>[0]>;\n  /**\n   * Save options for multiple record operations (createMany, updateMany)\n   */\n  saveMany?:\n    | Partial<Parameters<T[\"createMany\"]>[0]>\n    | Partial<Parameters<T[\"updateMany\"]>[0]>;\n  /**\n   * Options for finding a single record (first match)\n   */\n  findOne?: Partial<Parameters<T[\"findFirst\"]>[0]>;\n  /**\n   * Options for finding multiple records\n   */\n  findMany?: Partial<Parameters<T[\"findMany\"]>[0]>;\n  /**\n   * Options for creating a single record\n   */\n  createOne?: Partial<Parameters<T[\"create\"]>[0]>;\n  /**\n   * Options for creating multiple records\n   */\n  createMany?: Partial<Parameters<T[\"createMany\"]>[0]>;\n  /**\n   * Options for updating a single record\n   */\n  updateOne?: Partial<Parameters<T[\"update\"]>[0]>;\n  /**\n   * Options for updating multiple records\n   */\n  updateMany?: Partial<Parameters<T[\"updateMany\"]>[0]>;\n  /**\n   * Options for deleting a single record\n   */\n  deleteOne?: Partial<Parameters<T[\"delete\"]>[0]>;\n  /**\n   * Options for deleting multiple records\n   */\n  deleteMany?: Partial<Parameters<T[\"deleteMany\"]>[0]>;\n};\n\n/**\n * Type definition for Prisma query operations with flexible options\n * Conditionally provides auth-specific options when ModelName is \"auth\"\n * @template T - The Prisma model delegate type\n * @template ModelName - The model name (defaults to string for standard models)\n */\nexport type PrismaQueryOptions<\n  T extends Record<string, any>,\n  ModelName extends string = string,\n> = ModelName extends \"auth\"\n  ? AuthPrismaQueryOptions<T>\n  : BasePrismaQueryOptions<T>;\n\nexport interface UserRole {\n  id: string;\n  createdAt: Date;\n  deletedAt?: Date;\n  roleId: string;\n  role: AuthRole;\n  user: User;\n  userId: string;\n}\n\nexport interface AuthRole {\n  id: string;\n  createdAt: Date;\n  deletedAt?: Date;\n  name: string;\n  permissions: AuthPermission[];\n  userRoles: UserRole[];\n}\n\nexport enum AuthPermissionAction {\n  Create = \"Create\",\n  View = \"View\",\n  Update = \"Update\",\n  Delete = \"Delete\",\n}\n\nexport interface AuthPermission {\n  id: string;\n  createdAt: Date;\n  deletedAt?: Date;\n  resource: string;\n  action: AuthPermissionAction;\n  roleId: string;\n  role: AuthRole;\n}\n\nexport interface BaseUser extends Record<string, any> {\n  id: string;\n  isSuperUser: boolean;\n  password: string;\n  passwordChangedAt?: Date;\n  deletedSelfAccountAt: Date;\n  isActive: boolean;\n}\n\ntype UserModelPayload =\n  PrismaModels<{}> extends { user: infer U }\n    ? U extends { GetPayload: infer P }\n      ? P\n      : never\n    : never;\n\nexport type User = UserModelPayload extends never ? BaseUser : UserModelPayload;\n\nexport interface ArkosRequest<\n  P extends Record<string, any> = any,\n  ResBody = any,\n  ReqBody = any,\n  Query extends Record<string, any> = any,\n> extends Request<P, ResBody, ReqBody, Query> {\n  /**\n   * Authenticated user\n   */\n  user?: User;\n  /**\n   * Single uploaded file, populated when using `{ uploads: { type: \"single\" }}`\n   */\n  file?: ArkosFile;\n  /**\n   * Uploaded files, populated when using `{ uploads: { type: \"array\" }}` or `{ uploads: { type: \"fileds\" }}`.\n   */\n  files?: ArkosFile[] | Record<string, ArkosFile[]>;\n\n  /**\n   * Fields to include in relational queries\n   */\n  relationFields?: Record<string, boolean>;\n\n  /**\n   * Prisma include options for related data\n   */\n  include?: Record<string, any>;\n\n  /**\n   * Data to be sent in the response\n   */\n  responseData?: Record<string, any> | null;\n\n  /**\n   * Additional context data\n   */\n  additionalData?: Record<string, any> | null;\n\n  /**\n   * HTTP status code for the response\n   */\n  responseStatus?: number;\n\n  /**\n   * Typed request body\n   */\n  body: ReqBody;\n\n  /**\n   * Prisma query options (where, orderBy, select, etc.)\n   */\n  prismaQueryOptions?: Record<string, any>;\n\n  /**\n   * Typed query parameters\n   */\n  query: Query;\n\n  /**\n   * JWT token used in authentication process\n   */\n  accessToken?: string;\n\n  /**\n   * Query parameters after being handled and transformed by middleware\n   */\n  transformedQuery?: Record<string, any>;\n\n  /**\n   * Processed filters from APIFeatures.filters\n   */\n  filters?: Record<string, any>;\n\n  /**\n   * Name of the Prisma model being queried\n   */\n  modelName?: string;\n}\n\nexport interface ArkosResponse<\n  ResBody = any,\n  Locals extends Record<string, any> = Record<string, any>,\n> extends Response<ResBody, Locals> {}\n\nexport interface ArkosNextFunction extends NextFunction {}\n\nexport type ArkosRequestHandler<\n  P extends Record<string, any> = any,\n  ResBody = any,\n  ReqBody = any,\n  ReqQuery extends Record<string, any> = any,\n  Locals extends Record<string, any> = Record<string, any>,\n> = (\n  req: ArkosRequest<P, ResBody, ReqBody, ReqQuery>,\n  res: ArkosResponse<ResBody, Locals>,\n  next: ArkosNextFunction\n) => void | Promise<void>;\n\nexport type ArkosErrorRequestHandler<\n  P extends Record<string, any> = any,\n  ResBody = any,\n  ReqBody = any,\n  ReqQuery extends Record<string, any> = any,\n  Locals extends Record<string, any> = Record<string, any>,\n> = (\n  err: any,\n  req: ArkosRequest<P, ResBody, ReqBody, ReqQuery>,\n  res: ArkosResponse<ResBody, Locals>,\n  next: ArkosNextFunction\n) => void | Promise<void>;\n"]}