dolphin-server-modules 1.0.3 → 1.0.5

package/README.md

@@ -1,140 +1,130 @@
-# Dolphin Server Modules 🐬
+# Dolphin Framework 🐬
 
-A world-class, extremely lightweight, and 100% modular backend utility package for Node.js. It provides plug-and-play modules for Authentication, standard CRUD operations, Next.js/Express Controllers, and Zod validation. 
+**Dolphin** is a world-class, ultra-lightweight, and 100% modular backend framework built on native Node.js. It is designed for extreme performance, minimal boilerplate, and a developer-first experience.
 
-Build production-grade APIs in minutes!
+> "Close to native Node.js speed, with the developer experience of a premium framework."
 
-## 📦 Installation
-
-```bash
-npm install dolphin-server-modules
-```
+---
 
-You will also need to install `argon2` and `zod` if you are using the auth and validation modules respectively:
-```bash
-npm install argon2 zod
-```
+## 🚀 Core Philosophy
+- **Zero-Dependency Core**: Built on the native Node.js `http` module. No Express, no Fastify overhead.
+- **Extreme Modularity**: Use only what you need. Auth, CRUD, and Routing are all independent.
+- **Performance First**: Optimized matching engines and minimal object allocation.
+- **Type-Safe by Design**: First-class TypeScript support across all modules.
 
-## 🚀 100% Modular Structure
-You can import exactly what you need without bloating your project.
+---
 
-```typescript
-import { createAuth } from 'dolphin-server-modules/auth';
-import { createCRUD } from 'dolphin-server-modules/crud';
-import { createDolphinController } from 'dolphin-server-modules/controller';
-import { validateStructure } from 'dolphin-server-modules/middleware/zod';
+## 📦 Installation
+```bash
+npm install dolphin-server-modules
 ```
 
 ---
 
-## 🔒 1. Auth Module (`/auth`)
-Production-ready authentication supporting **argon2 password hashing**, **JWT**, and **TOTP (2FA)**. It also ships with internal memory LRU caches for protecting against token-reuse and rate-limiting.
+## 🚀 Quick Start (Complete Tutorial)
 
-```typescript
-import { createAuth } from 'dolphin-server-modules/auth';
+Building a high-performance API with Dolphin is simple. Here is a full example:
 
-const auth = createAuth({ 
-  secret: 'YOUR_SUPER_SECRET_KEY', 
-  cookieMaxAge: 7 * 86400000 // 7 days
-});
+### 1. Define your Database (Mongoose)
+```typescript
+import mongoose from 'mongoose';
+import { createMongooseAdapter } from 'dolphin-server-modules/adapters/mongoose';
 
-// Register
-const user = await auth.register(db, { email: 'user@example.com', password: 'password123' });
+const User = mongoose.model('User', new mongoose.Schema({
+  email: { type: String, required: true },
+  password: { type: String, required: true }
+}));
 
-// Login (Supports 2FA Totp)
-const session = await auth.login(db, { email: 'user@example.com', password: 'password123' });
-console.log(session.accessToken);
+const db = createMongooseAdapter({ User });
 ```
 
----
-
-## 💾 2. CRUD Module (`/crud`)
-A powerful Factory interface for databases providing instant pagination, soft-deletes, and ownership-checks out of the box.
-
+### 2. Initialize and Secure your Server
 ```typescript
-import { createCRUD } from 'dolphin-server-modules/crud';
+import { createDolphinServer } from 'dolphin-server-modules/server';
+import { createAuth } from 'dolphin-server-modules/auth';
 
-const crud = createCRUD(myDatabaseAdapter, { 
-    softDelete: true, 
-    enforceOwnership: true 
+const app = createDolphinServer();
+const auth = createAuth({ secret: 'SUPER_SECRET' });
+
+// Global Middleware
+app.use((ctx, next) => {
+  console.log(`🐬 ${ctx.req.method} ${ctx.req.url}`);
+  next();
 });
 
-// Automatically creates a record with generated IDs and createdAt fields
-const newPost = await crud.create('posts', { title: 'Hello World' }, 'user_id_1');
+// Hello World
+app.get('/', (ctx) => ctx.json({ message: "Welcome to Dolphin!" }));
 
-// Read with Advanced Filtering
-const posts = await crud.read('posts', { 
-    $or: [{ title: { $like: 'Hello' } }, { rating: { $gt: 4 } }] 
+// Secure Route
+app.get('/profile', auth.middleware(), (ctx) => {
+  ctx.json({ user: ctx.req.user });
 });
 
-// Soft Delete
-await crud.deleteOne('posts', newPost.id, 'user_id_1');
+// Dynamic Params
+app.get('/users/:id', (ctx) => ctx.json({ id: ctx.params.id }));
 
-// Restore Soft Deleted
-await crud.restore('posts', newPost.id, 'user_id_1');
+app.listen(3000, () => console.log("Dolphin swimming on port 3000!"));
 ```
 
 ---
 
