tezx 3.0.14-beta.3 → 4.0.0-beta

package/README.md

@@ -1,110 +1,91 @@
-# ⚡ TezX – High-Performance JavaScript Framework
+# ⚡ TezX – High-Performance JavaScript Framework for **Bun**
 
-**TezX** is a modern, high-performance, and lightweight JavaScript framework designed for speed, scalability, and cross-environment compatibility. It offers an intuitive API for routing, middleware management, and static file serving—making it ideal for building web applications with **Node.js**, **Deno**, and **Bun**.
+**TezX** is a modern, ultra-fast, and lightweight JavaScript framework built specifically for **Bun**.
+With a clean API, powerful routing, WebSocket support, middleware stacking, and native static file serving — TezX helps you build scalable applications with unmatched speed.
 
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/tezxjs/TezX)
 
 ---
 
-## 🚀 Features at a Glance
+## 🚀 Why TezX (Built for Bun)?
 
-- ⚡ **Ultra-Fast Performance** – Built for speed and concurrency.
-- 🧩 **Minimal & Intuitive API** – Clean and easy to use.
-- 🗂 **Static File Serving** – Serve files with a single command.
-- 🔌 **Middleware Support** – Stack and compose custom logic.
-- 🧭 **Flexible Routing** – Dynamic and pattern-based routing.
-- 🔐 **Security-First Design** – Secure by default.
-- 📡 **Efficient HTTP Engine** – High-concurrency request handling.
-- 🌍 **Cross-Environment** – Works with Node.js, Deno, and Bun.
+* ⚡ **Blazing Fast** — Fully optimized for Bun’s event loop & native performance.
+* 🧩 **Minimal, Clean API** — Developer-friendly and intuitive.
+* 🗂 **Native Static Serving** — No external dependencies needed.
+* 🔌 **Powerful Middleware Engine** — Compose any logic effortlessly.
+* 🧭 **Advanced Routing** — Dynamic, nested, and pattern-based.
+* 🔐 **Secure by Default** — Built-in safe context handling.
+* 📡 **WebSocket Support** — Real-time apps made easy with `wsHandlers`.
+* ♻️ **Multi-Process Ready** — Via Bun’s `reusePort`.
 
 ---
 
 ## 📦 Installation
 
-### Node.js
-
-```bash
-npm install tezx
-# or
-yarn add tezx
-```
-
-### Bun
-
 ```bash
 bun add tezx
+# or
+npm install tezx
 ```
 
-<!--
-### Deno
-
-```ts
-import { TezX } from "https://deno.land/x/tezx/mod.ts";
-```
--->
-
 ---
 
-## ⚡ Quick Start
+## ⚡ Quick Start (Bun)
 
 ```ts
 import { TezX } from "tezx";
-import { logger } from "tezx/logger";
-import { createServer } from "node:http";
-import { mountTezXOnNode } from "tezx/node";
+import { logger } from "tezx/middleware";
+import { serveStatic } from "tezx/static";
+import { wsHandlers } from "tezx/ws";
 
 const app = new TezX();
+
+// Middlewares
 app.use(logger());
-app.static("/", "./static");
 
+// Static files
+app.static(serveStatic("/", "./static"));
+
+// Route
 app.get("/", (ctx) =>
   ctx.html(`
     <h1>Welcome to TezX</h1>
-    <p>A modern, high-performance, cross-runtime JavaScript framework.</p>
+    <p>High-performance JavaScript framework optimized for Bun.</p>
   `)
 );
 
-const server = createServer();
-mountTezXOnNode(app, server);
+// Server
+const port = Number(process.env.PORT) || 3001;
 
-const PORT = process.env.PORT || 3000;
-server.listen(PORT, () => {
-  console.log(`🚀 TezX is running at http://localhost:${PORT}`);
+Bun.serve({
+  port,
+  reusePort: true,
+  fetch(req, server) {
+    return app.serve(req, server);
+  },
+  websocket: wsHandlers({
+    // Optional WebSocket config
+  }),
 });
-```
 
----
-
-## ▶ Starting the Server
-
-### Node.js
-
-```bash
-node server.js
-# or
-npm install -g nodemon
-nodemon server.js
+console.log(`🚀 TezX server running at http://localhost:${port}`);
 ```
 
-### Bun
-
-```bash
-bun run server.js
-```
+---
 
-### Deno
+## ▶ Run the Server
 
 ```bash
