@arikajs/dispatcher 0.0.4 → 0.0.6

package/README.md

@@ -17,7 +17,7 @@ const dispatcher = new Dispatcher(container);
 const response = await dispatcher.dispatch(matchedRoute, request, responseInstance);
 ```
 
-Arika Dispatcher is to ArikaJS what `illuminate/routing`’s dispatcher is to Laravel: it takes a route and makes things happen.
+Arika Dispatcher is to ArikaJS the core execution engine for ArikaJS: it takes a route and makes things happen.
 
 ---
 
@@ -46,21 +46,28 @@ The goal of this package is to be the **reliable executor** of application logic
   - Automatic instantiation of controllers via Service Container
 
 - **Method Invocation**
-  - Resolves method dependencies
+  - Resolves method dependencies (auto-DI if Container supports `.call()`)
   - Injects `Request` object automatically
   - Maps route parameters (e.g., `{id}`) to method arguments
 
 - **Middleware Pipeline**
   - Executes route-specific middleware
+  - **Executes Controller-specific middleware** (`static middleware = [...]` or `getMiddleware()`)
   - Onion-style execution flow (nested `next()` calls)
   - Asynchronous middleware support
   - Container-based middleware resolution
 
+- **Exception Handling**
+  - Configurable global execution wrapper `setExceptionHandler((err, req, res) => ...)`
+  - Converts errors gracefully into responses
+
 - **Response Normalization**
   - Automatically converts return values to HTTP responses
   - Objects/Arrays → JSON response
   - Strings → Plain text response
   - `null`/`undefined` → 204 No Content
+  - View Objects (implementing `.render()`) → Rendered HTML
+  - NodeJS Streams (`Readable`) → Piped directly to Response
 
 ---
 
@@ -135,8 +142,36 @@ const dispatcher = new Dispatcher(app.container);
 const response = await dispatcher.dispatch(matched, request, response);
 ```
 
+### Global Exception Handler
+
+You can intercept exceptions at the edge of execution and transform them into standard JSON responses, preventing hard crashes:
+
+```ts
+dispatcher.setExceptionHandler((error, request, response) => {
+    if (error.name === 'AuthorizationException') {
+        return response.status(403).json({ error: error.message });
+    }
+    
+    // Unhandled error fallback
+    return response.status(500).json({ error: 'Server Error' });
+});
+```
+
 ---
 
+## Controller Middleware
+
+Middleware don't just have to live on the route. The Dispatcher automatically scans your class-based controllers for middleware and merges them into the pipeline.
+
+```ts
+class PostController {
+    // Static middleware applied to all routes mapping to this controller
+    static middleware = ['auth', 'verified'];
+
+    index() { /* ... */ }
+}
+```
+
 ## Middleware Pipeline
 
 The `MiddlewarePipeline` executes middleware in an "onion" pattern, where each layer can perform logic before and after the next layer.
@@ -172,20 +207,30 @@ Conversion Rules:
 - **Strings/Buffers**: Sent as the body via `response.send()`
 - **null/undefined**: Sets status 204 (No Content)
 - **Response**: Returned as-is
+- **Views**: Anything with an async `render()` function calls the function and sends the result
+- **Streams**: Returned values extending `stream.Stream` pipe properly if the response driver supports `.stream()`
 
 ---
 
-## Project Structure (recommended)
-
-Inside the `arika-dispatcher` repository:
-
-- `src/`
-  - `Dispatcher.ts` – Main coordinator
-  - `ControllerResolver.ts` – DI-aware handler resolution
-  - `MethodInvoker.ts` – Dynamic method execution
-  - `ResponseResolver.ts` – Logic for normalizing return values
-  - `MiddlewarePipeline.ts` – The execution stack for middleware
-  - `index.ts` – Public exports
+## 🏗 Architecture
+
+```text
+dispatcher/
+├── src/
+│   ├── Contracts
+│   │   ├── Container.ts
+│   │   ├── Http.ts
+│   │   └── Router.ts
+│   ├── ControllerResolver.ts
+│   ├── Dispatcher.ts
+│   ├── index.ts
+│   ├── MethodInvoker.ts
+│   └── ResponseResolver.ts
+├── tests/
+├── package.json
+├── tsconfig.json
+└── README.md
+```
 
 ---
 

