princejs 1.5.4 → 1.6.0

package/Readme.md

@@ -9,13 +9,8 @@
 ## 🏆 World Record: Fastest Framework Under 3 kB
 
 ```bash
-# Create a new PrinceJS app
 bun create princejs my-app
-
-# Move into the project
 cd my-app
-
-# Run in development mode
 bun dev
 ```
 
@@ -38,52 +33,55 @@ app.listen(3000);
 
 ## ⚔️ Size War (Gzipped — Real World)
 
-| Framework    | Gzipped    | Minified   | vs PrinceJS |
-| ------------ | ---------- | ---------- | ----------- |
-| **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  |
+| Framework    | Gzipped    | Minified | vs PrinceJS     |
+| ------------ | ---------- | -------- | --------------- |
+| **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`
 
-### 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   |
+| 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 beats **Elysia by 21%** (3,338 more req/s)
+* PrinceJS beats **Hono by 18%** (2,988 more req/s)
+* PrinceJS beats **Express by 106%** (over 2× faster)
 
-> **PrinceJS is the FASTEST framework under 10 kB. Period.**
+> PrinceJS is the FASTEST framework under 10 kB. Period.
 
 ---
 
 ## 🔥 Why PrinceJS Wins
 
-### 1. **Trie-Based Router** (Cached)
+### 1. **Trie-Based Router (Cached)**
+
 Most frameworks rebuild routes on every request. PrinceJS builds once and caches.
 
 ### 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.
+
+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.
+
+Only parses body when needed. GET requests skip parsing entirely.
 
 ---
 
@@ -105,12 +103,42 @@ app
   })));
 ```
 
-✅ **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  
+### ✓ Middleware
+
+* CORS
+* Logger
+* Rate Limiting
+* Static Files
+
+### ✓ Validation
+
+* Zod schema validation
+
+### ✓ WebSocket Support
+
+### ✓ File Uploads
+
+### ✓ Response Builder
+
+### ✓ OpenAPI
+
+---
+
+## 🆕 v3.3.1 — New Tree-Shakable Features
+
+```ts
+import { cache, email, ai, upload } from "princejs/helpers";
+import { cron, openapi } from "princejs/scheduler";
+```
+
+* `cache(60)(handler)` — In-memory cache
+* `email(to, subject, html)` — Resend.com
+* `ai(prompt)` — Grok-3 via xAI API
+* `upload()` — 1-line file upload
+* `cron("*/2 * * * *", task)` — Cron support
+* `openapi({ title, version })` — Auto docs
+
+**Tree-shakable = only what you import gets bundled**
 
 ---
 
@@ -132,6 +160,8 @@ yarn add princejs
 import { prince } from "princejs";
 import { cors, logger, rateLimit } from "princejs/middleware";
 import { validate } from "princejs/validation";
+import { cache, ai, upload } from "princejs/helpers";
+import { cron } from "princejs/scheduler";
 import { z } from "zod";
 
 const app = prince(true); // dev mode
@@ -141,10 +171,13 @@ app.use(cors());
 app.use(logger());
 app.use(rateLimit({ max: 100, window: 60 }));
 
