princejs 1.5.2 → 1.5.4

package/Readme.md

@@ -1,12 +1,12 @@
-# princejs — The Smallest Bun Framework in History
+# PrinceJS — The Fastest Bun Framework in History
 
-**2.8 kB gzipped** • **~600k req/30s** • **Built by a 13yo Nigerian**
+**2.8 kB gzipped** • **19,200 req/s** • **Built by a 13yo Nigerian**
 
-> *"I didn’t beat Elysia. I outsmarted it."* — @Lil_Prince_1218
+> *"I didn't beat Elysia. I destroyed it."* — @Lil_Prince_1218
 
 ---
 
-## 🚀 Get Started
+## 🏆 World Record: Fastest Framework Under 3 kB
 
 ```bash
 # Create a new PrinceJS app
@@ -20,74 +20,205 @@ bun dev
 ```
 
 ```ts
-import { Prince } from "princejs";
-import { cors } from "princejs/middleware";
+import { prince } from "princejs";
+import { cors, logger } from "princejs/middleware";
 
-const app = new Prince()
-  .use(cors())
-  .get("/", () => "Hello princejs")
-  .get("/users/:id", (req) => ({ id: req.params.id }));
+const app = prince();
+
+app.use(cors());
+app.use(logger());
+
+app.get("/", () => ({ message: "Hello PrinceJS!" }));
+app.get("/users/:id", (req) => ({ id: req.params.id }));
 
-app.listen(5000);
+app.listen(3000);
 ```
 
 ---
 
 ## ⚔️ Size War (Gzipped — Real World)
 
-| Framework    | Gzipped    | Minified   | vs princejs |
+| Framework    | Gzipped    | Minified   | vs PrinceJS |
 | ------------ | ---------- | ---------- | ----------- |
-| **princejs** | **2.8 kB** | **7.8 kB** | —           |
+| **PrinceJS** | **2.8 kB** | **7.8 kB** | —           |
 | **Hono**     | 7.3 kB     | 18.7 kB    | 2.6× bigger |
 | **Elysia**   | 62.5 kB    | 245 kB     | 22× bigger  |
 
-> princejs fits in a tweet. Elysia needs a ZIP file.
+> PrinceJS fits in a tweet. Elysia needs a ZIP file.
+
+---
+
+## ⚡ Benchmarks (autocannon -c 100 -d 30)
+
+**Windows 11 • November 15, 2025 • 100 connections • 30 seconds**
+
+### Route: `GET /users/:id`
+
+| Rank | Framework    | Req/s      | Requests (30s) | Throughput  |
+| ---- | ------------ | ---------- | -------------- | ----------- |
+| 🥇   | **PrinceJS** | **19,200** | **576k**       | **2.34 MB/s** |
+| 🥈   | Hono         | 16,212     | 486k           | 1.98 MB/s   |
+| 🥉   | Elysia       | 15,862     | 476k           | 1.94 MB/s   |
+| 4️⃣   | Express      | 9,325      | 280k           | 1.84 MB/s   |
+
+### Summary
+
+- **PrinceJS beats Elysia by 21%** (3,338 more req/s)
+- **PrinceJS beats Hono by 18%** (2,988 more req/s)
+- **PrinceJS beats Express by 106%** (2× faster)
+
+> **PrinceJS is the FASTEST framework under 10 kB. Period.**
 
 ---
 
-## ⚡ Benchmarks (3×3 — Windows, Nov 11, 2025)
+## 🔥 Why PrinceJS Wins
 
-| Framework    | Requests (30s) | Req/s      | Notes          |
-| ------------ | -------------- | ---------- | -------------- |
-| **princejs** | **599k**       | **19,966** | 🥈 2nd fastest |
-| **Elysia**   | 602k           | 20,071     | 🥇 0.5% faster |
-| **Hono**     | 578k           | 19,254     | 🥉 Slower      |
+### 1. **Trie-Based Router** (Cached)
+Most frameworks rebuild routes on every request. PrinceJS builds once and caches.
 
-> Elysia is only 0.5% faster. But princejs is **22× smaller**.
+### 2. **Zero Overhead Middleware**
+Middleware tracking prevents duplicate execution. No wasted cycles.
+
+### 3. **Optimized for Bun**
+Native Bun.serve() with WebSocket support. No abstraction layers.
+
+### 4. **Smart Body Parsing**
+Only parses body when needed (POST/PUT/PATCH). GET requests skip parsing entirely.
 
 ---
 
-## 🧹 Features
+## 🧰 Features
 
 ```ts
-.use(rateLimit({ max: 100 }))
-.use(validate(z.object({ name: z.string() })))
+import { cors, logger, rateLimit, serve } from "princejs/middleware";
+import { validate } from "princejs/validation";
+import { z } from "zod";
+
+app
+  .use(cors())
+  .use(logger({ format: "dev" }))
+  .use(rateLimit({ max: 100, window: 60 }))
+  .use(serve({ root: "./public" }))
+  .use(validate(z.object({ 
+    name: z.string(),
+    age: z.number() 
+  })));
 ```
 
-✅ Zod Validation
-✅ CORS + Logger
-✅ Rate Limit Middleware
+✅ **Middleware:** CORS, Logger, Rate Limiting, Static Files  
+✅ **Validation:** Zod schema validation  
+✅ **WebSocket:** Full WebSocket support  
+✅ **File Upload:** Multipart form data handling  
+✅ **Response Builder:** Fluent API for responses  
+✅ **OpenAPI:** Auto-generate API docs  
 
 ---
 
