@kurdel/runtime 0.1.0-beta.1

package/lib/http/runtime-http-context-factory.js

@@ -0,0 +1,91 @@
+/**
+ * ## RuntimeHttpContextFactory
+ *
+ * Responsible for constructing per-request {@link HttpContext} objects.
+ *
+ * Each incoming request receives a fresh, isolated context encapsulating:
+ * - HTTP request/response wrappers provided by the adapter
+ * - parsed URL, query, params, body
+ * - matched route metadata (controller/action/schema/auth)
+ * - a request-scoped IoC container
+ * - typed constructors for {@link ActionResult}
+ *
+ * The context object is immutable except for `result`,
+ * which is later populated by the orchestrator and renderer.
+ */
+export class RuntimeHttpContextFactory {
+    /**
+     * Constructs a fully initialized {@link HttpContext} instance.
+     *
+     * @param req    - incoming HTTP request
+     * @param res    - outgoing HTTP response
+     * @param match  - router resolution result
+     * @param scope  - request-scoped IoC container
+     */
+    create(req, res, match, scope) {
+        const url = new URL(req.url ?? '/', 'http://internal');
+        const query = req.query ??
+            Object.fromEntries(url.searchParams.entries());
+        return {
+            /**
+             * Request-scoped IoC container.
+             *
+             * Used by:
+             * - authentication strategies
+             * - per-request services (logger, db, tracing)
+             * - custom middlewares
+             * - controllers needing scoped dependencies
+             */
+            scope,
+            /** Underlying request object */
+            req,
+            /** Underlying response object */
+            res,
+            /** Fully parsed URL of the current request */
+            url,
+            /** Parsed query parameters */
+            query,
+            /** Path parameters extracted from the matched route */
+            params: match.params,
+            /** Parsed request body (if available) */
+            body: req.body,
+            /** Matched route metadata (including schema and controller) */
+            route: match,
+            /**
+             * Authenticated user (if authentication middleware succeeded).
+             * Populated later in the pipeline.
+             */
+            user: undefined,
+            /** The latest computed ActionResult (populated later at runtime) */
+            result: undefined,
+            // ────────────────────────────────
+            // Response helper constructors
+            // ────────────────────────────────
+            /**
+             * Creates a JSON ActionResult with a given status and body.
+             */
+            json(status, body) {
+                return { kind: 'json', status, body };
+            },
+            /**
+             * Creates a plain text ActionResult.
+             */
+            text(status, body) {
+                return { kind: 'text', status, body };
+            },
+            /**
+             * Creates a redirect ActionResult to the given location.
+             */
+            redirect(status, location) {
+                return { kind: 'redirect', status, location };
+            },
+            /**
+             * Creates a standard HTTP 204 “No Content” ActionResult.
+             */
+            noContent() {
+                return { kind: 'empty', status: 204 };
+            },
+        };
+    }
+}
+//# sourceMappingURL=runtime-http-context-factory.js.map

package/lib/http/runtime-http-context-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-http-context-factory.js","sourceRoot":"","sources":["../../src/http/runtime-http-context-factory.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,yBAAyB;IACpC;;;;;;;OAOG;IACH,MAAM,CACJ,GAAgB,EAChB,GAAiB,EACjB,KAAiB,EACjB,KAAgB;QAEhB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,iBAAiB,CAAC,CAAC;QAEvD,MAAM,KAAK,GACT,GAAG,CAAC,KAAK;YACT,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC;QAEjD,OAAO;YACL;;;;;;;;eAQG;YACH,KAAK;YAEL,gCAAgC;YAChC,GAAG;YAEH,iCAAiC;YACjC,GAAG;YAEH,8CAA8C;YAC9C,GAAG;YAEH,8BAA8B;YAC9B,KAAK;YAEL,uDAAuD;YACvD,MAAM,EAAE,KAAK,CAAC,MAAM;YAEpB,yCAAyC;YACzC,IAAI,EAAE,GAAG,CAAC,IAAI;YAEd,+DAA+D;YAC/D,KAAK,EAAE,KAAK;YAEZ;;;eAGG;YACH,IAAI,EAAE,SAAS;YAEf,oEAAoE;YACpE,MAAM,EAAE,SAAS;YAEjB,mCAAmC;YACnC,+BAA+B;YAC/B,mCAAmC;YAEnC;;eAEG;YACH,IAAI,CAAC,MAAc,EAAE,IAAe;gBAClC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;YACxC,CAAC;YAED;;eAEG;YACH,IAAI,CAAC,MAAc,EAAE,IAAY;gBAC/B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;YACxC,CAAC;YAED;;eAEG;YACH,QAAQ,CAAC,MAAc,EAAE,QAAgB;gBACvC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;YAChD,CAAC;YAED;;eAEG;YACH,SAAS;gBACP,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;YACxC,CAAC;SACF,CAAC;IACJ,CAAC;CACF"}

