@kurdel/runtime-node 0.1.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Andrii Sorokin
+
+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,36 @@
+# @kurdel/runtime-node
+
+Native **Node.js HTTP adapter** for Kurdel runtime.  
+Implements the `ServerAdapter` interface using the built-in `http` module.
+
+---
+
+## 📦 Installation
+
+```bash
+npm install @kurdel/runtime-node
+```
+
+---
+
+## 🧠 Responsibilities
+
+* Create and manage a native Node HTTP server
+* Adapt Node’s `IncomingMessage` / `ServerResponse` to Kurdel `HttpRequest` / `HttpResponse`
+* Dispatch incoming requests to the runtime handler
+
+---
+
+## 🔧 Example
+
+```ts
+import { createNodeApplication } from '@kurdel/facade';
+const app = await createNodeApplication({ modules: [] });
+app.listen(3000);
+```
+
+---
+
+## 📄 License
+
+MIT © Andrii Sorokin

package/lib/http/index.d.ts

@@ -0,0 +1,2 @@
+export * from './native-http-server-adapter.js';
+export * from './native-req-res-adapters.js';

package/lib/http/index.js

@@ -0,0 +1,3 @@
+export * from './native-http-server-adapter.js';
+export * from './native-req-res-adapters.js';
+//# sourceMappingURL=index.js.map

package/lib/http/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC"}

package/lib/http/native-http-server-adapter.d.ts

@@ -0,0 +1,29 @@
+import type { Server } from 'node:http';
+import type { HttpRequest, HttpResponse } from '@kurdel/common';
+import type { ServerAdapter } from '@kurdel/core/http';
+/**
+ * Node.js implementation of ServerAdapter.
+ *
+ * Responsibilities:
+ * - Listen for native HTTP requests
+ * - Adapt Node's IncomingMessage / ServerResponse into
+ *   framework-agnostic HttpRequest / HttpResponse
+ * - Delegate execution to the runtime handler
+ */
+export declare class NativeHttpServerAdapter implements ServerAdapter<HttpRequest, HttpResponse> {
+    private readonly server;
+    private handler?;
+    constructor();
+    /** Core dispatch: adapt and delegate to the framework handler. */
+    private dispatch;
+    /** Minimal fallback when handler throws unexpectedly. */
+    private handleDispatchError;
+    /** Register the runtime handler invoked for every request. */
+    on(cb: (req: HttpRequest, res: HttpResponse) => void | Promise<void>): void;
+    /** Start listening for HTTP connections. */
+    listen(port: number, hostOrCb?: string | (() => void), cb?: () => void): void;
+    /** Gracefully close the underlying HTTP server. */
+    close(): Promise<void>;
+    /** Expose the raw Node.js server (used by the runtime). */
+    raw<T = Server>(): T;
+}

package/lib/http/native-http-server-adapter.js

