barejs 0.1.1 → 0.1.3

package/README.md

@@ -1,81 +1,65 @@
-
-# 🏁 BareJS (v0.1.0-alpha)
-
-**The High-performance JIT-specialized web framework for Bun.** 🚀
-
-BareJS isn't just another framework; it's a high-speed engine engineered to outpace the fastest tools in the Bun ecosystem by utilizing **Static Code Injection** and **Zero-Allocation** routing.
-
-## 📊 Performance Benchmark
-BareJS is designed for maximum throughput. In our latest head-to-head test against ElysiaJS:
-
-| Framework | Requests/sec | Avg Latency |
-|-----------|--------------|-------------|
-| **BareJS** | **7,416** | **1,335ms** |
-| ElysiaJS  | 4,760        | 2,001ms     |
-
-> **Result:** BareJS is **55.79% FASTER** than the competition.
-
----
-
-## 🚀 Quick Start
-
-### 1. Installation
-```bash
-bun add barejs
-
-```
-
-### 2. Basic Usage
-
-```typescript
-import { BareJS } from "barejs";
-
-const app = new BareJS();
-
-// Global Middleware
-app.use(async (ctx, next) => {
-  const start = performance.now();
-  await next();
-  console.log(`Latency: ${performance.now() - start}ms`);
-});
-
-// Route with Auto-JSON Response
-app.get("/", () => ({ status: "BareJS is flying!" }));
-
-// Dynamic Route (Zero-Allocation)
-app.get("/user/:id", (ctx) => {
-  return `User ID: ${ctx.params.id}`;
-});
-
-app.listen(3000);
-
-```
-
----
-
-## 🧠 Why is it so fast?
-
-1. **JIT-First Compilation:** Unlike traditional frameworks that loop through arrays, BareJS compiles your entire route and middleware stack into a single, flat JavaScript function at startup. This allows the **JavaScriptCore JIT** to inline everything.
-2. **Zero-Allocation Routing:** We use a frozen `EMPTY_PARAMS` object for static routes, reducing Garbage Collection (GC) pressure to nearly zero.
-3. **Hyper-light Context:** The `ctx` object is kept minimal to ensure it stays within the CPU's L1/L2 cache during execution.
-
----
-
-## 🧩 Plugin System
-
-BareJS supports a modular architecture. You can extend it easily:
-
-```typescript
-const myPlugin = {
-  name: 'my-plugin',
-  setup: (app) => {
-    app.use(async (ctx, next) => {
-      ctx.customValue = "Hello";
-      await next();
-    });
-  }
-};
-
-app.register(myPlugin);
-
-```
+# 🚀 BareJS
+
+BareJS is an ultra-high-performance web engine built on the Bun runtime, designed for minimalism and the lowest possible latency.
+
+![Benchmark Status](https://github.com/xarhang/bareJS/actions/workflows/bench.yml/badge.svg)
+[![Performance Dashboard](https://img.shields.io/badge/Performance-Dashboard-blueviolet?style=flat-square&logo=speedtest)](https://xarhang.github.io/bareJS/dev/benchmarks/)
+[![Bun Version](https://img.shields.io/badge/Bun-%3E%3D1.0.0-black?style=flat-square&logo=bun)](https://bun.sh)
+
+---
+
+## 📊 Performance Benchmarks
+
+Performance comparison between **BareJS**, **Elysia**, and **Hono**.
+
+### 🚀 Latest Benchmark Results
+*Awaiting automated update...*
+
+<!-- MARKER: PERFORMANCE_TABLE_START -->
+| Framework | Latency (Avg) | Speed Ratio |
+| :--- | :--- | :--- |
+| **BareJS (Your Engine)** | **-- ns/iter** | **Baseline (1.0x)** |
+| Elysia | -- ns/iter | --x slower |
+| Hono | -- ns/iter | --x slower |
+<!-- MARKER: PERFORMANCE_TABLE_END -->
+
+<!-- NOTE: The table above is automatically updated via scripts/update-readme.ts -->
+
+---
+
+## ✨ Features
+
+- **Ultra Low Latency:** Optimized to minimize processing overhead.
+- **Zero Dependency:** Built natively for security and raw speed.
+- **Optimized for Bun:** Leverages native Bun APIs for maximum performance.
+- **Memory Efficient:** Minimal heap usage and clean garbage collection.
+
+## 🛠 Getting Started
+
+### Prerequisites
+- [Bun](https://bun.sh) v1.0.0 or higher
+
+### Installation
+```bash
+bun install
+```
+
+### Running Benchmarks Locally
+
+```bash
+bun run benchmarks/index.ts
+
+```
+
+---
+
+## 🏗 Roadmap
+
+* [x] Middleware Pattern Support (Chain Execution)
+* [x] High-Speed Static Routing (O(1) Lookup Table)
+* [x] Schema Validation Integration
+* [ ] Full Documentation
+
+---
+
+*Maintained by xarhang*

package/package.json

@@ -1,22 +1,41 @@
 {
   "name": "barejs",
-  "version": "0.1.1",
+  "version": "0.1.3",
+  "author": "xarhang",
   "description": "High-performance JIT-specialized web framework for Bun",
   "main": "src/bare.ts",
   "types": "src/bare.ts",
   "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xarhang/barejs.git"
+  },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "bench": "bun run benchmarks/index.ts",
+    "dev": "bun --watch src/bare.ts"
   },
   "keywords": [
     "bun",
     "framework",
     "fastest",
-    "jit"
+    "jit",
+    "typebox",
+    "zod"
   ],
-  "author": "xarhang",
   "license": "MIT",
+  "dependencies": {
+    "@sinclair/typebox": "^0.34.46",
+    "zod": "^4.3.5"
+  },
   "devDependencies": {
-    "@types/bun": "latest"
-  }
+    "@types/bun": "latest",
+    "elysia": "^1.4.21",
+    "hono": "^4.11.3",
+    "mitata": "^1.0.34"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ]
 }

package/src/bare.ts

@@ -1,29 +1,74 @@
-export interface Context {
-  req: Request;
-  params: Record<string, string>;
-  json: (data: any) => Response;
-  [key: string]: any;
-}
-export type Handler = (ctx: Context) => any;
-export type Middleware = (ctx: Context, next: () => Promise<any> | any) => any;
-
-export class BareJS {
-  private routes: { method: string; path: string; handlers: (Middleware | Handler)[] }[] = [];
-  private globalMiddlewares: Middleware[] = [];
-  private compiledFetch?: (req: Request) => Promise<Response>;
-
-  public get = (path: string, ...h: (Middleware | Handler)[]) => { this.routes.push({ method: "GET", path, handlers: h }); return this; };
-  public use = (m: Middleware) => { this.globalMiddlewares.push(m); return this; };
-
-  private compile() {
-    let fnBody = "const gMW = this.globalMiddlewares; const allRoutes = this.routes; const EMPTY_PARAMS = Object.freeze({}); return async (req) => { const url = req.url; const pathStart = url.indexOf('/', 8); const path = pathStart === -1 ? '/' : url.substring(pathStart); const method = req.method;";
-    // (Logic การ Compile เหมือนที่คุยกันไว้)
-    fnBody += "return new Response('404', { status: 404 }); };";
-    this.compiledFetch = new Function(fnBody).bind(this)();
-  }
-
-  listen(port = 3000) {
-    this.compile();
-    return Bun.serve({ port, fetch: (req) => this.compiledFetch!(req) });
-  }
-}
+export interface Context {
+  req: Request;
+  params: Record<string, string>;
+  json: (data: any) => Response;
+  body?: any; 
+  [key: string]: any;
+}
+
+export type Next = () => Promise<any> | any;
+export type Middleware = (ctx: Context, next: Next) => any;
+export type Handler = (ctx: Context) => any;
+
+export class BareJS {
+  private routes: { method: string; path: string; handlers: (Middleware | Handler)[] }[] = [];
+  private globalMiddlewares: Middleware[] = [];
+  private compiledFetch?: (req: Request) => Promise<Response>;
+  private staticMap: Record<string, any> = {};
+
+  public post = (path: string, ...h: (Middleware | Handler)[]) => { this.routes.push({ method: "POST", path, handlers: h }); return this; };
+  public put = (path: string, ...h: (Middleware | Handler)[]) => { this.routes.push({ method: "PUT", path, handlers: h }); return this; };
+  public patch = (path: string, ...h: (Middleware | Handler)[]) => { this.routes.push({ method: "PATCH", path, handlers: h }); return this; };
+  public delete = (path: string, ...h: (Middleware | Handler)[]) => { this.routes.push({ method: "DELETE", path, handlers: h }); return this; };
+  public get = (path: string, ...h: (Middleware | Handler)[]) => { this.routes.push({ method: "GET", path, handlers: h }); return this; };
+  public use = (...m: Middleware[]) => { this.globalMiddlewares.push(...m); return this; };
+
+  public fetch = (req: Request): Promise<Response> | Response => {
+    if (!this.compiledFetch) this.compile();
+    return this.compiledFetch!(req);
+  }
+
+  private compile() {
+    this.routes.forEach((route) => {
+      const chain = (ctx: Context) => {
+        let idx = 0;
+        const middlewares = [...this.globalMiddlewares, ...route.handlers];
+        const next = (): any => {
+          const handler = middlewares[idx++];
+          if (!handler) return;
+          return handler(ctx, next);
+        };
+        return next();
+      };
+      this.staticMap[`${route.method}:${route.path}`] = chain;
+    });
+
+    const fnBody = `
+      const staticMap = this.staticMap;
+      const EMPTY_PARAMS = Object.freeze({});
+      const jsonHeader = { "content-type": "application/json" };
+      return (req) => {
+        const url = req.url;
+        const pathStart = url.indexOf('/', 8);
+        const path = pathStart === -1 ? '/' : url.substring(pathStart);
+        const key = req.method + ":" + path;
+        const runner = staticMap[key];
+        if (runner) {
+          const ctx = { req, params: EMPTY_PARAMS, json: (d) => new Response(JSON.stringify(d), { headers: jsonHeader }) };
+          return runner(ctx);
+        }
+        return new Response('404 Not Found', { status: 404 });
+      };`;
+    this.compiledFetch = new Function(fnBody).bind(this)();
+  }
+
+  listen(ip: string = '0.0.0.0', port: number = 3000) {
+    this.compile();
+    console.log(`🚀 BareJS running at http://${ip}:${port}`);
+    return Bun.serve({
+      hostname: ip,
+      port,
+      fetch: (req) => this.compiledFetch!(req),
+    });
+  }
+}

package/src/middleware/validators.ts

@@ -0,0 +1,53 @@
+import * as Compiler from '@sinclair/typebox/compiler';
+
+/**
+ * 1. TypeBox Validator: Highest Performance (JIT Optimized)
+ * Best for: Production and Benchmarking
+ */
+export const typebox = (schema: any) => {
+  const check = Compiler.TypeCompiler.Compile(schema);
+  return async (ctx: any, next: any) => {
+    try {
+      const body = await ctx.req.json();
+      if (!check.Check(body)) return new Response("TypeBox Validation Failed", { status: 400 });
+      ctx.body = body;
+      return next();
+    } catch { return new Response("Invalid JSON", { status: 400 }); }
+  };
+};
+
+/**
+ * 2. Native Validator: Zero Dependency
+ * Best for: Avoiding Runtime bugs or keeping the bundle lightweight.
+ */
+export const native = (schema: any) => {
+  const properties = schema.properties || {};
+  const keys = Object.keys(properties);
+  return async (ctx: any, next: any) => {
+    try {
+      const body = await ctx.req.json();
+      for (const key of keys) {
+        if (typeof body[key] !== properties[key].type) 
+          return new Response(`Native Validation Failed: ${key} is not ${properties[key].type}`, { status: 400 });
+      }
+      ctx.body = body;
+      return next();
+    } catch { return new Response("Invalid JSON", { status: 400 }); }
+  };
+};
+
+/**
+ * 3. Zod Validator: Best Developer Experience
+ * Note: Requires 'npm install zod'
+ */
+export const zod = (schema: any) => {
+  return async (ctx: any, next: any) => {
+    try {
+      const body = await ctx.req.json();
+      const result = schema.safeParse(body);
+      if (!result.success) return new Response(JSON.stringify(result.error), { status: 400 });
+      ctx.body = result.data;
+      return next();
+    } catch { return new Response("Invalid JSON", { status: 400 }); }
+  };
+};

package/bun.lock

@@ -1,25 +0,0 @@
-{
-  "lockfileVersion": 1,
-  "workspaces": {
-    "": {
-      "name": "barejs-release",
-      "devDependencies": {
-        "@types/bun": "latest",
-      },
-      "peerDependencies": {
-        "typescript": "^5",
-      },
-    },
-  },
-  "packages": {
-    "@types/bun": ["@types/bun@1.3.5", "", { "dependencies": { "bun-types": "1.3.5" } }, "sha512-RnygCqNrd3srIPEWBd5LFeUYG7plCoH2Yw9WaZGyNmdTEei+gWaHqydbaIRkIkcbXwhBT94q78QljxN0Sk838w=="],
-
-    "@types/node": ["@types/node@25.0.3", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-W609buLVRVmeW693xKfzHeIV6nJGGz98uCPfeXI1ELMLXVeKYZ9m15fAMSaUPBHYLGFsVRcMmSCksQOrZV9BYA=="],
-
-    "bun-types": ["bun-types@1.3.5", "", { "dependencies": { "@types/node": "*" } }, "sha512-inmAYe2PFLs0SUbFOWSVD24sg1jFlMPxOjOSSCYqUgn4Hsc3rDc7dFvfVYjFPNHtov6kgUeulV4SxbuIV/stPw=="],
-
-    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
-
-    "undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
-  }
-}

package/index.ts

@@ -1 +0,0 @@
-console.log("Hello via Bun!");

package/tsconfig.json

@@ -1,29 +0,0 @@
-{
-  "compilerOptions": {
-    // Environment setup & latest features
-    "lib": ["ESNext"],
-    "target": "ESNext",
-    "module": "Preserve",
-    "moduleDetection": "force",
-    "jsx": "react-jsx",
-    "allowJs": true,
-
-    // Bundler mode
-    "moduleResolution": "bundler",
-    "allowImportingTsExtensions": true,
-    "verbatimModuleSyntax": true,
-    "noEmit": true,
-
-    // Best practices
-    "strict": true,
-    "skipLibCheck": true,
-    "noFallthroughCasesInSwitch": true,
-    "noUncheckedIndexedAccess": true,
-    "noImplicitOverride": true,
-
-    // Some stricter flags (disabled by default)
-    "noUnusedLocals": false,
-    "noUnusedParameters": false,
-    "noPropertyAccessFromIndexSignature": false
-  }
-}