package/dist/Contracts/Http.d.ts

@@ -3,8 +3,8 @@ export interface Request {
 }
 export interface Response {
     status(code: number): this;
-    send(data: any): this;
-    json(data: any): this;
+    send(data: any, status?: number): this;
+    json(data: any, status?: number): this;
     [key: string]: any;
 }
 //# sourceMappingURL=Http.d.ts.map

package/dist/Contracts/Http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Http.d.ts","sourceRoot":"","sources":["../../src/Contracts/Http.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,OAAO;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACrB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAAC;IACtB,IAAI,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB"}
+{"version":3,"file":"Http.d.ts","sourceRoot":"","sources":["../../src/Contracts/Http.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,OAAO;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACrB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB"}

package/dist/Contracts/Router.d.ts

@@ -5,5 +5,6 @@ export interface MatchedRoute {
         [key: string]: any;
     };
     params: Record<string, string>;
+    hasParams: boolean;
 }
 //# sourceMappingURL=Router.d.ts.map

package/dist/Contracts/Router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Router.d.ts","sourceRoot":"","sources":["../../src/Contracts/Router.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE;QACH,OAAO,EAAE,GAAG,CAAC;QACb,UAAU,CAAC,EAAE,GAAG,EAAE,CAAC;QACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACtB,CAAC;IACF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC"}
+{"version":3,"file":"Router.d.ts","sourceRoot":"","sources":["../../src/Contracts/Router.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE;QACH,OAAO,EAAE,GAAG,CAAC;QACb,UAAU,CAAC,EAAE,GAAG,EAAE,CAAC;QACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACtB,CAAC;IACF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,SAAS,EAAE,OAAO,CAAC;CACtB"}

package/dist/Dispatcher.d.ts

@@ -8,11 +8,18 @@ export declare class Dispatcher {
     private middlewareGroups;
     private routeMiddleware;
     private parameterBinders;
+    private exceptionHandler?;
+    executionPlans: Map<any, any>;
     constructor(container?: any | undefined);
+    precompile(routes: any[]): void;
     /**
      * Set the container for resolving controllers.
      */
     setContainer(container: any): this;
+    /**
+     * Set a global exception handler to catch and format errors from route execution.
+     */
+    setExceptionHandler(handler: (error: any, request: Request, response: Response) => any): this;
     /**
      * Set the middleware groups mapping.
      */

package/dist/Dispatcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Dispatcher.d.ts","sourceRoot":"","sources":["../src/Dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMlD,qBAAa,UAAU;IAQP,OAAO,CAAC,SAAS,CAAC;IAP9B,OAAO,CAAC,kBAAkB,CAAC,CAAqB;IAChD,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,gBAAgB,CAA6B;IACrD,OAAO,CAAC,eAAe,CAA2B;IAClD,OAAO,CAAC,gBAAgB,CAAwD;gBAE5D,SAAS,CAAC,EAAE,GAAG,YAAA;IAQnC;;OAEG;IACI,YAAY,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI;IAMzC;;OAEG;IACI,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,IAAI;IAK/D;;OAEG;IACI,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAKhE;;OAEG;IACI,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,IAAI;IAS7C;;OAEG;IACU,QAAQ,CACjB,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,GACnB,OAAO,CAAC,QAAQ,CAAC;IAyCpB;;OAEG;YACW,iBAAiB;CAYlC"}
+{"version":3,"file":"Dispatcher.d.ts","sourceRoot":"","sources":["../src/Dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMlD,qBAAa,UAAU;IAUP,OAAO,CAAC,SAAS,CAAC;IAT9B,OAAO,CAAC,kBAAkB,CAAC,CAAqB;IAChD,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,gBAAgB,CAA6B;IACrD,OAAO,CAAC,eAAe,CAA2B;IAClD,OAAO,CAAC,gBAAgB,CAAwD;IAChF,OAAO,CAAC,gBAAgB,CAAC,CAA4D;IAC9E,cAAc,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAa;gBAE7B,SAAS,CAAC,EAAE,GAAG,YAAA;IAQ5B,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE;IAmD/B;;OAEG;IACI,YAAY,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI;IAOzC;;OAEG;IACI,mBAAmB,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,KAAK,GAAG,GAAG,IAAI;IAKpG;;OAEG;IACI,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,IAAI;IAK/D;;OAEG;IACI,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAKhE;;OAEG;IACI,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,IAAI;IAS7C;;OAEG;IACU,QAAQ,CACjB,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,GACnB,OAAO,CAAC,QAAQ,CAAC;IAyEpB;;OAEG;YACW,iBAAiB;CAYlC"}

package/dist/Dispatcher.js

@@ -11,18 +11,78 @@ class Dispatcher {
         this.middlewareGroups = {};
         this.routeMiddleware = {};
         this.parameterBinders = new Map();
-        this.invoker = new MethodInvoker_1.MethodInvoker();
+        this.executionPlans = new Map();
+        this.invoker = new MethodInvoker_1.MethodInvoker(container);
         this.responseResolver = new ResponseResolver_1.ResponseResolver();
         if (container) {
             this.controllerResolver = new ControllerResolver_1.ControllerResolver(container);
         }
     }
+    precompile(routes) {
+        for (let i = 0; i < routes.length; i++) {
+            const route = routes[i];
+            const handler = route.handler;
+            let resolvedHandler;
+            let controllerMiddleware = [];
+            if (Array.isArray(handler)) {
+                if (this.controllerResolver) {
+                    try {
+                        const resolved = this.controllerResolver.resolve(handler);
+                        resolvedHandler = resolved;
+                        if (typeof resolved.controller.getMiddleware === 'function') {
+                            controllerMiddleware = resolved.controller.getMiddleware() || [];
+                        }
+                        else if (resolved.controller.constructor && resolved.controller.constructor.middleware) {
+                            controllerMiddleware = resolved.controller.constructor.middleware;
+                        }
+                    }
+                    catch (e) {
+                        // Skip if cannot resolve at boot (e.g. missing container)
+                        continue;
+                    }
+                }
+                else {
+                    continue;
+                }
+            }
+            else {
+                resolvedHandler = handler;
+            }
+            const hasMiddleware = (route.middleware && route.middleware.length > 0) || (controllerMiddleware && controllerMiddleware.length > 0);
+            this.executionPlans.set(route, {
+                route,
+                hasMiddleware,
+                controllerMiddleware,
+                resolvedHandler,
+                handler: (req, res, params) => this.invoker.invoke(resolvedHandler, req, res, params),
+                middleware: hasMiddleware ? [...(route.middleware || []), ...(controllerMiddleware || [])] : []
+            });
+            // Pre-serialize simple responses if possible (only if handler takes no arguments)
+            if (!hasMiddleware && typeof resolvedHandler === 'function' && resolvedHandler.length === 0) {
+                try {
+                    const result = resolvedHandler();
+                    if (result && typeof result === 'object' && !(result instanceof Promise)) {
+                        this.responseResolver.bufferCache.set(route, Buffer.from(JSON.stringify(result)));
+                    }
+                }
+                catch (e) { }
+            }
+        }
+    }
     /**
      * Set the container for resolving controllers.
      */
     setContainer(container) {
         this.container = container;
         this.controllerResolver = new ControllerResolver_1.ControllerResolver(container);
+        this.invoker.setContainer(container);
+        return this;
+    }
+    /**
+     * Set a global exception handler to catch and format errors from route execution.
+     */
+    setExceptionHandler(handler) {
+        this.exceptionHandler = handler;
         return this;
     }
     /**
@@ -57,37 +117,72 @@ class Dispatcher {
     async dispatch(matchedRoute, request, response) {
         const { route, params } = matchedRoute;
         const handler = route.handler;
-        // 0. Resolve Route Parameters (Model Binding)
-        const resolvedParams = await this.resolveParameters(params);
+        // Set parameters on the request object
+        if (typeof request.setParams === 'function') {
+            request.setParams(params);
+        }
+        // 0. Resolve Route Parameters (Model Binding) - only if we have binders
+        const resolvedParams = this.parameterBinders.size > 0 ? await this.resolveParameters(params) : params;
         // 1. Resolve Handler
         let resolvedHandler;
-        if (Array.isArray(handler)) {
-            if (!this.controllerResolver) {
-                throw new Error('Container required for controller resolution.');
-            }
-            resolvedHandler = this.controllerResolver.resolve(handler);
-        }
-        else if (typeof handler === 'function') {
-            resolvedHandler = handler;
+        let controllerMiddleware = [];
+        const plan = this.executionPlans.get(route);
+        if (plan) {
+            resolvedHandler = plan.resolvedHandler;
+            controllerMiddleware = plan.controllerMiddleware;
         }
         else {
-            throw new Error('Invalid route handler.');
+            if (Array.isArray(handler)) {
+                if (!this.controllerResolver) {
+                    throw new Error('Container required for controller resolution.');
+                }
+                const resolved = this.controllerResolver.resolve(handler);
+                resolvedHandler = resolved;
+                // Extract controller-level middleware
+                if (typeof resolved.controller.getMiddleware === 'function') {
+                    controllerMiddleware = resolved.controller.getMiddleware() || [];
+                }
+                else if (resolved.controller.constructor && resolved.controller.constructor.middleware) {
+                    controllerMiddleware = resolved.controller.constructor.middleware;
+                }
+            }
+            else if (typeof handler === 'function') {
+                resolvedHandler = handler;
+            }
+            else {
+                throw new Error('Invalid route handler.');
+            }
         }
         // 2. Prepare Middleware Pipeline
         const pipeline = new middleware_1.Pipeline(this.container);
+        if (plan && plan.hasMiddleware) {
+            pipeline.pipe(plan.middleware);
+        }
+        else if (!plan) {
+            // Fallback for non-plan routes
+            if (route.middleware)
+                pipeline.pipe(route.middleware);
+            if (controllerMiddleware)
+                pipeline.pipe(controllerMiddleware);
+        }
         pipeline.setMiddlewareGroups(this.middlewareGroups);
         pipeline.setAliases(this.routeMiddleware);
-        // Add route-level middleware
-        if (route.middleware && route.middleware.length > 0) {
-            pipeline.pipe(route.middleware);
-        }
         // 3. Execute Pipeline
-        return await pipeline.handle(request, async (req) => {
-            // 4. Invoke Handler
-            const result = await this.invoker.invoke(resolvedHandler, req, resolvedParams);
-            // 5. Normalize Response
-            return this.responseResolver.resolve(result, response);
-        }, response);
+        try {
+            return await pipeline.handle(request, async (req) => {
+                // 4. Invoke Handler
+                const result = await this.invoker.invoke(resolvedHandler, req, response, resolvedParams);
+                // 5. Normalize Response
+                return await this.responseResolver.resolve(result, response);
+            }, response);
+        }
+        catch (error) {
+            if (this.exceptionHandler) {
+                const handledResult = await this.exceptionHandler(error, request, response);
+                return await this.responseResolver.resolve(handledResult, response);
+            }
+            throw error;
+        }
     }
     /**
      * Resolve route parameters using registered binders.

package/dist/Dispatcher.js.map

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

package/dist/MethodInvoker.d.ts

@@ -1,11 +1,14 @@
-import { Request } from './Contracts/Http';
+import { Request, Response } from './Contracts/Http';
 export declare class MethodInvoker {
+    private container?;
+    constructor(container?: any | undefined);
+    setContainer(container: any): this;
     /**
      * Invoke the handler (closure or controller method) with injected parameters.
      */
     invoke(handler: Function | {
         controller: any;
         method: string;
-    }, request: Request, params: Record<string, any>): Promise<any>;
+    }, request: Request, response: Response, params: Record<string, any>): Promise<any>;
 }
 //# sourceMappingURL=MethodInvoker.d.ts.map