@@ -0,0 +1,65 @@
+import { createServer } from 'node:http';
+import { adaptNodeRequest, adaptNodeResponse } from '../http/native-req-res-adapters.js';
+/**
+ * Node.js implementation of ServerAdapter.
+ *
+ * Responsibilities:
+ * - Listen for native HTTP requests
+ * - Adapt Node's IncomingMessage / ServerResponse into
+ *   framework-agnostic HttpRequest / HttpResponse
+ * - Delegate execution to the runtime handler
+ */
+export class NativeHttpServerAdapter {
+    constructor() {
+        // Delegate each incoming request to the unified dispatch method
+        this.server = createServer((req, res) => this.dispatch(req, res));
+    }
+    /** Core dispatch: adapt and delegate to the framework handler. */
+    async dispatch(req, res) {
+        if (!this.handler) {
+            res.statusCode = 404;
+            res.end('Not Found');
+            return;
+        }
+        try {
+            const request = await adaptNodeRequest(req);
+            const response = adaptNodeResponse(res);
+            await Promise.resolve(this.handler(request, response));
+        }
+        catch (err) {
+            this.handleDispatchError(res, err);
+        }
+    }
+    /** Minimal fallback when handler throws unexpectedly. */
+    handleDispatchError(res, err) {
+        console.error('Unhandled request error:', err);
+        if (res.headersSent)
+            return;
+        const status = err?.status ?? 500;
+        const message = err?.message ?? 'Internal Server Error';
+        res.statusCode = status;
+        res.setHeader('Content-Type', 'text/plain; charset=utf-8');
+        res.end(`${status}: ${message}`);
+    }
+    /** Register the runtime handler invoked for every request. */
+    on(cb) {
+        this.handler = cb;
+    }
+    /** Start listening for HTTP connections. */
+    listen(port, hostOrCb, cb) {
+        const done = (typeof hostOrCb === 'function' ? hostOrCb : cb) ?? (() => { });
+        if (typeof hostOrCb === 'string')
+            this.server.listen(port, hostOrCb, done);
+        else
+            this.server.listen(port, done);
+    }
+    /** Gracefully close the underlying HTTP server. */
+    async close() {
+        await new Promise((resolve, reject) => this.server.close(err => (err ? reject(err) : resolve())));
+    }
+    /** Expose the raw Node.js server (used by the runtime). */
+    raw() {
+        return this.server;
+    }
+}
+//# sourceMappingURL=native-http-server-adapter.js.map

package/lib/http/native-http-server-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-http-server-adapter.js","sourceRoot":"","sources":["../../src/http/native-http-server-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAKzC,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAE1F;;;;;;;;GAQG;AACH,MAAM,OAAO,uBAAuB;IAIlC;QACE,gEAAgE;QAChE,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IACpE,CAAC;IAED,kEAAkE;IAC1D,KAAK,CAAC,QAAQ,CAAC,GAAoB,EAAE,GAAmB;QAC9D,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;YACrB,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,GAAG,CAAC,CAAC;YAC5C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;YAExC,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,yDAAyD;IACjD,mBAAmB,CAAC,GAAmB,EAAE,GAAY;QAC3D,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,GAAG,CAAC,CAAC;QAE/C,IAAI,GAAG,CAAC,WAAW;YAAE,OAAO;QAE5B,MAAM,MAAM,GAAI,GAAW,EAAE,MAAM,IAAI,GAAG,CAAC;QAC3C,MAAM,OAAO,GAAI,GAAW,EAAE,OAAO,IAAI,uBAAuB,CAAC;QAEjE,GAAG,CAAC,UAAU,GAAG,MAAM,CAAC;QACxB,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,2BAA2B,CAAC,CAAC;QAC3D,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,KAAK,OAAO,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,8DAA8D;IAC9D,EAAE,CAAC,EAAiE;QAClE,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,CAAC;IAED,4CAA4C;IAC5C,MAAM,CAAC,IAAY,EAAE,QAAgC,EAAE,EAAe;QACpE,MAAM,IAAI,GAAG,CAAC,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC5E,IAAI,OAAO,QAAQ,KAAK,QAAQ;YAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;;YACtE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,mDAAmD;IACnD,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAC1C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAC1D,CAAC;IACJ,CAAC;IAED,2DAA2D;IAC3D,GAAG;QACD,OAAO,IAAI,CAAC,MAAsB,CAAC;IACrC,CAAC;CACF"}

package/lib/http/native-req-res-adapters.d.ts

