@arikajs/dispatcher 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ArikaJs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,224 @@
+## Arika Dispatcher
+
+`@arikajs/dispatcher` is the **execution engine** of the ArikaJS ecosystem.
+
+Before the response is sent back to the client, this package handles the **journey from route to result**:
+
+- Route handler resolution (Closures or Controllers)
+- Dependency Injection for controllers
+- Method invocation with parameter injection
+- Middleware pipeline execution
+- Response normalization
+
+If the following works cleanly, the dispatcher is considered correct:
+
+```ts
+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.
+
+---
+
+### Status
+
+- **Stage**: Experimental / v0.x
+- **Scope (v0.x)**:
+  - Controller & Closure resolution
+  - Method parameter injection (Request + Route Params)
+  - Basic middleware pipeline
+  - Response normalization (String, Object, Response)
+- **Out of scope (for this package)**:
+  - Route matching (see `@arikajs/router`)
+  - Request parsing (see `@arikajs/http`)
+  - Template rendering
+
+The goal of this package is to be the **reliable executor** of application logic.
+
+---
+
+## Features
+
+- **Handler Resolution**
+  - Support for basic closures: `(req) => 'Hello'`
+  - Support for class-based controllers: `[UserController, 'show']`
+  - Automatic instantiation of controllers via Service Container
+
+- **Method Invocation**
+  - Resolves method dependencies
+  - Injects `Request` object automatically
+  - Maps route parameters (e.g., `{id}`) to method arguments
+
+- **Middleware Pipeline**
+  - Executes route-specific middleware
+  - Onion-style execution flow (nested `next()` calls)
+  - Asynchronous middleware support
+  - Container-based middleware resolution
+
+- **Response Normalization**
+  - Automatically converts return values to HTTP responses
+  - Objects/Arrays → JSON response
+  - Strings → Plain text response
+  - `null`/`undefined` → 204 No Content
+
+---
+
+## Installation
+
+```bash
+npm install @arikajs/dispatcher
+# or
+yarn add @arikajs/dispatcher
+# or
+pnpm add @arikajs/dispatcher
+```
+
+This package is written in TypeScript and ships with type definitions.
+
+---
+
+## Quick Start
+
+### 1. Simple Dispatching
+
+```ts
+import { Dispatcher } from '@arikajs/dispatcher';
+
+const dispatcher = new Dispatcher();
+const response = await dispatcher.dispatch(matchedRoute, request, response);
+```
+
+### 2. Using Controllers with DI
+
+```ts
+import { Dispatcher } from '@arikajs/dispatcher';
+import { Container } from '@arikajs/foundation';
+
+const container = new Container();
+const dispatcher = new Dispatcher(container);
+
+// Dispatch to [UserController, 'index']
+const response = await dispatcher.dispatch(matchedRoute, request, response);
+```
+
+---
+
+## Dispatcher
+
+The `Dispatcher` class is the central coordinator that manages the lifecycle of a request dispatch.
+
+Core responsibilities:
+
+- Resolves the handler (Closure or Controller)
+- Manages the **middleware pipeline**
+- Coordinates the **invocation** of the handler
+- Ensures the return value is **normalized** into a Response
+
+Minimal API:
+
+```ts
+class Dispatcher {
+  constructor(container?: Container);
+
+  setContainer(container: Container): this;
+  dispatch(matchedRoute: MatchedRoute, request: Request, response: Response): Promise<Response>;
+}
+```
+
+Typical usage:
+
+```ts
+import { Dispatcher } from '@arikajs/dispatcher';
+
+const dispatcher = new Dispatcher(app.container);
+const response = await dispatcher.dispatch(matched, request, response);
+```
+
+---
+
+## Middleware Pipeline
+
+The `MiddlewarePipeline` executes middleware in an "onion" pattern, where each layer can perform logic before and after the next layer.
+
+Minimal API:
+
+```ts
+pipeline.use(middleware);
+pipeline.handle(request, destination);
+```
+
+### Usage
+
+```ts
+const pipeline = new MiddlewarePipeline(container);
+
+pipeline.use(async (req, next) => {
+  const res = await next(req);
+  res.header('X-Processed-By', 'Arika');
+  return res;
+});
+```
+
+---
+
+## Response Resolver
+
+The `ResponseResolver` ensures that your controller methods can stay clean by returning plain data.
+
+Conversion Rules:
+
+- **Objects**: Automatically converted to JSON via `response.json()`
+- **Strings/Buffers**: Sent as the body via `response.send()`
+- **null/undefined**: Sets status 204 (No Content)
+- **Response**: Returned as-is
+
+---
+
+## 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
+
+---
+
+## Versioning & Stability
+
+- While in **v0.x**, the API may change between minor versions.
+- Once the API stabilizes, `@arikajs/dispatcher` will move to **v1.0** and follow **semver** strictly.
+
+---
+
+## Contributing
+
+Contributions are welcome, especially around:
+
+- Advanced dependency injection in controller methods
+- Performance optimizations for middleware execution
+- Enhanced error handling hooks
+- Support for attribute-based routing
+
+Before submitting a PR:
+
+- Run the test suite
+- Add tests for any new behavior
+- Keep the public API focused and well-documented
+
+---
+
+## License
+
+`@arikajs/dispatcher` is open-sourced software licensed under the **MIT license**.
+
+---
+
+## Philosophy
+
+> “Routing decides the path. Dispatcher executes the journey.”

package/dist/Contracts/Container.d.ts

@@ -0,0 +1,4 @@
+export interface Container {
+    make<T = any>(token: any): T;
+}
+//# sourceMappingURL=Container.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Container.d.ts","sourceRoot":"","sources":["../../src/Contracts/Container.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,SAAS;IACtB,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC;CAChC"}

package/dist/Contracts/Container.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Container.js.map

package/dist/Contracts/Container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Container.js","sourceRoot":"","sources":["../../src/Contracts/Container.ts"],"names":[],"mappings":""}

package/dist/Contracts/Http.d.ts

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

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

@@ -0,0 +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"}

package/dist/Contracts/Http.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Http.js.map

package/dist/Contracts/Http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Http.js","sourceRoot":"","sources":["../../src/Contracts/Http.ts"],"names":[],"mappings":""}

package/dist/Contracts/Router.d.ts

@@ -0,0 +1,9 @@
+export interface MatchedRoute {
+    route: {
+        handler: any;
+        middleware?: any[];
+        [key: string]: any;
+    };
+    params: Record<string, string>;
+}
+//# sourceMappingURL=Router.d.ts.map

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

@@ -0,0 +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"}

package/dist/Contracts/Router.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Router.js.map

package/dist/Contracts/Router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Router.js","sourceRoot":"","sources":["../../src/Contracts/Router.ts"],"names":[],"mappings":""}

package/dist/ControllerResolver.d.ts

@@ -0,0 +1,12 @@
+export declare class ControllerResolver {
+    private container;
+    constructor(container: any);
+    /**
+     * Resolve the controller instance and method name.
+     */
+    resolve(handler: any[]): {
+        controller: any;
+        method: string;
+    };
+}
+//# sourceMappingURL=ControllerResolver.d.ts.map

package/dist/ControllerResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ControllerResolver.d.ts","sourceRoot":"","sources":["../src/ControllerResolver.ts"],"names":[],"mappings":"AAAA,qBAAa,kBAAkB;IACf,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,GAAG;IAElC;;OAEG;IACI,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG;QAAE,UAAU,EAAE,GAAG,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAiBtE"}

package/dist/ControllerResolver.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ControllerResolver = void 0;
+class ControllerResolver {
+    constructor(container) {
+        this.container = container;
+    }
+    /**
+     * Resolve the controller instance and method name.
+     */
+    resolve(handler) {
+        const [controllerClass, method] = handler;
+        if (!this.container) {
+            throw new Error('Container required for controller resolution.');
+        }
+        const controller = this.container.make(controllerClass);
+        if (typeof controller[method] !== 'function') {
+            throw new Error(`Controller method "${method}" not found on ${controllerClass.name || controllerClass}.`);
+        }
+        return { controller, method };
+    }
+}
+exports.ControllerResolver = ControllerResolver;
+//# sourceMappingURL=ControllerResolver.js.map

package/dist/ControllerResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ControllerResolver.js","sourceRoot":"","sources":["../src/ControllerResolver.ts"],"names":[],"mappings":";;;AAAA,MAAa,kBAAkB;IAC3B,YAAoB,SAAc;QAAd,cAAS,GAAT,SAAS,CAAK;IAAI,CAAC;IAEvC;;OAEG;IACI,OAAO,CAAC,OAAc;QACzB,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC;QAE1C,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACrE,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,eAAe,CAAQ,CAAC;QAE/D,IAAI,OAAO,UAAU,CAAC,MAAM,CAAC,KAAK,UAAU,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CACX,sBAAsB,MAAM,kBAAkB,eAAe,CAAC,IAAI,IAAI,eAAe,GAAG,CAC3F,CAAC;QACN,CAAC;QAED,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAClC,CAAC;CACJ;AAvBD,gDAuBC"}

package/dist/Dispatcher.d.ts

@@ -0,0 +1,37 @@
+import { Request, Response } from './Contracts/Http';
+import { MatchedRoute } from './Contracts/Router';
+export declare class Dispatcher {
+    private container?;
+    private controllerResolver?;
+    private invoker;
+    private responseResolver;
+    private middlewareGroups;
+    private routeMiddleware;
+    private parameterBinders;
+    constructor(container?: any | undefined);
+    /**
+     * Set the container for resolving controllers.
+     */
+    setContainer(container: any): this;
+    /**
+     * Set the middleware groups mapping.
+     */
+    setMiddlewareGroups(groups: Record<string, any[]>): this;
+    /**
+     * Set the route middleware mapping.
+     */
+    setRouteMiddleware(middleware: Record<string, any>): this;
+    /**
+     * Register a route parameter binder.
+     */
+    bind(key: string, resolver: any): this;
+    /**
+     * Dispatch the matched route to its handler.
+     */
+    dispatch(matchedRoute: MatchedRoute, request: Request, response: Response): Promise<Response>;
+    /**
+     * Resolve route parameters using registered binders.
+     */
+    private resolveParameters;
+}
+//# sourceMappingURL=Dispatcher.d.ts.map

package/dist/Dispatcher.d.ts.map

@@ -0,0 +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"}

package/dist/Dispatcher.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Dispatcher = void 0;
+const ControllerResolver_1 = require("./ControllerResolver");
+const MethodInvoker_1 = require("./MethodInvoker");
+const ResponseResolver_1 = require("./ResponseResolver");
+const middleware_1 = require("@arikajs/middleware");
+class Dispatcher {
+    constructor(container) {
+        this.container = container;
+        this.middlewareGroups = {};
+        this.routeMiddleware = {};
+        this.parameterBinders = new Map();
+        this.invoker = new MethodInvoker_1.MethodInvoker();
+        this.responseResolver = new ResponseResolver_1.ResponseResolver();
+        if (container) {
+            this.controllerResolver = new ControllerResolver_1.ControllerResolver(container);
+        }
+    }
+    /**
+     * Set the container for resolving controllers.
+     */
+    setContainer(container) {
+        this.container = container;
+        this.controllerResolver = new ControllerResolver_1.ControllerResolver(container);
+        return this;
+    }
+    /**
+     * Set the middleware groups mapping.
+     */
+    setMiddlewareGroups(groups) {
+        this.middlewareGroups = groups;
+        return this;
+    }
+    /**
+     * Set the route middleware mapping.
+     */
+    setRouteMiddleware(middleware) {
+        this.routeMiddleware = middleware;
+        return this;
+    }
+    /**
+     * Register a route parameter binder.
+     */
+    bind(key, resolver) {
+        if (resolver && typeof resolver.findOrFail === 'function') {
+            this.parameterBinders.set(key, (value) => resolver.findOrFail(value));
+        }
+        else {
+            this.parameterBinders.set(key, resolver);
+        }
+        return this;
+    }
+    /**
+     * Dispatch the matched route to its handler.
+     */
+    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);
+        // 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;
+        }
+        else {
+            throw new Error('Invalid route handler.');
+        }
+        // 2. Prepare Middleware Pipeline
+        const pipeline = new middleware_1.Pipeline(this.container);
+        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);
+    }
+    /**
+     * Resolve route parameters using registered binders.
+     */
+    async resolveParameters(params) {
+        const resolved = { ...params };
+        for (const [key, value] of Object.entries(params)) {
+            if (this.parameterBinders.has(key)) {
+                const resolver = this.parameterBinders.get(key);
+                resolved[key] = await resolver(value);
+            }
+        }
+        return resolved;
+    }
+}
+exports.Dispatcher = Dispatcher;
+//# sourceMappingURL=Dispatcher.js.map

package/dist/Dispatcher.js.map

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

package/dist/MethodInvoker.d.ts

@@ -0,0 +1,11 @@
+import { Request } from './Contracts/Http';
+export declare class MethodInvoker {
+    /**
+     * 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>;
+}
+//# sourceMappingURL=MethodInvoker.d.ts.map

package/dist/MethodInvoker.d.ts.map

@@ -0,0 +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"}

package/dist/MethodInvoker.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MethodInvoker = void 0;
+class MethodInvoker {
+    /**
+     * Invoke the handler (closure or controller method) with injected parameters.
+     */
+    async invoke(handler, request, params) {
+        if (typeof handler === 'function') {
+            return await handler(request, ...Object.values(params));
+        }
+        const { controller, method } = handler;
+        return await controller[method](request, ...Object.values(params));
+    }
+}
+exports.MethodInvoker = MethodInvoker;
+//# sourceMappingURL=MethodInvoker.js.map

package/dist/MethodInvoker.js.map

@@ -0,0 +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"}

package/dist/ResponseResolver.d.ts

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

package/dist/ResponseResolver.d.ts.map

@@ -0,0 +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"}

package/dist/ResponseResolver.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseResolver = void 0;
+class ResponseResolver {
+    /**
+     * Resolve and normalize the handler return value into a Response object.
+     */
+    resolve(value, response) {
+        // If it's already a Response object (basic duck typing check for framework response)
+        if (value && typeof value.send === 'function' && typeof value.status === 'function') {
+            return value;
+        }
+        if (typeof value === 'object' && value !== null) {
+            return response.json(value);
+        }
+        // If it's a string, return as text or buffer
+        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));
+    }
+}
+exports.ResponseResolver = ResponseResolver;
+//# sourceMappingURL=ResponseResolver.js.map

package/dist/ResponseResolver.js.map

@@ -0,0 +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"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './Dispatcher';
+export * from './ControllerResolver';
+export * from './MethodInvoker';
+export * from './ResponseResolver';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Dispatcher"), exports);
+__exportStar(require("./ControllerResolver"), exports);
+__exportStar(require("./MethodInvoker"), exports);
+__exportStar(require("./ResponseResolver"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,uDAAqC;AACrC,kDAAgC;AAChC,qDAAmC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+    "name": "@arikajs/dispatcher",
+    "version": "0.1.0",
+    "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": {},
+    "devDependencies": {
+        "@types/node": "^20.11.24",
+        "typescript": "^5.3.3"
+    },
+    "author": "Prakash Tank"
+}