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

package/dist/types/utils/arkos-router/index.d.ts

@@ -1,6 +1,78 @@
 import { RouterOptions } from "express";
 import { IArkosRouter } from "./types";
 import { OpenAPIV3 } from "openapi-types";
+import { Arkos } from "../../types/arkos";
+export type ArkosRouterOptions = {
+    /**
+     * Prefix to apply to all routes in this router.
+     * Nested routers inherit and concatenate prefixes from parent routers.
+     *
+     * @since 1.5.0-beta
+     * @example
+     * // All routes in this router will be prefixed with "/api"
+     * prefix: "/api"
+     */
+    prefix?: string | RegExp | Array<string | RegExp>;
+    /**
+     * OpenAPI metadata to apply to all routes in this router.
+     * Nested routers inherit from parent routers unless explicitly overridden.
+     * Route-level openapi config fully replaces inherited values when defined.
+     *
+     * @since 1.6.0-beta
+     * @example
+     * openapi: {
+     *   tags: ["Users"],
+     *   security: [{ bearerAuth: [] }]
+     * }
+     */
+    openapi?: {
+        /**
+         * Tags to apply to all routes in this router, used to group them in OpenAPI documentation.
+         * Route-level tags fully replaces this value when defined.
+         *
+         * @since 1.6.0-beta
+         * @example
+         * // Group all routes in this router under "Users"
+         * tags: ["Users"]
+         */
+        tags?: string[];
+        /**
+         * Security requirements to apply to all routes in this router.
+         * Route-level security fully replaces this value when defined.
+         *
+         * @since 1.6.2-canary.1
+         * @example
+         * // Require bearer auth for all routes in this router
+         * security: [{ bearerAuth: [] }]
+         *
+         * // Explicitly make all routes public (overridable per route)
+         * security: []
+         */
+        security?: OpenAPIV3.SecurityRequirementObject[];
+        /**
+         * Server definitions to apply to all routes in this router.
+         * Follows the OpenAPI 3.0 Server Object specification.
+         * Route-level servers fully replaces this value when defined.
+         *
+         * @since 1.6.2-canary.1
+         * @example
+         * servers: [{ url: "https://api.example.com/v2", description: "V2 API" }]
+         */
+        servers?: OpenAPIV3.ServerObject[];
+        /**
+         * External documentation to apply to all routes in this router.
+         * Route-level externalDocs fully replaces this value when defined.
+         *
+         * @since 1.6.2-canary.1
+         * @example
+         * externalDocs: {
+         *   description: "Find more information here",
+         *   url: "https://docs.example.com/users"
+         * }
+         */
+        externalDocs?: OpenAPIV3.ExternalDocumentationObject;
+    };
+};
 /**
  * Creates an enhanced Express Router with features like OpenAPI documentation capabilities and smart data validation.
  *
@@ -23,15 +95,11 @@ import { OpenAPIV3 } from "openapi-types";
  *
  * @returns {IArkosRouter} A proxied Express Router instance with enhanced OpenAPI capabilities
  *
- * @see {@link ArkosRouteConfig} for configuration options
+ * @see {@link https://www.arkosjs.com/docs/reference/arkos-router} for configuration options
+ * @since 1.4.0-beta
  */