@@ -0,0 +1,27 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { HttpRequest, HttpResponseWithHeaders } from '@kurdel/common';
+/**
+ * Adapts a native Node.js `IncomingMessage` into a platform-neutral `HttpRequest`.
+ *
+ * Responsibilities:
+ * - Read the request body (as text)
+ * - Parse JSON if `Content-Type` is `application/json`
+ * - Normalize headers into a consistent object
+ * - Extract query parameters from URL
+ *
+ * @param req - The native Node.js HTTP request object
+ * @returns A platform-agnostic {@link HttpRequest} used by Kurdel runtime
+ */
+export declare function adaptNodeRequest(req: IncomingMessage): Promise<HttpRequest>;
+/**
+ * Adapts a native Node.js `ServerResponse` into a framework-agnostic `HttpResponse`.
+ *
+ * Responsibilities:
+ * - Provide a unified API (`status()`, `send()`, `json()`, etc.)
+ * - Automatically manage headers and content types
+ * - Support streaming and manual writes (`write()` / `end()`)
+ *
+ * @param res - The native Node.js ServerResponse instance
+ * @returns Wrapped {@link HttpResponseWithHeaders} compatible with Kurdel runtime
+ */
+export declare function adaptNodeResponse(res: ServerResponse): HttpResponseWithHeaders;

package/lib/http/native-req-res-adapters.js

@@ -0,0 +1,136 @@
+import { DEFAULT_INTERNAL_BASE } from '@kurdel/common';
+/**
+ * Adapts a native Node.js `IncomingMessage` into a platform-neutral `HttpRequest`.
+ *
+ * Responsibilities:
+ * - Read the request body (as text)
+ * - Parse JSON if `Content-Type` is `application/json`
+ * - Normalize headers into a consistent object
+ * - Extract query parameters from URL
+ *
+ * @param req - The native Node.js HTTP request object
+ * @returns A platform-agnostic {@link HttpRequest} used by Kurdel runtime
+ */
+export async function adaptNodeRequest(req) {
+    const chunks = [];
+    // Collect request body (streamed)
+    if (Symbol.asyncIterator in req) {
+        for await (const chunk of req) {
+            chunks.push(chunk);
+        }
+    }
+    const rawBody = Buffer.concat(chunks).toString('utf8').trim();
+    // Normalize headers
+    const nodeHeaders = req.headers ?? {};
+    const headers = {};
+    for (const [key, value] of Object.entries(nodeHeaders)) {
+        if (value !== undefined)
+            headers[key] = value;
+    }
+    // Parse JSON body if applicable
+    const contentType = (req.headers?.['content-type'] ?? '').toString();
+    let parsedBody;
+    if (contentType.includes('application/json')) {
+        try {
+            parsedBody = rawBody ? JSON.parse(rawBody) : undefined;
+        }
+        catch {
+            parsedBody = undefined;
+        }
+    }
+    // Build absolute URL using default internal base (e.g., http://internal.local)
+    const url = new URL(req.url ?? '/', DEFAULT_INTERNAL_BASE);
+    // Extract query parameters
+    const query = {};
+    url.searchParams.forEach((value, key) => {
+        if (key in query) {
+            const prev = query[key];
+            query[key] = Array.isArray(prev) ? [...prev, value] : [prev, value];
+        }
+        else {
+            query[key] = value;
+        }
+    });
+    // Return normalized HttpRequest
+    return {
+        method: req.method ?? 'GET',
+        url: req.url ?? '/',
+        headers,
+        body: parsedBody,
+        query,
+        params: {},
+    };
+}
+/**
+ * Adapts a native Node.js `ServerResponse` into a framework-agnostic `HttpResponse`.
+ *
+ * Responsibilities:
+ * - Provide a unified API (`status()`, `send()`, `json()`, etc.)
+ * - Automatically manage headers and content types
+ * - Support streaming and manual writes (`write()` / `end()`)
+ *
+ * @param res - The native Node.js ServerResponse instance
+ * @returns Wrapped {@link HttpResponseWithHeaders} compatible with Kurdel runtime
+ */
+export function adaptNodeResponse(res) {
+    const response = {
+        get sent() {
+            return res.writableEnded || res.destroyed;
+        },
+        raw: res,
+        status(code) {
+            res.statusCode = code;
+            return this;
+        },
+        send(body) {
+            if (body == null) {
+                res.end();
+                return this;
+            }
+            const content = typeof body === 'object' ? JSON.stringify(body) : String(body);
+            if (!res.getHeader('Content-Type')) {
+                res.setHeader('Content-Type', typeof body === 'object' ? 'application/json; charset=utf-8' : 'text/plain; charset=utf-8');
+            }
+            res.end(content);
+            return this;
+        },
+        json(body) {
+            res.statusCode = res.statusCode || 200;
+            res.setHeader('Content-Type', 'application/json; charset=utf-8');
+            res.end(JSON.stringify(body));
+            return this;
+        },
+        redirect(code, location) {
+            res.statusCode = code;
+            res.setHeader('Location', location);
+            res.end();
+            return this;
+        },
+        setHeader(name, value) {
+            res.setHeader(name, value);
+            return this;
+        },
+        getHeader(name) {
+            const value = res.getHeader(name);
+            return typeof value === 'string'
+                ? value
+                : Array.isArray(value)
+                    ? value.join(', ')
+                    : undefined;
+        },
+        type(mime) {
+            this.setHeader('Content-Type', mime);
+            return this;
+        },
+        write(chunk) {
+            res.write(chunk);
+            return this;
+        },
+        end(chunk) {
+            res.end(chunk);
+            return this;
+        },
+    };
+    return response;
+}
+//# sourceMappingURL=native-req-res-adapters.js.map

