tezx 1.0.41 → 1.0.43

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",
@@ -81,7 +81,8 @@ class Context {
     #status = 200;
     state = new state_1.State();
     #params = {};
-    #resBody;
+    resBody;
+    #body;
     #localAddress = {};
     #remoteAddress = {};
     constructor(req, connInfo) {
@@ -392,6 +393,7 @@ class Context {
             status: status,
             headers,
         });
+        this.resBody = body;
         return response;
     }
     get req() {
@@ -401,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.41";
+exports.version = "1.0.43";

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) {
@@ -19,7 +19,8 @@ const detectBot = (options = {}) => {
             indicators: [],
         };
         const userAgent = ctx.headers.get("user-agent")?.toLowerCase() || "";
-        const remoteAddress = `${ctx.req.remoteAddress?.address}:${ctx.req.remoteAddress?.port}` || "unknown";
+        const remoteAddress = `${ctx.req.remoteAddress?.address}:${ctx.req.remoteAddress?.port}` ||
+            "unknown";
         const isBotQuery = ctx.req.query[queryKeyBot] === "true";
         if (botUserAgents.some((agent) => userAgent.includes(agent))) {
             detectionResult.indicators.push("User-Agent");

package/cjs/middleware/pagination.js

@@ -27,6 +27,7 @@ const paginationHandler = (options = {}) => {
             const pagination = {
                 page,
                 limit,
+                offset,
                 totalItems: total,
                 totalPages: Math.ceil(total / limit),
                 hasNextPage: page < Math.ceil(total / limit),
@@ -40,12 +41,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;
@@ -46,6 +46,7 @@ export declare class Context<T extends Record<string, any> = {}> {
      * @type {State}
      */
     state: State;
+    protected readonly resBody?: BodyInit | null;
     constructor(req: any, connInfo: ConnAddress);
     /**
      * Appends or set a value to an existing header or creates a new one.
@@ -60,14 +61,14 @@ export declare class Context<T extends Record<string, any> = {}> {
         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
-    */
+     * 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.
@@ -101,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.
@@ -193,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 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 | undefined);
+    set body(body: any);
     /**
-     * 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.
+     * 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",
@@ -78,7 +78,8 @@ export class Context {
     #status = 200;
     state = new State();
     #params = {};
-    #resBody;
+    resBody;
+    #body;
     #localAddress = {};
     #remoteAddress = {};
     constructor(req, connInfo) {
@@ -389,6 +390,7 @@ export class Context {
             status: status,
             headers,
         });
+        this.resBody = body;
         return response;
     }
     get req() {
@@ -398,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 | 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.41";
+export let version = "1.0.43";

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) {
@@ -14,7 +14,8 @@ export const detectBot = (options = {}) => {
             indicators: [],
         };
         const userAgent = ctx.headers.get("user-agent")?.toLowerCase() || "";
-        const remoteAddress = `${ctx.req.remoteAddress?.address}:${ctx.req.remoteAddress?.port}` || "unknown";
+        const remoteAddress = `${ctx.req.remoteAddress?.address}:${ctx.req.remoteAddress?.port}` ||
+            "unknown";
         const isBotQuery = ctx.req.query[queryKeyBot] === "true";
         if (botUserAgents.some((agent) => userAgent.includes(agent))) {
             detectionResult.indicators.push("User-Agent");

package/middleware/pagination.d.ts

@@ -67,6 +67,7 @@ export type PaginationBodyType = {
         page: number;
         limit: number;
         totalItems: any;
+        offset: number;
         totalPages: number;
         hasNextPage: boolean;
         hasPrevPage: boolean;

package/middleware/pagination.js

@@ -24,6 +24,7 @@ export const paginationHandler = (options = {}) => {
             const pagination = {
                 page,
                 limit,
+                offset,
                 totalItems: total,
                 totalPages: Math.ceil(total / limit),
                 hasNextPage: page < Math.ceil(total / limit),
@@ -37,11 +38,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.41",
+  "version": "1.0.43",
   "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",