barejs 0.1.45 → 0.1.47

package/README.md

@@ -1,60 +1,53 @@
-
 <div align="center">
-  <br />
-  <h1>Bare<span style="color: #F7DF1E;">JS</span></h1>
-  <p><strong>The "Metal" of Web Frameworks</strong></p>
-  <p><i>An ultra-high-performance web engine built for Bun, architected strictly for Mechanical Sympathy.</i></p>
-
-  <p>
-    <a href="https://www.npmjs.com/package/barejs">
-      <img src="https://img.shields.io/npm/v/barejs?style=for-the-badge&logo=npm&color=CB3837" alt="NPM Version">
-    </a>
-    <a href="https://github.com/xarhang/barejs/actions/workflows/bench.yml">
-      <img src="https://img.shields.io/github/actions/workflow/status/xarhang/barejs/bench.yml?branch=main&label=Performance&style=for-the-badge&logo=github" alt="Performance">
-    </a>
-    <a href="https://bun.sh">
-      <img src="https://img.shields.io/badge/Bun-%3E%3D1.0.0-black?style=for-the-badge&logo=bun" alt="Bun Version">
-    </a>
-    <a href="https://github.com/xarhang/barejs/blob/main/LICENSE">
-      <img src="https://img.shields.io/github/license/xarhang/barejs?style=for-the-badge&color=blue" alt="License">
-    </a>
-  </p>
-
-  <p align="center">
-    <a href="#-benchmarks">Benchmarks</a> •
-    <a href="#-features">Features</a> •
-    <a href="#-quick-start">Quick Start</a> •
-    <a href="#-configuration">Configuration</a> •
-    <a href="#-architecture">Architecture</a>
-  </p>
-
-  ---
+<br />
+<h1>Bare<span style="color: #F7DF1E;">JS</span></h1>
+<p><strong>The "Metal" of Web Frameworks</strong></p>
+<p><i>An ultra-high-performance web engine built for Bun, architected strictly for Mechanical Sympathy.</i></p>
+
+<p>
+<a href="https://www.npmjs.com/package/barejs">
+<img src="https://img.shields.io/npm/v/barejs?style=for-the-badge&logo=npm&color=CB3837" alt="NPM Version">
+</a>
+<a href="https://github.com/xarhang/barejs/actions/workflows/bench.yml">
+<img src="https://img.shields.io/github/actions/workflow/status/xarhang/barejs/bench.yml?branch=main&label=Performance&style=for-the-badge&logo=github" alt="Performance">
+</a>
+<a href="https://bun.sh">
+<img src="https://img.shields.io/badge/Bun-%3E%3D1.0.0-black?style=for-the-badge&logo=bun" alt="Bun Version">
+</a>
+<a href="https://github.com/xarhang/barejs/blob/main/LICENSE">
+<img src="https://img.shields.io/github/license/xarhang/barejs?style=for-the-badge&color=blue" alt="License">
+</a>
+</p>
+</div>
+
+---
+
 </div>
 
 ## 📊 Benchmarks: Real-World Performance
 
 BareJS leads in complex, real-world scenarios. We measure engine efficiency using a **stress test** involving **10+ middlewares** and **deep radix tree routing** to ensure performance holds under high concurrency.
-
 <!-- MARKER: PERFORMANCE_TABLE_START -->
 
 | Framework | Latency | Speed |
 | :--- | :--- | :--- |
-| **BareJS** | **1.57 µs** | **Baseline** |
-| Elysia | 2.43 µs | 1.55x slower |
-| Hono | 10.63 µs | 6.76x slower |
+| **BareJS** | **1.79 µs** | **Baseline** |
+| Elysia | 2.44 µs | 1.36x slower |
+| Hono | 9.86 µs | 5.52x slower |
 
-> Last Updated: 2026-01-12
+> Last Updated: 2026-01-14 (github action)
 
 <!-- MARKER: PERFORMANCE_TABLE_END -->
