qhttpx 2.3.1 → 2.3.2

package/dist/index.d.mts

@@ -87,7 +87,7 @@ interface RouteOptions {
     priority?: 'critical' | 'interactive' | 'background';
     sloTarget?: number;
 }
-interface Route {
+interface Route$1 {
     method: string;
     path: string;
     handler?: Handler;
@@ -161,6 +161,7 @@ interface FluentBuilder$1 {
         expiresIn?: string;
     }): this;
     respond(status?: number): void;
+    respond(handler: Handler): void;
     secure(): this;
     autoFilter(table: string, allow: string[], options?: {
         sort?: string[];
@@ -208,18 +209,23 @@ interface App$1 {
     auth: {
         setJwtSecret(secret: string): void;
     };
-    get(path: string, config: RouteConfig): RouteBuilder;
-    get(path: string, handler: Handler): RouteBuilder;
-    get(path: string): RouteBuilder;
-    post(path: string, config: RouteConfig): RouteBuilder;
-    post(path: string, handler: Handler): RouteBuilder;
-    post(path: string): RouteBuilder;
-    put(path: string, config: RouteConfig): RouteBuilder;
-    put(path: string, handler: Handler): RouteBuilder;
-    put(path: string): RouteBuilder;
-    delete(path: string, config: RouteConfig): RouteBuilder;
-    delete(path: string, handler: Handler): RouteBuilder;
-    delete(path: string): RouteBuilder;
+    get(path: string, config: RouteConfig): Route$1;
+    get(path: string, handler: Handler): Route$1;
+    get(path: string, options: RouteOptions, handler: Handler): Route$1;
+    get(path: string): FluentBuilder$1;
+    post(path: string, config: RouteConfig): Route$1;
+    post(path: string, handler: Handler): Route$1;
+    post(path: string, options: RouteOptions, handler: Handler): Route$1;
+    post(path: string): FluentBuilder$1;
+    put(path: string, config: RouteConfig): Route$1;
+    put(path: string, handler: Handler): Route$1;
+    put(path: string, options: RouteOptions, handler: Handler): Route$1;
+    put(path: string): FluentBuilder$1;
+    delete(path: string, config: RouteConfig): Route$1;
+    delete(path: string, handler: Handler): Route$1;
+    delete(path: string, options: RouteOptions, handler: Handler): Route$1;
+    delete(path: string): FluentBuilder$1;
+    addRoute(method: string, path: string): Route$1;
     listen(port: number, callback?: () => void): void;
     listen(options: ListenOptions): void;
     stop(): void;
@@ -260,6 +266,8 @@ declare class FluentBuilder {
     private requestSchema?;
     private responseSchemaDef?;
     private queryBuilder?;
+    private rateLimitOptions?;
+    private cacheOptions?;
     constructor(app: App$1, method: string, path: string);
     desc(description: string): this;
     auth(strategy?: string): this;
@@ -408,26 +416,56 @@ declare class App implements App$1 {
         headers?: string[];
         credentials?: boolean;
     }): this;
-    get(path: string, config: RouteConfig): FluentBuilder;
-    get(path: string, handler: Handler): FluentBuilder;
-    get(path: string, options: RouteOptions, handler: Handler): FluentBuilder;
+    get(path: string, config: RouteConfig): Route;
+    get(path: string, handler: Handler): Route;
+    get(path: string, options: RouteOptions, handler: Handler): Route;
     get(path: string): FluentBuilder;
-    post(path: string, config: RouteConfig): FluentBuilder;
-    post(path: string, handler: Handler): FluentBuilder;
-    post(path: string, options: RouteOptions, handler: Handler): FluentBuilder;
+    post(path: string, config: RouteConfig): Route;
+    post(path: string, handler: Handler): Route;
+    post(path: string, options: RouteOptions, handler: Handler): Route;
     post(path: string): FluentBuilder;
-    put(path: string, config: RouteConfig): FluentBuilder;
-    put(path: string, handler: Handler): FluentBuilder;
-    put(path: string, options: RouteOptions, handler: Handler): FluentBuilder;
+    put(path: string, config: RouteConfig): Route;
+    put(path: string, handler: Handler): Route;
+    put(path: string, options: RouteOptions, handler: Handler): Route;
     put(path: string): FluentBuilder;
-    delete(path: string, config: RouteConfig): FluentBuilder;
-    delete(path: string, handler: Handler): FluentBuilder;
-    delete(path: string, options: RouteOptions, handler: Handler): FluentBuilder;
+    delete(path: string, config: RouteConfig): Route;
+    delete(path: string, handler: Handler): Route;
+    delete(path: string, options: RouteOptions, handler: Handler): Route;
     delete(path: string): FluentBuilder;
-    private addRoute;
+    addRoute(method: string, path: string): Route;
     registerHandler(handler: Handler, serializer?: (doc: any) => string): number;
     listen(portOrOptions: number | ListenOptions, cb?: () => void): void;
     stop(): void;
 }
+declare class Route implements RouteBuilder {
+    path: string;
+    method: string;
+    private app;
+    handlerId: number | null;
+    routeConfig: RouteConfig | undefined;
+    options: any;
+    description: string | undefined;
+    middlewares: Middleware[];
+    handler?: Handler;
+    private serializer;
+    constructor(path: string, method: string, app: App);
+    desc(description: string): this;
+    auth(strategy?: string): this;
+    jwt(): this;
+    cache(options: {
+        ttl: number;
+        key?: string;
+    }): this;
+    rateLimit(options: {
+        limit: number;
+        window: number;
+    }): this;
+    query(schemaBuilder: (q: QueryBuilder) => void): this;
+    schema(def: any): this;
+    priority(level: 'critical' | 'interactive' | 'background'): this;
+    slo(targetMs: number): this;
+    responseSchema(def: any): this;
+    respond(handler: Handler): void;
+}
 
-export { App, type DatabaseContext, type EnvContext, FluentBuilder, type Handler, type ListenOptions, type Middleware, type NextFunction, Q, type QueryBuilder, type QueryField, type RequestContext, type RequestMetrics, type RequestSnapshot, type Route, type RouteBuilder, type RouteConfig, type RouteOptions, TestClient, type UploadConfig, type WebSocket, type WsHandler, createTestClient };
+export { App, type DatabaseContext, type EnvContext, FluentBuilder, type Handler, type ListenOptions, type Middleware, type NextFunction, Q, type QueryBuilder, type QueryField, type RequestContext, type RequestMetrics, type RequestSnapshot, type Route$1 as Route, type RouteBuilder, type RouteConfig, type RouteOptions, TestClient, type UploadConfig, type WebSocket, type WsHandler, createTestClient };

package/dist/index.d.ts

@@ -87,7 +87,7 @@ interface RouteOptions {
     priority?: 'critical' | 'interactive' | 'background';
     sloTarget?: number;
 }
-interface Route {
+interface Route$1 {
     method: string;
     path: string;
     handler?: Handler;
@@ -161,6 +161,7 @@ interface FluentBuilder$1 {
         expiresIn?: string;
     }): this;
     respond(status?: number): void;
+    respond(handler: Handler): void;
     secure(): this;
     autoFilter(table: string, allow: string[], options?: {
         sort?: string[];
@@ -208,18 +209,23 @@ interface App$1 {
     auth: {
         setJwtSecret(secret: string): void;
     };
-    get(path: string, config: RouteConfig): RouteBuilder;
-    get(path: string, handler: Handler): RouteBuilder;
-    get(path: string): RouteBuilder;
-    post(path: string, config: RouteConfig): RouteBuilder;
-    post(path: string, handler: Handler): RouteBuilder;
-    post(path: string): RouteBuilder;
-    put(path: string, config: RouteConfig): RouteBuilder;
-    put(path: string, handler: Handler): RouteBuilder;
-    put(path: string): RouteBuilder;
-    delete(path: string, config: RouteConfig): RouteBuilder;
-    delete(path: string, handler: Handler): RouteBuilder;
-    delete(path: string): RouteBuilder;
+    get(path: string, config: RouteConfig): Route$1;
+    get(path: string, handler: Handler): Route$1;
+    get(path: string, options: RouteOptions, handler: Handler): Route$1;
+    get(path: string): FluentBuilder$1;
+    post(path: string, config: RouteConfig): Route$1;
+    post(path: string, handler: Handler): Route$1;
+    post(path: string, options: RouteOptions, handler: Handler): Route$1;
+    post(path: string): FluentBuilder$1;
+    put(path: string, config: RouteConfig): Route$1;
+    put(path: string, handler: Handler): Route$1;
+    put(path: string, options: RouteOptions, handler: Handler): Route$1;
+    put(path: string): FluentBuilder$1;
+    delete(path: string, config: RouteConfig): Route$1;
+    delete(path: string, handler: Handler): Route$1;
+    delete(path: string, options: RouteOptions, handler: Handler): Route$1;
+    delete(path: string): FluentBuilder$1;
+    addRoute(method: string, path: string): Route$1;
     listen(port: number, callback?: () => void): void;
     listen(options: ListenOptions): void;
     stop(): void;
@@ -260,6 +266,8 @@ declare class FluentBuilder {
     private requestSchema?;
     private responseSchemaDef?;
     private queryBuilder?;
+    private rateLimitOptions?;
+    private cacheOptions?;
     constructor(app: App$1, method: string, path: string);
     desc(description: string): this;
     auth(strategy?: string): this;
@@ -408,26 +416,56 @@ declare class App implements App$1 {
         headers?: string[];
         credentials?: boolean;
     }): this;
-    get(path: string, config: RouteConfig): FluentBuilder;
-    get(path: string, handler: Handler): FluentBuilder;
-    get(path: string, options: RouteOptions, handler: Handler): FluentBuilder;
+    get(path: string, config: RouteConfig): Route;
+    get(path: string, handler: Handler): Route;
+    get(path: string, options: RouteOptions, handler: Handler): Route;
     get(path: string): FluentBuilder;
-    post(path: string, config: RouteConfig): FluentBuilder;
-    post(path: string, handler: Handler): FluentBuilder;
-    post(path: string, options: RouteOptions, handler: Handler): FluentBuilder;
+    post(path: string, config: RouteConfig): Route;
+    post(path: string, handler: Handler): Route;
+    post(path: string, options: RouteOptions, handler: Handler): Route;
     post(path: string): FluentBuilder;
-    put(path: string, config: RouteConfig): FluentBuilder;
-    put(path: string, handler: Handler): FluentBuilder;
-    put(path: string, options: RouteOptions, handler: Handler): FluentBuilder;
+    put(path: string, config: RouteConfig): Route;
+    put(path: string, handler: Handler): Route;
+    put(path: string, options: RouteOptions, handler: Handler): Route;
     put(path: string): FluentBuilder;
-    delete(path: string, config: RouteConfig): FluentBuilder;
-    delete(path: string, handler: Handler): FluentBuilder;
-    delete(path: string, options: RouteOptions, handler: Handler): FluentBuilder;
+    delete(path: string, config: RouteConfig): Route;
+    delete(path: string, handler: Handler): Route;
+    delete(path: string, options: RouteOptions, handler: Handler): Route;
     delete(path: string): FluentBuilder;
-    private addRoute;
+    addRoute(method: string, path: string): Route;
     registerHandler(handler: Handler, serializer?: (doc: any) => string): number;
     listen(portOrOptions: number | ListenOptions, cb?: () => void): void;
     stop(): void;
 }
+declare class Route implements RouteBuilder {
+    path: string;
+    method: string;
+    private app;
+    handlerId: number | null;
+    routeConfig: RouteConfig | undefined;
+    options: any;
+    description: string | undefined;
+    middlewares: Middleware[];
+    handler?: Handler;
+    private serializer;
+    constructor(path: string, method: string, app: App);
+    desc(description: string): this;
+    auth(strategy?: string): this;
+    jwt(): this;
+    cache(options: {
+        ttl: number;
+        key?: string;
+    }): this;
+    rateLimit(options: {
+        limit: number;
+        window: number;
+    }): this;
+    query(schemaBuilder: (q: QueryBuilder) => void): this;
+    schema(def: any): this;
+    priority(level: 'critical' | 'interactive' | 'background'): this;
+    slo(targetMs: number): this;
+    responseSchema(def: any): this;
+    respond(handler: Handler): void;
+}
 
-export { App, type DatabaseContext, type EnvContext, FluentBuilder, type Handler, type ListenOptions, type Middleware, type NextFunction, Q, type QueryBuilder, type QueryField, type RequestContext, type RequestMetrics, type RequestSnapshot, type Route, type RouteBuilder, type RouteConfig, type RouteOptions, TestClient, type UploadConfig, type WebSocket, type WsHandler, createTestClient };
+export { App, type DatabaseContext, type EnvContext, FluentBuilder, type Handler, type ListenOptions, type Middleware, type NextFunction, Q, type QueryBuilder, type QueryField, type RequestContext, type RequestMetrics, type RequestSnapshot, type Route$1 as Route, type RouteBuilder, type RouteConfig, type RouteOptions, TestClient, type UploadConfig, type WebSocket, type WsHandler, createTestClient };

package/dist/index.js

@@ -557,6 +557,8 @@ var FluentBuilder = class {
   requestSchema;
   responseSchemaDef;
   queryBuilder;
+  rateLimitOptions;
+  cacheOptions;
   // RouteBuilder compatibility methods
   desc(description) {
     this.steps.push({
@@ -577,6 +579,7 @@ var FluentBuilder = class {
     return this;
   }
   cache(options) {
+    this.cacheOptions = options;
     this.steps.push({
       name: "cache",
       fn: (ctx, state) => {
@@ -586,6 +589,7 @@ var FluentBuilder = class {
     return this;
   }
   rateLimit(options) {
+    this.rateLimitOptions = options;
     this.steps.push({
       name: "rateLimit",
       fn: (ctx, state) => {
@@ -827,7 +831,10 @@ var FluentBuilder = class {
     }
     const status = handlerOrStatus;
     const handler = async (ctx) => {
-      let state = {};
+      let state = {
+        params: ctx.params || {},
+        query: ctx.query || {}
+      };
       let finalStatus = status;
       try {
         for (const step of this.steps) {
@@ -848,7 +855,8 @@ var FluentBuilder = class {
         ctx.json({ error: message }, status2);
       }
     };
-    const route = this.app[this.method.toLowerCase()](this.path, handler);
+    const route = this.app.addRoute(this.method, this.path);
+    route.handler = handler;
     this.applyOptionsToRoute(route);
   }
   applyOptionsToRoute(route) {
@@ -861,6 +869,12 @@ var FluentBuilder = class {
     if (this.queryBuilder) {
       route.query(this.queryBuilder);
     }
+    if (this.rateLimitOptions) {
+      route.rateLimit(this.rateLimitOptions);
+    }
+    if (this.cacheOptions) {
+      route.cache(this.cacheOptions);
+    }
     if (this.useJwt) {
       route.jwt();
     }
@@ -1634,76 +1648,88 @@ var App = class {
     return this;
   }
   get(path2, arg2, arg3) {
-    const fluentBuilder = new FluentBuilder(this, "GET", path2);
     if (arg3) {
       const route = this.addRoute("GET", path2);
       route.options = arg2;
       route.handler = arg3;
+      return route;
     } else if (arg2) {
       const route = this.addRoute("GET", path2);
       if (typeof arg2 === "function") {
         route.handler = arg2;
+        return route;
       } else if ("json" in arg2 || "text" in arg2 || "upload" in arg2) {
         route.routeConfig = arg2;
+        return route;
       } else {
         route.options = arg2;
+        return route;
       }
     }
-    return fluentBuilder;
+    return new FluentBuilder(this, "GET", path2);
   }
   post(path2, arg2, arg3) {
-    const fluentBuilder = new FluentBuilder(this, "POST", path2);
     if (arg3) {
       const route = this.addRoute("POST", path2);
       route.options = arg2;
       route.handler = arg3;
+      return route;
     } else if (arg2) {
       const route = this.addRoute("POST", path2);
       if (typeof arg2 === "function") {
         route.handler = arg2;
+        return route;
       } else if ("json" in arg2 || "text" in arg2 || "upload" in arg2) {
         route.routeConfig = arg2;
+        return route;
       } else {
         route.options = arg2;
+        return route;
       }
     }
-    return fluentBuilder;
+    return new FluentBuilder(this, "POST", path2);
   }
   put(path2, arg2, arg3) {
-    const fluentBuilder = new FluentBuilder(this, "PUT", path2);
     if (arg3) {
       const route = this.addRoute("PUT", path2);
       route.options = arg2;
       route.handler = arg3;
+      return route;
     } else if (arg2) {
       const route = this.addRoute("PUT", path2);
       if (typeof arg2 === "function") {
         route.handler = arg2;
+        return route;
       } else if ("json" in arg2 || "text" in arg2 || "upload" in arg2) {
         route.routeConfig = arg2;
+        return route;
       } else {
         route.options = arg2;
+        return route;
       }
     }
-    return fluentBuilder;
+    return new FluentBuilder(this, "PUT", path2);
   }
   delete(path2, arg2, arg3) {
-    const fluentBuilder = new FluentBuilder(this, "DELETE", path2);
     if (arg3) {
       const route = this.addRoute("DELETE", path2);
       route.options = arg2;
       route.handler = arg3;
+      return route;
     } else if (arg2) {
       const route = this.addRoute("DELETE", path2);
       if (typeof arg2 === "function") {
         route.handler = arg2;
+        return route;
       } else if ("json" in arg2 || "text" in arg2 || "upload" in arg2) {
         route.routeConfig = arg2;
+        return route;
       } else {
         route.options = arg2;
+        return route;
       }
     }
-    return fluentBuilder;
+    return new FluentBuilder(this, "DELETE", path2);
   }
   addRoute(method, path2) {
     const route = new Route(path2, method, this);
@@ -1840,9 +1866,14 @@ var App = class {
             options
           );
         }
-      } else if (route.handlerId) {
+      } else if (route.handlerId || route.handler) {
         try {
-          this.engine.registerRoute(route.method, enginePath, route.handlerId, options);
+          if (!route.handlerId && route.handler) {
+            route.handlerId = this.registerHandler(route.handler);
+          }
+          if (route.handlerId) {
+            this.engine.registerRoute(route.method, enginePath, route.handlerId, options);
+          }
         } catch (e) {
           console.error(`Failed to register route ${route.method} ${route.path}:`, e);
         }

package/dist/index.mjs

@@ -466,6 +466,8 @@ var FluentBuilder = class {
   requestSchema;
   responseSchemaDef;
   queryBuilder;
+  rateLimitOptions;
+  cacheOptions;
   // RouteBuilder compatibility methods
   desc(description) {
     this.steps.push({
@@ -486,6 +488,7 @@ var FluentBuilder = class {
     return this;
   }
   cache(options) {
+    this.cacheOptions = options;
     this.steps.push({
       name: "cache",
       fn: (ctx, state) => {
@@ -495,6 +498,7 @@ var FluentBuilder = class {
     return this;
   }
   rateLimit(options) {
+    this.rateLimitOptions = options;
     this.steps.push({
       name: "rateLimit",
       fn: (ctx, state) => {
@@ -736,7 +740,10 @@ var FluentBuilder = class {
     }
     const status = handlerOrStatus;
     const handler = async (ctx) => {
-      let state = {};
+      let state = {
+        params: ctx.params || {},
+        query: ctx.query || {}
+      };
       let finalStatus = status;
       try {
         for (const step of this.steps) {
@@ -757,7 +764,8 @@ var FluentBuilder = class {
         ctx.json({ error: message }, status2);
       }
     };
-    const route = this.app[this.method.toLowerCase()](this.path, handler);
+    const route = this.app.addRoute(this.method, this.path);
+    route.handler = handler;
     this.applyOptionsToRoute(route);
   }
   applyOptionsToRoute(route) {
@@ -770,6 +778,12 @@ var FluentBuilder = class {
     if (this.queryBuilder) {
       route.query(this.queryBuilder);
     }
+    if (this.rateLimitOptions) {
+      route.rateLimit(this.rateLimitOptions);
+    }
+    if (this.cacheOptions) {
+      route.cache(this.cacheOptions);
+    }
     if (this.useJwt) {
       route.jwt();
     }
@@ -1543,76 +1557,88 @@ var App = class {
     return this;
   }
   get(path, arg2, arg3) {
-    const fluentBuilder = new FluentBuilder(this, "GET", path);
     if (arg3) {
       const route = this.addRoute("GET", path);
       route.options = arg2;
       route.handler = arg3;
+      return route;
     } else if (arg2) {
       const route = this.addRoute("GET", path);
       if (typeof arg2 === "function") {
         route.handler = arg2;
+        return route;
       } else if ("json" in arg2 || "text" in arg2 || "upload" in arg2) {
         route.routeConfig = arg2;
+        return route;
       } else {
         route.options = arg2;
+        return route;
       }
     }
-    return fluentBuilder;
+    return new FluentBuilder(this, "GET", path);
   }
   post(path, arg2, arg3) {
-    const fluentBuilder = new FluentBuilder(this, "POST", path);
     if (arg3) {
       const route = this.addRoute("POST", path);
       route.options = arg2;
       route.handler = arg3;
+      return route;
     } else if (arg2) {
       const route = this.addRoute("POST", path);
       if (typeof arg2 === "function") {
         route.handler = arg2;
+        return route;
       } else if ("json" in arg2 || "text" in arg2 || "upload" in arg2) {
         route.routeConfig = arg2;
+        return route;
       } else {
         route.options = arg2;
+        return route;
       }
     }
-    return fluentBuilder;
+    return new FluentBuilder(this, "POST", path);
   }
   put(path, arg2, arg3) {
-    const fluentBuilder = new FluentBuilder(this, "PUT", path);
     if (arg3) {
       const route = this.addRoute("PUT", path);
       route.options = arg2;
       route.handler = arg3;
+      return route;
     } else if (arg2) {
       const route = this.addRoute("PUT", path);
       if (typeof arg2 === "function") {
         route.handler = arg2;
+        return route;
       } else if ("json" in arg2 || "text" in arg2 || "upload" in arg2) {
         route.routeConfig = arg2;
+        return route;
       } else {
         route.options = arg2;
+        return route;
       }
     }
-    return fluentBuilder;
+    return new FluentBuilder(this, "PUT", path);
   }
   delete(path, arg2, arg3) {
-    const fluentBuilder = new FluentBuilder(this, "DELETE", path);
     if (arg3) {
       const route = this.addRoute("DELETE", path);
       route.options = arg2;
       route.handler = arg3;
+      return route;
     } else if (arg2) {
       const route = this.addRoute("DELETE", path);
       if (typeof arg2 === "function") {
         route.handler = arg2;
+        return route;
       } else if ("json" in arg2 || "text" in arg2 || "upload" in arg2) {
         route.routeConfig = arg2;
+        return route;
       } else {
         route.options = arg2;
+        return route;
       }
     }
-    return fluentBuilder;
+    return new FluentBuilder(this, "DELETE", path);
   }
   addRoute(method, path) {
     const route = new Route(path, method, this);
@@ -1749,9 +1775,14 @@ var App = class {
             options
           );
         }
-      } else if (route.handlerId) {
+      } else if (route.handlerId || route.handler) {
         try {
-          this.engine.registerRoute(route.method, enginePath, route.handlerId, options);
+          if (!route.handlerId && route.handler) {
+            route.handlerId = this.registerHandler(route.handler);
+          }
+          if (route.handlerId) {
+            this.engine.registerRoute(route.method, enginePath, route.handlerId, options);
+          }
         } catch (e) {
           console.error(`Failed to register route ${route.method} ${route.path}:`, e);
         }

package/examples/cluster_demo.ts

@@ -7,18 +7,20 @@ const app = Q.app();
 // Just by connecting Redis, all rate limits become distributed!
 // app.db.connectRedis("redis://127.0.0.1:6379");
 
-app.get('/expensive', (c) => {
-    return c.send({ data: "Expensive computation" });
-})
-.rateLimit({ limit: 10, window: 60 }); // 10 reqs / min shared across ALL instances
+app.get('/expensive')
+   .rateLimit({ limit: 10, window: 60 })
+   .use(() => ({ data: "Expensive computation" }))
+   .respond();
 
 // 2. Native Redis Access
 // Use the shared Redis connection for your own data
-app.get('/cache', async (c) => {
-    await app.db.redis.set("my_key", "hello from rust", 300);
-    const val = await app.db.redis.get("my_key");
-    return c.send({ val });
-});
+app.get('/cache')
+   .use(async () => {
+       await app.db.redis.set("my_key", "hello from rust", 300);
+       const val = await app.db.redis.get("my_key");
+       return { val };
+   })
+   .respond();
 
 app.listen(3000, () => {
     console.log('Server running on http://localhost:3000');

package/examples/cors_demo.ts

@@ -10,13 +10,13 @@ app.cors({
     credentials: true
 });
 
-app.get('/', (c) => {
-    return c.send({ message: 'Hello with CORS!' });
-});
+app.get('/')
+   .use(() => ({ message: 'Hello with CORS!' }))
+   .respond();
 
-app.post('/data', (c) => {
-    return c.send({ status: 'received' });
-});
+app.post('/data')
+   .use(() => ({ status: 'received' }))
+   .respond();
 
 const PORT = 4000;
 app.listen(PORT, () => {

package/examples/db_auth_demo.ts

@@ -19,35 +19,40 @@ const SECRET = 'native-super-secret-key-123';
 // the connection might fail, but the architecture is valid.
 const PG_URL = "postgres://user:pass@localhost:5432/mydb";
 
-app.get('/public', (c) => {
-    return c.send({ message: "Public Access OK" });
-});
+app.get('/public')
+   .use(() => ({ message: "Public Access OK" }))
+   .respond();
 
 // Protected Route (Native JWT Check)
 // If the token is invalid, Rust rejects it. Node.js never sees the request.
-app.get('/protected', (c) => {
-    return c.send({ message: "You have valid Native JWT!" });
-})
-.jwt(); // Enable Native JWT Policy
+app.get('/protected')
+   .jwt() // Enable Native JWT Policy
+   .use(() => ({ message: "You have valid Native JWT!" }))
+   .respond();
 
 // Database Route
-app.get('/users', async (c) => {
-    // This executes SQL in Rust and returns JSON string directly
-    // Zero serialization overhead in Node.js!
-    try {
-        const result = await app.db.query("SELECT * FROM users");
-        // Result is a JSON string string from Rust
-        return c.send(JSON.parse(result));
-    } catch (e: any) {
-        return c.send({ error: e.message });
-    }
-});
+app.get('/users')
+   .use(async (ctx) => {
+       // This executes SQL in Rust and returns JSON string directly
+       // Zero serialization overhead in Node.js!
+       try {
+           const result = await app.db.query("SELECT * FROM users");
+           // Result is a JSON string string from Rust
+           return JSON.parse(result);
+       } catch (e: any) {
+           // Fluent API handles errors if we throw with status
+           throw { status: 500, message: e.message };
+       }
+   })
+   .respond();
 
 // Helper to generate token for testing
-app.get('/login', (c) => {
-    const token = jsonwebtoken.sign({ sub: 'user123' }, SECRET, { expiresIn: '1h' });
-    return c.send({ token });
-});
+app.get('/login')
+   .use(() => {
+       const token = jsonwebtoken.sign({ sub: 'user123' }, SECRET, { expiresIn: '1h' });
+       return { token };
+   })
+   .respond();
 
 app.listen(3000, () => {
     console.log('Server running on http://localhost:3000');

package/examples/hello.ts

@@ -2,6 +2,10 @@ import { Q } from '../src';
 
 const app = Q.app();
 
+app.get('/')
+   .use(() => ({ message: 'Hello World' }))
+   .respond();
+
 app.listen(3000, () => {
     console.log("Server started on port 3000");
 });

package/examples/http2_demo.ts

@@ -5,9 +5,9 @@ import http from 'http';
 
 const app = Q.app();
 
-app.get('/h2', (c) => {
-    c.send('Hello from QHTTPX!');
-});
+app.get('/h2')
+   .use(() => 'Hello from QHTTPX!')
+   .respond();
 
 app.listen(3003, async () => {
     console.log('Server listening on port 3003');

package/examples/magic-dev.ts

@@ -3,12 +3,12 @@ import { Q } from '../src';
 
 const app = Q.app();
 
-app.get('/', () => {
-    return { 
-        message: "Hello from Magic Dev Mode! ✨", 
-        timestamp: new Date().toISOString() 
-    };
-});
+app.get('/')
+   .use(() => ({ 
+       message: "Hello from Magic Dev Mode! ✨", 
+       timestamp: new Date().toISOString() 
+   }))
+   .respond();
 
 app.listen(3000, () => {
     console.log("Server running on http://localhost:3000");

package/examples/middleware_demo.ts

@@ -4,28 +4,30 @@ const app = Q.app();
 
 // 1. Rate Limited Route
 // Limit: 5 requests per 10 seconds
-app.get('/limited', (ctx) => {
-    return ctx.send({ message: "I am rate limited!" });
-})
-.rateLimit({ limit: 5, window: 10 });
+app.get('/limited')
+   .rateLimit({ limit: 5, window: 10 })
+   .use(() => ({ message: "I am rate limited!" }))
+   .respond();
 
 // 2. Cached Route
 // TTL: 10 seconds
 // The handler sleeps for 2 seconds to simulate slow work
-app.get('/cached', async (ctx) => {
-    // Simulate slow DB call
-    await new Promise(resolve => setTimeout(resolve, 2000));
-    return ctx.send({ 
-        message: "I am cached!", 
-        timestamp: Date.now() 
-    });
-})
-.cache({ ttl: 10 });
+app.get('/cached')
+   .cache({ ttl: 10 })
+   .use(async () => {
+       // Simulate slow DB call
+       await new Promise(resolve => setTimeout(resolve, 2000));
+       return { 
+           message: "I am cached!", 
+           timestamp: Date.now() 
+       };
+   })
+   .respond();
 
 // 3. Normal Route
-app.get('/normal', (ctx) => {
-    return ctx.send({ message: "I am normal" });
-});
+app.get('/normal')
+   .use(() => ({ message: "I am normal" }))
+   .respond();
 
 app.listen(3000, () => {
     console.log('Middleware Demo running on http://localhost:3000');

package/examples/mongo_demo.ts

@@ -6,30 +6,34 @@ const app = Q.app();
 // 1. Native Query Caching
 // SQL executed in Rust, result cached in Rust memory (DashMap)
 // Second request returns instantly without DB roundtrip!
-app.get('/users/cached', async (c) => {
-    try {
-        // Query with 60 second TTL
-        const json = await app.db.query("SELECT * FROM users", 60);
-        return c.send(JSON.parse(json));
-    } catch (e: any) {
-        return c.send({ error: e.message });
-    }
-});
+app.get('/users/cached')
+   .use(async (ctx) => {
+       try {
+           // Query with 60 second TTL
+           const json = await app.db.query("SELECT * FROM users", 60);
+           return JSON.parse(json);
+       } catch (e: any) {
+           return { error: e.message };
+       }
+   })
+   .respond();
 
 // 2. Native MongoDB Support
 // Query executed in Rust via mongodb crate
 // BSON -> JSON conversion happens in Rust
-app.get('/logs', async (c) => {
-    try {
-        const logs = await app.db.mongo("my_db", "logs").find({ 
-            level: "error",
-            timestamp: { $gt: 1700000000 }
-        });
-        return c.send(logs);
-    } catch (e: any) {
-        return c.send({ error: e.message });
-    }
-});
+app.get('/logs')
+   .use(async (ctx) => {
+       try {
+           const logs = await app.db.mongo("my_db", "logs").find({ 
+               level: "error",
+               timestamp: { $gt: 1700000000 }
+           });
+           return logs;
+       } catch (e: any) {
+           return { error: e.message };
+       }
+   })
+   .respond();
 
 app.listen(3000, () => {
     console.log('Server running on http://localhost:3000');

package/examples/observability_demo.ts

@@ -7,13 +7,15 @@ const app = Q.app();
 // Run with RUST_LOG=info node observability_demo.js
 app.enableLogging();
 
-app.get('/', (c) => {
-    return c.send({ message: "Hello Observability" });
-});
+app.get('/')
+   .use(() => ({ message: "Hello Observability" }))
+   .respond();
 
-app.get('/error', (c) => {
-    throw new Error("Something went wrong");
-});
+app.get('/error')
+   .use(() => {
+       throw new Error("Something went wrong");
+   })
+   .respond();
 
 // 2. Metrics are automatically exposed at /metrics
 // Try: curl http://localhost:3000/metrics

package/examples/static_demo.ts

@@ -19,9 +19,9 @@ fs.writeFileSync(path.join(publicDir, '1mb.dat'), buffer);
 // Serve static files
 app.static('/public', './examples/public');
 
-app.get('/', (c: any) => {
-    return c.send({ hello: 'world' });
-});
+app.get('/')
+   .use(() => ({ hello: 'world' }))
+   .respond();
 
 app.listen(PORT, () => {
     console.log(`Static File Server running on port ${PORT}`);

package/examples/tls_demo.ts

@@ -16,9 +16,9 @@ if (!fs.existsSync(certPath) || !fs.existsSync(keyPath)) {
     process.exit(1);
 }
 
-app.get('/', (c) => {
-    return c.send({ message: "Secure Hello from Native HTTP/2!" });
-});
+app.get('/')
+   .use(() => ({ message: "Secure Hello from Native HTTP/2!" }))
+   .respond();
 
 app.listen({
     port: 3000,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qhttpx",
-  "version": "2.3.1",
+  "version": "2.3.2",
   "description": "The AI-Native High-Performance Web Engine",
   "bin": {
     "qhttpx": "./dist/cli.js"