package/lib/http/runtime-middleware-pipe.d.ts

@@ -0,0 +1,15 @@
+import type { HttpContext, Middleware, ActionResult } from '@kurdel/core/http';
+/**
+ * ## RuntimeMiddlewarePipe
+ *
+ * Executes middleware chain in declared order.
+ *
+ * - Stops on returned ActionResult
+ * - Stops on thrown error
+ * - Calls `next()` only when middleware yields `undefined`
+ */
+export declare class RuntimeMiddlewarePipe {
+    private readonly middlewares;
+    constructor(middlewares?: Middleware[]);
+    run(ctx: HttpContext, terminal?: () => Promise<ActionResult | void>): Promise<ActionResult | void>;
+}

package/lib/http/runtime-middleware-pipe.js

@@ -0,0 +1,31 @@
+/**
+ * ## RuntimeMiddlewarePipe
+ *
+ * Executes middleware chain in declared order.
+ *
+ * - Stops on returned ActionResult
+ * - Stops on thrown error
+ * - Calls `next()` only when middleware yields `undefined`
+ */
+export class RuntimeMiddlewarePipe {
+    constructor(middlewares = []) {
+        this.middlewares = middlewares;
+    }
+    async run(ctx, terminal) {
+        const dispatch = async (index) => {
+            if (index >= this.middlewares.length) {
+                return terminal ? await terminal() : undefined;
+            }
+            const mw = this.middlewares[index];
+            const result = await mw(ctx, () => dispatch(index + 1));
+            // 🚫 STOP: middleware returned an ActionResult
+            if (result !== undefined) {
+                return result;
+            }
+            // otherwise continue automatically (middleware already called next)
+            return undefined;
+        };
+        return dispatch(0);
+    }
+}
+//# sourceMappingURL=runtime-middleware-pipe.js.map

package/lib/http/runtime-middleware-pipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-middleware-pipe.js","sourceRoot":"","sources":["../../src/http/runtime-middleware-pipe.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,OAAO,qBAAqB;IAChC,YAA6B,cAA4B,EAAE;QAA9B,gBAAW,GAAX,WAAW,CAAmB;IAAG,CAAC;IAE/D,KAAK,CAAC,GAAG,CACP,GAAgB,EAChB,QAA6C;QAE7C,MAAM,QAAQ,GAAG,KAAK,EAAE,KAAa,EAAgC,EAAE;YACrE,IAAI,KAAK,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;gBACrC,OAAO,QAAQ,CAAC,CAAC,CAAC,MAAM,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;YACjD,CAAC;YAED,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YACnC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;YAExD,+CAA+C;YAC/C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,OAAO,MAAM,CAAC;YAChB,CAAC;YAED,oEAAoE;YACpE,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC;QAEF,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;CACF"}

package/lib/http/runtime-middleware-registry.d.ts

@@ -0,0 +1,18 @@
+import type { Newable } from '@kurdel/common';
+import type { Controller, Middleware, MiddlewareRegistry } from '@kurdel/core/http';
+import type { MiddlewareZone, MiddlewareRegistration } from '@kurdel/core/http';
+export declare class RuntimeMiddlewareRegistry implements MiddlewareRegistry {
+    private readonly global;
+    private readonly perController;
+    use(mw: Middleware, opts?: {
+        zone?: MiddlewareZone;
+        priority?: number;
+    }): void;
+    useFor(controller: Newable<Controller>, mw: Middleware, opts?: {
+        zone?: MiddlewareZone;
+        priority?: number;
+        action?: string;
+    }): void;
+    for(controller: Newable<Controller>, zone?: MiddlewareZone, action?: string): MiddlewareRegistration[];
+    all(zone?: MiddlewareZone): MiddlewareRegistration[];
+}

package/lib/http/runtime-middleware-registry.js