-> [!TIP]
-> **View our [Continuous Benchmark Dashboard](https://xarhang.github.io/bareJS/dev/benchmarks/)** for historical data and detailed performance trends across different hardware.
 
+> [!TIP]
+> **View our [Continuous Benchmark Dashboard**](https://xarhang.github.io/bareJS/dev/benchmarks/) for historical data and detailed performance trends.
 
 ## 🚀 Key Features
 
 * **JIT Pipeline Compilation**: Routes and middleware chains are flattened into a single function at runtime.
 * **Object Pooling**: Recycles `Context` objects via a circular buffer, drastically reducing GC pressure.
-* **Secure by Default**: Built-in **Argon2id (64MB)** hashing for maximum production security.
+* **Internal High-Performance Logger**: Zero-overhead logging integrated directly into the JIT engine.
+* **Precise Radix Router**: v0.1.46 introduces optimized segment matching for deep-nested paths.
 * **Mechanical Sympathy**: Intentionally designed to align with V8's optimization and Bun's I/O.
 
 ## 🛠️ Installation
@@ -70,7 +63,12 @@ bun add barejs
 import { BareJS, type Context } from 'barejs';
 
 const app = new BareJS();
+
+// Enable Internal Logger
+app.useLog(true);
+
 app.get('/', (ctx: Context) => ctx.json({ hello: "world" }));
+
 app.listen(3000);
 
 ```
@@ -79,9 +77,23 @@ app.listen(3000);
 
 ## 📘 Comprehensive Guide
 
-### 1. 🛡️ Security & Authentication (Dual-API)
+### 1. ⚡ Standardized Response & Chaining
 
-BareJS provides high-level security utilities. You can use `Hash` or `Password` interchangeably for semantic clarity.
+BareJS v0.1.46 provides a fluent API for building responses.
+
+```typescript
+app.get('/api/v1/health', (ctx: Context) => {
+  // Chainable status and standardized send helper
+  return ctx.status(200).send("System is healthy", { 
+    uptime: process.uptime() 
+  });
+});
+
+// Output: { "status": "success", "msg": "System is healthy", "uptime": ... }
+
+```
+
+### 2. 🛡️ Security & Authentication (Dual-API)
 
 ```typescript
 import { bareAuth, createToken, Password, Hash, type Context } from 'barejs';
@@ -103,37 +115,23 @@ app.post('/register', async (ctx: Context) => {
   }
 });
 
-// Protect routes
+// Protect routes with built-in JWT middleware
 app.get('/me', bareAuth(SECRET), (ctx: Context) => {
-  return { user: ctx.get('user') };
+  return ctx.send("Authenticated", { user: ctx.get('user') });
 });
 
 ```
 
-### 2. ⚙️ Configuration
-
-Customize your engine by creating a `bare.config.ts` in your root directory.
-
-```typescript
-// bare.config.ts
-export default {
-  port: 3000,
-  hash: {
-    algorithm: "argon2id",
-    memoryCost: 65536, // 64MB
-    timeCost: 2
-  }
-};
-
-```
-
 ### 3. ✅ Data Validation (3 Styles)
 
+BareJS is the only engine that offers JIT-optimized validation paths.
+
 ```typescript
 import { typebox, zod, native, t, type Context } from 'barejs';
 import { z } from 'zod';
 
 // Style A: TypeBox (JIT Optimized - Recommended)
+// Pre-compiled validation to outperform competitors by 55%
 const Schema = t.Object({ name: t.String() });
 app.post('/user', typebox(Schema), (ctx) => ctx.json(ctx.body));
 
@@ -141,14 +139,16 @@ app.post('/user', typebox(Schema), (ctx) => ctx.json(ctx.body));
 const ZodSchema = z.object({ age: z.number() });
 app.post('/age', zod(ZodSchema), (ctx) => ctx.json(ctx.body));
 
+// Style C: Native (Zero Dependency - Simple Checks)
+app.post('/native', native({ properties: { id: { type: 'number' } } }), (ctx) => ctx.json(ctx.body));
+
 ```
 
-### 4. 🔌 Essential Plugins
+### 4. 🔌 Essential Middleware
 
 ```typescript
-import { logger, cors, staticFile } from 'barejs';
+import { cors, staticFile } from 'barejs';
 
-app.use(logger);
 app.use(cors());
 app.use(staticFile("public"));
 
@@ -162,9 +162,12 @@ app.use(staticFile("public"));
 | --- | --- |
 | `ctx.req` | Raw incoming Bun `Request` object. |
 | `ctx.params` | Route parameters (e.g., `:id`). |
-| `ctx.jsonBody()` | **[Async]** Parses and caches JSON body. |
-| `ctx.status(code)` | Sets the HTTP status code. |
-| `ctx.json(data)` | Returns an optimized JSON response. |
+| `ctx.jsonBody()` | **[Async]** Parses and caches JSON body for performance. |
+| `ctx.status(code)` | Sets the HTTP status code (**Chainable**). |
+| `ctx.send(msg, ext)` | Returns a standardized JSON response. |
+| `ctx.json(data)` | Returns an optimized raw JSON response. |
+| `ctx.setHeader(k, v)` | Sets a response header. |
+| `ctx.set / ctx.get` | Manual storage within the request lifecycle. |
 
 ---
 
@@ -172,8 +175,10 @@ app.use(staticFile("public"));
 
 | OS Variable / File | Default | Description |
 | --- | --- | --- |
-| `bare.config.ts` | - | Centralized config for Port and Hash. |
-| `BARE_POOL_SIZE` | `1024` | Context pool size (Must be Power of 2). |
-| `NODE_ENV` | `development` | Set to `production` for peak JIT speed. |
+| `bare.config.ts` | - | Centralized config for Port and Hash algorithms. |
+| `BARE_POOL_SIZE` | `1024` | Context pool size (**Must be Power of 2**). |
+| `NODE_ENV` | `development` | Set to `production` to enable peak JIT optimizations. |
+
+---
 
-**Maintained by [xarhang](https://github.com/xarhang) | License: MIT**
+**Maintained by [xarhang](https://github.com/xarhang) | License: MIT**