-## 🎮 3. Controller Module (`/controller`)
-Easily convert your `crud` instance into instant API Controllers. Supports Next.js App Router, Pages API, and Express out of the box.
+## 🛠️ Key Features
 
+### ⚡ 1. Native High-Performance Server (`/server`)
+A thin wrapper around native `http` with a modern `Context` (ctx) based API.
 ```typescript
-import { createDolphinController, createNextAppRoute } from 'dolphin-server-modules/controller';
-
-const postController = createDolphinController(crud, 'posts');
+import { createDolphinServer } from 'dolphin-server-modules/server';
 
-// Next.js App Router API Route (app/api/posts/route.ts)
-export const { GET, POST, PUT, DELETE } = createNextAppRoute(postController);
-```
+const app = createDolphinServer();
 
----
+app.get('/ping', (ctx) => ctx.json({ message: 'pong' }));
 
-## 🍃 4. Mongoose Adapter (`/adapters/mongoose`)
-An official, fully typed Mongoose adapter for seamless integration with the Auth and CRUD modules. It handles mapping `id` to `_id`, query mapping (`$like` to `$regex`), and works independently!
+app.listen(3000);
+```
 
+### 🛣️ 2. Intelligent Routing (`/router`)
+Uses a hybrid Radix Tree + Static Map approach for $O(1)$ and $O(L)$ matching. Supports dynamic path parameters out of the box.
 ```typescript