package/lib/http/native-req-res-adapters.js.map

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

package/lib/http/render-node-action-result.d.ts

@@ -0,0 +1,7 @@
+import type { HttpResponse } from '@kurdel/common';
+import type { ActionResult } from '@kurdel/core/http';
+/**
+ * Node-specific renderer for ActionResult.
+ * Handles JSON, text, HTML, redirects, empties and stream bodies.
+ */
+export declare function renderNodeActionResult(res: HttpResponse, r: ActionResult): void;

package/lib/http/render-node-action-result.js

@@ -0,0 +1,48 @@
+/**
+ * Node-specific renderer for ActionResult.
+ * Handles JSON, text, HTML, redirects, empties and stream bodies.
+ */
+export function renderNodeActionResult(res, r) {
+    switch (r.kind) {
+        case 'json':
+            res.status(r.status).json(r.body);
+            break;
+        case 'text':
+            res.status(r.status).send(r.body);
+            break;
+        case 'html': {
+            const withHeaders = res;
+            withHeaders.setHeader?.('Content-Type', r.contentType ?? 'text/html; charset=utf-8');
+            res.status(r.status).send(r.body);
+            break;
+        }
+        case 'redirect':
+            res.redirect(r.status, r.location);
+            break;
+        case 'empty':
+            res.status(r.status).send('');
+            break;
+        case 'stream': {
+            const s = r;
+            const withHeaders = res;
+            const nodeRes = res.raw;
+            if (s.contentType)
+                withHeaders.setHeader?.('Content-Type', s.contentType);
+            if (s.contentLength)
+                withHeaders.setHeader?.('Content-Length', String(s.contentLength));
+            res.status(s.status);
+            const stream = s.body;
+            if (stream && typeof stream.pipe === 'function' && typeof nodeRes.write === 'function') {
+                // ✅ Pipe directly into native Node response
+                stream.pipe(nodeRes);
+            }
+            else {
+                res.status(500).send('Invalid stream body');
+            }
+            break;
+        }
+        default:
+            res.status(500).send('Unsupported response type');
+    }
+}
+//# sourceMappingURL=render-node-action-result.js.map