-deno run --allow-all server.ts
+bun run server.ts
 ```
 
 ---
 
-## 🔌 Middleware Usage
+## 🔌 Middleware Example
 
 ```ts
 app.use((ctx, next) => {
-  console.log(`Incoming request: ${ctx.req.url}`);
+  console.log("➡ Request:", ctx.req.url);
   return next();
 });
 ```
@@ -114,21 +95,28 @@ app.use((ctx, next) => {
 ## 🗂 Static File Serving
 
 ```ts
-app.static("/public", "./public");
+import { serveStatic } from "tezx/static";
+
+app.static(serveStatic("/assets", "./assets"));
 ```
 
-Accessible via: `http://localhost:3000/public/filename.ext`
+Access via:
+
+```bash
+http://localhost:3001/assets/your-file.ext
+```
 
 ---
 
 ## 🧭 Routing
 
 ```ts
-app.get("/about", (ctx) => ctx.html("<h1>About Us</h1>"));
+app.get("/about", (ctx) => ctx.html("<h1>About TezX</h1>"));
 
-app.post("/submit", (ctx) =>
-  ctx.json({ message: "Form submitted successfully" })
-);
+app.post("/contact", async (ctx) => {
+  const body = await ctx.json();
+  return ctx.json({ received: body });
+});
 ```
 
 ---
