tezx 1.0.40 → 1.0.42

package/cjs/core/context.js

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Context = exports.httpStatusMap = void 0;
+const state_1 = require("../utils/state");
+const staticFile_1 = require("../utils/staticFile");
 const environment_1 = require("./environment");
 const header_1 = require("./header");
 const request_1 = require("./request");
-const state_1 = require("../utils/state");
-const staticFile_1 = require("../utils/staticFile");
 exports.httpStatusMap = {
     100: "Continue",
     101: "Switching Protocols",
@@ -75,14 +75,14 @@ class Context {
     #rawRequest;
     env = {};
     headers = new header_1.HeadersParser();
-    res;
     pathname;
     url;
     method;
     #status = 200;
     state = new state_1.State();
     #params = {};
-    #resBody;
+    resBody;
+    #body;
     #localAddress = {};
     #remoteAddress = {};
     constructor(req, connInfo) {
@@ -93,8 +93,14 @@ class Context {
         this.pathname = this.req.urlRef.pathname;
         this.url = this.req.url;
     }
-    header(key, value) {
-        this.headers.set(key, value);
+    header(key, value, options) {
+        let append = options?.append;
+        if (append) {
+            this.headers.append(key, value);
+        }
+        else {
+            this.headers.set(key, value);
+        }
         return this;
     }
     get cookies() {
@@ -387,10 +393,8 @@ class Context {
             status: status,
             headers,
         });
-        let clone = response.clone();
-        this.body = body;
-        this.res = response;
-        return clone;
+        this.resBody = body;
+        return response;
     }
     get req() {
         return new request_1.Request(this.#rawRequest, this.params, this.#remoteAddress);
@@ -399,10 +403,10 @@ class Context {
         this.#params = params;
     }
     set body(body) {
-        this.#resBody = body;
+        this.#body = body;
     }
     get body() {
-        return this.#resBody;
+        return this.#body;
     }
     get params() {
         return this.#params;

package/cjs/index.js

@@ -7,4 +7,4 @@ var server_1 = require("./core/server");
 Object.defineProperty(exports, "TezX", { enumerable: true, get: function () { return server_1.TezX; } });
 var params_1 = require("./utils/params");
 Object.defineProperty(exports, "useParams", { enumerable: true, get: function () { return params_1.useParams; } });
-exports.version = "1.0.40";
+exports.version = "1.0.42";

package/cjs/middleware/detectBot.js

@@ -7,7 +7,7 @@ const config_1 = require("../core/config");
 const detectBot = (options = {}) => {
     const { botUserAgents = ["bot", "spider", "crawl", "slurp"], maxRequests = 30, windowMs = 60000, isBlacklisted = async () => false, queryKeyBot = "bot", onBotDetected = "block", enableRateLimiting = false, customBotDetector = async () => false, customBlockedResponse = (ctx, { reason }) => {
         ctx.setStatus = 403;
-        ctx.body = { error: `Bot detected: ${reason}` };
+        return ctx.json({ error: `Bot detected: ${reason}` });
     }, storage, confidenceThreshold = 0.5, } = options;
     let store = storage;
     if (enableRateLimiting) {

package/cjs/middleware/pagination.js

@@ -40,12 +40,13 @@ const paginationHandler = (options = {}) => {
                 [countKey]: total,
                 pagination,
             };
+            ctx.body = body;
             if (next) {
-                ctx.body = body;
                 return await next();
             }
-            return (ctx.body = body);
+            return ctx.json(body);
         }
+        return await next();
     };
 };
 exports.paginationHandler = paginationHandler;

package/core/context.d.ts

@@ -1,6 +1,6 @@
+import { State } from "../utils/state";
 import { HeadersParser } from "./header";
 import { ConnAddress, HTTPMethod, Request } from "./request";
-import { State } from "../utils/state";
 export interface CookieOptions {
     expires?: Date;
     path?: string;
@@ -25,11 +25,6 @@ export declare class Context<T extends Record<string, any> = {}> {
      * @type {HeadersParser}
      */
     headers: HeadersParser;
-    /**
-     * Parser for handling and manipulating HTTP response(Read Only)
-     * @type {Response}
-     */
-    readonly res: Response | undefined;
     /**
      * Request path without query parameters
      * @type {string}
@@ -51,22 +46,29 @@ export declare class Context<T extends Record<string, any> = {}> {
      * @type {State}
      */
     state: State;
+    protected readonly resBody?: BodyInit | null;
     constructor(req: any, connInfo: ConnAddress);
     /**
-     * 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
-     */
-    /**
-     * Sets a header value.
+     * Appends or set a value to an existing header or creates a new one.
      * @param key - Header name.
-     * @param value - Header value(s).
-     */
-    header(key: string, value: string | string[]): this;
+     * @param value - Value to append.
+     * @default {append:false}
+     */
+    header(key: string, value: string, options?: {
+        append?: true;
+    }): this;
+    header(key: string, value: string | string[], options?: {
+        append?: false;
+    }): this;
+    /**
+    * 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.
@@ -100,9 +102,9 @@ export declare class Context<T extends Record<string, any> = {}> {
      * @param headers - (Optional) Additional response headers.
      * @returns Response object with JSON data.
      */
-    json(body: any, status?: number, headers?: ResponseHeaders): Response;
-    json(body: any, headers?: ResponseHeaders): Response;
-    json(body: any, status?: number): Response;
+    json(body: object, status?: number, headers?: ResponseHeaders): Response;
+    json(body: object, headers?: ResponseHeaders): Response;
+    json(body: object, status?: number): Response;
     /**
      * Sends a response with any content type.
      * Automatically determines content type if not provided.
@@ -192,16 +194,30 @@ export declare class Context<T extends Record<string, any> = {}> {
     get req(): Request;
     protected set params(params: Record<string, any>);
     /**
-     * Sets the HTTP response body to be returned to the client.
-     * This can be a string, object, or any serializable data.
-     * @param body - The response payload to be stored internally.
-     */
-    set body(body: any | undefined);
-    /**
-     * Retrieves the current response body set for the outgoing HTTP response.
-     * This value will be used when sending the final response.
-     * @returns The internally stored response payload.
+    * Set response body to be passed between middlewares or returned as final output.
+    *
+    * 🔄 Use-case:
+    * - Middleware or route handlers can set this value to share data.
+    * - If no explicit Response is returned (e.g., `ctx.json()` or `new Response()`),
+    *   then this body will be auto-wrapped into a `Response` by the framework.
+    *
+    * ⚠️ Note:
+    * Always use `return next()` or an explicit return like `return ctx.json(...)`
+    * to ensure proper flow control and response resolution.
+    *
+    * @param body - The response content (string, object, etc).
+    */
+    set body(body: any);
+    /**
+     * Get the current response body.
+     *
+     * 🧠 Use-case:
+     * - Allows middleware or route handler to access any pre-set data
+     *   from earlier in the middleware chain.
+     * - Common for situations where response is deferred or centrally handled.
+     *
+     * @returns The currently stored response body.
      */
-    get body(): any | undefined;
+    get body(): any;
     protected get params(): Record<string, any>;
 }

package/core/context.js

@@ -1,8 +1,8 @@
+import { State } from "../utils/state";
+import { defaultMimeType, mimeTypes } from "../utils/staticFile";
 import { EnvironmentDetector } from "./environment";
 import { HeadersParser } from "./header";
 import { Request } from "./request";
-import { State } from "../utils/state";
-import { defaultMimeType, mimeTypes } from "../utils/staticFile";
 export const httpStatusMap = {
     100: "Continue",
     101: "Switching Protocols",
@@ -72,14 +72,14 @@ export class Context {
     #rawRequest;
     env = {};
     headers = new HeadersParser();
-    res;
     pathname;
     url;
     method;
     #status = 200;
     state = new State();
     #params = {};
-    #resBody;
+    resBody;
+    #body;
     #localAddress = {};
     #remoteAddress = {};
     constructor(req, connInfo) {
@@ -90,8 +90,14 @@ export class Context {
         this.pathname = this.req.urlRef.pathname;
         this.url = this.req.url;
     }
-    header(key, value) {
-        this.headers.set(key, value);
+    header(key, value, options) {
+        let append = options?.append;
+        if (append) {
+            this.headers.append(key, value);
+        }
+        else {
+            this.headers.set(key, value);
+        }
         return this;
     }
     get cookies() {
@@ -384,10 +390,8 @@ export class Context {
             status: status,
             headers,
         });
-        let clone = response.clone();
-        this.body = body;
-        this.res = response;
-        return clone;
+        this.resBody = body;
+        return response;
     }
     get req() {
         return new Request(this.#rawRequest, this.params, this.#remoteAddress);
@@ -396,10 +400,10 @@ export class Context {
         this.#params = params;
     }
     set body(body) {
-        this.#resBody = body;
+        this.#body = body;
     }
     get body() {
-        return this.#resBody;
+        return this.#body;
     }
     get params() {
         return this.#params;

package/core/router.d.ts

@@ -1,10 +1,11 @@
 import { Context, ResponseHeaders } from "./context";
 import MiddlewareConfigure, { DuplicateMiddlewares, UniqueMiddlewares } from "./MiddlewareConfigure";
 import { HTTPMethod } from "./request";
-export type NextCallback = () => Promise<any>;
 export type ctx<T extends Record<string, any> = {}> = Context<T> & T;
-export type Callback<T extends Record<string, any> = {}> = (ctx: ctx<T>) => Promise<Response> | Response | string | Record<string, any> | void;
-export type Middleware<T extends Record<string, any> = {}> = (ctx: ctx<T>, next: NextCallback) => NextCallback | Promise<NextCallback | Response> | Response | string | Record<string, any> | void;
+export type NextCallback = () => Promise<any>;
+export type CallbackReturn = Promise<Response> | Response;
+export type Callback<T extends Record<string, any> = {}> = (ctx: ctx<T>) => CallbackReturn;
+export type Middleware<T extends Record<string, any> = {}> = (ctx: ctx<T>, next: NextCallback) => Promise<Response> | Response | NextCallback;
 export type RouterConfig = {
     /**
      * `env` allows you to define environment variables for the router.

package/index.js

@@ -1,4 +1,4 @@
 export { Router } from "./core/router";
 export { TezX } from "./core/server";
 export { useParams } from "./utils/params";
-export let version = "1.0.40";
+export let version = "1.0.42";

package/middleware/detectBot.d.ts

@@ -1,4 +1,5 @@
 import { Context, Middleware } from "..";
+import { CallbackReturn } from "../core/router";
 export type DetectBotReason = "User-Agent" | "Blacklisted IP" | "Query Parameter" | "Rate Limiting" | "Custom Detector" | "Multiple Indicators";
 type BotDetectionResult = {
     isBot: boolean;
@@ -35,7 +36,7 @@ type DetectBotOptions = {
      * 🛡️ Action to take when bot is detected
      * @default "block"
      */
-    onBotDetected?: "block" | ((ctx: Context, result: BotDetectionResult) => void);
+    onBotDetected?: "block" | ((ctx: Context, result: BotDetectionResult) => CallbackReturn);
     /**
      * ⚖️ Enable rate-limiting based detection
      * @default false
@@ -49,7 +50,7 @@ type DetectBotOptions = {
     /**
      * ✉️ Custom response for blocked requests
      */
-    customBlockedResponse?: (ctx: Context, result: BotDetectionResult) => void;
+    customBlockedResponse?: (ctx: Context, result: BotDetectionResult) => CallbackReturn;
     /**
      * 🔄 Custom cache storage implementation (e.g., using `Map`, `Redis`, etc.).
      * By default, it uses a `Map<string, { count: number; resetTime: number }>`.
@@ -96,7 +97,7 @@ type DetectBotOptions = {
  *   isBlacklistedIP: async (ip) => await checkIPReputation(ip),
  *   onBotDetected: (ctx, { reason }) => {
  *     ctx.status = 403;
- *     ctx.body = { error: `Bot detected (${reason})` };
+ *     return ctx.json({ error: `Bot detected (${reason})` });
  *   }
  * }));
  */

package/middleware/detectBot.js

@@ -2,7 +2,7 @@ import { GlobalConfig } from "../core/config";
 export const detectBot = (options = {}) => {
     const { botUserAgents = ["bot", "spider", "crawl", "slurp"], maxRequests = 30, windowMs = 60000, isBlacklisted = async () => false, queryKeyBot = "bot", onBotDetected = "block", enableRateLimiting = false, customBotDetector = async () => false, customBlockedResponse = (ctx, { reason }) => {
         ctx.setStatus = 403;
-        ctx.body = { error: `Bot detected: ${reason}` };
+        return ctx.json({ error: `Bot detected: ${reason}` });
     }, storage, confidenceThreshold = 0.5, } = options;
     let store = storage;
     if (enableRateLimiting) {

package/middleware/pagination.js

@@ -37,11 +37,12 @@ export const paginationHandler = (options = {}) => {
                 [countKey]: total,
                 pagination,
             };
+            ctx.body = body;
             if (next) {
-                ctx.body = body;
                 return await next();
             }
-            return (ctx.body = body);
+            return ctx.json(body);
         }
+        return await next();
     };
 };

package/middleware/rateLimiter.d.ts

@@ -1,5 +1,5 @@
 import { Context } from "../core/context";
-import { Middleware } from "../core/router";
+import { CallbackReturn, Middleware } from "../core/router";
 export type RateLimiterOptions = {
     /**
      * 🔴 Maximum allowed requests in the time window
@@ -49,7 +49,7 @@ export type RateLimiterOptions = {
      *   throw new Error( `Rate limit exceeded. Try again in ${retryAfter} seconds.`);
      * }
      */
-    onError?: (ctx: Context, retryAfter: number, error: Error) => void;
+    onError?: (ctx: Context, retryAfter: number, error: Error) => CallbackReturn;
 };
 /**
  * 🚦 Rate limiting middleware for request throttling

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tezx",
-  "version": "1.0.40",
+  "version": "1.0.42",
   "description": "TezX is a high-performance, lightweight JavaScript framework designed for speed, scalability, and flexibility. It enables efficient routing, middleware management, and static file serving with minimal configuration. Fully compatible with Node.js, Deno, and Bun.",
   "main": "cjs/index.js",
   "module": "index.js",