package/lib/http/render-node-action-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-node-action-result.js","sourceRoot":"","sources":["../../src/http/render-node-action-result.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAiB,EAAE,CAAe;IACvE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,MAAM;YACT,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM;QAER,KAAK,MAAM;YACT,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM;QAER,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,WAAW,GAAG,GAA8B,CAAC;YACnD,WAAW,CAAC,SAAS,EAAE,CAAC,cAAc,EAAE,CAAC,CAAC,WAAW,IAAI,0BAA0B,CAAC,CAAC;YACrF,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM;QACR,CAAC;QAED,KAAK,UAAU;YACb,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;YACnC,MAAM;QAER,KAAK,OAAO;YACV,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC9B,MAAM;QAER,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,CAAC,GAAG,CAAwC,CAAC;YACnD,MAAM,WAAW,GAAG,GAA8B,CAAC;YACnD,MAAM,OAAO,GAAG,GAAG,CAAC,GAAgC,CAAC;YAErD,IAAI,CAAC,CAAC,WAAW;gBAAE,WAAW,CAAC,SAAS,EAAE,CAAC,cAAc,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC;YAC1E,IAAI,CAAC,CAAC,aAAa;gBAAE,WAAW,CAAC,SAAS,EAAE,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;YAExF,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YAErB,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC;YAEtB,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBACvF,4CAA4C;gBAC5C,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;YAC9C,CAAC;YACD,MAAM;QACR,CAAC;QAED;YACE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACtD,CAAC;AACH,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,2 @@
+export * as http from './http/index.js';
+export * as modules from './modules/index.js';

package/lib/index.js

@@ -0,0 +1,3 @@
+export * as http from './http/index.js';
+export * as modules from './modules/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,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC"}

package/lib/middlewares/index.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/middlewares/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/lib/middlewares/index.js.map

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

package/lib/middlewares/serve-static-middleware.d.ts

@@ -0,0 +1,12 @@
+import type { Middleware } from '@kurdel/core/http';
+/**
+ * @kurdel
+ * Node.js static file middleware.
+ *
+ * Responsibilities:
+ * - Serve static files from a configured directory
+ * - Prevent directory traversal
+ * - Set correct MIME type
+ * - Fallback to `next()` if file not found
+ */
+export declare function serveStaticMiddleware(rootDir: string): Middleware<unknown, NodeJS.ReadableStream>;

package/lib/middlewares/serve-static-middleware.js

@@ -0,0 +1,50 @@
+import { createReadStream, promises as fs } from 'node:fs';
+import { extname, join, normalize } from 'node:path';
+import mime from 'mime-types';
+/**
+ * @kurdel
+ * Node.js static file middleware.
+ *
+ * Responsibilities:
+ * - Serve static files from a configured directory
+ * - Prevent directory traversal
+ * - Set correct MIME type
+ * - Fallback to `next()` if file not found
+ */
+export function serveStaticMiddleware(rootDir) {
+    return async (ctx, next) => {
+        try {
+            // Normalize path to prevent traversal (`..`)
+            const urlPath = decodeURIComponent(ctx.url.pathname ?? '/');
+            const safePath = normalize(join(rootDir, urlPath)).replace(/\\/g, '/');
+            if (!safePath.startsWith(rootDir.replace(/\\/g, '/'))) {
+                // Security guard — attempt to escape root directory
+                return next();
+            }
+            let filePath = safePath;
+            // If it's a directory, try to serve index.html
+            const stat = await fs.stat(filePath).catch(() => null);
+            if (stat?.isDirectory()) {
+                filePath = join(filePath, 'index.html');
+            }
+            const finalStat = await fs.stat(filePath).catch(() => null);
+            if (!finalStat?.isFile()) {
+                return next();
+            }
+            const extension = extname(filePath);
+            const mimeType = mime.lookup(extension) || 'application/octet-stream';
+            const stream = createReadStream(filePath);
+            return {
+                kind: 'stream',
+                status: 200,
+                body: stream,
+                contentType: mimeType,
+                contentLength: finalStat.size,
+            };
+        }
+        catch {
+            return next();
+        }
+    };
+}
+//# sourceMappingURL=serve-static-middleware.js.map