-import { createMongooseAdapter } from 'dolphin-server-modules/adapters/mongoose';
-import { User, RefreshToken, Post } from './my-mongoose-models';
-
-const dbAdapter = createMongooseAdapter({
-  User,
-  RefreshToken,
-  models: {
-    posts: Post // Maps the 'posts' collection to the generic Post model
-  }
+app.get('/users/:id', (ctx) => {
+  return ctx.json({ userId: ctx.params.id });
 });
-
-// Now pass dbAdapter to createAuth or createCRUD initializers!
 ```
 
----
+### 🔒 3. Advanced Auth Module (`/auth`)
+Production-ready security with zero external bloat:
+- Argon2 Hashing & JWT (Timing-safe)
+- Refresh Token Rotation & Reuse Detection
+- 2FA (TOTP) + Recovery Code Management
 
-## ✅ 5. Zod Validation Middleware (`/middleware/zod`)
-Validate your data effortlessly using `zod`. Protect your endpoints from bad data.
+### 💾 4. Adapter-Based CRUD & Database (`/crud`)
+Seamlessly switch between databases with the Adapter pattern.
+- **Mongoose Adapter**: Included by default.
+- **Automated CRUD**: Just define a schema and get a full API.
 
-```typescript
-import { z } from 'zod';
-import { validateAppRoute } from 'dolphin-server-modules/middleware/zod';
+### ✅ 5. Zod-Powered Validation (`/middleware/zod`)
+Validate payloads and params with 100% type inference.
 
-const userSchema = z.object({
-  name: z.string().min(2),
-  age: z.number().gte(18)
-});
+---
 
-// App Router Handler wrapped with validation
-const myPostHandler = validateAppRoute(userSchema, async (req, validatedData) => {
-    console.log(validatedData.name); // 100% typed and safe
-    return new Response('Success');
-});
-```
+## 🗺️ Roadmap & Future Vision
+1. **`defineModel` Engine**: Define a schema once, auto-generate CRUD, validation, and types.
+2. **Plugin System**: A robust "hook" based system for extending the framework core.
+3. **IoT & WebSocket Support**: Dedicated ingestion layer for high-throughput data.
+4. **CLI Presets**: `npx dolphin init` for instant project scaffolding.
 
 ---
 
-## 🌐 Hosting Docs via GitHub Pages
-To host this documentation cleanly:
-1. Go to your repository **Settings** on GitHub.
-2. Click on **Pages** on the left sidebar.
-3. Under **Build and deployment**, select **Deploy from a branch**.
-4. Select `main` branch and `/ (root)` folder.
-5. Click **Save**. GitHub will automatically host this README as your documentation website!
+## 📊 Performance Comparison
+| Metric | Express | Fastify | **Dolphin** |
+| :--- | :--- | :--- | :--- |
+| **Overhead** | High | Low | **Ultra-Low (Native)** |
+| **Modularity** | Low | Medium | **Extreme** |
+| **DX** | Good | Excellent | **Premium** |
+
+---
+
+## 🌐 Documentation
+Detailed documentation is automatically hosted via GitHub Pages from this README.
+
+## 📄 License
+ISC © 2026 Dolphin Team

package/TUTORIAL.md

@@ -0,0 +1,116 @@
+# Dolphin Framework Tutorial 🐬
+
+Welcome to the official tutorial for the **Dolphin Framework**. This guide will take you from zero to a production-ready API using our native, high-performance modules.
+
+---
+
+## 1. Project Setup
+Create a new directory and initialize your project:
+```bash
+mkdir my-dolphin-app && cd my-dolphin-app
+npm init -y
+npm install dolphin-server-modules mongoose zod
+```
+
+---
+
+## 2. Database Setup (Mongoose)
+Define your models using Mongoose:
+```typescript
+// models.ts
+import mongoose from 'mongoose';
+
+const UserSchema = new mongoose.Schema({
+  email: { type: String, required: true, unique: true },
+  password: { type: String, required: true }
+});
+
+export const User = mongoose.model('User', UserSchema);
+```
+
+---
+
+## 3. Initialize Dolphin
+Create your main entry point and connect the components:
+```typescript
+// index.ts
+import { createDolphinServer } from 'dolphin-server-modules/server';
+import { createMongooseAdapter } from 'dolphin-server-modules/adapters/mongoose';
+import { createAuth } from 'dolphin-server-modules/auth';
+import { User } from './models';
+
+// 1. Setup Adapter
+const db = createMongooseAdapter({ User });
+
+// 2. Setup Auth
+const auth = createAuth({ secret: 'SUPER_SECRET' });
+
+// 3. Setup Server
+const app = createDolphinServer();
+```
+
+---
+
+## 4. Routing with Context (ctx)
+Dolphin uses a unified `ctx` object for ultra-clean handlers.
+
+```typescript
+// Simple Route
+app.get('/', (ctx) => {
+  ctx.json({ message: "Welcome to Dolphin!" });
+});
+
+// Dynamic Route with Params
+app.get('/users/:id', (ctx) => {
+  const { id } = ctx.params;
+  ctx.json({ userId: id });
+});
+
+// Post Request with Body
+app.post('/echo', (ctx) => {
+  ctx.json({ youSent: ctx.body });
+});
+```
+
+---
+
+## 5. Adding Authentication Middleware
+Secure your routes with the `auth` module:
+
+```typescript
+// Protecting a route
+app.get('/profile', auth.middleware(), (ctx) => {
+  // ctx.req.user is automatically populated
+  ctx.json({ user: ctx.req.user });
+});
+```
+
+---
+
+## 6. Global Middleware
+Add logging or custom logic to every request:
+
+```typescript
+app.use((ctx, next) => {
+  console.log(`${ctx.req.method} ${ctx.req.url}`);
+  next();
+});
+```
+
+---
+
+## 7. Starting the Server
+```typescript
+app.listen(3000, () => {
+  console.log("Dolphin is swimming on http://localhost:3000 🐬");
+});
+```
+
+---
+
+## 🚀 Performance Tips
+- Use **Context (ctx)** directly for JSON responses.
+- Keep your routes organized using prefixing (coming in v1.1.0).
+- Use the **Zod Middleware** for automatic type-safe validation.
+
+Happy Coding!

package/dist/router/router.d.ts

@@ -1,4 +1,4 @@
-type Handler = (req: any, res: any) => Promise<void> | void;
+type Handler = (ctx: any) => Promise<void> | void;
 export declare function createDolphinRouter(): {
     get: (path: string, handler: Handler) => void;
     post: (path: string, handler: Handler) => void;

package/dist/server/server.d.ts

@@ -6,13 +6,13 @@ export declare function createDolphinServer(options?: {
     use: (mw: any) => number;
     listen: (port?: number, callback?: () => void) => void;
     close: () => http.Server<typeof http.IncomingMessage, typeof http.ServerResponse>;
-    get: (path: string, handler: (req: any, res: any) => Promise<void> | void) => void;
-    post: (path: string, handler: (req: any, res: any) => Promise<void> | void) => void;
-    put: (path: string, handler: (req: any, res: any) => Promise<void> | void) => void;
-    delete: (path: string, handler: (req: any, res: any) => Promise<void> | void) => void;
-    patch: (path: string, handler: (req: any, res: any) => Promise<void> | void) => void;
+    get: (path: string, handler: (ctx: any) => Promise<void> | void) => void;
+    post: (path: string, handler: (ctx: any) => Promise<void> | void) => void;
+    put: (path: string, handler: (ctx: any) => Promise<void> | void) => void;
+    delete: (path: string, handler: (ctx: any) => Promise<void> | void) => void;
+    patch: (path: string, handler: (ctx: any) => Promise<void> | void) => void;
     match(method: string, url: string): {
-        handler: (req: any, res: any) => Promise<void> | void;
+        handler: (ctx: any) => Promise<void> | void;
         params: Record<string, string>;
     } | null;
 };

package/dist/server/server.js

@@ -15,12 +15,26 @@ function createDolphinServer(options = {}) {
             res.writeHead(status, { 'Content-Type': 'application/json' });
             res.end(JSON.stringify(data));
         };
+        const host = req.headers.host || 'localhost';
+        const parsedUrl = new URL(req.url, `http://${host}`);
+        const ctx = {
+            req,
+            res,
+            params: {},
+            query: Object.fromEntries(parsedUrl.searchParams),
+            body: {},
+            state: {},
+            json: res.json,
+            status: (code) => {
+                res.statusCode = code;
+                return ctx;
+            }
+        };
         // Global middleware execution
         for (const mw of middlewares) {
-            const next = new Promise(resolve => mw(req, res, resolve));
-            await next;
             if (res.writableEnded)
                 return;
+            await new Promise(resolve => mw(ctx, resolve));
         }
         // Body parsing for POST/PUT/PATCH
         if (['POST', 'PUT', 'PATCH'].includes(req.method) && req.headers['content-type']?.includes('application/json')) {
@@ -28,25 +42,26 @@ function createDolphinServer(options = {}) {
             for await (const chunk of req)
                 chunks.push(chunk);
             try {
-                req.body = JSON.parse(Buffer.concat(chunks).toString());
+                ctx.body = JSON.parse(Buffer.concat(chunks).toString());
             }
             catch {
-                req.body = {};
+                ctx.body = {};
             }
         }
         // Matching route
-        const match = router.match(req.method, req.url);
+        const match = router.match(req.method, parsedUrl.pathname);
         if (match) {
-            req.params = match.params;
+            ctx.params = match.params;
             try {
-                await match.handler(req, res);
+                await match.handler(ctx);
             }
             catch (err) {
-                res.json({ error: err.message || 'Internal Server Error' }, err.status || 500);
+                console.error('Server Handler Error:', err);
+                ctx.json({ error: err.message || 'Internal Server Error' }, err.status || 500);
             }
         }
         else {
-            res.json({ error: 'Not Found' }, 404);
+            ctx.json({ error: 'Not Found' }, 404);
         }
     });
     return {

package/dist/server/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../server/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../server/server.ts"],"names":[],"mappings":";;;;;AAGA,kDAoEC;AAvED,0DAA6B;AAC7B,6CAAuD;AAEvD,SAAgB,mBAAmB,CAAC,UAA4C,EAAE;IAChF,MAAM,MAAM,GAAG,IAAA,4BAAmB,GAAE,CAAC;IACrC,MAAM,WAAW,GAAU,EAAE,CAAC;IAE9B,MAAM,MAAM,GAAG,mBAAI,CAAC,YAAY,CAAC,KAAK,EAAE,GAAQ,EAAE,GAAQ,EAAE,EAAE;QAC5D,6BAA6B;QAC7B,GAAG,CAAC,IAAI,GAAG,CAAC,IAAS,EAAE,MAAM,GAAG,GAAG,EAAE,EAAE;YACrC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAC9D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAChC,CAAC,CAAC;QAEF,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC;QAC7C,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAI,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC;QAEtD,MAAM,GAAG,GAAQ;YACf,GAAG;YACH,GAAG;YACH,MAAM,EAAE,EAAE;YACV,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,YAAY,CAAC;YACjD,IAAI,EAAE,EAAE;YACR,KAAK,EAAE,EAAE;YACT,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;gBACvB,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC;gBACtB,OAAO,GAAG,CAAC;YACb,CAAC;SACF,CAAC;QAEF,8BAA8B;QAC9B,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;YAC7B,IAAI,GAAG,CAAC,aAAa;gBAAE,OAAO;YAC9B,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;QACjD,CAAC;QAED,kCAAkC;QAClC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAO,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAChH,MAAM,MAAM,GAAU,EAAE,CAAC;YACzB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG;gBAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClD,IAAI,CAAC;gBACH,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC1D,CAAC;YAAC,MAAM,CAAC;gBACP,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;YAChB,CAAC;QACH,CAAC;QAED,iBAAiB;QACjB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,MAAO,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC5D,IAAI,KAAK,EAAE,CAAC;YACV,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YAC1B,IAAI,CAAC;gBACH,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC3B,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAClB,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;gBAC5C,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,IAAI,uBAAuB,EAAE,EAAE,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,GAAG,CAAC,CAAC;QACxC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,MAAM,EAAE,yCAAyC;QACpD,GAAG,EAAE,CAAC,EAAO,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,EAAE,CAAC,OAAe,OAAO,CAAC,IAAI,IAAI,IAAI,EAAE,QAAqB,EAAE,EAAE;YACrE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC3D,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE;KAC5B,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dolphin-server-modules",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Core utility modules for Auth, CRUD, and Controllers",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/router/router.ts

@@ -1,4 +1,4 @@
-type Handler = (req: any, res: any) => Promise<void> | void;
+type Handler = (ctx: any) => Promise<void> | void;
 
 interface Route {
   method: string;

package/scripts/benchmark.js

@@ -0,0 +1,12 @@
+const { createDolphinServer } = require('../dist/server/server');
+
+const app = createDolphinServer();
+
+app.get('/health', (ctx) => {
+  ctx.json({ status: 'ok' });
+});
+
+const PORT = 5008;
+app.listen(PORT, () => {
+  console.log(`Benchmark server running on port ${PORT}`);
+});

package/scripts/benchmark.ts

@@ -0,0 +1,12 @@
+import { createDolphinServer } from '../server/server';
+
+const app = createDolphinServer();
+
+app.get('/health', (ctx: any) => {
+  ctx.json({ status: 'ok' });
+});
+
+const PORT = 5002;
+app.listen(PORT, () => {
+  console.log(`Benchmark server running on port ${PORT}`);
+});

package/scripts/test-dolphin.js

@@ -0,0 +1,27 @@
+const { createDolphinServer } = require('../dist/server/server');
+const http = require('node:http');
+
+const app = createDolphinServer();
+
+app.get('/test', (ctx) => {
+  ctx.json({ success: true });
+});
+
+const PORT = 5005;
+app.listen(PORT, () => {
+  console.log(`Test server running on port ${PORT}`);
+  
+  // Make a request immediately
+  http.get(`http://127.0.0.1:${PORT}/test`, (res) => {
+    let data = '';
+    res.on('data', chunk => data += chunk);
+    res.on('end', () => {
+      console.log('STATUS:', res.statusCode);
+      console.log('BODY:', data);
+      process.exit(0);
+    });
+  }).on('error', (err) => {
+    console.error('Request Error:', err.message);
+    process.exit(1);
+  });
+});

package/server/server.ts

@@ -12,11 +12,27 @@ export function createDolphinServer(options: { port?: number; host?: string } =
       res.end(JSON.stringify(data));
     };
 
+    const host = req.headers.host || 'localhost';
+    const parsedUrl = new URL(req.url!, `http://${host}`);
+
+    const ctx: any = {
+      req,
+      res,
+      params: {},
+      query: Object.fromEntries(parsedUrl.searchParams),
+      body: {},
+      state: {},
+      json: res.json,
+      status: (code: number) => {
+        res.statusCode = code;
+        return ctx;
+      }
+    };
+
     // Global middleware execution
     for (const mw of middlewares) {
-      const next = new Promise(resolve => mw(req, res, resolve));
-      await next;
       if (res.writableEnded) return;
+      await new Promise(resolve => mw(ctx, resolve));
     }
 
     // Body parsing for POST/PUT/PATCH
@@ -24,23 +40,24 @@ export function createDolphinServer(options: { port?: number; host?: string } =
       const chunks: any[] = [];
       for await (const chunk of req) chunks.push(chunk);
       try {
-        req.body = JSON.parse(Buffer.concat(chunks).toString());
+        ctx.body = JSON.parse(Buffer.concat(chunks).toString());
       } catch {
-        req.body = {};
+        ctx.body = {};
       }
     }
 
     // Matching route
-    const match = router.match(req.method!, req.url!);
+    const match = router.match(req.method!, parsedUrl.pathname);
     if (match) {
-      req.params = match.params;
+      ctx.params = match.params;
       try {
-        await match.handler(req, res);
+        await match.handler(ctx);
       } catch (err: any) {
-        res.json({ error: err.message || 'Internal Server Error' }, err.status || 500);
+        console.error('Server Handler Error:', err);
+        ctx.json({ error: err.message || 'Internal Server Error' }, err.status || 500);
       }
     } else {
-      res.json({ error: 'Not Found' }, 404);
+      ctx.json({ error: 'Not Found' }, 404);
     }
   });