tezx 4.0.2 → 4.0.3

package/cjs/core/context.js

@@ -31,7 +31,7 @@ class Context {
             return this;
         const _key = key.toLowerCase();
         const append = options?.append || _key === "set-cookie";
-        const target = this.res?.headers ?? (this.#headers ??= new Headers());
+        const target = this.headers;
         if (append) {
             target.append(_key, value);
         }
@@ -47,10 +47,11 @@ class Context {
         this.#status = status;
         return this;
     }
-    #newResponse(body, type, init = {}) {
-        let headers = (0, response_js_1.mergeHeaders)(this.#headers, init.headers);
-        if (!headers.has("Content-Type"))
+    createResponse(body, type, init = {}) {
+        const headers = (0, response_js_1.mergeHeaders)(this.#headers, init.headers);
+        if (type) {
             headers.set("Content-Type", type);
+        }
         return new Response(body, {
             status: init.status ?? this.#status,
             statusText: init.statusText,
@@ -58,50 +59,16 @@ class Context {
         });
     }
     newResponse(body, init = {}) {
-        let headers = (0, response_js_1.mergeHeaders)(this.#headers, init.headers);
-        return new Response(body, {
-            status: init.status ?? this.#status,
-            statusText: init.statusText,
-            headers,
-        });
+        return this.createResponse(body, null, init);
     }
     text(content, init) {
-        return this.#newResponse(content, "text/plain; charset=utf-8", init);
+        return this.createResponse(content, "text/plain; charset=utf-8", init);
     }
     html(strings, init) {
-        return this.#newResponse(strings, "text/html; charset=utf-8", init);
+        return this.createResponse(strings, "text/html; charset=utf-8", init);
     }
     json(json, init) {
-        return this.#newResponse(JSON.stringify(json), "application/json; charset=utf-8", init);
-    }
-    send(body, init) {
-        let _body;
-        let type;
-        if (body === null || body === undefined) {
-            _body = "";
-            type = "text/plain";
-        }
-        else if (typeof body === "string" || typeof body === "number") {
-            _body = body;
-            type = "text/plain";
-        }
-        else if (body instanceof Uint8Array || body instanceof ArrayBuffer || (typeof ReadableStream !== "undefined" && body instanceof ReadableStream)) {
-            _body = body;
-            type = "application/octet-stream";
-        }
-        else if (body instanceof Blob || (typeof File !== "undefined" && body instanceof File)) {
-            _body = body;
-            type = body.type || "application/octet-stream";
-        }
-        else if (typeof body === "object") {
-            _body = JSON.stringify(body);
-            type = "application/json";
-        }
-        else {
-            _body = String(body);
-            type = "text/plain";
-        }
-        return this.#newResponse(_body, type, init);
+        return this.createResponse(JSON.stringify(json), "application/json; charset=utf-8", init);
     }
     redirect(url, status = 302) {
         const headers = new Headers(this.#headers);
@@ -122,18 +89,15 @@ class Context {
         if (init?.filename) {
             headers["Content-Disposition"] = `attachment; filename="${init?.filename}"`;
         }
+        let contentType = null;
         if (init?.download || init?.filename) {
-            headers["Content-Type"] = "application/octet-stream";
-            return this.newResponse(stream, {
-                status: init?.status ?? this.#status,
-                statusText: init?.statusText,
-                headers,
-            });
+            contentType = "application/octet-stream";
+        }
+        else {
+            const ext = (0, utils_js_1.extensionExtract)(filePath);
+            contentType = mimeTypes_js_1.mimeTypes[ext] ?? mimeTypes_js_1.defaultMimeType;
         }
-        const ext = (0, utils_js_1.extensionExtract)(filePath);
-        const mimeType = mimeTypes_js_1.mimeTypes[ext] ?? mimeTypes_js_1.defaultMimeType;
-        headers["Content-Type"] = mimeType;
-        return this.newResponse(stream, {
+        return this.createResponse(stream, contentType, {
             status: init?.status ?? this.#status,
             statusText: init?.statusText,
             headers,

package/cjs/core/request.js

@@ -8,7 +8,6 @@ class TezXRequest {
     pathname;
     #rawRequest;
     params = {};
-    remoteAddress = {};
     #bodyConsumed = false;
     #rawBodyArrayBuffer;
     #cachedText;

package/cjs/core/server.js

@@ -7,10 +7,9 @@ const url_js_1 = require("../utils/url.js");
 const context_js_1 = require("./context.js");
 const router_js_1 = require("./router.js");
 class TezX extends router_js_1.Router {
-    #pathResolver;
     #notFound = response_js_1.notFoundResponse;
     #errorHandler = response_js_1.handleErrorResponse;
-    constructor({ basePath = "/", routeRegistry = new RadixRouter_js_1.RadixRouter(), } = {}) {
+    constructor({ basePath = "/", routeRegistry = new RadixRouter_js_1.RadixRouter() } = {}) {
         super({ basePath });
         if (!routeRegistry) {
             throw new Error("routeRegistry is required for TezX initialization");
@@ -30,24 +29,27 @@ class TezX extends router_js_1.Router {
         let index = -1;
         const dispatch = (i) => {
             if (i <= index)
-                throw new Error("next() called multiple times");
+                return Promise.reject(new Error("next() called multiple times"));
             index = i;
             const fn = stack[i];
             if (!fn)
                 return ctx.res;
-            const result = fn(ctx, () => dispatch(i + 1));
-            if (!(result instanceof Promise)) {
-                if (result instanceof Response)
-                    ctx.res = result;
-                return ctx.res;
+            try {
+                const result = fn(ctx, () => dispatch(i + 1));
+                if (!(result instanceof Promise)) {
+                    if (result instanceof Response)
+                        ctx.res = result;
+                    return result ?? ctx.res;
+                }
+                return result.then((res) => {
+                    if (res instanceof Response)
+                        ctx.res = res;
+                    return res ?? ctx.res;
+                }, (err) => Promise.reject(err));
+            }
+            catch (err) {
+                return Promise.reject(err);
             }
-            return result.then((res) => {
-                if (res instanceof Response)
-                    ctx.res = res;
-                return ctx.res;
-            }, (err) => {
-                throw err;
-            });
         };
         return dispatch(0);
     }
@@ -66,9 +68,13 @@ class TezX extends router_js_1.Router {
             if (mLen === 0)
                 return this.#notFound(ctx);
             ctx.params = params;
-            if (mLen === 1)
-                return await middlewares[0](ctx) ?? this.#notFound(ctx);
-            return await this.#composeChain(ctx, middlewares) ?? this.#notFound(ctx);
+            if (mLen === 1) {
+                ctx.res = await middlewares[0](ctx);
+            }
+            else {
+                ctx.res = await this.#composeChain(ctx, middlewares);
+            }
+            return ctx.res ?? this.#notFound(ctx);
         }
         catch (err) {
             let error = err instanceof Error ? err : new Error(String(err));
@@ -76,10 +82,9 @@ class TezX extends router_js_1.Router {
         }
     }
     async serve(req, server) {
-        const method = req.method || "GET";
+        const method = req.method;
         if (method === "HEAD") {
-            const headReq = new Request(req, { method: "GET" });
-            const res = await this.#handleRequest(headReq, "GET", server);
+            const res = await this.#handleRequest(req, "GET", server);
             return new Response(null, {
                 status: res.status,
                 statusText: res.statusText,

package/cjs/helper/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateUUID = exports.generateRandomBase64 = exports.generateID = exports.useFormData = void 0;
+exports.getConnInfo = getConnInfo;
 const formData_js_1 = require("./formData.js");
 Object.defineProperty(exports, "useFormData", { enumerable: true, get: function () { return formData_js_1.useFormData; } });
 const generateID_js_1 = require("./generateID.js");
@@ -11,3 +12,6 @@ exports.default = {
     useFormData: formData_js_1.useFormData,
     generateID: generateID_js_1.generateID, generateRandomBase64: generateID_js_1.generateRandomBase64, generateUUID: generateID_js_1.generateUUID
 };
+function getConnInfo(ctx) {
+    return ctx?.server?.requestIP?.(ctx.rawRequest);
+}

package/cjs/index.js

@@ -5,7 +5,7 @@ const router_js_1 = require("./core/router.js");
 Object.defineProperty(exports, "Router", { enumerable: true, get: function () { return router_js_1.Router; } });
 const server_js_1 = require("./core/server.js");
 Object.defineProperty(exports, "TezX", { enumerable: true, get: function () { return server_js_1.TezX; } });
-exports.version = "4.0.2";
+exports.version = "4.0.3";
 exports.default = {
     Router: router_js_1.Router,
     TezX: server_js_1.TezX,

package/cjs/middleware/detect-bot.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.detectBot = void 0;
+const index_js_1 = require("../helper/index.js");
 const rateLimit_js_1 = require("../utils/rateLimit.js");
 const detectBot = (opts = {}) => {
     const botUAs = opts.botUserAgents || ["bot", "spider", "crawl", "slurp"];
@@ -8,7 +9,7 @@ const detectBot = (opts = {}) => {
     const botRegex = new RegExp(botUAs.join("|"), "i");
     checkBot = (ua) => botRegex.test(ua);
     const keyGenerator = opts.keyGenerator ?? ((ctx) => {
-        const addr = ctx.req.remoteAddress;
+        const addr = (0, index_js_1.getConnInfo)(ctx);
         return addr ? `${addr.address}:${addr.port}` : "unknown";
     });
     const maxReq = opts.maxRequests || 30;

package/cjs/middleware/index.js

@@ -20,7 +20,6 @@ __exportStar(require("./cache-control.js"), exports);
 __exportStar(require("./cors.js"), exports);
 __exportStar(require("./detect-bot.js"), exports);
 __exportStar(require("./etag.js"), exports);
-__exportStar(require("./getConnInfo.js"), exports);
 __exportStar(require("./i18n.js"), exports);
 __exportStar(require("./logger.js"), exports);
 __exportStar(require("./pagination.js"), exports);

package/cjs/middleware/pagination.js

@@ -42,8 +42,9 @@ const paginationHandler = (options = {}) => {
                 pagination,
             };
             ctx.body = body;
-            if (next) {
-                return await next();
+            let res = await next();
+            if (res) {
+                return res;
             }
             return ctx.json(body);
         }

package/cjs/middleware/rate-limiter.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = exports.rateLimiter = void 0;
+exports.rateLimiter = exports.default = void 0;
+const index_js_1 = require("../helper/index.js");
 const rateLimit_js_1 = require("../utils/rateLimit.js");
 const rateLimiter = (options) => {
     const { maxRequests, windowMs, keyGenerator = (ctx) => {
@@ -12,9 +13,8 @@ const rateLimiter = (options) => {
         const clientIp = ctx.req.header("client-ip");
         if (clientIp)
             return clientIp;
-        const addr = ctx.req.remoteAddress?.address || "unknown";
-        const port = ctx.req.remoteAddress?.port || "0";
-        return `${addr}:${port}`;
+        const { port, address } = (0, index_js_1.getConnInfo)(ctx) ?? {};
+        return `${address}:${port}`;
     }, storage = (0, rateLimit_js_1.createRateLimitDefaultStorage)(), onError = (ctx, retryAfter, error) => {
         ctx.status(429);
         throw new Error(`Rate limit exceeded. Try again in ${retryAfter} seconds.`);
@@ -33,5 +33,5 @@ const rateLimiter = (options) => {
         return await next();
     };
 };
-exports.rateLimiter = rateLimiter;
 exports.default = rateLimiter;
+exports.rateLimiter = rateLimiter;

package/cjs/utils/mimeTypes.js

@@ -15,6 +15,10 @@ exports.mimeTypes = {
     tsv: "text/tab-separated-values",
     rtf: "application/rtf",
     markdown: "text/markdown",
+    jsx: "text/javascript",
+    ts: "text/typescript",
+    tsx: "text/typescript",
+    jsonld: "application/ld+json",
     png: "image/png",
     jpg: "image/jpeg",
     jpeg: "image/jpeg",
@@ -25,6 +29,13 @@ exports.mimeTypes = {
     bmp: "image/bmp",
     tiff: "image/tiff",
     psd: "image/vnd.adobe.photoshop",
+    tif: "image/tiff",
+    avif: "image/avif",
+    woff: "font/woff",
+    woff2: "font/woff2",
+    ttf: "font/ttf",
+    otf: "font/otf",
+    eot: "application/vnd.ms-fontobject",
     mp4: "video/mp4",
     webm: "video/webm",
     ogg: "video/ogg",
@@ -33,6 +44,9 @@ exports.mimeTypes = {
     wmv: "video/x-ms-wmv",
     flv: "video/x-flv",
     "3gp": "video/3gpp",
+    mkv: "video/x-matroska",
+    mpeg: "video/mpeg",
+    mpg: "video/mpeg",
     mp3: "audio/mpeg",
     wav: "audio/wav",
     aac: "audio/aac",
@@ -40,11 +54,7 @@ exports.mimeTypes = {
     m4a: "audio/mp4",
     mid: "audio/midi",
     midi: "audio/midi",
-    woff: "font/woff",
-    woff2: "font/woff2",
-    ttf: "font/ttf",
-    otf: "font/otf",
-    eot: "application/vnd.ms-fontobject",
+    weba: "audio/webm",
     pdf: "application/pdf",
     odp: "application/vnd.oasis.opendocument.presentation",
     zip: "application/zip",
@@ -83,6 +93,8 @@ exports.mimeTypes = {
     deb: "application/x-debian-package",
     rpm: "application/x-redhat-package-manager",
     apk: "application/vnd.android.package-archive",
+    bin: "application/octet-stream",
+    iso: "application/octet-stream",
     webmanifest: "application/manifest+json",
     ics: "text/calendar",
     vcf: "text/vcard",

package/core/context.d.ts

@@ -1,4 +1,5 @@
 import { ExtractParamsFromPath, HttpBaseResponse, ResHeaderKey, ResponseInit, WebSocketEvent } from "../types/index.js";
+import { ContentType } from "../utils/mimeTypes.js";
 import { TezXRequest } from "./request.js";
 export declare class Context<TPath extends string = any> {
     #private;
@@ -112,6 +113,35 @@ export declare class Context<TPath extends string = any> {
      * ctx.status(404).text("Not found");
      */
     status(status: number): this;
+    /**
+     * Creates a native Response object with optional body, Content-Type, and headers.
+     *
+     * This function always overwrites the `Content-Type` header if `type` is provided.
+     * It merges any existing headers from the context (`this.#headers`) with headers
+     * provided in `init.headers`.
+     *
+     * @param {BodyInit | null} body - The response body. Can be string, Blob, ArrayBuffer, Uint8Array, or null.
+     * @param {string | null} type - The MIME type to set in the `Content-Type` header. If null, no Content-Type is set.
+     * @param {ResponseInit} [init={}] - Optional response initialization object (status, statusText, headers).
+     * @param {number} [init.status] - HTTP status code (default is `this.#status`).
+     * @param {string} [init.statusText] - Optional status text for the response.
+     * @param {HeadersInit} [init.headers] - Additional headers to merge with context headers.
+     *
+     * @returns {Response} A native Fetch API Response object.
+     *
+     * @example
+     * // Simple text response
+     * const res = createResponse("Hello World", "text/plain");
+     *
+     * @example
+     * // JSON response
+     * const res = createResponse(JSON.stringify({ ok: true }), "application/json", { status: 200 });
+     *
+     * @example
+     * // Custom headers
+     * const res = createResponse("Hello", "text/plain", { headers: { "X-Custom": "test" } });
+     */
+    createResponse(body: BodyInit | null, type: ContentType | null, init?: ResponseInit): Response;
     /**
      * Protected helper method to create a Response or PlainResponse
      * based on runtime environment (Node.js or Web).
@@ -157,38 +187,6 @@ export declare class Context<TPath extends string = any> {
      * ctx.json({ success: true });
      */
     json(json: object, init?: ResponseInit): HttpBaseResponse;
-    /**
-    * Send a response with automatic content type detection.
-    *
-    * This method determines the proper `Content-Type` header based on the type of `body`.
-    * If a `Content-Type` is provided in `init.headers`, it will be used instead.
-    *
-    * Supported types:
-    * - `string` / `number` → "text/plain"
-    * - `object` → JSON serialized, "application/json"
-    * - `Uint8Array` / `ArrayBuffer` / `ReadableStream` → "application/octet-stream"
-    * - `Blob` / `File` → uses `body.type` or falls back to "application/octet-stream"
-    * - `null` / `undefined` → empty string, "text/plain"
-    * - any other → `String(body)`, "text/plain"
-    *
-    * @param {any} body - Response body of any type.
-    * @param {ResponseInit} [init] - Optional response init object, headers, status, etc.
-    * @returns {HttpBaseResponse} - A Bun-compatible response object.
-    *
-    * @example
-    * // Send a string
-    * ctx.send("Hello World");
-    *
-    * // Send JSON
-    * ctx.send({ user: "Alice", id: 123 });
-    *
-    * // Send binary
-    * ctx.send(new Uint8Array([1,2,3]));
-    *
-    * // Custom content-type
-    * ctx.send("Hello", { headers: { "Content-Type": "text/html" } });
-    */
-    send(body: any, init?: ResponseInit): HttpBaseResponse;
     /**
      * Sends an HTTP redirect response to the specified URL.
      *

package/core/context.js

@@ -28,7 +28,7 @@ export class Context {
             return this;
         const _key = key.toLowerCase();
         const append = options?.append || _key === "set-cookie";
-        const target = this.res?.headers ?? (this.#headers ??= new Headers());
+        const target = this.headers;
         if (append) {
             target.append(_key, value);
         }
@@ -44,10 +44,11 @@ export class Context {
         this.#status = status;
         return this;
     }
-    #newResponse(body, type, init = {}) {
-        let headers = mergeHeaders(this.#headers, init.headers);
-        if (!headers.has("Content-Type"))
+    createResponse(body, type, init = {}) {
+        const headers = mergeHeaders(this.#headers, init.headers);
+        if (type) {
             headers.set("Content-Type", type);
+        }
         return new Response(body, {
             status: init.status ?? this.#status,
             statusText: init.statusText,
@@ -55,50 +56,16 @@ export class Context {
         });
     }
     newResponse(body, init = {}) {
-        let headers = mergeHeaders(this.#headers, init.headers);
-        return new Response(body, {
-            status: init.status ?? this.#status,
-            statusText: init.statusText,
-            headers,
-        });
+        return this.createResponse(body, null, init);
     }
     text(content, init) {
-        return this.#newResponse(content, "text/plain; charset=utf-8", init);
+        return this.createResponse(content, "text/plain; charset=utf-8", init);
     }
     html(strings, init) {
-        return this.#newResponse(strings, "text/html; charset=utf-8", init);
+        return this.createResponse(strings, "text/html; charset=utf-8", init);
     }
     json(json, init) {
-        return this.#newResponse(JSON.stringify(json), "application/json; charset=utf-8", init);
-    }
-    send(body, init) {
-        let _body;
-        let type;
-        if (body === null || body === undefined) {
-            _body = "";
-            type = "text/plain";
-        }
-        else if (typeof body === "string" || typeof body === "number") {
-            _body = body;
-            type = "text/plain";
-        }
-        else if (body instanceof Uint8Array || body instanceof ArrayBuffer || (typeof ReadableStream !== "undefined" && body instanceof ReadableStream)) {
-            _body = body;
-            type = "application/octet-stream";
-        }
-        else if (body instanceof Blob || (typeof File !== "undefined" && body instanceof File)) {
-            _body = body;
-            type = body.type || "application/octet-stream";
-        }
-        else if (typeof body === "object") {
-            _body = JSON.stringify(body);
-            type = "application/json";
-        }
-        else {
-            _body = String(body);
-            type = "text/plain";
-        }
-        return this.#newResponse(_body, type, init);
+        return this.createResponse(JSON.stringify(json), "application/json; charset=utf-8", init);
     }
     redirect(url, status = 302) {
         const headers = new Headers(this.#headers);
@@ -119,18 +86,15 @@ export class Context {
         if (init?.filename) {
             headers["Content-Disposition"] = `attachment; filename="${init?.filename}"`;
         }
+        let contentType = null;
         if (init?.download || init?.filename) {
-            headers["Content-Type"] = "application/octet-stream";
-            return this.newResponse(stream, {
-                status: init?.status ?? this.#status,
-                statusText: init?.statusText,
-                headers,
-            });
+            contentType = "application/octet-stream";
+        }
+        else {
+            const ext = extensionExtract(filePath);
+            contentType = mimeTypes[ext] ?? defaultMimeType;
         }
-        const ext = extensionExtract(filePath);
-        const mimeType = mimeTypes[ext] ?? defaultMimeType;
-        headers["Content-Type"] = mimeType;
-        return this.newResponse(stream, {
+        return this.createResponse(stream, contentType, {
             status: init?.status ?? this.#status,
             statusText: init?.statusText,
             headers,

package/core/request.d.ts

@@ -1,4 +1,4 @@
-import { ExtractParamsFromPath, HTTPMethod, NetAddr, ReqHeaderKey, RequestHeaders } from "../types/index.js";
+import { ExtractParamsFromPath, HTTPMethod, ReqHeaderKey, RequestHeaders } from "../types/index.js";
 /**
  * A wrapper around the raw HTTP request that provides convenient access to URL, headers, body parsing, and route parameters.
  *
@@ -26,18 +26,6 @@ export declare class TezXRequest<Path extends string = any> {
      * @type {ExtractParamsFromPath<Path>}
      */
     readonly params: ExtractParamsFromPath<Path>;
-    /**
-     * Remote address details of the connected client.
-     * @requires injectRemoteAddress middleware.
-     * @typedef {Object} NetAddr
-     * @property {string} [transport] - Transport protocol (e.g., "tcp", "udp").
-     * @property {"IPv4" | "IPv6" | "Unix"} [family] - Address family.
-     * @property {string} [hostname] - Hostname or IP address.
-     * @property {number} [port] - Port number.
-     * @type {NetAddr}
-     * @default {}
-     */
-    remoteAddress: NetAddr;
     /**
      * Creates an instance of TezXRequest.
      *

package/core/request.js

@@ -5,7 +5,6 @@ export class TezXRequest {
     pathname;
     #rawRequest;
     params = {};
-    remoteAddress = {};
     #bodyConsumed = false;
     #rawBodyArrayBuffer;
     #cachedText;

package/core/server.d.ts

@@ -25,7 +25,7 @@ export declare class TezX<T extends Record<string, any> = {}> extends Router<T>
     #private;
     /** Internal route registry to hold all routes */
     protected router?: RouteRegistry;
-    constructor({ basePath, routeRegistry, }?: TezXConfig);
+    constructor({ basePath, routeRegistry }?: TezXConfig);
     /**
      * Register a custom 404 (not found) handler.
      *

package/core/server.js

@@ -4,10 +4,9 @@ import { getPathname } from "../utils/url.js";
 import { Context } from "./context.js";
 import { Router } from "./router.js";
 export class TezX extends Router {
-    #pathResolver;
     #notFound = notFoundResponse;
     #errorHandler = handleErrorResponse;
-    constructor({ basePath = "/", routeRegistry = new RadixRouter(), } = {}) {
+    constructor({ basePath = "/", routeRegistry = new RadixRouter() } = {}) {
         super({ basePath });
         if (!routeRegistry) {
             throw new Error("routeRegistry is required for TezX initialization");
@@ -27,24 +26,27 @@ export class TezX extends Router {
         let index = -1;
         const dispatch = (i) => {
             if (i <= index)
-                throw new Error("next() called multiple times");
+                return Promise.reject(new Error("next() called multiple times"));
             index = i;
             const fn = stack[i];
             if (!fn)
                 return ctx.res;
-            const result = fn(ctx, () => dispatch(i + 1));
-            if (!(result instanceof Promise)) {
-                if (result instanceof Response)
-                    ctx.res = result;
-                return ctx.res;
+            try {
+                const result = fn(ctx, () => dispatch(i + 1));
+                if (!(result instanceof Promise)) {
+                    if (result instanceof Response)
+                        ctx.res = result;
+                    return result ?? ctx.res;
+                }
+                return result.then((res) => {
+                    if (res instanceof Response)
+                        ctx.res = res;
+                    return res ?? ctx.res;
+                }, (err) => Promise.reject(err));
+            }
+            catch (err) {
+                return Promise.reject(err);
             }
-            return result.then((res) => {
-                if (res instanceof Response)
-                    ctx.res = res;
-                return ctx.res;
-            }, (err) => {
-                throw err;
-            });
         };
         return dispatch(0);
     }
@@ -63,9 +65,13 @@ export class TezX extends Router {
             if (mLen === 0)
                 return this.#notFound(ctx);
             ctx.params = params;
-            if (mLen === 1)
-                return await middlewares[0](ctx) ?? this.#notFound(ctx);
-            return await this.#composeChain(ctx, middlewares) ?? this.#notFound(ctx);
+            if (mLen === 1) {
+                ctx.res = await middlewares[0](ctx);
+            }
+            else {
+                ctx.res = await this.#composeChain(ctx, middlewares);
+            }
+            return ctx.res ?? this.#notFound(ctx);
         }
         catch (err) {
             let error = err instanceof Error ? err : new Error(String(err));
@@ -73,10 +79,9 @@ export class TezX extends Router {
         }
     }
     async serve(req, server) {
-        const method = req.method || "GET";
+        const method = req.method;
         if (method === "HEAD") {
-            const headReq = new Request(req, { method: "GET" });
-            const res = await this.#handleRequest(headReq, "GET", server);
+            const res = await this.#handleRequest(req, "GET", server);
             return new Response(null, {
                 status: res.status,
                 statusText: res.statusText,

package/helper/index.d.ts

@@ -1,3 +1,4 @@
+import { Ctx, NetAddr } from "../types/index.js";
 import { useFormData } from "./formData.js";
 import { generateID, generateRandomBase64, generateUUID } from "./generateID.js";
 export { useFormData, generateID, generateRandomBase64, generateUUID };
@@ -8,3 +9,17 @@ declare const _default: {
     generateUUID: typeof generateUUID;
 };
 export default _default;
+/**
+ * Retrieves remote connection details of the client from the Bun server context.
+ *
+ * This function returns network address information such as transport protocol,
+ * address family, IP/hostname, and port.
+ *
+ * @param {Ctx} ctx - The request context containing the Bun server and raw request.
+ * @returns {NetAddr} Object containing client connection details.
+ *
+ * @example
+ * const conn = getConnInfo(ctx);
+ * console.log(conn.address, conn.port);
+ */
+export declare function getConnInfo(ctx: Ctx): NetAddr;

package/helper/index.js

@@ -5,3 +5,6 @@ export default {
     useFormData,
     generateID, generateRandomBase64, generateUUID
 };
+export function getConnInfo(ctx) {
+    return ctx?.server?.requestIP?.(ctx.rawRequest);
+}

package/index.js

@@ -1,7 +1,7 @@
 import { Router } from "./core/router.js";
 import { TezX } from "./core/server.js";
 export { Router, TezX };
-export let version = "4.0.2";
+export let version = "4.0.3";
 export default {
     Router,
     TezX,

package/middleware/detect-bot.d.ts

@@ -6,6 +6,7 @@ import { HttpBaseResponse } from "../types/index.js";
 export type DetectBotOptions = {
     /**
      * 🤖 List of known bot-like User-Agent patterns.
+     * Middleware will block requests whose User-Agent matches any of these patterns.
      * @default ["bot", "spider", "crawl", "slurp"]
      * @example
      * botUserAgents: ["bot", "crawler", "indexer"]
@@ -13,40 +14,31 @@ export type DetectBotOptions = {
     botUserAgents?: string[];
     /**
      * ⚖️ Enable rate-limiting based bot detection.
-     * Requires `getConnInfo()` import from TezX runtime.
+     * Middleware will track requests per client and block if exceeding limits.
      * @default false
-     * @example
-     * enableRateLimiting: true
      */
     enableRateLimiting?: boolean;
     /**
-     * 🔑 Client identifier generator function for rate limit
-     * @default (ctx) => `${ctx.req.remoteAddress.address}:${ctx.req.remoteAddress.port}`
+     * 🔑 Function to generate a client identifier for rate-limiting.
+     * By default, it uses the client's IP and port via `getConnInfo`.
      * @example
-     * keyGenerator: (ctx) => ctx.user?.id || ctx.ip // Use user ID if authenticated
+     * keyGenerator: (ctx) => ctx.user?.id || ctx.ip
      */
     keyGenerator?: (ctx: Context) => string;
     /**
      * ⚠️ Maximum allowed requests in the rate-limit window.
-     * Only used when `enableRateLimiting` is true.
+     * Only used if `enableRateLimiting` is true.
      * @default 30
      */
     maxRequests?: number;
     /**
-     * ⏱️ Time window for rate-limiting (in milliseconds).
+     * ⏱️ Time window for rate-limiting in milliseconds.
      * @default 60000 (1 minute)
      */
     windowMs?: number;
     /**
      * 🔄 Custom rate-limit storage implementation.
-     * Allows integration with Redis, Memcached, or in-memory stores.
-     * @default In-memory Map
-     * @example
-     * storage: {
-     *   get: (key) => myRedisClient.get(key),
-     *   set: (key, value) => myRedisClient.set(key, value),
-     *   clearExpired: () => {}
-     * }
+     * Can integrate with Redis, Memcached, or an in-memory store.
      */
     storage?: {
         get: (key: string) => {
@@ -61,54 +53,44 @@ export type DetectBotOptions = {
     };
     /**
      * 🚫 Optional IP blacklist checker.
-     * Should return true if the current request’s IP is banned or suspicious.
+     * Return true to block a specific IP.
      * @default () => false
-     * @example
-     * isBlacklisted: (ctx) => ctx.req.remoteAddress.address === "192.168.0.10"
      */
     isBlacklisted?: (ctx: Context) => boolean | Promise<boolean>;
     /**
      * 🧠 Custom bot detector function.
-     * Use this for advanced heuristics (e.g., suspicious query params or headers).
-     * @example
-     * customBotDetector: (ctx) => ctx.query?.token === "weird"
+     * Return true to block the request based on custom logic.
      */
     customBotDetector?: (ctx: Context) => boolean | Promise<boolean>;
     /**
-     * 🛡️ Action executed when a bot is detected.
-     * Can return a custom HTTP response (e.g., JSON, HTML, or redirect).
+     * 🛡️ Callback executed when a bot is detected.
+     * Can return a custom HTTP response (JSON, HTML, redirect, etc.).
      * @default Responds with 403 and JSON error.
-     * @example
-     * onBotDetected: (ctx, reason) => ctx.status(403).json({ error: `Blocked: ${reason}` })
      */
     onBotDetected?: (ctx: Context, reason: string) => HttpBaseResponse;
 };
 /**
  * 🤖 Smart Bot Detection Middleware
  *
- * Detects automated or malicious requests using a combination of:
+ * Detects automated or malicious requests using multiple strategies:
  * - User-Agent analysis
- * - IP blacklisting
- * - Rate limiting
- * - Custom detection logic
- *
- * 🧩 Supports:
- * - Bun (uses precompiled RegExp for speed)
- * - Node.js / Deno (optimized `includes()` loop)
+ * - IP blacklist
+ * - Rate-limiting per client
+ * - Custom bot detection
  *
- * ⚙️ Requirements (for rate limiting):
- * You must import `getConnInfo` from your runtime adapter:
+ * The client identity for rate-limiting is determined via `getConnInfo(ctx)`,
+ * which returns the connection info:
  * ```ts
- * import { getConnInfo } from "tezx/bun";
- * // or
- * import { getConnInfo } from "tezx/node";
- * // or
- * import { getConnInfo } from "tezx/deno";
+ * {
+ *   address: string;   // IP address of the client
+ *   port?: number;     // Port number of the client
+ *   transport?: string;// Transport protocol (tcp, udp)
+ * }
  * ```
  *
  * 📦 Example Usage:
  * ```ts
- * import { detectBot } from "tezx/middleware/detectBot";
+ * import { detectBot } from "tezx/middleware";
  *
  * app.use(detectBot({
  *   enableRateLimiting: true,

package/middleware/detect-bot.js

@@ -1,3 +1,4 @@
+import { getConnInfo } from "../helper/index.js";
 import { createRateLimitDefaultStorage, isRateLimit } from "../utils/rateLimit.js";
 export const detectBot = (opts = {}) => {
     const botUAs = opts.botUserAgents || ["bot", "spider", "crawl", "slurp"];
@@ -5,7 +6,7 @@ export const detectBot = (opts = {}) => {
     const botRegex = new RegExp(botUAs.join("|"), "i");
     checkBot = (ua) => botRegex.test(ua);
     const keyGenerator = opts.keyGenerator ?? ((ctx) => {
-        const addr = ctx.req.remoteAddress;
+        const addr = getConnInfo(ctx);
         return addr ? `${addr.address}:${addr.port}` : "unknown";
     });
     const maxReq = opts.maxRequests || 30;

package/middleware/index.d.ts

@@ -4,7 +4,6 @@ export * from "./cache-control.js";
 export * from "./cors.js";
 export * from "./detect-bot.js";
 export * from "./etag.js";
-export * from "./getConnInfo.js";
 export * from "./i18n.js";
 export * from "./logger.js";
 export * from "./pagination.js";

package/middleware/index.js

@@ -4,7 +4,6 @@ export * from "./cache-control.js";
 export * from "./cors.js";
 export * from "./detect-bot.js";
 export * from "./etag.js";
-export * from "./getConnInfo.js";
 export * from "./i18n.js";
 export * from "./logger.js";
 export * from "./pagination.js";

package/middleware/pagination.js

@@ -39,8 +39,9 @@ const paginationHandler = (options = {}) => {
                 pagination,
             };
             ctx.body = body;
-            if (next) {
-                return await next();
+            let res = await next();
+            if (res) {
+                return res;
             }
             return ctx.json(body);
         }

package/middleware/rate-limiter.d.ts

@@ -1,4 +1,4 @@
-import { Context } from "../core/context.js";
+import { Context } from "../index.js";
 import { HttpBaseResponse, Middleware } from "../types/index.js";
 export type RateLimiterOptions = {
     /**
@@ -14,15 +14,16 @@ export type RateLimiterOptions = {
      */
     windowMs: number;
     /**
-     * 🔑 Client identifier generator function
-     * @default (ctx) => `${ctx.req.remoteAddress.address}:${ctx.req.remoteAddress.port}`
+     * 🔑 Function to generate a client identifier for rate-limiting.
+     * By default, it uses `X-Forwarded-For`, `Client-IP`, or `getConnInfo(ctx)`.
      * @example
-     * keyGenerator: (ctx) => ctx.user?.id || ctx.ip // Use user ID if authenticated
+     * keyGenerator: (ctx) => ctx.user?.id || ctx.ip
      */
     keyGenerator?: (ctx: Context) => string;
     /**
-     * 🔄 Custom cache storage implementation (e.g., using `Map`, `Redis`, etc.).
-     * By default, it uses a `Map<string, { count: number; resetTime: number }>`.
+     * 🔄 Custom cache/storage implementation.
+     * Must provide `get`, `set`, and `clearExpired` methods.
+     * @default In-memory Map via `createRateLimitDefaultStorage()`
      */
     storage?: {
         get: (key: string) => {
@@ -36,42 +37,39 @@ export type RateLimiterOptions = {
         clearExpired: () => void;
     };
     /**
-     * 🛑 Custom rate limit exceeded handler
-     * @default Sends 429 status with Retry-After header
-     * @example
-     * onError: (ctx, retryAfter) => {
-     *   ctx.status = 429;
-     *   throw new Error( `Rate limit exceeded. Try again in ${retryAfter} seconds.`);
-     * }
+     * 🛑 Custom handler when rate limit is exceeded.
+     * @default Throws 429 status with Retry-After header
      */
     onError?: (ctx: Context, retryAfter: number, error: Error) => HttpBaseResponse;
 };
 /**
- * 🚦 Rate limiting middleware for request throttling
+ * 🚦 Rate Limiter Middleware
+ *
+ * Throttles requests per client based on a sliding window.
+ * Supports custom client identification and storage backends.
+ *
+ * Client IP detection uses (in order):
+ * 1. `X-Forwarded-For` header
+ * 2. `Client-IP` header
+ * 3. `getConnInfo(ctx)` fallback
  *
- * Enforces maximum request limits per client with sliding window.
- * Currently supports in-memory storage only (Redis coming soon).
- * @requires
- *  *
-```ts
-  import { getConnInfo } from "tezx/middleware";
-```
- * @param {RateLimiterOptions} options - Configuration
- * @returns {Middleware} Middleware function
+ * ```ts
+ * import { getConnInfo } from "tezx/helper";
+ * ```
+ *
+ * @param options RateLimiterOptions
+ * @returns Middleware function
  *
  * @example
  * // Basic rate limiting (100 requests/minute)
- * app.use(rateLimiter({
- *   maxRequests: 100,
- *   windowMs: 60_000
- * }));
+ * app.use(rateLimiter({ maxRequests: 100, windowMs: 60_000 }));
  *
  * // Custom client identification
  * app.use(rateLimiter({
  *   maxRequests: 10,
  *   windowMs: 10_000,
- *   keyGenerator: (ctx) => ctx.user?.id || ctx.remoteAddress.address
+ *   keyGenerator: (ctx) => ctx.user?.id
  * }));
  */
 declare const rateLimiter: <T extends Record<string, any> = {}, Path extends string = any>(options: RateLimiterOptions) => Middleware<T, Path>;
-export { rateLimiter, rateLimiter as default };
+export { rateLimiter as default, rateLimiter };

package/middleware/rate-limiter.js

@@ -1,3 +1,4 @@
+import { getConnInfo } from "../helper/index.js";
 import { createRateLimitDefaultStorage, isRateLimit } from "../utils/rateLimit.js";
 const rateLimiter = (options) => {
     const { maxRequests, windowMs, keyGenerator = (ctx) => {
@@ -9,9 +10,8 @@ const rateLimiter = (options) => {
         const clientIp = ctx.req.header("client-ip");
         if (clientIp)
             return clientIp;
-        const addr = ctx.req.remoteAddress?.address || "unknown";
-        const port = ctx.req.remoteAddress?.port || "0";
-        return `${addr}:${port}`;
+        const { port, address } = getConnInfo(ctx) ?? {};
+        return `${address}:${port}`;
     }, storage = createRateLimitDefaultStorage(), onError = (ctx, retryAfter, error) => {
         ctx.status(429);
         throw new Error(`Rate limit exceeded. Try again in ${retryAfter} seconds.`);
@@ -30,4 +30,4 @@ const rateLimiter = (options) => {
         return await next();
     };
 };
-export { rateLimiter, rateLimiter as default };
+export { rateLimiter as default, rateLimiter };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tezx",
-  "version": "4.0.2",
+  "version": "4.0.3",
   "description": "TezX is a modern, ultra-lightweight, and high-performance JavaScript framework built specifically for Bun. It provides a minimal yet powerful API, seamless environment management, and a high-concurrency HTTP engine for building fast, scalable web applications.",
   "type": "module",
   "main": "cjs/index.js",

package/types/index.d.ts

@@ -311,7 +311,11 @@ export interface FormDataOptions {
  */
 type TransportType = "tcp" | "udp" | "unix" | "pipe" | "unixpacket";
 /**
- * A normalized network address description.
+ * Remote address details of the connected client.
+ * @property {string} [transport] - Transport protocol (e.g., "tcp", "udp").
+ * @property {"IPv4" | "IPv6" | "Unix"} [family] - Address family.
+ * @property {string} [hostname] - Hostname or IP address.
+ * @property {number} [port] - Port number.
  */
 export type NetAddr = {
     /** Transport protocol used by the connection. */

package/utils/mimeTypes.d.ts

@@ -1,4 +1,117 @@
 export declare const mimeTypes: {
-    [key: string]: string;
+    readonly html: "text/html";
+    readonly htm: "text/html";
+    readonly css: "text/css";
+    readonly js: "text/javascript";
+    readonly mjs: "text/javascript";
+    readonly json: "application/json";
+    readonly xml: "application/xml";
+    readonly txt: "text/plain";
+    readonly md: "text/markdown";
+    readonly csv: "text/csv";
+    readonly tsv: "text/tab-separated-values";
+    readonly rtf: "application/rtf";
+    readonly markdown: "text/markdown";
+    readonly jsx: "text/javascript";
+    readonly ts: "text/typescript";
+    readonly tsx: "text/typescript";
+    readonly jsonld: "application/ld+json";
+    readonly png: "image/png";
+    readonly jpg: "image/jpeg";
+    readonly jpeg: "image/jpeg";
+    readonly gif: "image/gif";
+    readonly svg: "image/svg+xml";
+    readonly webp: "image/webp";
+    readonly ico: "image/x-icon";
+    readonly bmp: "image/bmp";
+    readonly tiff: "image/tiff";
+    readonly psd: "image/vnd.adobe.photoshop";
+    readonly tif: "image/tiff";
+    readonly avif: "image/avif";
+    readonly woff: "font/woff";
+    readonly woff2: "font/woff2";
+    readonly ttf: "font/ttf";
+    readonly otf: "font/otf";
+    readonly eot: "application/vnd.ms-fontobject";
+    readonly mp4: "video/mp4";
+    readonly webm: "video/webm";
+    readonly ogg: "video/ogg";
+    readonly mov: "video/quicktime";
+    readonly avi: "video/x-msvideo";
+    readonly wmv: "video/x-ms-wmv";
+    readonly flv: "video/x-flv";
+    readonly "3gp": "video/3gpp";
+    readonly mkv: "video/x-matroska";
+    readonly mpeg: "video/mpeg";
+    readonly mpg: "video/mpeg";
+    readonly mp3: "audio/mpeg";
+    readonly wav: "audio/wav";
+    readonly aac: "audio/aac";
+    readonly flac: "audio/flac";
+    readonly m4a: "audio/mp4";
+    readonly mid: "audio/midi";
+    readonly midi: "audio/midi";
+    readonly weba: "audio/webm";
+    readonly pdf: "application/pdf";
+    readonly odp: "application/vnd.oasis.opendocument.presentation";
+    readonly zip: "application/zip";
+    readonly gz: "application/gzip";
+    readonly tar: "application/x-tar";
+    readonly rar: "application/x-rar-compressed";
+    readonly _7z: "application/x-7z-compressed";
+    readonly bz2: "application/x-bzip2";
+    readonly "7z": "application/x-7z-compressed";
+    readonly doc: "application/msword";
+    readonly docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
+    readonly xls: "application/vnd.ms-excel";
+    readonly xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
+    readonly ppt: "application/vnd.ms-powerpoint";
+    readonly pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation";
+    readonly odt: "application/vnd.oasis.opendocument.text";
+    readonly ods: "application/vnd.oasis.opendocument.spreadsheet";
+    readonly wasm: "application/wasm";
+    readonly map: "application/json";
+    readonly yaml: "application/yaml";
+    readonly yml: "application/yaml";
+    readonly proto: "text/plain";
+    readonly graphql: "application/graphql";
+    readonly pem: "application/x-pem-file";
+    readonly cer: "application/pkix-cert";
+    readonly crt: "application/x-x509-ca-cert";
+    readonly key: "application/x-pem-file";
+    readonly pfx: "application/x-pkcs12";
+    readonly glb: "model/gltf-binary";
+    readonly gltf: "model/gltf+json";
+    readonly obj: "model/obj";
+    readonly stl: "model/stl";
+    readonly usdz: "model/vnd.usdz+zip";
+    readonly exe: "application/x-msdownload";
+    readonly dmg: "application/x-apple-diskimage";
+    readonly deb: "application/x-debian-package";
+    readonly rpm: "application/x-redhat-package-manager";
+    readonly apk: "application/vnd.android.package-archive";
+    readonly bin: "application/octet-stream";
+    readonly iso: "application/octet-stream";
+    readonly webmanifest: "application/manifest+json";
+    readonly ics: "text/calendar";
+    readonly vcf: "text/vcard";
+    readonly warc: "application/warc";
+    readonly atom: "application/atom+xml";
+    readonly rss: "application/rss+xml";
+    readonly dll: "application/x-msdownload";
+    readonly sh: "application/x-sh";
+    readonly py: "text/x-python";
+    readonly rb: "text/x-ruby";
+    readonly pl: "text/x-perl";
+    readonly php: "application/x-httpd-php";
+    readonly torrent: "application/x-bittorrent";
+    readonly ipa: "application/vnd.iphone";
+    readonly eps: "application/postscript";
+    readonly ps: "application/postscript";
+    readonly ai: "application/postscript";
+    readonly swf: "application/x-shockwave-flash";
+    readonly jar: "application/java-archive";
+    readonly gcode: "text/x.gcode";
 };
+export type ContentType = (typeof mimeTypes[keyof typeof mimeTypes]) | "application/octet-stream" | (string & {});
 export declare const defaultMimeType = "application/octet-stream";

package/utils/mimeTypes.js

@@ -12,6 +12,10 @@ export const mimeTypes = {
     tsv: "text/tab-separated-values",
     rtf: "application/rtf",
     markdown: "text/markdown",
+    jsx: "text/javascript",
+    ts: "text/typescript",
+    tsx: "text/typescript",
+    jsonld: "application/ld+json",
     png: "image/png",
     jpg: "image/jpeg",
     jpeg: "image/jpeg",
@@ -22,6 +26,13 @@ export const mimeTypes = {
     bmp: "image/bmp",
     tiff: "image/tiff",
     psd: "image/vnd.adobe.photoshop",
+    tif: "image/tiff",
+    avif: "image/avif",
+    woff: "font/woff",
+    woff2: "font/woff2",
+    ttf: "font/ttf",
+    otf: "font/otf",
+    eot: "application/vnd.ms-fontobject",
     mp4: "video/mp4",
     webm: "video/webm",
     ogg: "video/ogg",
@@ -30,6 +41,9 @@ export const mimeTypes = {
     wmv: "video/x-ms-wmv",
     flv: "video/x-flv",
     "3gp": "video/3gpp",
+    mkv: "video/x-matroska",
+    mpeg: "video/mpeg",
+    mpg: "video/mpeg",
     mp3: "audio/mpeg",
     wav: "audio/wav",
     aac: "audio/aac",
@@ -37,11 +51,7 @@ export const mimeTypes = {
     m4a: "audio/mp4",
     mid: "audio/midi",
     midi: "audio/midi",
-    woff: "font/woff",
-    woff2: "font/woff2",
-    ttf: "font/ttf",
-    otf: "font/otf",
-    eot: "application/vnd.ms-fontobject",
+    weba: "audio/webm",
     pdf: "application/pdf",
     odp: "application/vnd.oasis.opendocument.presentation",
     zip: "application/zip",
@@ -80,6 +90,8 @@ export const mimeTypes = {
     deb: "application/x-debian-package",
     rpm: "application/x-redhat-package-manager",
     apk: "application/vnd.android.package-archive",
+    bin: "application/octet-stream",
+    iso: "application/octet-stream",
     webmanifest: "application/manifest+json",
     ics: "text/calendar",
     vcf: "text/vcard",

package/cjs/middleware/getConnInfo.js

@@ -1,13 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getConnInfo = getConnInfo;
-function getConnInfo() {
-    return (ctx, next) => {
-        let server = ctx.server;
-        if (server && server.requestIP) {
-            ctx.req.remoteAddress = server.requestIP(ctx.rawRequest);
-        }
-        return next();
-    };
-}
-exports.default = getConnInfo;

package/middleware/getConnInfo.d.ts

@@ -1,22 +0,0 @@
-import { Middleware } from "../types/index.js";
-/**
- * Middleware to extract and inject connection information into the request context.
- *
- * This middleware reads the socket's remote address information (like IP, port, and family)
- * from the request object and attaches it to `ctx.req.remoteAddress`.
- *
- * @returns {Middleware<any>} The middleware function that sets `ctx.req.remoteAddress`.
- *
- * @example
- * import { getConnInfo } from "tezx/middleware";
- *
- * app.use(getConnInfo());
- *
- * // Access later in route handler:
- * router.get("/", (ctx) => {
- *   const ip = ctx.req.remoteAddress?.address;
- *   return new Response(`Your IP: ${ip}`);
- * });
- */
-export declare function getConnInfo<T extends Record<string, any> = {}, Path extends string = any>(): Middleware<T, Path>;
-export default getConnInfo;

package/middleware/getConnInfo.js

@@ -1,10 +0,0 @@
-export function getConnInfo() {
-    return (ctx, next) => {
-        let server = ctx.server;
-        if (server && server.requestIP) {
-            ctx.req.remoteAddress = server.requestIP(ctx.rawRequest);
-        }
-        return next();
-    };
-}
-export default getConnInfo;