princejs 1.9.6 → 2.0.0

package/README.md

@@ -1,7 +1,5 @@
 <div align="center">
 
-<img src="./src/images/og.png" alt="PrinceJS"/>
-
 # 👑 PrinceJS
 
 **Ultra-clean, modern & minimal Bun web framework.**  
@@ -36,9 +34,9 @@ Benchmarked with `oha -c 100 -z 30s` on Windows 10:
 ## 🚀 Quick Start
 
 ```bash
-bun create princejs my-app
-cd my-app
-bun dev
+npm install princejs
+bun add princejs
+yarn add princejs
 ```
 
 ```ts
@@ -77,7 +75,8 @@ app.listen(3000);
 | SQLite Database | `princejs/db` |
 | Plugin System | `princejs` |
 | End-to-End Type Safety | `princejs/client` |
-| Deploy Adapters | `princejs/vercel` · `princejs/cloudflare` · `princejs/deno` |
+| Deploy Adapters | `princejs/vercel` · `princejs/cloudflare` · `princejs/deno` · `princejs/node` |
+| Lifecycle Hooks | `princejs` | 
 
 ---
 
@@ -160,6 +159,57 @@ app.plugin(usersPlugin, { prefix: "/api" });
 
 ---
 
+## 🎣 Lifecycle Hooks
+
+React to key moments in request processing with lifecycle hooks:
+
+```ts
+import { prince } from "princejs";
+
+const app = prince();
+
+// Called for every incoming request
+app.onRequest((req) => {
+  console.log(`📥 Request received: ${req.method} ${req.url}`);
+});
+
+// Called before handler execution
+app.onBeforeHandle((req, path, method) => {
+  console.log(`🔍 About to handle: ${method} ${path}`);
+  (req as any).startTime = Date.now();
+});
+
+// Called after successful handler execution
+app.onAfterHandle((req, res, path, method) => {
+  const duration = Date.now() - (req as any).startTime;
+  console.log(`✅ Response: ${method} ${path} ${res.status} (${duration}ms)`);
+});
+
+// Called when handler throws an error
+app.onError((err, req, path, method) => {
+  console.error(`❌ Error in ${method} ${path}:`, err.message);
+  // Send alert, log to monitoring service, etc.
+});
+
+app.get("/users", () => ({ users: [] }));
+```
+
+**Hook execution order:**
+1. `onRequest` — early for request-wide setup
+2. `onBeforeHandle` — just before route handler runs
+3. Handler executes
+4. `onAfterHandle` — after success (on error, skipped)
+5. `onError` — only if handler throws (skips onAfterHandle)
+
+**Use cases:**
+- 📊 Metrics & observability
+- 🔍 Request inspection & debugging
+- ⏱️ Timing & performance monitoring
+- 🚨 Error tracking & alerting  
+- 🔐 Security audits & compliance logging
+
+---
+
 ## 🔒 End-to-End Type Safety
 
 Define a contract once — your client gets full TypeScript autocompletion automatically:
@@ -206,6 +256,25 @@ import { toDeno } from "princejs/deno";
 Deno.serve(toDeno(app));
 ```
 
+**Node Adapter** - `server.ts`
+```ts
+import { createServer } from "http";
+import { toNode, toExpress } from "princejs/node";
+
+const app = prince();
+app.get("/", () => ({ message: "Hello from Node!" }));
+
+// Native Node.js http
+const server = createServer(toNode(app));
+server.listen(3000);
+
+// Or with Express
+import express from "express";
+const expressApp = express();
+expressApp.all("*", toExpress(app));
+expressApp.listen(3000);
+```
+
 ---
 
 ## 🎯 Full Example
@@ -222,7 +291,29 @@ import { z } from "zod";
 
 const app = prince(true);
 
-// Global middleware
+// ==========================================
+// LIFECYCLE HOOKS - Timing & Observability
+// ==========================================
+app.onRequest((req) => {
+  (req as any).startTime = Date.now();
+});
+
+app.onBeforeHandle((req, path, method) => {
+  console.log(`🔍 Handling: ${method} ${path}`);
+});
+
+app.onAfterHandle((req, res, path, method) => {
+  const duration = Date.now() - (req as any).startTime;
+  console.log(`✅ ${method} ${path} → ${res.status} (${duration}ms)`);
+});
+
+app.onError((err, req, path, method) => {
+  console.error(`❌ ${method} ${path} failed:`, err.message);
+});
+
+// ==========================================
+// GLOBAL MIDDLEWARE
+// ==========================================
 app.use(cors());
 app.use(logger());
 app.use(rateLimit({ max: 100, window: 60 }));