+// Validation
+app.use(validate(z.object({ name: z.string() })));
+
 // Routes
 app.get("/", () => ({ 
   message: "Welcome to PrinceJS",
-  version: "1.5.2"
+  version: "3.3.1"
 }));
 
 app.get("/users/:id", (req) => ({
@@ -152,17 +185,26 @@ app.get("/users/:id", (req) => ({
   name: "John Doe"
 }));
 
-// File upload
-app.post("/upload", (req) => ({
+// New: Cache
+app.get("/data", cache(60)(() => ({ time: Date.now() })));
+
+// New: AI
+app.post("/ai", async (req) => ({ reply: await ai(req.body.q) }));
+
+// New: Upload
+app.post("/upload", upload(), (req) => ({
   files: Object.keys(req.files || {}),
   body: req.body
 }));
 
+// New: Cron
+cron("*/1 * * * *", () => console.log("PrinceJS heartbeat"));
+
 // WebSocket
 app.ws("/chat", {
   open: (ws) => ws.send("Welcome!"),
   message: (ws, msg) => ws.send(`Echo: ${msg}`),
-  close: (ws) => console.log("Disconnected")
+  close: () => console.log("Disconnected")
 });
 
 app.listen(3000);
@@ -172,13 +214,13 @@ app.listen(3000);
 
 ## 📚 Documentation
 
-Check: [princejs](https://princejs.vercel.app)
+Visit: **princejs.vercel.app**
 
 ---
 
 ## 🤝 Contributing
 
-Issues and PRs welcome! This is a learning project but we take quality seriously.
+Issues and PRs welcome!
 
 ```bash
 git clone https://github.com/MatthewTheCoder1218/princejs
@@ -191,9 +233,8 @@ bun test
 
 ## 🇳🇬 Built in Nigeria
 
-**Made by @Lil_Prince_1218 — Age 13**
-
-> *"2.8 kB. 19,200 req/s. The fastest framework under 10 kB."*
+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.
 
@@ -201,15 +242,15 @@ Inspired by the greats (Express, Hono, Elysia) but built to win.
 
 ## 📄 License
 
-MIT © 2025 Matthew Michael
+MIT © 2025 **Matthew Michael**
 
 ---
 
 ## ⭐ Star This Repo
 
-If PrinceJS helped you, give it a star! It helps other developers discover it.
+If PrinceJS helped you, star the repo!
 
-**GitHub:** [github.com/MatthewTheCoder1218/princejs](https://github.com/MatthewTheCoder1218/princejs)
+GitHub: [github.com/MatthewTheCoder1218/princejs](https://github.com/MatthewTheCoder1218/princejs)
 
 ---
 
@@ -221,4 +262,4 @@ If PrinceJS helped you, give it a star! It helps other developers discover it.
 
 ---
 
-**PrinceJS: Small in size. Giant in speed. 🚀**
+**PrinceJS: Small in size. Giant in speed. 🚀**

package/dist/helpers.js

@@ -0,0 +1,44 @@
+// @bun
+// src/helpers.ts
+var cache = (ttl) => {
+  const store = {};
+  return (handler) => async (req) => {
+    const key = req.url;
+    const now = Date.now();
+    if (store[key]?.exp > now)
+      return store[key].data;
+    const data = await handler(req);
+    store[key] = { data, exp: now + ttl * 1000 };
+    setTimeout(() => delete store[key], ttl * 1000 + 1000);
+    return data;
+  };
+};
+var email = async (to, subject, html) => {
+  await fetch("https://api.resend.com/emails", {
+    method: "POST",
+    headers: { Authorization: `Bearer ${process.env.RESEND_KEY}` },
+    body: JSON.stringify({ from: "no-reply@princejs.dev", to, subject, html })
+  });
+};
+var ai = async (prompt) => {
+  const res = await fetch("https://api.x.ai/v1/chat/completions", {
+    method: "POST",
+    headers: { Authorization: `Bearer ${process.env.XAI_KEY}` },
+    body: JSON.stringify({ model: "grok-beta", messages: [{ role: "user", content: prompt }] })
+  });
+  const json = await res.json();
+  return json.choices?.[0]?.message?.content || "";
+};
+var upload = () => {
+  return async (req) => {
+    const form = await req.formData();
+    const file = form.get("file");
+    return { name: file.name, size: file.size };
+  };
+};
+export {
+  upload,
+  email,
+  cache,
+  ai
+};

package/dist/middleware.js

@@ -1,159 +1,66 @@
 // @bun
 // src/middleware.ts
-var MIDDLEWARE_EXECUTED = Symbol("middlewareExecuted");
-var cors = (options) => {
-  const origin = options?.origin || "*";
-  const methods = options?.methods || "GET,POST,PUT,DELETE,PATCH,OPTIONS";
-  const headers = options?.headers || "Content-Type,Authorization";
-  const credentials = options?.credentials || false;
+var cors = (origin = "*") => {
   return async (req, next) => {
-    if (req[MIDDLEWARE_EXECUTED]?.cors) {
-      return await next();
-    }
-    if (!req[MIDDLEWARE_EXECUTED]) {
-      req[MIDDLEWARE_EXECUTED] = {};
-    }
-    req[MIDDLEWARE_EXECUTED].cors = true;
     if (req.method === "OPTIONS") {
       return new Response(null, {
         status: 204,
         headers: {
           "Access-Control-Allow-Origin": origin,
-          "Access-Control-Allow-Methods": methods,
-          "Access-Control-Allow-Headers": headers,
-          ...credentials ? { "Access-Control-Allow-Credentials": "true" } : {}
+          "Access-Control-Allow-Methods": "GET,POST,PUT,DELETE,PATCH,OPTIONS",
+          "Access-Control-Allow-Headers": "Content-Type,Authorization"
         }
       });
     }
     const res = await next();
-    if (!res)
-      return res;
-    const newHeaders = new Headers(res.headers);
-    newHeaders.set("Access-Control-Allow-Origin", origin);
-    if (credentials)
-      newHeaders.set("Access-Control-Allow-Credentials", "true");
-    return new Response(res.body, {
-      status: res.status,
-      statusText: res.statusText,
-      headers: newHeaders
-    });
+    res?.headers.set("Access-Control-Allow-Origin", origin);
+    return res;
   };
 };
-var logger = (options) => {
-  const format = options?.format || "dev";
-  const colors = options?.colors !== false;
-  const colorize = (code, text) => {
-    if (!colors)
-      return text;
-    if (code >= 500)
-      return `\x1B[31m${text}\x1B[0m`;
-    if (code >= 400)
-      return `\x1B[33m${text}\x1B[0m`;
-    if (code >= 300)
-      return `\x1B[36m${text}\x1B[0m`;
-    if (code >= 200)
-      return `\x1B[32m${text}\x1B[0m`;
-    return text;
-  };
+var logger = () => {
   return async (req, next) => {
-    if (req[MIDDLEWARE_EXECUTED]?.logger) {
-      return await next();
-    }
-    if (!req[MIDDLEWARE_EXECUTED]) {
-      req[MIDDLEWARE_EXECUTED] = {};
-    }
-    req[MIDDLEWARE_EXECUTED].logger = true;
     const start = Date.now();
-    const pathname = new URL(req.url).pathname;
     const res = await next();
-    if (!res)
-      return res;
-    const duration = Date.now() - start;
-    const status = res.status;
-    if (format === "dev") {
-      console.log(`${colorize(status, req.method)} ${pathname} ${colorize(status, String(status))} ${duration}ms`);
-    } else if (format === "tiny") {
-      console.log(`${req.method} ${pathname} ${status} - ${duration}ms`);
-    } else {
-      const date = new Date().toISOString();
-      console.log(`[${date}] ${req.method} ${pathname} ${status} ${duration}ms`);
-    }
+    console.log(`${req.method} ${new URL(req.url).pathname} ${res?.status} ${Date.now() - start}ms`);
     return res;
   };
 };
-var rateLimit = (options) => {
-  const store = new Map;
-  setInterval(() => {
-    const now = Date.now();
-    for (const [key, record] of store.entries()) {
-      if (now > record.resetAt) {
-        store.delete(key);
-      }
-    }
-  }, options.window * 1000);
+var jwt = (secret) => {
   return async (req, next) => {
-    if (req[MIDDLEWARE_EXECUTED]?.rateLimit) {
-      return await next();
-    }
-    if (!req[MIDDLEWARE_EXECUTED]) {
-      req[MIDDLEWARE_EXECUTED] = {};
-    }
-    req[MIDDLEWARE_EXECUTED].rateLimit = true;
-    const key = options.keyGenerator ? options.keyGenerator(req) : req.headers.get("x-forwarded-for") || req.headers.get("x-real-ip") || "unknown";
-    const now = Date.now();
-    const windowMs = options.window * 1000;
-    let record = store.get(key);
-    if (!record || now > record.resetAt) {
-      record = { count: 1, resetAt: now + windowMs };
-      store.set(key, record);
-      return await next();
+    const auth = req.headers.get("authorization");
+    if (auth?.startsWith("Bearer ")) {
+      try {
+        req.user = JSON.parse(atob(auth.slice(7).split(".")[1]));
+      } catch {}
     }
-    if (record.count >= options.max) {
-      const retryAfter = Math.ceil((record.resetAt - now) / 1000);
-      return new Response(JSON.stringify({
-        error: options.message || "Too many requests",
-        retryAfter
-      }), {
-        status: 429,
-        headers: {
-          "Content-Type": "application/json",
-          "Retry-After": String(retryAfter)
-        }
-      });
-    }
-    record.count++;
-    return await next();
+    return next();
   };
 };
-var serve = (options) => {
-  const root = options.root || "./public";
-  const index = options.index || "index.html";
-  const dotfiles = options.dotfiles || "deny";
+var rateLimit = (max, window = 60) => {
+  const store = {};
+  return async (req, next) => {
+    const ip = req.headers.get("x-forwarded-for") || "unknown";
+    const key = `${ip}:${Math.floor(Date.now() / (window * 1000))}`;
+    store[key] = (store[key] || 0) + 1;
+    if (store[key] > max)
+      return new Response("Too many requests", { status: 429 });
+    return next();
+  };
+};
+var validate = (schema) => {
   return async (req, next) => {
-    const url = new URL(req.url);
-    let filepath = url.pathname;
-    if (filepath.includes("..")) {
-      return new Response("Forbidden", { status: 403 });
-    }
-    if (dotfiles === "deny" && filepath.split("/").some((part) => part.startsWith("."))) {
-      return new Response("Forbidden", { status: 403 });
-    }
     try {
-      const file = Bun.file(`${root}${filepath}`);
-      if (await file.exists()) {
-        return new Response(file);
-      }
-      const indexFile = Bun.file(`${root}${filepath}/${index}`);
-      if (await indexFile.exists()) {
-        return new Response(indexFile);
-      }
-    } catch (err) {}
-    return await next();
+      req.body = schema.parse(req.body);
+    } catch (e) {
+      return new Response(JSON.stringify({ error: "Invalid", details: e.errors }), { status: 400 });
+    }
+    return next();
   };
 };
 export {
-  serve,
+  validate,
   rateLimit,
   logger,
+  jwt,
   cors
 };

package/dist/scheduler.js

@@ -0,0 +1,31 @@
+// @bun
+// src/scheduler.ts
+var cron = (pattern, task) => {
+  const parts = pattern.trim().split(/\s+/);
+  const [minute, hour, day, month, dow] = parts;
+  console.log(`CRON REGISTERED: ${pattern} \u2192 ${task.toString().slice(0, 50)}...`);
+  const check = () => {
+    const now = new Date;
+    const m = now.getMinutes();
+    const h = now.getHours();
+    const matchMinute = minute === "*" ? true : minute.includes("/") ? m % parseInt(minute.split("/")[1]) === 0 : minute.includes(",") ? minute.split(",").map(Number).includes(m) : m === parseInt(minute);
+    const matchHour = hour === "*" ? true : hour.includes("/") ? h % parseInt(hour.split("/")[1]) === 0 : h === parseInt(hour);
+    if (matchMinute && matchHour) {
+      console.log(`CRON TRIGGERED: ${pattern} @ ${now.toLocaleTimeString()}`);
+      try {
+        task();
+      } catch (e) {
+        console.error("CRON ERROR:", e);
+      }
+    }
+  };
+  check();
+  setInterval(check, 60000);
+};
+var openapi = (info) => {
+  return { openapi: "3.0.0", info, paths: {} };
+};
+export {
+  openapi,
+  cron
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "princejs",
-  "version": "1.5.4",
+  "version": "1.6.0",
   "description": "An easy and fast backend framework — by a 13yo developer, for developers.",
   "main": "dist/prince.js",
   "types": "dist/prince.d.ts",
@@ -17,9 +17,13 @@
       "import": "./dist/middleware.js",
       "types": "./dist/middleware.d.ts"
     },
-    "./validation": {
-      "import": "./dist/validation.js",
-      "types": "./dist/validation.d.ts"
+    "./helpers": {
+      "import": "./dist/helpers.js",
+      "types": "./dist/helpers.d.ts"
+    },
+    "./scheduler": {
+      "import": "./dist/scheduler.js",
+      "types": "./dist/scheduler.d.ts"
     }
   },
   "files": [
@@ -38,7 +42,9 @@
     "server",
     "typescript",
     "websocket",
-    "middleware"
+    "middleware",
+    "scheduler",
+    "fast"
   ],
   "author": "Matthew Michael (MatthewTheCoder1218)",
   "license": "MIT",
@@ -56,10 +62,12 @@
   "devDependencies": {
     "@types/bun": "^1.3.2",
     "bun-types": "latest",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "fast-jwt": "^5.0.0",
+    "zod": "^4.1.12"
   },
   "peerDependencies": {
-    "zod": "^4.0.0"
+    "zod": "^4.1.12"
   },
   "peerDependenciesMeta": {
     "zod": {
@@ -67,6 +75,6 @@
     }
   },
   "scripts": {
-    "build": "bun build src/prince.ts --outdir dist --target bun && bun build src/middleware.ts --outdir dist --target bun && bun build src/validation.ts --outdir dist --target bun && bun build bin/create.ts --outdir dist --target bun --format esm"
+    "build": "bun build src/prince.ts --outdir dist --target bun && bun build src/middleware.ts --outdir dist --target bun && bun build src/helpers.ts --outdir dist --target bun && bun build bin/create.ts --outdir dist --target bun --format esm && bun build src/scheduler.ts --outdir dist --target bun && bun build src/helpers --outdir dist --target bun"
   }
 }