@@ -0,0 +1,39 @@
+export class RuntimeMiddlewareRegistry {
+    constructor() {
+        this.global = new Map();
+        this.perController = new Map();
+    }
+    use(mw, opts = {}) {
+        const zone = opts.zone ?? 'pre';
+        const priority = opts.priority ?? 0;
+        const entry = { use: mw, zone, priority };
+        if (!this.global.has(zone))
+            this.global.set(zone, []);
+        this.global.get(zone).push(entry);
+    }
+    useFor(controller, mw, opts = {}) {
+        const zone = opts.zone ?? 'pre';
+        const priority = opts.priority ?? 0;
+        const entry = { use: mw, zone, priority, action: opts.action };
+        if (!this.perController.has(controller)) {
+            this.perController.set(controller, new Map());
+        }
+        const zones = this.perController.get(controller);
+        if (!zones.has(zone))
+            zones.set(zone, []);
+        zones.get(zone).push(entry);
+    }
+    for(controller, zone = 'pre', action) {
+        const map = this.perController.get(controller);
+        if (!map)
+            return [];
+        const entries = map.get(zone) ?? [];
+        return entries
+            .filter(e => !e.action || e.action === action)
+            .sort((a, b) => b.priority - a.priority);
+    }
+    all(zone = 'pre') {
+        return (this.global.get(zone) ?? []).sort((a, b) => b.priority - a.priority);
+    }
+}
+//# sourceMappingURL=runtime-middleware-registry.js.map

package/lib/http/runtime-middleware-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-middleware-registry.js","sourceRoot":"","sources":["../../src/http/runtime-middleware-registry.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,yBAAyB;IAAtC;QACmB,WAAM,GAAG,IAAI,GAAG,EAA4C,CAAC;QAC7D,kBAAa,GAAG,IAAI,GAAG,EAGrC,CAAC;IA4CN,CAAC;IA1CC,GAAG,CAAC,EAAc,EAAE,OAAqD,EAAE;QACzE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;QACpC,MAAM,KAAK,GAA2B,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAClE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,CACJ,UAA+B,EAC/B,EAAc,EACd,OAAsE,EAAE;QAExE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;QACpC,MAAM,KAAK,GAA2B,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QAEvF,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACxC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAChD,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,CAAE,CAAC;QAClD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1C,KAAK,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,GAAG,CACD,UAA+B,EAC/B,OAAuB,KAAK,EAC5B,MAAe;QAEf,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC/C,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,CAAC;QAEpB,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACpC,OAAO,OAAO;aACX,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC;aAC7C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED,GAAG,CAAC,OAAuB,KAAK;QAC9B,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC/E,CAAC;CACF"}

package/lib/http/runtime-request-orchestrator.d.ts

@@ -0,0 +1,21 @@
+import type { HttpRequest, HttpResponse } from '@kurdel/common';
+import type { Container } from '@kurdel/ioc';
+import type { ResponseRenderer, Router, MiddlewareRegistry } from '@kurdel/core/http';
+/**
+ * ## RuntimeRequestOrchestrator
+ *
+ * Deterministic pipeline:
+ * resolve → validate → auth → pre → controller → render → post → error → final
+ */
+export declare class RuntimeRequestOrchestrator {
+    private readonly router;
+    private readonly renderer;
+    private readonly registry;
+    private readonly contextFactory;
+    private readonly controllerPipe;
+    constructor(router: Router, renderer: ResponseRenderer, registry: MiddlewareRegistry);
+    execute(req: HttpRequest, res: HttpResponse, scope: Container): Promise<void>;
+    private collect;
+    private runZone;
+    private runFinal;
+}

package/lib/http/runtime-request-orchestrator.js