package/lib/middlewares/serve-static-middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-static-middleware.js","sourceRoot":"","sources":["../../src/middlewares/serve-static-middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,IAAI,MAAM,YAAY,CAAC;AAG9B;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,OAAO,KAAK,EAAE,GAAgB,EAAE,IAAI,EAAuD,EAAE;QAC3F,IAAI,CAAC;YACH,6CAA6C;YAC7C,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAC;YAC5D,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAEvE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;gBACtD,oDAAoD;gBACpD,OAAO,IAAI,EAAE,CAAC;YAChB,CAAC;YAED,IAAI,QAAQ,GAAG,QAAQ,CAAC;YAExB,+CAA+C;YAC/C,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACvD,IAAI,IAAI,EAAE,WAAW,EAAE,EAAE,CAAC;gBACxB,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;YAC1C,CAAC;YAED,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YAC5D,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;gBACzB,OAAO,IAAI,EAAE,CAAC;YAChB,CAAC;YAED,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;YACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,0BAA0B,CAAC;YAEtE,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YAE1C,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,GAAG;gBACX,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,QAAQ;gBACrB,aAAa,EAAE,SAAS,CAAC,IAAI;aAC9B,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/lib/modules/index.d.ts

@@ -0,0 +1,2 @@
+export * from './node-platform-module.js';
+export * from './static-files-module.js';

package/lib/modules/index.js

@@ -0,0 +1,3 @@
+export * from './node-platform-module.js';
+export * from './static-files-module.js';
+//# sourceMappingURL=index.js.map

package/lib/modules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/modules/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC"}

package/lib/modules/node-platform-module.d.ts

@@ -0,0 +1,7 @@
+import type { AppModule } from '@kurdel/core/app';
+/**
+ * Provides Node.js platform-level services:
+ * - native ServerAdapter
+ * - platform-aware ResponseRenderer
+ */
+export declare const NodePlatformModule: AppModule;

package/lib/modules/node-platform-module.js

@@ -0,0 +1,26 @@
+import { ModulePriority } from '@kurdel/core/app';
+import { TOKENS } from '@kurdel/core/tokens';
+import { RuntimeResponseRenderer } from '@kurdel/runtime/http';
+import { renderNodeActionResult } from '../http/render-node-action-result.js';
+import { NativeHttpServerAdapter } from '../http/native-http-server-adapter.js';
+/**
+ * Provides Node.js platform-level services:
+ * - native ServerAdapter
+ * - platform-aware ResponseRenderer
+ */
+export const NodePlatformModule = {
+    priority: ModulePriority.Platform,
+    providers: [
+        {
+            provide: TOKENS.ServerAdapter,
+            useFactory: () => new NativeHttpServerAdapter(),
+            singleton: true,
+        },
+        {
+            provide: TOKENS.ResponseRenderer,
+            useFactory: () => new RuntimeResponseRenderer(renderNodeActionResult),
+            singleton: true,
+        },
+    ],
+};
+//# sourceMappingURL=node-platform-module.js.map

package/lib/modules/node-platform-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-platform-module.js","sourceRoot":"","sources":["../../src/modules/node-platform-module.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAEjF;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAc;IAC3C,QAAQ,EAAE,cAAc,CAAC,QAAQ;IACjC,SAAS,EAAE;QACT;YACE,OAAO,EAAE,MAAM,CAAC,aAAa;YAC7B,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,uBAAuB,EAAE;YAC/C,SAAS,EAAE,IAAI;SAChB;QACD;YACE,OAAO,EAAE,MAAM,CAAC,gBAAgB;YAChC,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,uBAAuB,CAAC,sBAAsB,CAAC;YACrE,SAAS,EAAE,IAAI;SAChB;KACF;CACF,CAAC"}

package/lib/modules/static-files-module.d.ts

