tezx 1.0.0 → 1.0.2

package/dist/index.d.ts

@@ -63,9 +63,9 @@ declare class HeadersParser {
      */
     forEach(callback: (value: string[], key: string) => void): void;
     /**
-    * Converts headers into a plain object.
-    * @returns A record of headers where single-value headers are returned as a string.
-    */
+     * Converts headers into a plain object.
+     * @returns A record of headers where single-value headers are returned as a string.
+     */
     toObject(): Record<string, string | string[]>;
 }
 
@@ -88,6 +88,7 @@ type FormDataOptions = {
     maxSize?: number;
     allowedTypes?: string[];
     sanitized?: boolean;
+    maxFiles?: number;
 };
 type HTTPMethod = "GET" | "POST" | "PUT" | "DELETE" | "OPTIONS" | "PATCH" | "HEAD" | "ALL" | "TRACE" | "CONNECT" | string;
 declare class Request$1 {
@@ -115,46 +116,46 @@ declare class Request$1 {
     readonly params: Record<string, any>;
     constructor(req: any, params: Record<string, any>);
     /**
-    * Parses the request body as plain text.
-    * @returns {Promise<string>} The text content of the request body.
-    */
+     * Parses the request body as plain text.
+     * @returns {Promise<string>} The text content of the request body.
+     */
     text(): Promise<string>;
     /**
-    * Parses the request body as JSON.
-    * @returns {Promise<Record<string, any>>} The parsed JSON object.
-    * If the Content-Type is not 'application/json', it returns an empty object.
-    */
+     * Parses the request body as JSON.
+     * @returns {Promise<Record<string, any>>} The parsed JSON object.
+     * If the Content-Type is not 'application/json', it returns an empty object.
+     */
     json(): Promise<Record<string, any>>;
     /**
-    * Parses the request body based on Content-Type.
-    * Supports:
-    * - application/json → JSON parsing
-    * - application/x-www-form-urlencoded → URL-encoded form parsing
-    * - multipart/form-data → Multipart form-data parsing (for file uploads)
-    * @returns {Promise<Record<string, any>>} The parsed form data as an object.
-    * @throws {Error} If the Content-Type is missing or invalid.
-    */
+     * Parses the request body based on Content-Type.
+     * Supports:
+     * - application/json → JSON parsing
+     * - application/x-www-form-urlencoded → URL-encoded form parsing
+     * - multipart/form-data → Multipart form-data parsing (for file uploads)
+     * @returns {Promise<Record<string, any>>} The parsed form data as an object.
+     * @throws {Error} If the Content-Type is missing or invalid.
+     */
     formData(options?: FormDataOptions): Promise<Record<string, any>>;
 }
 
-declare class JetResponse {
-    /**
-    * Sends a JSON response.
-    * @param body - The response data.
-    * @param status - (Optional) HTTP status code (default: 200).
-    * @param headers - (Optional) Additional response headers.
-    * @returns Response object with JSON data.
-    */
+declare class TezResponse {
+    /**
+     * Sends a JSON response.
+     * @param body - The response data.
+     * @param status - (Optional) HTTP status code (default: 200).
+     * @param headers - (Optional) Additional response headers.
+     * @returns Response object with JSON data.
+     */
     static json(body: any, status?: number, headers?: ResponseHeaders): Response;
     static json(body: any, headers?: ResponseHeaders): Response;
     static json(body: any, status?: number): Response;
     /**
-    * Sends an HTML response.
-    * @param data - The HTML content as a string.
-    * @param status - (Optional) HTTP status code (default: 200).
-    * @param headers - (Optional) Additional response headers.
-    * @returns Response object with HTML data.
-    */
+     * Sends an HTML response.
+     * @param data - The HTML content as a string.
+     * @param status - (Optional) HTTP status code (default: 200).
+     * @param headers - (Optional) Additional response headers.
+     * @returns Response object with HTML data.
+     */
     static html(data: string, status?: number, headers?: ResponseHeaders): Response;
     static html(data: string, headers?: ResponseHeaders): Response;
     static html(data: string, status?: number): Response;
@@ -190,19 +191,19 @@ declare class JetResponse {
     static send(body: any, headers?: ResponseHeaders): Response;
     static send(body: any, status?: number): Response;
     /**
-    * Redirects to a given URL.
-    * @param url - The target URL.
-    * @param status - (Optional) HTTP status code (default: 302).
-    * @param headers - (Optional) Additional headers.
-    * @returns Response object with redirect.
-    */
+     * Redirects to a given URL.
+     * @param url - The target URL.
+     * @param status - (Optional) HTTP status code (default: 302).
+     * @param headers - (Optional) Additional headers.
+     * @returns Response object with redirect.
+     */
     static redirect(url: string, status?: number, headers?: ResponseHeaders): Response;
     /**
-    * Handles file downloads.
-    * @param filePath - The path to the file.
-    * @param fileName - The name of the downloaded file.
-    * @returns Response object for file download.
-    */
+     * Handles file downloads.
+     * @param filePath - The path to the file.
+     * @param fileName - The name of the downloaded file.
+     * @returns Response object for file download.
+     */
     static download(filePath: string, fileName: string): Promise<Response>;
     /**
      * Serves a file to the client.
@@ -274,7 +275,7 @@ interface CookieOptions {
     domain?: string;
     secure?: boolean;
     httpOnly?: boolean;
-    sameSite?: 'Strict' | 'Lax' | 'None';
+    sameSite?: "Strict" | "Lax" | "None";
 }
 type ResponseHeaders = Record<string, string>;
 declare class Context<T extends Record<string, any> = {}> {
@@ -291,19 +292,14 @@ declare class Context<T extends Record<string, any> = {}> {
      */
     headers: HeadersParser;
     /**
-     * Parser for handling and manipulating HTTP response
-     * @type {Response}
+     * Request path without query parameters
+     * @type {string}
      */
-    res: Response;
-    /**
-    * Request path without query parameters
-    * @type {string}
-    */
     readonly pathname: string;
     /**
-    * Full request URL including protocol and query string
-    * @type {string}
-    */
+     * Full request URL including protocol and query string
+     * @type {string}
+     */
     readonly url: string;
     /**
      * HTTP request method (GET, POST, PUT, DELETE, etc.)
@@ -323,14 +319,14 @@ declare class Context<T extends Record<string, any> = {}> {
     finalized: boolean;
     constructor(req: any);
     /**
-    * Cookie handling utility with get/set/delete operations
-    * @returns {{
-    *  get: (name: string) => string | undefined,
-    *  all: () => Record<string, string>,
-    *  delete: (name: string, options?: CookieOptions) => void,
-    *  set: (name: string, value: string, options?: CookieOptions) => void
-    * }} Cookie handling interface
-    */
+     * Cookie handling utility with get/set/delete operations
+     * @returns {{
+     *  get: (name: string) => string | undefined,
+     *  all: () => Record<string, string>,
+     *  delete: (name: string, options?: CookieOptions) => void,
+     *  set: (name: string, value: string, options?: CookieOptions) => void
+     * }} Cookie handling interface
+     */
     get cookies(): {
         /**
          * Get a specific cookie by name.
@@ -339,62 +335,62 @@ declare class Context<T extends Record<string, any> = {}> {
          */
         get: (cookie: string) => string;
         /**
-        * Get all cookies as an object.
-        * @returns {Record<string, string>} - An object containing all cookies.
-        */
+         * Get all cookies as an object.
+         * @returns {Record<string, string>} - An object containing all cookies.
+         */
         all: () => Record<string, string>;
         /**
-        * Delete a cookie by setting its expiration to the past.
-        * @param {string} name - The name of the cookie to delete.
-        * @param {CookieOptions} [options] - Additional cookie options.
-        */
+         * Delete a cookie by setting its expiration to the past.
+         * @param {string} name - The name of the cookie to delete.
+         * @param {CookieOptions} [options] - Additional cookie options.
+         */
         delete: (name: string, options?: CookieOptions) => void;
         /**
-        * Set a new cookie with the given name, value, and options.
-        * @param {string} name - The name of the cookie.
-        * @param {string} value - The value of the cookie.
-        * @param {CookieOptions} [options] - Additional options like expiration.
-        */
+         * Set a new cookie with the given name, value, and options.
+         * @param {string} name - The name of the cookie.
+         * @param {string} value - The value of the cookie.
+         * @param {CookieOptions} [options] - Additional options like expiration.
+         */
         set: (name: string, value: string, options?: CookieOptions) => void;
     };
     /**
-    * Sends a JSON response.
-    * @param body - The response data.
-    * @param status - (Optional) HTTP status code (default: 200).
-    * @param headers - (Optional) Additional response headers.
-    * @returns Response object with JSON data.
-    */
-    json(body: any, status?: number, headers?: ResponseHeaders): JetResponse;
-    json(body: any, headers?: ResponseHeaders): JetResponse;
-    json(body: any, status?: number): JetResponse;
-    /**
-    * Sends a response with any content type.
-    * Automatically determines content type if not provided.
-    * @param body - The response body.
-    * @param status - (Optional) HTTP status code.
-    * @param headers - (Optional) Additional response headers.
-    * @returns Response object.
-    */
+     * Sends a JSON response.
+     * @param body - The response data.
+     * @param status - (Optional) HTTP status code (default: 200).
+     * @param headers - (Optional) Additional response headers.
+     * @returns Response object with JSON data.
+     */
+    json(body: any, status?: number, headers?: ResponseHeaders): TezResponse;
+    json(body: any, headers?: ResponseHeaders): TezResponse;
+    json(body: any, status?: number): TezResponse;
+    /**
+     * Sends a response with any content type.
+     * Automatically determines content type if not provided.
+     * @param body - The response body.
+     * @param status - (Optional) HTTP status code.
+     * @param headers - (Optional) Additional response headers.
+     * @returns Response object.
+     */
     send(body: any, status?: number, headers?: ResponseHeaders): any;
     send(body: any, headers?: ResponseHeaders): any;
     send(body: any, status?: number): any;
     /**
-    * Sends an HTML response.
-    * @param data - The HTML content as a string.
-    * @param status - (Optional) HTTP status code (default: 200).
-    * @param headers - (Optional) Additional response headers.
-    * @returns Response object with HTML data.
-    */
+     * Sends an HTML response.
+     * @param data - The HTML content as a string.
+     * @param status - (Optional) HTTP status code (default: 200).
+     * @param headers - (Optional) Additional response headers.
+     * @returns Response object with HTML data.
+     */
     html(data: string, status?: number, headers?: ResponseHeaders): any;
     html(data: string, headers?: ResponseHeaders): any;
     html(data: string, status?: number): any;
     /**
-    * Sends a plain text response.
-    * @param data - The text content.
-    * @param status - (Optional) HTTP status code (default: 200).
-    * @param headers - (Optional) Additional response headers.
-    * @returns Response object with plain text data.
-    */
+     * Sends a plain text response.
+     * @param data - The text content.
+     * @param status - (Optional) HTTP status code (default: 200).
+     * @param headers - (Optional) Additional response headers.
+     * @returns Response object with plain text data.
+     */
     text(data: string, status?: number, headers?: ResponseHeaders): any;
     text(data: string, headers?: ResponseHeaders): any;
     text(data: string, status?: number): any;
@@ -409,10 +405,10 @@ declare class Context<T extends Record<string, any> = {}> {
     xml(data: string, headers?: ResponseHeaders): any;
     xml(data: string, status?: number): any;
     /**
-   * HTTP status code..
-   * @param status - number.
-   * @returns Response object with context all method.
-   */
+     * HTTP status code..
+     * @param status - number.
+     * @returns Response object with context all method.
+     */
     status: (status: number) => this;
     /**
      * Redirects to a given URL.
@@ -423,19 +419,19 @@ declare class Context<T extends Record<string, any> = {}> {
      */
     redirect(url: string, status?: number, headers?: ResponseHeaders): Response;
     /**
-   * Handles file downloads.
-   * @param filePath - The path to the file.
-   * @param fileName - The name of the downloaded file.
-   * @returns Response object for file download.
-   */
+     * Handles file downloads.
+     * @param filePath - The path to the file.
+     * @param fileName - The name of the downloaded file.
+     * @returns Response object for file download.
+     */
     download(filePath: string, fileName: string): Promise<Response>;
     /**
-    * Serves a file to the client.
-    * @param filePath - Absolute or relative path to the file.
-    * @param fileName - (Optional) The name of the send file.
-    * @param headers - (Optional) Additional headers.
-    * @returns Response object with the file stream.
-    */
+     * Serves a file to the client.
+     * @param filePath - Absolute or relative path to the file.
+     * @param fileName - (Optional) The name of the send file.
+     * @param headers - (Optional) Additional headers.
+     * @returns Response object with the file stream.
+     */
     sendFile(filePath: string, fileName?: string, headers?: ResponseHeaders): Promise<Response>;
     sendFile(filePath: string, headers?: ResponseHeaders): Promise<Response>;
     sendFile(filePath: string, fileName?: string): Promise<Response>;
@@ -473,10 +469,11 @@ declare class CommonHandler {
     onError(callback: <T extends Record<string, any> = {}>(err: string, ctx: ctx<T>) => any): this;
 }
 
+type DuplicateMiddlewares = Middleware<any>[];
+type UniqueMiddlewares = Set<Middleware<any>>;
 declare class TriMiddleware {
     children: Map<string, TriMiddleware>;
-    middlewares: Middleware<any>[];
-    groupMiddlewares: Map<string, Middleware<any>[]>;
+    middlewares: DuplicateMiddlewares | UniqueMiddlewares;
     isOptional: boolean;
     pathname: string;
     constructor(pathname?: string);
@@ -490,33 +487,61 @@ declare class MiddlewareConfigure<T extends Record<string, any> = {}> extends Co
 
 type NextCallback = () => Promise<any>;
 type ctx<T extends Record<string, any> = {}> = Context<T> & T;
-type Callback<T extends Record<string, any> = {}> = (ctx: ctx<T>) => void;
-type Middleware<T extends Record<string, any> = {}> = (ctx: ctx<T>, next: NextCallback) => void;
+type Callback<T extends Record<string, any> = {}> = (ctx: ctx<T>) => Promise<TezResponse> | TezResponse;
+type Middleware<T extends Record<string, any> = {}> = (ctx: ctx<T>, next: NextCallback) => NextCallback | Promise<TezResponse> | TezResponse;
 type RouterConfig = {
+    /**
+     * `env` allows you to define environment variables for the router.
+     * It is a record of key-value pairs where the key is the variable name
+     * and the value can be either a string or a number.
+     */
     env?: Record<string, string | number>;
+    /**
+     * `basePath` sets the base path for the router. This is useful for grouping
+     * routes under a specific path prefix.
+     */
     basePath?: string;
 };
 declare class TrieRouter {
     children: Map<string, TrieRouter>;
     handlers: Map<HTTPMethod, {
-        handlerID?: string;
         callback: Callback<any>;
-        middlewares: Middleware<any>[];
+        middlewares: UniqueMiddlewares | DuplicateMiddlewares;
     }>;
     pathname: string;
     paramName: any;
     isParam: boolean;
     constructor(pathname?: string);
 }
+type StaticServeOption = {
+    cacheControl?: string;
+    headers?: ResponseHeaders;
+};
 declare class Router<T extends Record<string, any> = {}> extends MiddlewareConfigure<T> {
     #private;
     protected routers: Map<string, Map<HTTPMethod, {
         callback: Callback<T>;
-        handlerID?: string;
-        middlewares: Middleware<T>[];
+        middlewares: UniqueMiddlewares | DuplicateMiddlewares;
     }>>;
-    protected rootNode: TrieRouter;
+    protected env: Record<string, string | number>;
+    protected triRouter: TrieRouter;
     constructor({ basePath, env }?: RouterConfig);
+    /**
+     * Serves static files from a specified directory.
+     *
+     * This method provides two overloads:
+     * 1. `static(route: string, folder: string, option?: StaticServeOption): this;`
+     *    - Serves static files from `folder` at the specified `route`.
+     * 2. `static(folder: string, option?: StaticServeOption): this;`
+     *    - Serves static files from `folder` at the root (`/`).
+     *
+     * @param {string} route - The base route to serve static files from (optional in overload).
+     * @param {string} folder - The folder containing the static files.
+     * @param {StaticServeOption} [option] - Optional settings for static file serving.
+     * @returns {this} Returns the current instance to allow method chaining.
+     */
+    static(route: string, folder: string, option?: StaticServeOption): this;
+    static(folder: string, Option?: StaticServeOption): this;
     /**
      * Registers a GET route with optional middleware(s)
      * @param path - URL path pattern (supports route parameters)
@@ -537,10 +562,10 @@ declare class Router<T extends Record<string, any> = {}> extends MiddlewareConfi
     get(path: string, middlewares: Middleware<T>[], callback: Callback<T>): this;
     get(path: string, middlewares: Middleware<T>, callback: Callback<T>): this;
     /**
-    * Registers a POST route with optional middleware(s)
-    * @param path - URL path pattern
-    * @param args - Handler callback or middleware(s) + handler
-    */
+     * Registers a POST route with optional middleware(s)
+     * @param path - URL path pattern
+     * @param args - Handler callback or middleware(s) + handler
+     */
     post(path: string, callback: Callback<T>): this;
     post(path: string, middlewares: Middleware<T>[], callback: Callback<T>): this;
     post(path: string, middlewares: Middleware<T>, callback: Callback<T>): this;
@@ -593,29 +618,29 @@ declare class Router<T extends Record<string, any> = {}> extends MiddlewareConfi
     all(path: string, middlewares: Middleware<T>[], callback: Callback<T>): this;
     all(path: string, middlewares: Middleware<T>, callback: Callback<T>): this;
     /**
-    * Generic method registration for custom HTTP methods
-    * @param method - HTTP method name (e.g., 'PURGE')
-    * @param path - URL path pattern
-    * @param args - Handler callback or middleware(s) + handler
-    *
-    * @example
-    * // Register custom method
-    * server.addRoute('PURGE', '/cache', purgeHandler);
-    */
+     * Generic method registration for custom HTTP methods
+     * @param method - HTTP method name (e.g., 'PURGE')
+     * @param path - URL path pattern
+     * @param args - Handler callback or middleware(s) + handler
+     *
+     * @example
+     * // Register custom method
+     * server.addRoute('PURGE', '/cache', purgeHandler);
+     */
     addRoute(method: HTTPMethod, path: string, callback: Callback<T>): this;
     addRoute(method: HTTPMethod, path: string, middlewares: Middleware<T>[], callback: Callback<T>): this;
     addRoute(method: HTTPMethod, path: string, middlewares: Middleware<T>, callback: Callback<T>): this;
     /**
-    * Mount a sub-router at specific path prefix
-    * @param path - Base path for the sub-router
-    * @param router - Router instance to mount
-    * @returns Current instance for chaining
-    *
-    * @example
-    * const apiRouter = new Router();
-    * apiRouter.get('/users', () => { ... });
-    * server.addRouter('/api', apiRouter);
-    */
+     * Mount a sub-router at specific path prefix
+     * @param path - Base path for the sub-router
+     * @param router - Router instance to mount
+     * @returns Current instance for chaining
+     *
+     * @example
+     * const apiRouter = new Router();
+     * apiRouter.get('/users', () => { ... });
+     * server.addRouter('/api', apiRouter);
+     */
     addRouter(path: string, router: Router<T>): void;
     /**
      * Create route group with shared path prefix
@@ -630,12 +655,12 @@ declare class Router<T extends Record<string, any> = {}> extends MiddlewareConfi
      */
     group(prefix: string, callback: (group: Router<T>) => void): this;
     /**
-   * Register middleware with flexible signature
-   * @overload
-   * @param path - Optional path to scope middleware
-   * @param middlewares - Middleware(s) to register
-   * @param [callback] - Optional sub-router or handler
-   */
+     * Register middleware with flexible signature
+     * @overload
+     * @param path - Optional path to scope middleware
+     * @param middlewares - Middleware(s) to register
+     * @param [callback] - Optional sub-router or handler
+     */
     use(path: string, middlewares: Middleware<T>[], callback: Callback<T> | Router<T | any>): this;
     use(path: string, middleware: Middleware<T>, callback: Callback<T> | Router<T | any>): this;
     use(path: string, middlewares: Middleware<T>[]): this;
@@ -665,32 +690,67 @@ type LoggerFnType = () => {
     debug?: (msg: string, ...args: unknown[]) => void;
     success?: (msg: string, ...args: unknown[]) => void;
 };
-type AcceleroConfig = {
+type TezXConfig = {
+    /**
+     * `allowDuplicateMw` determines whether duplicate middleware functions
+     * are allowed in the router.
+     *
+     * - When `true`: The same middleware can be added multiple times.
+     * - When `false`: Ensures each middleware is registered only once
+     *   per route or application context.
+     *
+     * @default false
+     */
+    allowDuplicateMw?: boolean;
+    /**
+     * `overwriteMethod` controls whether existing route handlers
+     * should be overwritten when a new handler for the same
+     * HTTP method and path is added.
+     *
+     * - When `true`: The new handler replaces the existing one.
+     * - When `false`: Prevents overwriting, ensuring that the
+     *   first registered handler remains active.
+     *
+     * @default true
+     */
+    overwriteMethod?: boolean;
+    /**
+     * `logger` is an optional function that handles logging within the application.
+     * It should conform to the `LoggerFnType`, which defines the expected signature for the logging function.
+     *
+     * If provided, this function will be called for logging purposes throughout the application.
+     */
     logger?: LoggerFnType;
-    middlewareRule?: "follow" | "ignore";
 } & RouterConfig;
-declare class Accelero<T extends Record<string, any> = {}> extends Router<T> {
+declare class TezX<T extends Record<string, any> = {}> extends Router<T> {
     #private;
-    constructor({ basePath, middlewareRule, env, logger, }?: AcceleroConfig);
+    constructor({ basePath, env, logger, allowDuplicateMw, overwriteMethod, }?: TezXConfig);
     protected findRoute(method: HTTPMethod, pathname: string): {
         callback: any;
         middlewares: Middleware<T>[];
         params: Record<string, string>;
-        handlerID?: string;
     } | null;
     serve(req: Request): Promise<ServeResponse | any>;
 }
 
-declare function denoAdapter<T extends Record<string, any> = {}>(Accelero: Accelero<T>): {
+declare function denoAdapter<T extends Record<string, any> = {}>(TezX: TezX<T>): {
     listen: (port: number, callback?: (message: string) => void) => any;
 };
-declare function bunAdapter<T extends Record<string, any> = {}>(Accelero: Accelero<T>): {
+declare function bunAdapter<T extends Record<string, any> = {}>(TezX: TezX<T>): {
     listen: (port: number, callback?: (message: string) => void) => any;
 };
-declare function nodeAdapter<T extends Record<string, any> = {}>(Accelero: Accelero<T>): {
+declare function nodeAdapter<T extends Record<string, any> = {}>(TezX: TezX<T>): {
     listen: (port: number, callback?: (message: string) => void) => void;
 };
 
+declare function useParams({ path, urlPattern, }: {
+    path: string;
+    urlPattern: string;
+}): {
+    success: boolean;
+    params: Record<string, any>;
+};
+
 /**
  * Loads environment variables from .env files.
  * @param basePath - The base directory where .env files are located.
@@ -723,4 +783,4 @@ type CorsOptions = {
 };
 declare function cors(option?: CorsOptions): (ctx: ctx, next: () => Promise<any>) => Promise<any>;
 
-export { Accelero, type AcceleroConfig, type Callback, type ctx as Context, type CorsOptions, JetResponse, type LogLevel, type LoggerFnType, type Middleware, type NextCallback, Router, type RouterConfig, type UrlRef, bunAdapter, cors, denoAdapter, loadEnv, logger, nodeAdapter };
+export { type Callback, type ctx as Context, type CorsOptions, type LogLevel, type LoggerFnType, type Middleware, type NextCallback, Router, type RouterConfig, type StaticServeOption, TezResponse, TezX, type TezXConfig, type UrlRef, bunAdapter, cors, denoAdapter, loadEnv, logger, nodeAdapter, useParams };