-export default function ArkosRouter(options?: RouterOptions & {
-    prefix?: string | RegExp | Array<string | RegExp>;
-    openapi?: {
-        tags?: string[];
-    };
-}): IArkosRouter;
-export declare function generateOpenAPIFromApp(app: any): Record<string, Record<string, Partial<{
+export default function ArkosRouter(options?: RouterOptions & ArkosRouterOptions): IArkosRouter;
+export declare function generateOpenAPIFromApp(app: Arkos): Record<string, Record<string, Partial<{
     tags?: string[];
     summary?: string;
     description?: string;

package/dist/types/utils/arkos-router/types/index.d.ts

@@ -8,11 +8,22 @@ import compression from "compression";
 import { OpenApiConfig } from "./openapi-config";
 import { UploadConfig } from "./upload-config";
 import { BodyParserConfig } from "./body-parser-config";
+import { ArkosRouterOptions } from "..";
 export type ArkosUseConfig = Pick<ArkosRouteConfig, "authentication" | "rateLimit" | "compression" | "queryParser" | "bodyParser" | "disabled"> & {
     path?: PathParams;
 };
 type InferValidationType<T, Fallback> = T extends ZodSchema ? z.infer<T> : T extends new (...args: any[]) => infer I ? I : Fallback;
 export type PathParams = string | RegExp | Array<string | RegExp>;
+export type InternalIArkosRouter = IArkosRouter & {
+    _arkos: {
+        options?: ArkosRouterOptions;
+        routes: Array<{
+            handler: ArkosAnyRequestHandler;
+            config: ArkosRouteConfig;
+            method: string;
+        }>;
+    };
+};
 export type ArkosAnyRequestHandler = ArkosRequestHandler | ArkosErrorRequestHandler | Array<ArkosRequestHandler | ArkosErrorRequestHandler>;
 /**
  * Handler function for HTTP methods that accepts route configuration and request handlers.
@@ -23,13 +34,13 @@ export type ArkosAnyRequestHandler = ArkosRequestHandler | ArkosErrorRequestHand
  */
 type RouterMethodHandler<T> = IRouterHandler<T> & IRouterMatcher<T> & {
     (config: PathParams, ...handlers: Array<ArkosAnyRequestHandler>): T;
-    <TQuery extends ZodSchema | (new (...args: any[]) => object) | false | undefined = any, TBody extends ZodSchema | (new (...args: any[]) => object) | false | undefined = any, TParams extends ZodSchema | (new (...args: any[]) => object) | false | undefined = any>(config: ArkosRouteConfig<TQuery, TBody, TParams>, ...handlers: Array<ArkosRequestHandler<InferValidationType<TParams, Record<string, string>>, any, InferValidationType<TBody, any>, InferValidationType<TQuery, qs.ParsedQs>, any> | Array<ArkosRequestHandler<InferValidationType<TParams, Record<string, string>>, any, InferValidationType<TBody, any>, InferValidationType<TQuery, qs.ParsedQs>, any>>>): T;
-    <TQuery extends ZodSchema | (new (...args: any[]) => object) | false | undefined = any, TBody extends ZodSchema | (new (...args: any[]) => object) | false | undefined = any, TParams extends ZodSchema | (new (...args: any[]) => object) | false | undefined = any>(config: ArkosRouteConfig<TQuery, TBody, TParams>, ...handlers: Array<ArkosErrorRequestHandler<InferValidationType<TParams, Record<string, string>>, any, InferValidationType<TBody, any>, InferValidationType<TQuery, qs.ParsedQs>, any> | Array<ArkosErrorRequestHandler<InferValidationType<TParams, Record<string, string>>, any, InferValidationType<TBody, any>, InferValidationType<TQuery, qs.ParsedQs>, any>>>): T;
+    <TQuery extends ZodSchema | (new (...args: any[]) => object) | null | false | undefined = any, TBody extends ZodSchema | (new (...args: any[]) => object) | null | false | undefined = any, TParams extends ZodSchema | (new (...args: any[]) => object) | null | false | undefined = any>(config: ArkosRouteConfig<TQuery, TBody, TParams>, ...handlers: Array<ArkosRequestHandler<InferValidationType<TParams, Record<string, string>>, any, InferValidationType<TBody, any>, InferValidationType<TQuery, qs.ParsedQs>, any> | Array<ArkosRequestHandler<InferValidationType<TParams, Record<string, string>>, any, InferValidationType<TBody, any>, InferValidationType<TQuery, qs.ParsedQs>, any>>>): T;
+    <TQuery extends ZodSchema | (new (...args: any[]) => object) | null | false | undefined = any, TBody extends ZodSchema | (new (...args: any[]) => object) | null | false | undefined = any, TParams extends ZodSchema | (new (...args: any[]) => object) | null | false | undefined = any>(config: ArkosRouteConfig<TQuery, TBody, TParams>, ...handlers: Array<ArkosErrorRequestHandler<InferValidationType<TParams, Record<string, string>>, any, InferValidationType<TBody, any>, InferValidationType<TQuery, qs.ParsedQs>, any> | Array<ArkosErrorRequestHandler<InferValidationType<TParams, Record<string, string>>, any, InferValidationType<TBody, any>, InferValidationType<TQuery, qs.ParsedQs>, any>>>): T;
 };
 export type ArkosRouteMethodHandler<T> = {
     (config: ArkosAnyRequestHandler | Omit<ArkosRouteConfig, "path">, ...handlers: Array<ArkosRequestHandler | ArkosErrorRequestHandler | Array<ArkosRequestHandler | ArkosErrorRequestHandler>>): T;
-    <TQuery extends ZodSchema | (new (...args: any[]) => object) | false | undefined = any, TBody extends ZodSchema | (new (...args: any[]) => object) | false | undefined = any, TParams extends ZodSchema | (new (...args: any[]) => object) | false | undefined = any>(config: Omit<ArkosRouteConfig<TQuery, TBody, TParams>, "path">, ...handlers: Array<ArkosRequestHandler<InferValidationType<TParams, Record<string, string>>, any, InferValidationType<TBody, any>, InferValidationType<TQuery, qs.ParsedQs>, Locals> | Array<ArkosRequestHandler<InferValidationType<TParams, Record<string, string>>, any, InferValidationType<TBody, any>, InferValidationType<TQuery, qs.ParsedQs>, Locals>>>): T;
-    <TQuery extends ZodSchema | (new (...args: any[]) => object) | false | undefined = any, TBody extends ZodSchema | (new (...args: any[]) => object) | false | undefined = any, TParams extends ZodSchema | (new (...args: any[]) => object) | false | undefined = any>(config: Omit<ArkosRouteConfig<TQuery, TBody, TParams>, "path">, ...handlers: Array<ArkosErrorRequestHandler<InferValidationType<TParams, Record<string, string>>, any, InferValidationType<TBody, any>, InferValidationType<TQuery, qs.ParsedQs>, Locals> | Array<ArkosErrorRequestHandler<InferValidationType<TParams, Record<string, string>>, any, InferValidationType<TBody, any>, InferValidationType<TQuery, qs.ParsedQs>, Locals>>>): T;
+    <TQuery extends ZodSchema | (new (...args: any[]) => object) | null | null | false | undefined = any, TBody extends ZodSchema | (new (...args: any[]) => object) | null | null | false | undefined = any, TParams extends ZodSchema | (new (...args: any[]) => object) | null | null | false | undefined = any>(config: Omit<ArkosRouteConfig<TQuery, TBody, TParams>, "path">, ...handlers: Array<ArkosRequestHandler<InferValidationType<TParams, Record<string, string>>, any, InferValidationType<TBody, any>, InferValidationType<TQuery, qs.ParsedQs>, Locals> | Array<ArkosRequestHandler<InferValidationType<TParams, Record<string, string>>, any, InferValidationType<TBody, any>, InferValidationType<TQuery, qs.ParsedQs>, Locals>>>): T;
+    <TQuery extends ZodSchema | (new (...args: any[]) => object) | null | null | false | undefined = any, TBody extends ZodSchema | (new (...args: any[]) => object) | null | null | false | undefined = any, TParams extends ZodSchema | (new (...args: any[]) => object) | null | null | false | undefined = any>(config: Omit<ArkosRouteConfig<TQuery, TBody, TParams>, "path">, ...handlers: Array<ArkosErrorRequestHandler<InferValidationType<TParams, Record<string, string>>, any, InferValidationType<TBody, any>, InferValidationType<TQuery, qs.ParsedQs>, Locals> | Array<ArkosErrorRequestHandler<InferValidationType<TParams, Record<string, string>>, any, InferValidationType<TBody, any>, InferValidationType<TQuery, qs.ParsedQs>, Locals>>>): T;
 };
 /**
  * Handler function for `use` that accepts route configuration and middleware handlers.
@@ -41,6 +52,7 @@ export type ArkosRouteMethodHandler<T> = {
 export type UseMethodHandler<T> = IRouterHandler<T> & IRouterMatcher<T> & {
     (config: ArkosUseConfig, ...handlers: Array<ArkosRequestHandler | Array<ArkosRequestHandler>>): T;
     (config: ArkosUseConfig, ...handlers: Array<ArkosErrorRequestHandler | Array<ArkosErrorRequestHandler>>): T;
+    (...handlers: Array<ArkosRequestHandler | Array<ArkosRequestHandler>>): T;
 };
 export interface IArkosRoute extends IRoute {
     /** GET method handler with route configuration support */
@@ -110,7 +122,7 @@ export interface IArkosRouter extends IRouter {
 /**
  * Configuration object for defining routes in Arkos.js.
  */
-export type ArkosRouteConfig<TQuery extends ZodSchema | (new (...args: any[]) => object) | false | undefined = any, TBody extends ZodSchema | (new (...args: any[]) => object) | false | undefined = any, TParams extends ZodSchema | (new (...args: any[]) => object) | false | undefined = any> = {
+export type ArkosRouteConfig<TQuery extends ZodSchema | (new (...args: any[]) => object) | null | false | null | undefined = any, TBody extends ZodSchema | (new (...args: any[]) => object) | null | false | null | undefined = any, TParams extends ZodSchema | (new (...args: any[]) => object) | null | false | null | undefined = any> = {
     /**
      * Disables the route by not mounting it internally.
      */
@@ -139,10 +151,11 @@ export type ArkosRouteConfig<TQuery extends ZodSchema | (new (...args: any[]) =>
      *
      * @remarks
      * - Set to `false` to disable all validation.
+     * - Set to `null` to forbidden all request inputs.
      * - Provide an object with `query`, `body`, and/or `params` properties to validate specific parts of the request.
      * - Each property accepts a Zod schema, a class constructor, or `false` to disable validation for that part.
      */
-    validation?: false | {
+    validation?: false | null | {
         query?: TQuery;
         body?: TBody;
         params?: TParams;

package/dist/types/utils/arkos-router/types/upload-config.d.ts

@@ -16,7 +16,7 @@ export type UploadConfig =
  */
 ({
     type: "single";
-    /** Name of the multipart form field to process */
+    /** Name of the multipart form field to process. Supports bracket notation, including nested array paths (e.g. "banners[][image]") */
     field: string;
 } & ArkosRouterBaseUploadConfig)
 /**
@@ -39,10 +39,12 @@ export type UploadConfig =
  */
  | ({
     type: "array";
-    /** Shared name of the multipart form fields to process */
+    /** Shared name of the multipart form fields to process. Supports bracket notation, including nested array paths (e.g. "banners[][images]") */
     field: string;
     /** Maximum number of files to process (defaults to framework config) */
     maxCount?: number;
+    /** Minimum number of files required */
+    minCount?: number;
 } & ArkosRouterBaseUploadConfig)
 /**
  * Creates middleware that processes multiple files associated with the
@@ -52,18 +54,25 @@ export type UploadConfig =
  * maps each field name to an array of the associated file information
  * objects.
  *
- * @throws `MulterError('LIMIT_UNEXPECTED_FILE')` if more than `maxCount` files are associated with `fieldName` for any field
+ * Each field entry is a full single or array upload config with a `name`
+ * property. Field names support bracket notation, including nested array
+ * paths (e.g. "banners[][images]").
  *
  * @example
  * uploads: {
  *   type: "fields",
  *   fields: [
- *     { field: "avatar", maxCount: 1, uploadDir: "images" },
- *     { field: "resume", maxCount: 1, uploadDir: "documents" }
+ *     { name: "avatar", type: "single", uploadDir: "images" },
+ *     { name: "resume", type: "single", uploadDir: "documents" },
+ *     { name: "banners[][images]", type: "array", maxCount: 5, uploadDir: "banners" }
  *   ]
  * }
  */
  | ({
+    type: "fields";
+    /** Array of field configurations describing multipart form fields to process */
+    fields: UploadConfigFieldEntry[];
+} & Pick<ArkosRouterBaseUploadConfig, "deleteOnError">) | ({
     type: "fields";
     /** Array of field configurations describing multipart form fields to process */
     fields: {
@@ -71,12 +80,59 @@ export type UploadConfig =
         name: string;
         /** Maximum number of files for this field (defaults to framework config) */
         maxCount?: number;
+        minCount?: number;
     }[];
 } & ArkosRouterBaseUploadConfig);
 /**
- * Base configuration options for file uploads.
- * These settings can override framework-level defaults for specific routes.
+ * A single field entry inside a `fields` upload config.
+ * Each entry is a full single or array upload config with an additional
+ * `name` property identifying the form field.
+ *
+ * Field names support bracket notation, including nested array paths
+ * (e.g. "banners[][images]"). For nested array paths, multer validation
+ * is bypassed and constraints (allowedFileTypes, maxSize, minCount, maxCount)
+ * are enforced per group after upload.
+ */
+export type UploadConfigFieldEntry = 
+/**
+ * A single-file field entry.
+ *
+ * @example
+ * { name: "avatar", type: "single", uploadDir: "images", required: true }
+ *
+ * @example
+ * // nested array path — one image per banner
+ * { name: "banners[][image]", type: "single", uploadDir: "banners" }
+ */
+({
+    /** Name of the form field. Supports bracket notation including nested array paths. */
+    name: string;
+    type: "single";
+} & Omit<ArkosRouterBaseUploadConfig, "deleteOnError">)
+/**
+ * A multi-file field entry.
+ *
+ * @example
+ * { name: "gallery", type: "array", maxCount: 6, uploadDir: "gallery" }
+ *
+ * @example
+ * // nested array path — multiple images per banner, min 1 max 5
+ * { name: "banners[][images]", type: "array", minCount: 1, maxCount: 5, uploadDir: "banners" }
  */
+ | ({
+    /** Name of the form field. Supports bracket notation including nested array paths. */
+    name: string;
+    type?: "array";
+    /** Maximum number of files for this field (defaults to framework config) */
+    maxCount?: number;
+    /** Minimum number of files required for this field */
+    minCount?: number;
+} & Omit<ArkosRouterBaseUploadConfig, "deleteOnError">); /**
+
+/**
+* Base configuration options for file uploads.
+* These settings can override framework-level defaults for specific routes.
+*/
 export type ArkosRouterBaseUploadConfig = {
     /**
      * Directory category where files will be stored.

package/dist/types/utils/arkos-router/utils/helpers/apply-arkos-router-proxy.d.ts

@@ -4,4 +4,4 @@ export declare function applyArkosRouterProxy<T extends object>(target: T, optio
     openapi?: {
         tags?: string[];
     };
-}, name?: "app" | "ArkosRouter()"): T;
+}, component?: "app" | "router"): T;

package/dist/types/utils/arkos-router/utils/helpers/index.d.ts

@@ -1,8 +1,10 @@
 import { ArkosRouteConfig } from "../../types";
+import { ArkosRouterOptions } from "../..";
 export declare function extractArkosRoutes(app: any, basePath?: string): Array<{
     path: string;
     method: string;
     config?: ArkosRouteConfig;
+    routeOptions?: ArkosRouterOptions;
 }>;
 export declare function getMiddlewareStack(config: ArkosRouteConfig | Omit<ArkosRouteConfig, "path">): any[];
 /**

package/dist/types/utils/arkos-router/utils/helpers/upload-manager.d.ts

@@ -5,45 +5,9 @@ declare class UploadManager {
     private getUpload;
     getMiddleware(config: UploadConfig): RequestHandler;
     handleUpload(config: UploadConfig, oldFilePath?: string): any;
-    /**
-     * Validates that all required upload files are present in the request.
-     * Checks req.file or req.files based on upload configuration type.
-     *
-     * @param {UploadConfig} uploadConfig - The upload configuration from config.experimental.uploads
-     * @throws {AppError} If required files are missing
-     *
-     * @example
-     * // Single file upload - checks req.file
-     * validateRequiredFiles(
-     *   { type: 'single', field: 'avatar', required: true },
-     *   req,
-     *   '/users/:id/avatar'
-     * )
-     *
-     * @example
-     * // Array file upload - checks req.files array
-     * validateRequiredFiles(
-     *   { type: 'array', field: 'photos', required: true },
-     *   req,
-     *   '/gallery/upload'
-     * )
-     *
-     * @example
-     * // Multiple fields - checks req.files object
-     * validateRequiredFiles(
-     *   { type: 'fields', fields: [{ name: 'avatar' }, { name: 'resume' }], required: true },
-     *   req,
-     *   '/profile/upload'
-     * )
-     */
     validateRequiredFiles(uploadConfig: UploadConfig): any;
     handleFileCleanup(config: UploadConfig): (err: any, req: ArkosRequest, _: ArkosResponse, next: ArkosNextFunction) => Promise<void>;
     handlePostUpload(config: UploadConfig): any;
-    /**
-     * Validates the file's type and MIME type.
-     * @param {Express.Multer.File} file - The uploaded file.
-     * @param {Function} cb - The callback function to indicate if file is valid.
-     */
     private fileFilter;
 }
 declare const uploadManager: UploadManager;

package/dist/types/utils/bundler.d.ts

@@ -87,7 +87,7 @@ export declare class Bundler {
      * @param filePath - Absolute path to the JSON file
      * @returns Parsed object, or empty object if parsing fails
      */
-    private readJsonWithComments;
+    readJsonWithComments(filePath: string): any;
     /**
      * Resolves a single import path to its final rewritten form.
      *

package/dist/types/utils/cli/generate.d.ts

@@ -5,7 +5,6 @@ export type GenerateOptions = {
     path?: string;
     model?: string;
     module?: string;
-    modules?: string;
     overwrite?: boolean;
     shouldExit?: boolean;
     shouldPrintError?: boolean;

package/dist/types/utils/cli/start.d.ts

@@ -5,7 +5,7 @@ interface StartOptions {
 /**
  * Production start command for the arkos CLI
  */
-export declare function startCommand(options?: StartOptions): void;
+export declare function startCommand(options?: StartOptions): Promise<void>;
 /**
  * Help function to help other processes to terminate the production server child process
  */

package/dist/types/utils/helpers/arkos-config.helpers.d.ts

@@ -7,3 +7,5 @@ export declare function isAuthenticationEnabled(): boolean | undefined;
  * @returns {ArkosConfig}
  */
 export declare function getArkosConfig(): UserArkosConfig;
+export declare function isProduction(): boolean;
+export declare function validateArkosConfig(): void;

package/dist/types/utils/helpers/fs.helpers.d.ts

@@ -12,4 +12,4 @@ export declare let userFileExtension: "ts" | "js" | undefined;
  * Returns 'ts' when TypeScript config exists and not in build mode, otherwise 'js'
  * @returns 'ts' | 'js'
  */
-export declare const getUserFileExtension: () => "ts" | "js";
+export declare const getUserFileExtension: (root?: string) => "ts" | "js";

package/dist/types/utils/helpers/global.helpers.d.ts

@@ -1,5 +1,6 @@
 export declare function getPackageJson(): any;
 export declare function isEsm(): boolean;
+export declare const userRequire: NodeJS.Require;
 export declare function importModule(modulePath: string, options?: {
     fixExtension: boolean;
 }): Promise<any>;

package/dist/types/utils/helpers/url-helpers.d.ts

@@ -0,0 +1 @@
+export declare function lenientDecode(str: string): string;

package/dist/types/utils/prisma/prisma-schema-parser.d.ts

@@ -29,6 +29,7 @@ export declare class PrismaSchemaParser {
     prismaSchemasContent: string;
     parsed: boolean;
     config: SchemaConfig;
+    warningNotLogged: boolean;
     constructor();
     /**
      * Parses the Prisma schema and extracts all models and enums.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkos",
-  "version": "2.0.0-next.13",
+  "version": "2.0.0-next.16",
   "description": "The Express & Prisma RESTful Framework",
   "main": "dist/cjs/exports/index.js",
   "module": "dist/esm/exports/index.js",
@@ -103,7 +103,6 @@
     "test": "jest",
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage",
-    "test:ui": "vitest --ui",
     "test:create": "tsx src/scripts/create-test.ts",
     "publish:test": "npm publish --tag test",
     "publish:beta": "npm publish --tag beta",
@@ -147,13 +146,13 @@
     "@types/compression": "1.7.5",
     "@types/cookie-parser": "1.4.8",
     "@types/cors": "2.8.17",
-    "@types/express": "5.0.0",
+    "@types/express": "4.17.25",
     "@types/html-to-text": "9.0.4",
     "@types/jest": "29.5.14",
     "@types/jsonwebtoken": "9.0.9",
     "@types/multer": "2.0.0",
     "@types/node": "22.13.13",
-    "@types/nodemailer": "6.4.17",
+    "@types/nodemailer": "8.0.0",
     "@types/pluralize": "0.0.33",
     "@types/swagger-jsdoc": "6.0.4",
     "@typescript-eslint/eslint-plugin": "6.0.0",
@@ -166,11 +165,11 @@
     "openapi-types": "12.1.3",
     "prisma": "6.19.2",
     "ts-jest": "29.3.1",
+    "ts-node": "^10.9.2",
     "ts-prune": "0.10.3",
     "tsx": "4.20.3",
     "type-fest": "4.41.0",
-    "typescript": "5.8.2",
-    "vitest": "3.2.4"
+    "typescript": "5.8.2"
   },
   "dependencies": {
     "chokidar": "4.0.3",
@@ -179,24 +178,25 @@
   },
   "peerDependencies": {
     "@prisma/client": "6.19.2",
+    "@scalar/api-reference": "1.55.3",
     "@scalar/express-api-reference": "0.8.35",
     "bcryptjs": "3.0.2",
     "class-transformer": "0.5.1",
     "class-validator": "0.14.1",
     "class-validator-jsonschema": "5.0.2",
-    "compression": "1.8.0",
+    "compression": "1.8.1",
     "cookie-parser": "1.4.7",
-    "cors": "2.8.5",
-    "dotenv": "16.4.7",
-    "dotenv-expand": "12.0.3",
+    "cors": "2.8.6",
+    "dotenv": "17.4.2",
+    "dotenv-expand": "13.0.0",
     "express": "4.22.1",
-    "express-rate-limit": "7.5.0",
+    "express-rate-limit": "8.4.1",
     "html-to-text": "9.0.5",
-    "jsonwebtoken": "9.0.2",
+    "jsonwebtoken": "9.0.3",
     "mimetype": "0.0.8",
-    "multer": "2.0.2",
-    "nodemailer": "6.10.0",
-    "sharp": "0.33.5",
+    "nodemailer": "8.0.7",
+    "sharp": "0.34.5",
+    "multer": "2.1.1",
     "swagger-jsdoc": "6.2.8",
     "zod": "3.24.2",
     "zod-to-json-schema": "3.24.6"

package/dist/cjs/utils/cli/utils/template-generator/templates/route-hook.template.js

@@ -1,39 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateRouteHookTemplate = generateRouteHookTemplate;
-function generateRouteHookTemplate(options) {
-    const { modelName } = options;
-    const isAuthModule = modelName.kebab === "auth";
-    const isFileUploadModule = modelName.kebab === "file-upload" || modelName.kebab === "fileUpload";
-    const moduleType = isAuthModule
-        ? `"auth"`
-        : isFileUploadModule
-            ? `"file-upload"`
-            : `"${modelName.kebab}"`;
-    const methods = isAuthModule
-        ? ["getMe", "login", "logout", "signup", "updateMe", "updatePassword"]
-        : isFileUploadModule
-            ? ["findFile", "uploadFile", "updateFile", "deleteFile"]
-            : [
-                "createOne",
-                "findOne",
-                "findMany",
-                "updateOne",
-                "deleteOne",
-                "createMany",
-                "updateMany",
-                "deleteMany",
-            ];
-    const methodCalls = methods
-        .map((m) => `${modelName.camel}RouteHook.${m}({});`)
-        .join("\n\n");
-    return `import { ArkosRouteHook } from 'arkos';
-
-const ${modelName.camel}RouteHook = ArkosRouteHook(${moduleType});
-
-${methodCalls}
-
-export default ${modelName.camel}RouteHook;
-`;
-}
-//# sourceMappingURL=route-hook.template.js.map

package/dist/cjs/utils/cli/utils/template-generator/templates/route-hook.template.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"route-hook.template.js","sourceRoot":"","sources":["../../../../../../../src/utils/cli/utils/template-generator/templates/route-hook.template.ts"],"names":[],"mappings":";;AAEA,8DAwCC;AAxCD,SAAgB,yBAAyB,CAAC,OAAwB;IAChE,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAE9B,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,KAAK,MAAM,CAAC;IAChD,MAAM,kBAAkB,GACtB,SAAS,CAAC,KAAK,KAAK,aAAa,IAAI,SAAS,CAAC,KAAK,KAAK,YAAY,CAAC;IAExE,MAAM,UAAU,GAAG,YAAY;QAC7B,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,kBAAkB;YAClB,CAAC,CAAC,eAAe;YACjB,CAAC,CAAC,IAAI,SAAS,CAAC,KAAK,GAAG,CAAC;IAE7B,MAAM,OAAO,GAAG,YAAY;QAC1B,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,gBAAgB,CAAC;QACtE,CAAC,CAAC,kBAAkB;YAClB,CAAC,CAAC,CAAC,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,CAAC;YACxD,CAAC,CAAC;gBACE,WAAW;gBACX,SAAS;gBACT,UAAU;gBACV,WAAW;gBACX,WAAW;gBACX,YAAY;gBACZ,YAAY;gBACZ,YAAY;aACb,CAAC;IAER,MAAM,WAAW,GAAG,OAAO;SACxB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC,KAAK,aAAa,CAAC,OAAO,CAAC;SACnD,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,OAAO;;QAED,SAAS,CAAC,KAAK,8BAA8B,UAAU;;EAE7D,WAAW;;iBAEI,SAAS,CAAC,KAAK;CAC/B,CAAC;AACF,CAAC","sourcesContent":["import { TemplateOptions } from \"../../template-generators\";\n\nexport function generateRouteHookTemplate(options: TemplateOptions): string {\n  const { modelName } = options;\n\n  const isAuthModule = modelName.kebab === \"auth\";\n  const isFileUploadModule =\n    modelName.kebab === \"file-upload\" || modelName.kebab === \"fileUpload\";\n\n  const moduleType = isAuthModule\n    ? `\"auth\"`\n    : isFileUploadModule\n      ? `\"file-upload\"`\n      : `\"${modelName.kebab}\"`;\n\n  const methods = isAuthModule\n    ? [\"getMe\", \"login\", \"logout\", \"signup\", \"updateMe\", \"updatePassword\"]\n    : isFileUploadModule\n      ? [\"findFile\", \"uploadFile\", \"updateFile\", \"deleteFile\"]\n      : [\n          \"createOne\",\n          \"findOne\",\n          \"findMany\",\n          \"updateOne\",\n          \"deleteOne\",\n          \"createMany\",\n          \"updateMany\",\n          \"deleteMany\",\n        ];\n\n  const methodCalls = methods\n    .map((m) => `${modelName.camel}RouteHook.${m}({});`)\n    .join(\"\\n\\n\");\n\n  return `import { ArkosRouteHook } from 'arkos';\n\nconst ${modelName.camel}RouteHook = ArkosRouteHook(${moduleType});\n\n${methodCalls}\n\nexport default ${modelName.camel}RouteHook;\n`;\n}\n"]}

package/dist/cjs/utils/cli/utils/template-generator/templates/service-hook.template.js

@@ -1,32 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateServiceHookTemplate = generateServiceHookTemplate;
-function generateServiceHookTemplate(options) {
-    const { modelName } = options;
-    const methods = [
-        "createOne",
-        "createMany",
-        "count",
-        "findMany",
-        "findOne",
-        "findById",
-        "updateOne",
-        "updateById",
-        "updateMany",
-        "deleteOne",
-        "deleteById",
-        "deleteMany",
-    ];
-    const methodCalls = methods
-        .map((m) => `${modelName.camel}ServiceHook.${m}({});`)
-        .join("\n\n");
-    return `import { ArkosServiceHook } from 'arkos';
-
-const ${modelName.camel}ServiceHook = ArkosServiceHook("${modelName.kebab}");
-
-${methodCalls}
-
-export default ${modelName.camel}ServiceHook;
-`;
-}
-//# sourceMappingURL=service-hook.template.js.map

package/dist/cjs/utils/cli/utils/template-generator/templates/service-hook.template.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"service-hook.template.js","sourceRoot":"","sources":["../../../../../../../src/utils/cli/utils/template-generator/templates/service-hook.template.ts"],"names":[],"mappings":";;AAEA,kEA8BC;AA9BD,SAAgB,2BAA2B,CAAC,OAAwB;IAClE,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAE9B,MAAM,OAAO,GAAG;QACd,WAAW;QACX,YAAY;QACZ,OAAO;QACP,UAAU;QACV,SAAS;QACT,UAAU;QACV,WAAW;QACX,YAAY;QACZ,YAAY;QACZ,WAAW;QACX,YAAY;QACZ,YAAY;KACb,CAAC;IAEF,MAAM,WAAW,GAAG,OAAO;SACxB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC,KAAK,eAAe,CAAC,OAAO,CAAC;SACrD,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,OAAO;;QAED,SAAS,CAAC,KAAK,mCAAmC,SAAS,CAAC,KAAK;;EAEvE,WAAW;;iBAEI,SAAS,CAAC,KAAK;CAC/B,CAAC;AACF,CAAC","sourcesContent":["import { TemplateOptions } from \"../../template-generators\";\n\nexport function generateServiceHookTemplate(options: TemplateOptions): string {\n  const { modelName } = options;\n\n  const methods = [\n    \"createOne\",\n    \"createMany\",\n    \"count\",\n    \"findMany\",\n    \"findOne\",\n    \"findById\",\n    \"updateOne\",\n    \"updateById\",\n    \"updateMany\",\n    \"deleteOne\",\n    \"deleteById\",\n    \"deleteMany\",\n  ];\n\n  const methodCalls = methods\n    .map((m) => `${modelName.camel}ServiceHook.${m}({});`)\n    .join(\"\\n\\n\");\n\n  return `import { ArkosServiceHook } from 'arkos';\n\nconst ${modelName.camel}ServiceHook = ArkosServiceHook(\"${modelName.kebab}\");\n\n${methodCalls}\n\nexport default ${modelName.camel}ServiceHook;\n`;\n}\n"]}

package/dist/esm/utils/cli/utils/template-generator/templates/route-hook.template.js

@@ -1,36 +0,0 @@
-export function generateRouteHookTemplate(options) {
-    const { modelName } = options;
-    const isAuthModule = modelName.kebab === "auth";
-    const isFileUploadModule = modelName.kebab === "file-upload" || modelName.kebab === "fileUpload";
-    const moduleType = isAuthModule
-        ? `"auth"`
-        : isFileUploadModule
-            ? `"file-upload"`
-            : `"${modelName.kebab}"`;
-    const methods = isAuthModule
-        ? ["getMe", "login", "logout", "signup", "updateMe", "updatePassword"]
-        : isFileUploadModule
-            ? ["findFile", "uploadFile", "updateFile", "deleteFile"]
-            : [
-                "createOne",
-                "findOne",
-                "findMany",
-                "updateOne",
-                "deleteOne",
-                "createMany",
-                "updateMany",
-                "deleteMany",
-            ];
-    const methodCalls = methods
-        .map((m) => `${modelName.camel}RouteHook.${m}({});`)
-        .join("\n\n");
-    return `import { ArkosRouteHook } from 'arkos';
-
-const ${modelName.camel}RouteHook = ArkosRouteHook(${moduleType});
-
-${methodCalls}
-
-export default ${modelName.camel}RouteHook;
-`;
-}
-//# sourceMappingURL=route-hook.template.js.map

package/dist/esm/utils/cli/utils/template-generator/templates/route-hook.template.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"route-hook.template.js","sourceRoot":"","sources":["../../../../../../../src/utils/cli/utils/template-generator/templates/route-hook.template.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,yBAAyB,CAAC,OAAwB;IAChE,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAE9B,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,KAAK,MAAM,CAAC;IAChD,MAAM,kBAAkB,GACtB,SAAS,CAAC,KAAK,KAAK,aAAa,IAAI,SAAS,CAAC,KAAK,KAAK,YAAY,CAAC;IAExE,MAAM,UAAU,GAAG,YAAY;QAC7B,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,kBAAkB;YAClB,CAAC,CAAC,eAAe;YACjB,CAAC,CAAC,IAAI,SAAS,CAAC,KAAK,GAAG,CAAC;IAE7B,MAAM,OAAO,GAAG,YAAY;QAC1B,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,gBAAgB,CAAC;QACtE,CAAC,CAAC,kBAAkB;YAClB,CAAC,CAAC,CAAC,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,CAAC;YACxD,CAAC,CAAC;gBACE,WAAW;gBACX,SAAS;gBACT,UAAU;gBACV,WAAW;gBACX,WAAW;gBACX,YAAY;gBACZ,YAAY;gBACZ,YAAY;aACb,CAAC;IAER,MAAM,WAAW,GAAG,OAAO;SACxB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC,KAAK,aAAa,CAAC,OAAO,CAAC;SACnD,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,OAAO;;QAED,SAAS,CAAC,KAAK,8BAA8B,UAAU;;EAE7D,WAAW;;iBAEI,SAAS,CAAC,KAAK;CAC/B,CAAC;AACF,CAAC","sourcesContent":["import { TemplateOptions } from \"../../template-generators\";\n\nexport function generateRouteHookTemplate(options: TemplateOptions): string {\n  const { modelName } = options;\n\n  const isAuthModule = modelName.kebab === \"auth\";\n  const isFileUploadModule =\n    modelName.kebab === \"file-upload\" || modelName.kebab === \"fileUpload\";\n\n  const moduleType = isAuthModule\n    ? `\"auth\"`\n    : isFileUploadModule\n      ? `\"file-upload\"`\n      : `\"${modelName.kebab}\"`;\n\n  const methods = isAuthModule\n    ? [\"getMe\", \"login\", \"logout\", \"signup\", \"updateMe\", \"updatePassword\"]\n    : isFileUploadModule\n      ? [\"findFile\", \"uploadFile\", \"updateFile\", \"deleteFile\"]\n      : [\n          \"createOne\",\n          \"findOne\",\n          \"findMany\",\n          \"updateOne\",\n          \"deleteOne\",\n          \"createMany\",\n          \"updateMany\",\n          \"deleteMany\",\n        ];\n\n  const methodCalls = methods\n    .map((m) => `${modelName.camel}RouteHook.${m}({});`)\n    .join(\"\\n\\n\");\n\n  return `import { ArkosRouteHook } from 'arkos';\n\nconst ${modelName.camel}RouteHook = ArkosRouteHook(${moduleType});\n\n${methodCalls}\n\nexport default ${modelName.camel}RouteHook;\n`;\n}\n"]}