@@ -0,0 +1,114 @@
+import { HttpError } from '@kurdel/core/http';
+import { ControllerActionMissingResultError } from '../app/errors/controller-action-missing-result-error.js';
+import { RuntimeHttpContextFactory } from '../http/runtime-http-context-factory.js';
+import { RuntimeControllerPipe } from '../http/runtime-controller-pipe.js';
+import { RuntimeMiddlewarePipe } from '../http/runtime-middleware-pipe.js';
+/**
+ * ## RuntimeRequestOrchestrator
+ *
+ * Deterministic pipeline:
+ * resolve → validate → auth → pre → controller → render → post → error → final
+ */
+export class RuntimeRequestOrchestrator {
+    constructor(router, renderer, registry) {
+        this.router = router;
+        this.renderer = renderer;
+        this.registry = registry;
+        this.contextFactory = new RuntimeHttpContextFactory();
+        this.controllerPipe = new RuntimeControllerPipe();
+    }
+    async execute(req, res, scope) {
+        const method = req.method ?? 'GET';
+        const url = req.url ?? '/';
+        // --- 1️⃣ Resolve route ---
+        const routeMatch = this.router.resolve(method, url, scope);
+        if (!routeMatch) {
+            this.renderer.handleError(res, new HttpError(404, 'Not Found'));
+            return;
+        }
+        // --- 2️⃣ Build HttpContext ---
+        const ctx = this.contextFactory.create(req, res, routeMatch, scope);
+        // --- 3️⃣ Validation ---
+        try {
+            const schema = routeMatch.schema;
+            if (schema?.body)
+                ctx.body = await schema.body.validate(ctx.body);
+            if (schema?.params)
+                ctx.params = await schema.params.validate(ctx.params);
+            if (schema?.query)
+                ctx.query = await schema.query.validate(ctx.query);
+        }
+        catch (err) {
+            this.renderer.handleError(res, err);
+            await this.runFinal(ctx, routeMatch);
+            return;
+        }
+        try {
+            // --- 4️⃣ AUTH zone ---
+            const authResult = await this.runZone('auth', ctx, routeMatch);
+            if (authResult) {
+                ctx.result = authResult;
+                this.renderer.render(res, authResult);
+                await this.runFinal(ctx, routeMatch);
+                return;
+            }
+            // --- 5️⃣ PRE middleware ---
+            const preResult = await this.runZone('pre', ctx, routeMatch);
+            if (preResult) {
+                ctx.result = preResult;
+                this.renderer.render(res, preResult);
+                await this.runFinal(ctx, routeMatch);
+                return;
+            }
+            // --- 6️⃣ Controller execution ---
+            const result = await this.controllerPipe.run(routeMatch.controller, ctx, routeMatch.action);
+            if (typeof result === 'undefined') {
+                throw new ControllerActionMissingResultError(routeMatch.controller, routeMatch.action);
+            }
+            ctx.result = result;
+            this.renderer.render(res, result);
+            // --- 7️⃣ POST middleware (only if response was rendered) ---
+            if (res.sent) {
+                await this.runZone('post', ctx, routeMatch);
+            }
+        }
+        catch (err) {
+            // --- 8️⃣ ERROR middleware zone ---
+            const errorResult = await this.runZone('error', ctx, routeMatch, err);
+            if (errorResult && !res.sent) {
+                this.renderer.render(res, errorResult);
+            }
+            else if (!res.sent) {
+                this.renderer.handleError(res, err);
+            }
+        }
+        finally {
+            // --- 9️⃣ FINAL always executed ---
+            await this.runFinal(ctx, routeMatch);
+        }
+    }
+    // ---------------------------------------------------------------------
+    // Middleware helpers
+    // ---------------------------------------------------------------------
+    collect(zone, match) {
+        const ctor = match.controller?.constructor;
+        return [
+            ...this.registry.all(zone),
+            ...(ctor ? this.registry.for(ctor, zone, match.action) : []),
+        ].map(m => m.use);
+    }
+    async runZone(zone, ctx, match, error) {
+        const fns = this.collect(zone, match);
+        if (!fns.length)
+            return undefined;
+        const pipe = new RuntimeMiddlewarePipe(fns);
+        if (zone === 'error' && error !== undefined) {
+            ctx.error = error;
+        }
+        return pipe.run(ctx);
+    }
+    async runFinal(ctx, match) {
+        return this.runZone('final', ctx, match);
+    }
+}
+//# sourceMappingURL=runtime-request-orchestrator.js.map

package/lib/http/runtime-request-orchestrator.js.map

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

package/lib/http/runtime-response-renderer.d.ts

@@ -0,0 +1,12 @@
+import type { ActionResult, ResponseRenderer } from '@kurdel/core/http';
+import type { HttpResponse } from '@kurdel/common';
+/**
+ * Handles rendering of ActionResult into HttpResponse
+ * and unified error translation.
+ */
+export declare class RuntimeResponseRenderer implements ResponseRenderer {
+    private readonly platformRender;
+    constructor(platformRender: (res: HttpResponse, result: ActionResult) => void);
+    render(res: HttpResponse, result: ActionResult | void): void;
+    handleError(res: HttpResponse, err: unknown): void;
+}