@@ -137,7 +125,10 @@ app.post("/submit", (ctx) =>
 
 ```ts
 app.onError((err, ctx) => {
-  return ctx.status(500).json({ error: "Internal Server Error" });
+  return ctx.status(500).json({
+    error: "Internal Server Error",
+    message: err.message,
+  });
 });
 ```
 
@@ -145,38 +136,9 @@ app.onError((err, ctx) => {
 
 ## 🧪 Development Setup
 
-### Run Dev Server
-
-```bash
-npm run dev
-# or
-bun run dev
-```
+### `dev` script for Bun
 
-Access: [http://localhost:3000](http://localhost:3000)
-
----
-
-## ⚙️ Platform-Specific Scripts
-
-### Node.js – `package.json`
-
-```json
-{
-  "scripts": {
-    "build:esm": "tsc --outDir dist/mjs --removeComments",
-    "build:dts": "tsc --outDir dist/types --declaration --emitDeclarationOnly",
-    "build": "npm run build:esm && npm run build:dts",
-    "start": "node dist/index.js",
-    "nodemon": "nodemon src/index.ts",
-    "dev": "tsx watch src/index.ts"
-  }
-}
-```
-
----
-
-### Bun – `package.json`
+**package.json**
 
 ```json
 {
@@ -186,111 +148,62 @@ Access: [http://localhost:3000](http://localhost:3000)
 }
 ```
 
-#### Example: `src/index.ts`
+### Example: `src/index.ts`
 
 ```ts
+import app from "./app";
+
 Bun.serve({
   port: 3001,
   reusePort: true,
   fetch(req, server) {
     return app.serve(req, server);
   },
-  websocket: {
-    open(ws) {
-      console.log("WebSocket connected");
-      return ws.data?.open?.(ws);
-    },
-    message(ws, msg) {
-      return ws.data?.message?.(ws, msg);
-    },
-    close(ws, code, reason) {
-      return ws.data?.close?.(ws, { code, reason });
-    },
-    ping(ws, data) {
-      return ws.data?.ping?.(ws, data);
-    },
-    pong(ws, data) {
-      return ws.data?.pong?.(ws, data);
-    },
-    drain(ws) {
-      return ws.data?.drain?.(ws);
-    }
-  }
-});
-
-console.log(`🚀 Server running at http://localhost:${process.env.PORT}`);
-```
-
----
-
-### Deno – `package.json`
-
-```json
-{
-  "scripts": {
-    "dev": "deno run --watch --allow-all --unstable-sloppy-imports src/index.ts"
-  }
-}
-```
-
-#### Example: `src/index.ts`
-
-```ts
-Deno.serve({ port: Number(Deno.env.get("PORT") || 5000) }, (req, connInfo) => {
-  return app.serve(req, connInfo);
 });
 ```
 
 ---
 
-## 🏗 Build & Deployment
-
-### Compile TypeScript
-
-```bash
-npm run build
-```
-
-Outputs:
-
-- CommonJS (`dist/cjs`)
-- ESM (`dist/mjs`)
-- Type Declarations (`dist/types`)
-
----
-
 ## 🤝 Contributing
 
-We welcome all contributions! Here's how to get started:
+We welcome contributions!
 
-- Fork the repository
-- Create a new branch
-- Submit a pull request
-- Open issues for bugs or ideas
+1. Fork the repo
+2. Create a new branch
+3. Commit your changes
+4. Open a pull request
 
-👉 GitHub: [https://github.com/tezxjs](https://github.com/tezxjs)
+👉 GitHub: **[https://github.com/tezxjs](https://github.com/tezxjs)**
 
 ---
 
 ## 💖 Support TezX
 
-TezX is open-source and developed with love. If you find it helpful:
-
-- 🌟 Star the project on [GitHub](https://github.com/tezxjs/TezX)
-- 💸 [Sponsor on GitHub](https://github.com/sponsors/srakib17)
+If TezX helps you, consider supporting:
 
-<!-- - ☕ [Buy Me a Coffee](https://www.buymeacoffee.com/srakib17) -->
+* ⭐ Star on GitHub
+* 💸 Sponsor on GitHub: [https://github.com/sponsors/srakib17](https://github.com/sponsors/srakib17)
 
-Your support helps improve and maintain TezX for everyone.
+Your support helps improve the framework.
 
 ---
 
 ## 🙌 Sponsor
 
-[![papernxt](https://papernxt.com/favicon.ico)](https://papernxt.com)
+<a href="http://papernxt.com" target="_blank">
+  <img
+  src="https://papernxt.com/favicon.ico"
+  width="48"
+  hight="48"
+  alt="papernxt.com"
+  title="papernxt.com"
+  />
+</a>
 
 ---
 
 ## 📜 License
 
-This project is licensed under the [MIT License](./LICENSE).
+Licensed under the **MIT License**.
+
+---

package/cjs/{core/config.js → config/index.js}

@@ -1,11 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GlobalConfig = void 0;
+exports.Config = void 0;
 const debugging_js_1 = require("../utils/debugging.js");
-const runtime_js_1 = require("../utils/runtime.js");
-let GlobalConfig = class {
+let Config = class {
     static debugMode = false;
-    static adapter = runtime_js_1.runtime;
     static get debugging() {
         return this.debugMode
             ? {
@@ -24,4 +22,4 @@ let GlobalConfig = class {
             };
     }
 };
-exports.GlobalConfig = GlobalConfig;
+exports.Config = Config;

package/cjs/core/context.js

@@ -1,39 +1,29 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Context = void 0;
-const file_js_1 = require("../utils/file.js");
-const low_level_js_1 = require("../utils/low-level.js");
 const mimeTypes_js_1 = require("../utils/mimeTypes.js");
 const response_js_1 = require("../utils/response.js");
-const error_js_1 = require("./error.js");
+const utils_js_1 = require("../utils/utils.js");
 const request_js_1 = require("./request.js");
 class Context {
     #status = 200;
     #headers;
     #req = null;
-    #params = {};
+    params = {};
     rawRequest;
-    #args;
+    #server;
     #body;
     url;
     res;
-    env = {};
     pathname;
     method;
-    constructor(req, pathname, method, env, args) {
-        this.#args = args;
+    constructor(req, pathname, method, server) {
+        this.#server = server;
         this.rawRequest = req;
         this.url = req.url;
         this.pathname = pathname;
-        this.env = env ?? {};
         this.method = method;
     }
-    get getStatus() {
-        return this.#status;
-    }
-    set setStatus(code) {
-        this.#status = code;
-    }
     get headers() {
         return this.res?.headers ?? (this.#headers ??= new Headers());
     }
@@ -51,11 +41,8 @@ class Context {
         }
         return this;
     }
-    set params(params) {
-        this.#params = params;
-    }
     get req() {
-        return (this.#req ??= new request_js_1.TezXRequest(this.rawRequest, this.method, this.pathname, this.#params));
+        return (this.#req ??= new request_js_1.TezXRequest(this.rawRequest, this.method, this.pathname, this.params));
     }
     get body() {
         return this.#body;
@@ -63,26 +50,14 @@ class Context {
     set body(value) {
         this.#body = value;
     }
-    status = (status) => {
+    status(status) {
         this.#status = status;
         return this;
-    };
+    }
     #newResponse(body, type, init = {}) {
-        const headers = new Headers(this.#headers);
-        headers.set("Content-Type", type);
-        if (init.headers) {
-            for (const key in init.headers) {
-                const value = init.headers[key];
-                if (!value)
-                    continue;
-                if (key.toLowerCase() === "set-cookie") {
-                    headers.append(key, value);
-                }
-                else {
-                    headers.set(key, value);
-                }
-            }
-        }
+        let headers = (0, response_js_1.mergeHeaders)(this.#headers, init.headers);
+        if (!headers.has("Content-Type"))
+            headers.set("Content-Type", type);
         return new Response(body, {
             status: init.status ?? this.#status,
             statusText: init.statusText,
@@ -90,21 +65,7 @@ class Context {
         });
     }
     newResponse(body, init = {}) {
-        const headers = new Headers(this.#headers);
-        if (init.headers) {
-            for (const key in init.headers) {
-                const value = init.headers[key];
-                if (!value) {
-                    continue;
-                }
-                if (key.toLowerCase() === "set-cookie") {
-                    headers.append(key, value);
-                }
-                else {
-                    headers.set(key, value);
-                }
-            }
-        }
+        let headers = (0, response_js_1.mergeHeaders)(this.#headers, init.headers);
         return new Response(body, {
             status: init.status ?? this.#status,
             statusText: init.statusText,
@@ -114,64 +75,79 @@ class Context {
     text(content, init) {
         return this.#newResponse(content, "text/plain; charset=utf-8", init);
     }
-    html(strings, ...args) {
-        return this.#newResponse((0, response_js_1.toString)(strings, args), "text/html; charset=utf-8", args?.[0]);
-    }
-    xml(strings, ...args) {
-        return this.#newResponse((0, response_js_1.toString)(strings, args), "text/html; charset=utf-8", args?.[0]);
+    html(strings, init) {
+        return this.#newResponse(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: _body, type } = (0, response_js_1.determineContentTypeBody)(body);
-        const contentType = init?.headers?.["Content-Type"] ??
-            init?.headers?.["content-type"] ??
-            type;
-        return this.#newResponse(_body, contentType, 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);
     }
     redirect(url, status = 302) {
         const headers = new Headers(this.#headers);
         headers.set("Location", url);
         return new Response(null, { status, headers });
     }
-    async download(filePath, filename) {
-        if (!(await (0, file_js_1.fileExists)(filePath)))
-            throw error_js_1.TezXError.notFound("File not found");
-        const buf = await (0, file_js_1.getFileBuffer)(filePath);
-        const headers = {
-            "Content-Disposition": `attachment; filename="${filename}"`,
-            "Content-Length": buf.byteLength.toString(),
-        };
-        return this.#newResponse(buf, "application/octet-stream", {
-            status: this.#status,
-            headers,
-        });
-    }
     async sendFile(filePath, init) {
-        if (!(await (0, file_js_1.fileExists)(filePath)))
-            throw error_js_1.TezXError.notFound("File not found");
-        let { size, mtime } = await (0, file_js_1.fileSize)(filePath);
-        const ext = (0, low_level_js_1.extensionExtract)(filePath);
-        const mimeType = mimeTypes_js_1.mimeTypes[ext] ?? mimeTypes_js_1.defaultMimeType;
-        let fileStream = await (0, file_js_1.readStream)(filePath);
-        let headers = {
-            "Content-Type": mimeType,
-            "Content-Length": size.toString(),
-            ...init?.headers,
-        };
-        let filename = init?.filename;
-        if (filename) {
-            headers["Content-Disposition"] = `attachment; filename="${filename}"`;
+        let file = Bun.file(filePath);
+        if (!await file.exists()) {
+            this.#status = 404;
+            throw Error("File not found");
+        }
+        ;
+        let size = file.size;
+        let stream = file.stream();
+        let headers = init?.headers ?? {};
+        headers['Content-Length'] = size.toString();
+        if (init?.filename) {
+            headers["Content-Disposition"] = `attachment; filename="${init?.filename}"`;
         }
-        return this.newResponse(fileStream, {
+        if (init?.download || init?.filename) {
+            headers["Content-Type"] = "application/octet-stream";
+            return this.newResponse(stream, {
+                status: init?.status ?? this.#status,
+                statusText: init?.statusText,
+                headers,
+            });
+        }
+        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, {
             status: init?.status ?? this.#status,
             statusText: init?.statusText,
             headers,
         });
     }
-    get args() {
-        return this.#args;
+    get server() {
+        return this.#server;
     }
 }
 exports.Context = Context;

package/cjs/core/request.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TezXRequest = void 0;
 const url_js_1 = require("../utils/url.js");
-const error_js_1 = require("./error.js");
 class TezXRequest {
     url;
     method;
@@ -84,11 +83,11 @@ class TezXRequest {
             return this.#cachedFormObject;
         const ct = this.#contentType;
         if (!ct)
-            throw new error_js_1.TezXError("Missing Content-Type");
+            throw new Error("Missing Content-Type");
         if (ct === "application/x-www-form-urlencoded" ||
             ct === "multipart/form-data") {
             if (this.#bodyConsumed) {
-                throw new error_js_1.TezXError("Multipart body already consumed elsewhere");
+                throw new Error("Multipart body already consumed elsewhere");
             }
             this.#cachedFormObject = (await this.#rawRequest.formData());
             this.#bodyConsumed = true;