-## 📦 Install
+## 📦 Installation
 
 ```bash
-npm i princejs
+npm install princejs
 # or
 bun add princejs
+# or
+yarn add princejs
+```
+
+---
+
+## 🎯 Full Example
+
+```ts
+import { prince } from "princejs";
+import { cors, logger, rateLimit } from "princejs/middleware";
+import { validate } from "princejs/validation";
+import { z } from "zod";
+
+const app = prince(true); // dev mode
+
+// Middleware
+app.use(cors());
+app.use(logger());
+app.use(rateLimit({ max: 100, window: 60 }));
+
+// Routes
+app.get("/", () => ({ 
+  message: "Welcome to PrinceJS",
+  version: "1.5.2"
+}));
+
+app.get("/users/:id", (req) => ({
+  id: req.params.id,
+  name: "John Doe"
+}));
+
+// File upload
+app.post("/upload", (req) => ({
+  files: Object.keys(req.files || {}),
+  body: req.body
+}));
+
+// WebSocket
+app.ws("/chat", {
+  open: (ws) => ws.send("Welcome!"),
+  message: (ws, msg) => ws.send(`Echo: ${msg}`),
+  close: (ws) => console.log("Disconnected")
+});
+
+app.listen(3000);
 ```
 
 ---
 
-## 📚 Docs
+## 📚 Documentation
 
-**coming soon →** [princejs.vercel.app](https://princejs.vercel.app)
+Check: [princejs](https://princejs.vercel.app)
+
+---
+
+## 🤝 Contributing
+
+Issues and PRs welcome! This is a learning project but we take quality seriously.
+
+```bash
+git clone https://github.com/MatthewTheCoder1218/princejs
+cd princejs
+bun install
+bun test
+```
 
 ---
 
 ## 🇳🇬 Built in Nigeria
 
-**@Lil_Prince_1218 — 13 years old**
+**Made by @Lil_Prince_1218 — Age 13**
+
+> *"2.8 kB. 19,200 req/s. The fastest framework under 10 kB."*
+
+Inspired by the greats (Express, Hono, Elysia) but built to win.
+
+---
+
+## 📄 License
+
+MIT © 2025 Matthew Michael
+
+---
+
+## ⭐ Star This Repo
+
+If PrinceJS helped you, give it a star! It helps other developers discover it.
+
+**GitHub:** [github.com/MatthewTheCoder1218/princejs](https://github.com/MatthewTheCoder1218/princejs)
+
+---
+
+## 🔗 Links
+
+- [npm](https://www.npmjs.com/package/princejs)
+- [GitHub](https://github.com/MatthewTheCoder1218/princejs)
+- [Twitter](https://twitter.com/Lil_Prince_1218)
+
+---
 
-> *“2.8 kB. 600k req. No excuses.”*
+**PrinceJS: Small in size. Giant in speed. 🚀**

package/dist/prince.js

@@ -188,19 +188,20 @@ class Prince {
     return async (req, params, query) => {
       Object.defineProperty(req, "params", { value: params, writable: true, configurable: true });
       Object.defineProperty(req, "query", { value: query, writable: true, configurable: true });
+      if (["POST", "PUT", "PATCH"].includes(req.method)) {
+        const parsed = await this.parseBody(req);
+        if (parsed && typeof parsed === "object" && "files" in parsed && "fields" in parsed) {
+          Object.defineProperty(req, "body", { value: parsed.fields, writable: true, configurable: true });
+          Object.defineProperty(req, "files", { value: parsed.files, writable: true, configurable: true });
+        } else {
+          Object.defineProperty(req, "body", { value: parsed, writable: true, configurable: true });
+        }
+      }
       let i = 0;
       const next = async () => {
         if (i < this.middlewares.length) {
-          return await this.middlewares[i++](req, next) ?? new Response("");
-        }
-        if (["POST", "PUT", "PATCH"].includes(req.method)) {
-          const parsed = await this.parseBody(req);
-          if (parsed && typeof parsed === "object" && "files" in parsed && "fields" in parsed) {
-            Object.defineProperty(req, "body", { value: parsed.fields, writable: true, configurable: true });
-            Object.defineProperty(req, "files", { value: parsed.files, writable: true, configurable: true });
-          } else {
-            Object.defineProperty(req, "body", { value: parsed, writable: true, configurable: true });
-          }
+          const result = await this.middlewares[i++](req, next);
+          return result ?? new Response("");
         }
         const res = await handler(req);
         if (res instanceof Response)

package/dist/validation.js

@@ -6,7 +6,11 @@ var validate = (schema, source = "body") => {
       const data = source === "body" ? req.body : source === "query" ? req.query : req.params;
       const validated = schema.parse(data);
       req[`validated${source.charAt(0).toUpperCase() + source.slice(1)}`] = validated;
-      return await next();
+      if (next) {
+        const result = await next();
+        return result;
+      }
+      return;
     } catch (err) {
       return new Response(JSON.stringify({
         error: "Validation failed",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "princejs",
-  "version": "1.5.2",
+  "version": "1.5.4",
   "description": "An easy and fast backend framework — by a 13yo developer, for developers.",
   "main": "dist/prince.js",
   "types": "dist/prince.d.ts",
@@ -59,7 +59,7 @@
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "zod": "^3.0.0"
+    "zod": "^4.0.0"
   },
   "peerDependenciesMeta": {
     "zod": {