@@ -231,6 +322,10 @@ app.use(jwt(key));
 app.use(session({ secret: "key" }));
 app.use(compress());
 
+// ==========================================
+// ROUTES
+// ==========================================
+
 // JSX
 const Page = () => Html(Head("Test Page"), Body(H1("Hello World"), P("This is a test")));
 app.get("/jsx", () => render(Page()));
@@ -247,7 +342,7 @@ app.ws("/chat", {
 
 // Auth
 app.get("/protected", auth(), (req) => ({ user: req.user }));
-app.get("/api", apiKey({ keys: ["key_123"] }), handler);
+app.get("/api", apiKey({ keys: ["key_123"] }), (req) => ({ ok: true }));
 
 // Helpers
 app.get("/data", cache(60)(() => ({ time: Date.now() })));
@@ -256,10 +351,14 @@ app.get("/events", sse(), (req) => {
   setInterval(() => req.sseSend({ time: Date.now() }), 1000);
 });
 
-// Cron
+// ==========================================
+// CRON JOBS
+// ==========================================
 cron("*/1 * * * *", () => console.log("PrinceJS heartbeat"));
 
-// OpenAPI + Scalar docs
+// ==========================================
+// OPENAPI + SCALAR DOCS
+// ==========================================
 const api = app.openapi({ title: "PrinceJS App", version: "1.0.0" }, "/docs");
 api.route("GET", "/items", {
   summary: "List items",

package/dist/adapters/node.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Official Node.js deploy adapter for PrinceJS
+ *
+ * @example
+ * // server.ts
+ * import { createServer } from "http";
+ * import { prince } from "princejs";
+ * import { toNode } from "princejs/node";
+ *
+ * const app = prince();
+ * app.get("/", () => ({ message: "Hello from Node.js!" }));
+ *
+ * const server = createServer(toNode(app));
+ * server.listen(3000, () => {
+ *   console.log("Listening on http://localhost:3000");
+ * });
+ *
+ * @example
+ * // With Express.js
+ * import express from "express";
+ * import { prince } from "princejs";
+ * import { toExpress } from "princejs/node";
+ *
+ * const app = express();
+ * const princeApp = prince();
+ * princeApp.get("/", () => ({ message: "Hello!" }));
+ *
+ * app.all("*", toExpress(princeApp));
+ * app.listen(3000);
+ */
+export type PrinceApp = {
+    fetch(request: Request): Promise<Response>;
+};
+/**
+ * Converts a Prince app to a Node.js http.createServer() handler
+ * @example
+ * const server = createServer(toNode(app));
+ * server.listen(3000);
+ */
+export declare function toNode(app: PrinceApp): (req: any, res: any) => Promise<void>;
+/**
+ * Converts a Prince app to an Express.js middleware handler
+ * @example
+ * app.all("*", toExpress(princeApp));
+ */
+export declare function toExpress(app: PrinceApp): (req: any, res: any, next?: any) => Promise<void>;
+//# sourceMappingURL=node.d.ts.map

package/dist/adapters/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/adapters/node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,MAAM,MAAM,SAAS,GAAG;IAAE,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;CAAE,CAAC;AAEvE;;;;;GAKG;AACH,wBAAgB,MAAM,CACpB,GAAG,EAAE,SAAS,GACb,CACD,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,GAAG,KACL,OAAO,CAAC,IAAI,CAAC,CAuCjB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,SAAS,GACb,CACD,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,GAAG,EACR,IAAI,CAAC,EAAE,GAAG,KACP,OAAO,CAAC,IAAI,CAAC,CAoCjB"}

package/dist/prince.d.ts

@@ -14,6 +14,10 @@ export interface PrinceRequest extends Request {
     sseSend?: (data: any, event?: string, id?: string) => void;
     [key: string]: any;
 }
+export type OnRequest = (req: PrinceRequest) => void | Promise<void>;
+export type OnBeforeHandle = (req: PrinceRequest, path: string, method: string) => void | Promise<void>;
+export type OnAfterHandle = (req: PrinceRequest, res: Response, path: string, method: string) => void | Promise<void>;
+export type OnError = (err: any, req: PrinceRequest, path: string, method: string) => void | Promise<void>;
 interface WebSocketHandler {
     open?: (ws: any) => void;
     message?: (ws: any, msg: string | Buffer) => void;
@@ -62,6 +66,10 @@ export declare class Prince {
     private staticRoutes;
     private staticMiddlewares;
     private routeCache;
+    private onRequestHooks;
+    private onBeforeHandleHooks;
+    private onAfterHandleHooks;
+    private onErrorHooks;
     constructor(devMode?: boolean);
     use(mw: Middleware): this;
     /**
@@ -77,6 +85,10 @@ export declare class Prince {
      */
     plugin<TOptions = any>(plugin: PrincePlugin<TOptions>, options?: TOptions): this;
     error(fn: (err: any, req: PrinceRequest) => Response): this;
+    onRequest(hook: OnRequest): this;
+    onBeforeHandle(hook: OnBeforeHandle): this;
+    onAfterHandle(hook: OnAfterHandle): this;
+    onError(hook: OnError): this;
     json(data: any, status?: number): Response;
     response(): ResponseBuilder;
     get(path: string, ...args: (RouteHandler | Middleware)[]): this;

package/dist/prince.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prince.d.ts","sourceRoot":"","sources":["../src/prince.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"prince.d.ts","sourceRoot":"","sources":["../src/prince.ts"],"names":[],"mappings":"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"}

package/dist/prince.js

@@ -310,6 +310,10 @@ class Prince {
   staticRoutes = new Map;
   staticMiddlewares = new Map;
   routeCache = new Map;
+  onRequestHooks = [];
+  onBeforeHandleHooks = [];
+  onAfterHandleHooks = [];
+  onErrorHooks = [];
   constructor(devMode = false) {
     this.devMode = devMode;
   }
@@ -325,6 +329,22 @@ class Prince {
     this.errorHandler = fn;
     return this;
   }
+  onRequest(hook) {
+    this.onRequestHooks.push(hook);
+    return this;
+  }
+  onBeforeHandle(hook) {
+    this.onBeforeHandleHooks.push(hook);
+    return this;
+  }
+  onAfterHandle(hook) {
+    this.onAfterHandleHooks.push(hook);
+    return this;
+  }
+  onError(hook) {
+    this.onErrorHooks.push(hook);
+    return this;
+  }
   json(data, status = 200) {
     return new Response(JSON.stringify(data), {
       status,
@@ -572,7 +592,7 @@ class Prince {
     }
     return null;
   }
-  async executeHandler(req, handler, params, query, routeMiddlewares) {
+  async executeHandler(req, handler, params, query, routeMiddlewares, method, pathname) {
     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) && !req.parsedBody) {
@@ -593,6 +613,9 @@ class Prince {
       },
       configurable: true
     });
+    for (const hook of this.onBeforeHandleHooks) {
+      await hook(req, pathname, method);
+    }
     const allMiddlewares = routeMiddlewares.length > 0 ? [...this.middlewares, ...routeMiddlewares] : this.middlewares;
     let i = 0;
     const next = async () => {
@@ -610,13 +633,20 @@ class Prince {
         return new Response(res);
       return this.json(res);
     };
-    return next();
+    const response = await next();
+    for (const hook of this.onAfterHandleHooks) {
+      await hook(req, response.clone(), pathname, method);
+    }
+    return response;
   }
   async handleFetch(req) {
     const url = new URL(req.url);
     const r = req;
     const method = req.method;
     const pathname = url.pathname;
+    for (const hook of this.onRequestHooks) {
+      await hook(r);
+    }
     const routeMatch = this.findRoute(method, pathname);
     if (!routeMatch) {
       return this.json({ error: "Not Found" }, 404);
@@ -630,12 +660,18 @@ class Prince {
         }
       });
     }
-    return this.executeHandler(r, routeMatch.handler, routeMatch.params, url.searchParams, routeMatch.middlewares);
+    return this.executeHandler(r, routeMatch.handler, routeMatch.params, url.searchParams, routeMatch.middlewares, method, pathname);
   }
   async fetch(req) {
+    const url = new URL(req.url);
+    const pathname = url.pathname;
+    const method = req.method;
     try {
       return await this.handleFetch(req);
     } catch (err) {
+      for (const hook of this.onErrorHooks) {
+        await hook(err, req, pathname, method);
+      }
       if (this.errorHandler)
         return this.errorHandler(err, req);
       if (this.devMode) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "princejs",
-  "version": "1.9.6",
+  "version": "2.0.0",
   "description": "An easy and fast backend framework that is among the top three — by a 13yo developer, for developers.",
   "main": "dist/prince.js",
   "types": "dist/prince.d.ts",
@@ -45,6 +45,10 @@
       "import": "./dist/adapters/deno.js",
       "types": "./dist/adapters/deno.d.ts"
     },
+    "./node": {
+      "import": "./dist/adapters/node.js",
+      "types": "./dist/adapters/node.d.ts"
+    },
     "./client": {
       "import": "./dist/client.js",
       "types": "./dist/client.d.ts"