@@ -0,0 +1,21 @@
+import type { AppConfig } from '@kurdel/core/app';
+import type { HttpModule } from '@kurdel/core/http';
+/**
+ * StaticFilesModule
+ *
+ * HTTP module that provides a global middleware
+ * for serving static files from a specified directory.
+ *
+ * @example:
+ * ```ts
+ * export const AppModule: HttpModule = {
+ *   imports: [StaticFilesModule.forRoot('public')],
+ * };
+ * ```
+ */
+export declare class StaticFilesModule implements HttpModule<AppConfig, NodeJS.ReadableStream> {
+    private readonly baseDir;
+    readonly middlewares: import("@kurdel/core/http").Middleware<unknown, NodeJS.ReadableStream>[];
+    constructor(baseDir: string);
+    static forRoot(baseDir: string): StaticFilesModule;
+}

package/lib/modules/static-files-module.js

@@ -0,0 +1,24 @@
+import { serveStaticMiddleware } from '../middlewares/serve-static-middleware.js';
+/**
+ * StaticFilesModule
+ *
+ * HTTP module that provides a global middleware
+ * for serving static files from a specified directory.
+ *
+ * @example:
+ * ```ts
+ * export const AppModule: HttpModule = {
+ *   imports: [StaticFilesModule.forRoot('public')],
+ * };
+ * ```
+ */
+export class StaticFilesModule {
+    constructor(baseDir) {
+        this.baseDir = baseDir;
+        this.middlewares = [serveStaticMiddleware(baseDir)];
+    }
+    static forRoot(baseDir) {
+        return new StaticFilesModule(baseDir);
+    }
+}
+//# sourceMappingURL=static-files-module.js.map

package/lib/modules/static-files-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-files-module.js","sourceRoot":"","sources":["../../src/modules/static-files-module.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AAEnF;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,iBAAiB;IAG5B,YAA6B,OAAe;QAAf,YAAO,GAAP,OAAO,CAAQ;QAC1C,IAAI,CAAC,WAAW,GAAG,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,OAAe;QAC5B,OAAO,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;CACF"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@kurdel/runtime-node",
+  "version": "0.1.0-beta.1",
+  "description": "Node.js HTTP runtime adapter for Kurdel",
+  "type": "module",
+  "exports": {
+    ".": "./lib/index.js",
+    "./http": "./lib/http/index.js",
+    "./modules": "./lib/modules/index.js"
+  },
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "files": [
+    "lib"
+  ],
+  "scripts": {
+    "prepack": "npm run build",
+    "test": "vitest run",
+    "test:ui": "vitest",
+    "test:watch": "vitest --watch",
+    "coverage": "vitest run --coverage",
+    "clean": "rimraf lib ../../.cache/tsconfig.runtime-node.build.tsbuildinfo",
+    "build": "tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json",
+    "build:force": "npm run clean && tsc -p tsconfig.build.json --force && tsc-alias -p tsconfig.build.json"
+  },
+  "keywords": [
+    "kurdel",
+    "node",
+    "http",
+    "adapter",
+    "framework"
+  ],
+  "author": "Andrii Sorokin",
+  "license": "MIT",
+  "engines": {
+    "node": "^20.19.0 || ^22.12.0 || >=24.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ignorantic/kurdel.git",
+    "directory": "packages/runtime-node"
+  },
+  "homepage": "https://github.com/ignorantic/kurdel/tree/main/packages/runtime-node#readme",
+  "bugs": {
+    "url": "https://github.com/ignorantic/kurdel/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "beta"
+  },
+  "devDependencies": {
+    "@types/mime-types": "^3.0.1",
+    "@types/node": "^20.9.0",
+    "@types/supertest": "^6.0.3",
+    "@vitest/coverage-v8": "^3.2.4",
+    "rimraf": "^6.0.1",
+    "supertest": "^7.1.4",
+    "tsc-alias": "^1.8.16"
+  },
+  "dependencies": {
+    "@kurdel/common": "0.1.0-beta.1",
+    "@kurdel/core": "0.1.0-beta.1",
+    "@kurdel/runtime": "0.1.0-beta.1"
+  }
+}