package/lib/http/runtime-response-renderer.js

@@ -0,0 +1,37 @@
+import { HttpError } from '@kurdel/core/http';
+/**
+ * Handles rendering of ActionResult into HttpResponse
+ * and unified error translation.
+ */
+export class RuntimeResponseRenderer {
+    constructor(platformRender) {
+        this.platformRender = platformRender;
+    }
+    render(res, result) {
+        if (!res.sent && result) {
+            this.platformRender(res, result);
+        }
+    }
+    handleError(res, err) {
+        if (res.sent)
+            return;
+        if (err instanceof HttpError) {
+            this.platformRender(res, {
+                kind: 'json',
+                status: err.status,
+                body: {
+                    error: err.message,
+                    details: err.details,
+                },
+            });
+        }
+        else {
+            this.platformRender(res, {
+                kind: 'json',
+                status: 500,
+                body: { error: 'Internal Server Error' },
+            });
+        }
+    }
+}
+//# sourceMappingURL=runtime-response-renderer.js.map

package/lib/http/runtime-response-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-response-renderer.js","sourceRoot":"","sources":["../../src/http/runtime-response-renderer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG9C;;;GAGG;AACH,MAAM,OAAO,uBAAuB;IAClC,YAA6B,cAAiE;QAAjE,mBAAc,GAAd,cAAc,CAAmD;IAAG,CAAC;IAElG,MAAM,CAAC,GAAiB,EAAE,MAA2B;QACnD,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,MAAM,EAAE,CAAC;YACxB,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,WAAW,CAAC,GAAiB,EAAE,GAAY;QACzC,IAAI,GAAG,CAAC,IAAI;YAAE,OAAO;QAErB,IAAI,GAAG,YAAY,SAAS,EAAE,CAAC;YAC7B,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE;gBACvB,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,IAAI,EAAE;oBACJ,KAAK,EAAE,GAAG,CAAC,OAAO;oBAClB,OAAO,EAAE,GAAG,CAAC,OAAoB;iBAClC;aACF,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE;gBACvB,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,GAAG;gBACX,IAAI,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE;aACzC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}

package/lib/http/runtime-router.d.ts

@@ -0,0 +1,37 @@
+import type { Container } from '@kurdel/ioc';
+import type { Method, ControllerConfig, ControllerResolver, Router, RouteMatch, RouteAuth } from '@kurdel/core/http';
+export declare function mergeAuth(base?: RouteAuth, override?: RouteAuth): RouteAuth | undefined;
+/**
+ * ## RuntimeRouter
+ *
+ * Responsible for:
+ * - extracting metadata from controller `routes`
+ * - compiling patterns into a fast lookup table
+ * - performing deterministic route matching at runtime
+ *
+ * Initialization stages:
+ *   1️⃣ iterate controller configs
+ *   2️⃣ instantiate controller *only to read routes*
+ *   3️⃣ extract `ROUTE_META` from handlers
+ *   4️⃣ normalize `prefix + path`
+ *   5️⃣ compile regex + param keys
+ *   6️⃣ store immutable route entries
+ */
+export declare class RuntimeRouter implements Router {
+    /** Immutable table of compiled routes. */
+    private readonly entries;
+    /** Controller instance resolver (DI-based). */
+    private resolver;
+    /**
+     * Builds the route table by reading controller metadata.
+     */
+    init(resolver: ControllerResolver, controllerConfigs: ControllerConfig[]): void;
+    /**
+     * Matches an incoming HTTP request to a controller/action.
+     */
+    resolve(method: Method, url: string, scope: Container): RouteMatch | null;
+    /**
+     * Adds a compiled route entry into the lookup table.
+     */
+    private addEntry;
+}

package/lib/http/runtime-router.js