package/dist/MethodInvoker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MethodInvoker.d.ts","sourceRoot":"","sources":["../src/MethodInvoker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,qBAAa,aAAa;IACtB;;OAEG;IACU,MAAM,CACf,OAAO,EAAE,QAAQ,GAAG;QAAE,UAAU,EAAE,GAAG,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EACvD,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC5B,OAAO,CAAC,GAAG,CAAC;CAQlB"}
+{"version":3,"file":"MethodInvoker.d.ts","sourceRoot":"","sources":["../src/MethodInvoker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAErD,qBAAa,aAAa;IACV,OAAO,CAAC,SAAS,CAAC;gBAAV,SAAS,CAAC,EAAE,GAAG,YAAA;IAE5B,YAAY,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI;IAKzC;;OAEG;IACU,MAAM,CACf,OAAO,EAAE,QAAQ,GAAG;QAAE,UAAU,EAAE,GAAG,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EACvD,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC5B,OAAO,CAAC,GAAG,CAAC;CAmBlB"}

package/dist/MethodInvoker.js

@@ -2,15 +2,31 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MethodInvoker = void 0;
 class MethodInvoker {
+    constructor(container) {
+        this.container = container;
+    }
+    setContainer(container) {
+        this.container = container;
+        return this;
+    }
     /**
      * Invoke the handler (closure or controller method) with injected parameters.
      */
-    async invoke(handler, request, params) {
+    async invoke(handler, request, response, params) {
         if (typeof handler === 'function') {
-            return await handler(request, ...Object.values(params));
+            // If container has a call method (e.g., Arika Foundation container), delegate to it
+            // This enables advanced method DI using reflect-metadata
+            if (this.container && typeof this.container.call === 'function') {
+                return await this.container.call(handler, { request, response, ...params });
+            }
+            return await handler(request, response, ...Object.values(params));
         }
         const { controller, method } = handler;
-        return await controller[method](request, ...Object.values(params));
+        // Container-based advanced method DI
+        if (this.container && typeof this.container.call === 'function') {
+            return await this.container.call([controller, method], { request, response, ...params });
+        }
+        return await controller[method](request, response, ...Object.values(params));
     }
 }
 exports.MethodInvoker = MethodInvoker;

package/dist/MethodInvoker.js.map

@@ -1 +1 @@
-{"version":3,"file":"MethodInvoker.js","sourceRoot":"","sources":["../src/MethodInvoker.ts"],"names":[],"mappings":";;;AAEA,MAAa,aAAa;IACtB;;OAEG;IACI,KAAK,CAAC,MAAM,CACf,OAAuD,EACvD,OAAgB,EAChB,MAA2B;QAE3B,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;YAChC,OAAO,MAAM,OAAO,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QACvC,OAAO,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACvE,CAAC;CACJ;AAhBD,sCAgBC"}
+{"version":3,"file":"MethodInvoker.js","sourceRoot":"","sources":["../src/MethodInvoker.ts"],"names":[],"mappings":";;;AAEA,MAAa,aAAa;IACtB,YAAoB,SAAe;QAAf,cAAS,GAAT,SAAS,CAAM;IAAI,CAAC;IAEjC,YAAY,CAAC,SAAc;QAC9B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,MAAM,CACf,OAAuD,EACvD,OAAgB,EAChB,QAAkB,EAClB,MAA2B;QAE3B,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;YAChC,oFAAoF;YACpF,yDAAyD;YACzD,IAAI,IAAI,CAAC,SAAS,IAAI,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBAC9D,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;YAChF,CAAC;YACD,OAAO,MAAM,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAEvC,qCAAqC;QACrC,IAAI,IAAI,CAAC,SAAS,IAAI,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC9D,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QAC7F,CAAC;QAED,OAAO,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACjF,CAAC;CACJ;AAnCD,sCAmCC"}

package/dist/ResponseResolver.d.ts

@@ -1,8 +1,9 @@
 import { Response } from './Contracts/Http';
 export declare class ResponseResolver {
+    bufferCache: Map<any, Buffer>;
     /**
      * Resolve and normalize the handler return value into a Response object.
      */
-    resolve(value: any, response: Response): Response;
+    resolve(value: any, response: Response, route?: any): Response | Promise<Response>;
 }
 //# sourceMappingURL=ResponseResolver.d.ts.map

package/dist/ResponseResolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ResponseResolver.d.ts","sourceRoot":"","sources":["../src/ResponseResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,qBAAa,gBAAgB;IACzB;;OAEG;IACI,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,GAAG,QAAQ;CAuB3D"}
+{"version":3,"file":"ResponseResolver.d.ts","sourceRoot":"","sources":["../src/ResponseResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,qBAAa,gBAAgB;IAClB,WAAW,EAAE,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAa;IAEjD;;OAEG;IACI,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;CA4C5F"}

package/dist/ResponseResolver.js

@@ -1,13 +1,40 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ResponseResolver = void 0;
+const stream_1 = require("stream");
 class ResponseResolver {
+    constructor() {
+        this.bufferCache = new Map();
+    }
     /**
      * Resolve and normalize the handler return value into a Response object.
      */
-    resolve(value, response) {
+    resolve(value, response, route) {
+        if (route && this.bufferCache.has(route)) {
+            return response.send(this.bufferCache.get(route));
+        }
+        // Handle null or undefined (empty response)
+        if (value === null || value === undefined) {
+            return response.status(204).send('');
+        }
+        // Output of a View or object with a render() method
+        if (value && typeof value.render === 'function') {
+            const rendered = value.render();
+            if (rendered instanceof Promise) {
+                return rendered.then(r => response.send(r));
+            }
+            return response.send(rendered);
+        }
+        // If it's a native stream, map to the response's stream handler if supported
+        if (value instanceof stream_1.Stream) {
+            if (typeof response.stream === 'function') {
+                return response.stream(value);
+            }
+            // fallback, assuming some other mechanism handles it
+            return value;
+        }
         // If it's already a Response object (basic duck typing check for framework response)
-        if (value && typeof value.send === 'function' && typeof value.status === 'function') {
+        if (typeof value.send === 'function' && typeof value.status === 'function') {
             return value;
         }
         if (typeof value === 'object' && value !== null) {
@@ -17,10 +44,6 @@ class ResponseResolver {
         if (typeof value === 'string' || Buffer.isBuffer(value)) {
             return response.send(value);
         }
-        // Handle null or undefined (empty response)
-        if (value === null || value === undefined) {
-            return response.status(204).send('');
-        }
         // Default to string conversion
         return response.send(String(value));
     }

package/dist/ResponseResolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"ResponseResolver.js","sourceRoot":"","sources":["../src/ResponseResolver.ts"],"names":[],"mappings":";;;AAEA,MAAa,gBAAgB;IACzB;;OAEG;IACI,OAAO,CAAC,KAAU,EAAE,QAAkB;QACzC,qFAAqF;QACrF,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YAClF,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC9C,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAED,6CAA6C;QAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACtD,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAED,4CAA4C;QAC5C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxC,OAAO,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzC,CAAC;QAED,+BAA+B;QAC/B,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACxC,CAAC;CACJ;AA3BD,4CA2BC"}
+{"version":3,"file":"ResponseResolver.js","sourceRoot":"","sources":["../src/ResponseResolver.ts"],"names":[],"mappings":";;;AACA,mCAAgC;AAEhC,MAAa,gBAAgB;IAA7B;QACW,gBAAW,GAAqB,IAAI,GAAG,EAAE,CAAC;IAiDrD,CAAC;IA/CG;;OAEG;IACI,OAAO,CAAC,KAAU,EAAE,QAAkB,EAAE,KAAW;QACtD,IAAI,KAAK,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACvC,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,CAAC;QACvD,CAAC;QACD,4CAA4C;QAC5C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxC,OAAO,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzC,CAAC;QAED,oDAAoD;QACpD,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YAC9C,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAChC,IAAI,QAAQ,YAAY,OAAO,EAAE,CAAC;gBAC9B,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAChD,CAAC;YACD,OAAO,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC;QAED,6EAA6E;QAC7E,IAAI,KAAK,YAAY,eAAM,EAAE,CAAC;YAC1B,IAAI,OAAO,QAAQ,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBACxC,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAClC,CAAC;YACD,qDAAqD;YACrD,OAAO,KAAY,CAAC;QACxB,CAAC;QAED,qFAAqF;QACrF,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YACzE,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC9C,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAED,6CAA6C;QAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACtD,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAED,+BAA+B;QAC/B,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACxC,CAAC;CACJ;AAlDD,4CAkDC"}

package/package.json

@@ -1,45 +1,47 @@
 {
-    "name": "@arikajs/dispatcher",
-    "version": "0.0.4",
-    "description": "Request dispatching and handler execution layer of the ArikaJS framework.",
-    "license": "MIT",
-    "main": "dist/index.js",
-    "types": "dist/index.d.ts",
-    "scripts": {
-        "build": "tsc -p tsconfig.json",
-        "clean": "rm -rf dist",
-        "prepare": "echo skip",
-        "test": "npx tsx tests/Dispatcher.test.ts",
-        "test:watch": "npx tsx --watch tests/Dispatcher.test.ts"
-    },
-    "files": [
-        "dist"
-    ],
-    "keywords": [
-        "arika",
-        "arika-js",
-        "framework",
-        "dispatcher",
-        "controller",
-        "middleware"
-    ],
-    "engines": {
-        "node": ">=20.0.0"
-    },
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/arikajs/dispatcher.git"
-    },
-    "bugs": {
-        "url": "https://github.com/arikajs/dispatcher/issues"
-    },
-    "homepage": "https://github.com/arikajs/dispatcher#readme",
-    "dependencies": {
-        "@arikajs/middleware": "^0.0.4"
-    },
-    "devDependencies": {
-        "@types/node": "^20.11.24",
-        "typescript": "^5.3.3"
-    },
-    "author": "Prakash Tank"
+  "name": "@arikajs/dispatcher",
+  "version": "0.0.6",
+  "description": "Request dispatching and handler execution layer of the ArikaJS framework.",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "prepare": "echo skip",
+    "test": "npx tsx tests/Dispatcher.test.ts",
+    "test:watch": "npx tsx --watch tests/Dispatcher.test.ts",
+    "dev": "tsc -p tsconfig.json --watch"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "arika",
+    "arika-js",
+    "framework",
+    "dispatcher",
+    "controller",
+    "middleware"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ArikaJs/arikajs.git",
+    "directory": "packages/dispatcher"
+  },
+  "bugs": {
+    "url": "https://github.com/ArikaJs/arikajs/issues"
+  },
+  "homepage": "https://github.com/ArikaJs/arikajs/tree/main/packages/dispatcher#readme",
+  "dependencies": {
+    "@arikajs/middleware": "*"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.24",
+    "typescript": "^5.3.3"
+  },
+  "author": "Prakash Tank"
 }