@@ -0,0 +1,135 @@
+import { ROUTE_META } from '@kurdel/core/http';
+/**
+ * Joins two path segments safely, preventing `//` occurrences.
+ */
+function joinPaths(a, b) {
+    return `${a.replace(/\/+$/, '')}/${b.replace(/^\/+/, '')}`;
+}
+/**
+ * Extracts path keys and compiles a regex matcher.
+ */
+function compilePath(path) {
+    const keys = [];
+    const pattern = path
+        .split('/')
+        .filter(Boolean)
+        .map(segment => {
+        if (segment.startsWith(':')) {
+            keys.push(segment.slice(1));
+            return '([^/]+)';
+        }
+        return segment;
+    })
+        .join('/');
+    const regex = pattern ? new RegExp(`^/${pattern}/?$`) : /^\/$/;
+    return { regex, keys };
+}
+export function mergeAuth(base, override) {
+    if (!base && !override)
+        return undefined;
+    return {
+        public: override?.public ?? base?.public,
+        strategy: override?.strategy ?? base?.strategy,
+        roles: override?.roles ?? base?.roles,
+    };
+}
+/**
+ * ## RuntimeRouter
+ *
+ * Responsible for:
+ * - extracting metadata from controller `routes`
+ * - compiling patterns into a fast lookup table
+ * - performing deterministic route matching at runtime
+ *
+ * Initialization stages:
+ *   1️⃣ iterate controller configs
+ *   2️⃣ instantiate controller *only to read routes*
+ *   3️⃣ extract `ROUTE_META` from handlers
+ *   4️⃣ normalize `prefix + path`
+ *   5️⃣ compile regex + param keys
+ *   6️⃣ store immutable route entries
+ */
+export class RuntimeRouter {
+    constructor() {
+        /** Immutable table of compiled routes. */
+        this.entries = [];
+    }
+    /**
+     * Builds the route table by reading controller metadata.
+     */
+    init(resolver, controllerConfigs) {
+        this.resolver = resolver;
+        for (const { use: ControllerClass, prefix = '', auth: ctrlAuth = {} } of controllerConfigs) {
+            /**
+             * We instantiate the controller *only* to read its static `routes` definition.
+             *
+             * This instance:
+             *   - is not created by DI
+             *   - receives no real dependencies (`{}` is enough)
+             *   - is never used to execute actions
+             *
+             * During request handling, controllers are instantiated per-scope
+             * via ControllerResolver — this initialization step only extracts metadata.
+             */
+            const { routes } = new ControllerClass({});
+            for (const [action, handler] of Object.entries(routes)) {
+                const meta = handler[ROUTE_META];
+                if (!meta)
+                    continue;
+                const fullPath = joinPaths(prefix, meta.path);
+                const { method, schema } = meta;
+                const auth = mergeAuth(ctrlAuth, meta.auth);
+                this.addEntry(method, fullPath, ControllerClass, action, auth, schema);
+            }
+        }
+        // Optional debug output
+        if (process.env.DEBUG_ROUTES) {
+            console.log('[router] Registered:', this.entries.map(e => `${e.method} ${e.path}`));
+        }
+    }
+    /**
+     * Matches an incoming HTTP request to a controller/action.
+     */
+    resolve(method, url, scope) {
+        const pathname = (url ?? '/').split('?')[0].replace(/\\/g, '/');
+        for (const entry of this.entries) {
+            if (entry.method !== method)
+                continue;
+            const match = entry.regex.exec(pathname);
+            if (!match)
+                continue;
+            const params = {};
+            entry.keys.forEach((key, i) => {
+                params[key] = match[i + 1];
+            });
+            const controller = this.resolver.resolve(entry.token, scope);
+            return {
+                controller,
+                method,
+                action: entry.action,
+                path: entry.path,
+                params,
+                auth: entry.auth,
+                schema: entry.schema,
+            };
+        }
+        return null;
+    }
+    /**
+     * Adds a compiled route entry into the lookup table.
+     */
+    addEntry(method, path, token, action, auth, schema) {
+        const { regex, keys } = compilePath(path);
+        this.entries.push({
+            method,
+            path,
+            regex,
+            keys,
+            token,
+            action,
+            auth,
+            schema,
+        });
+    }
+}
+//# sourceMappingURL=runtime-router.js.map

package/lib/http/runtime-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-router.js","sourceRoot":"","sources":["../../src/http/runtime-router.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAgB/C;;GAEG;AACH,SAAS,SAAS,CAAC,CAAS,EAAE,CAAS;IACrC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,IAAY;IAC/B,MAAM,IAAI,GAAa,EAAE,CAAC;IAE1B,MAAM,OAAO,GAAG,IAAI;SACjB,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,OAAO,CAAC,EAAE;QACb,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;SACD,IAAI,CAAC,GAAG,CAAC,CAAC;IAEb,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAE/D,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAgB,EAAE,QAAoB;IAC9D,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEzC,OAAO;QACL,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,IAAI,EAAE,MAAM;QACxC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,IAAI,IAAI,EAAE,QAAQ;QAC9C,KAAK,EAAE,QAAQ,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK;KACtC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,aAAa;IAA1B;QACE,0CAA0C;QACzB,YAAO,GAAY,EAAE,CAAC;IAwGzC,CAAC;IAnGC;;OAEG;IACI,IAAI,CAAC,QAA4B,EAAE,iBAAqC;QAC7E,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAEzB,KAAK,MAAM,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,GAAG,EAAE,EAAE,IAAI,iBAAiB,EAAE,CAAC;YAC3F;;;;;;;;;;eAUG;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,eAAe,CAAC,EAAS,CAAC,CAAC;YAElD,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACvD,MAAM,IAAI,GAA2B,OAAe,CAAC,UAAU,CAAC,CAAC;gBACjE,IAAI,CAAC,IAAI;oBAAE,SAAS;gBAEpB,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC9C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;gBAEhC,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBAE5C,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YACzE,CAAC;QACH,CAAC;QAED,wBAAwB;QACxB,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CACT,sBAAsB,EACtB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAC/C,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACI,OAAO,CAAC,MAAc,EAAE,GAAW,EAAE,KAAgB;QAC1D,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAEhE,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM;gBAAE,SAAS;YAEtC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACzC,IAAI,CAAC,KAAK;gBAAE,SAAS;YAErB,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;gBAC5B,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC7B,CAAC,CAAC,CAAC;YAEH,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAkB,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAE9E,OAAO;gBACL,UAAU;gBACV,MAAM;gBACN,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,MAAM;gBACN,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,QAAQ,CACd,MAAc,EACd,IAAY,EACZ,KAA8B,EAC9B,MAAc,EACd,IAAgB,EAChB,MAAoB;QAEpB,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAE1C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;YAChB,MAAM;YACN,IAAI;YACJ,KAAK;YACL,IAAI;YACJ,KAAK;YACL,MAAM;YACN,IAAI;YACJ,MAAM;SACP,CAAC,CAAC;IACL,CAAC;CACF"}

package/lib/index.d.ts

@@ -0,0 +1,3 @@
+export * as app from './app/index.js';
+export * as http from './http/index.js';
+export * as middlewares from './middlewares/index.js';

package/lib/index.js

@@ -0,0 +1,4 @@
+export * as app from './app/index.js';
+export * as http from './http/index.js';
+export * as middlewares from './middlewares/index.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,WAAW,MAAM,wBAAwB,CAAC"}

package/lib/middlewares/create-validator.d.ts

@@ -0,0 +1,7 @@
+import type { ValidationError, SchemaValidator } from '@kurdel/core/http';
+/**
+ * Generic adapter factory for schema validators (Zod, Joi, Yup, etc.)
+ *
+ * Wraps any validation library into a unified `SchemaValidator` interface.
+ */
+export declare function createValidator<T>(parse: (data: unknown) => T | Promise<T>, mapError: (err: unknown) => ValidationError | null): SchemaValidator<T>;

package/lib/middlewares/create-validator.js

@@ -0,0 +1,21 @@
+/**
+ * Generic adapter factory for schema validators (Zod, Joi, Yup, etc.)
+ *
+ * Wraps any validation library into a unified `SchemaValidator` interface.
+ */
+export function createValidator(parse, mapError) {
+    return {
+        async validate(data) {
+            try {
+                return await parse(data);
+            }
+            catch (err) {
+                const mapped = mapError(err);
+                if (mapped)
+                    throw mapped;
+                throw err;
+            }
+        },
+    };
+}
+//# sourceMappingURL=create-validator.js.map

package/lib/middlewares/create-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-validator.js","sourceRoot":"","sources":["../../src/middlewares/create-validator.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAwC,EACxC,QAAkD;IAElD,OAAO;QACL,KAAK,CAAC,QAAQ,CAAC,IAAa;YAC1B,IAAI,CAAC;gBACH,OAAO,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;gBAC7B,IAAI,MAAM;oBAAE,MAAM,MAAM,CAAC;gBACzB,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/lib/middlewares/error-handle.d.ts

@@ -0,0 +1,2 @@
+import type { Middleware } from '@kurdel/core/http';
+export declare const errorHandler: Middleware;