@krantho/server-node 0.0.0-stage → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Descoped
+
+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/dist/index.d.ts

@@ -0,0 +1,20 @@
+import type { KranthoHandler, KranthoHandlerOptions } from '@krantho/server';
+export type { ContentLoader, PageRequestOptions, PageRequestResult, StudioRequest, StudioServer, } from '@krantho/server';
+export { createContentLoader, createStudioServer, runPageRequest, verifyPreviewRequest, } from '@krantho/server';
+export { toWebRequest } from './node-request.js';
+export { writeResponseHeaders, writeWebResponse } from './node-response.js';
+export type { CachedPage, CachedPageHeaders, PageHeaders, PageRequestInfo, RenderedPage, } from './page-cache.js';
+export { renderCachedPage } from './page-cache.js';
+export type { KranthoHandlerOptions };
+/**
+ * Create a raw handler for use with any Node.js HTTP server.
+ *
+ * Returns an object with `handle(request: Request): Promise<Response>`.
+ * The handler is initialized lazily on first request and reused (singleton).
+ *
+ * Use this when integrating with Express, Fastify, or a custom Node.js server.
+ * For Vite dev middleware, use `@krantho/server-node/vite` instead.
+ * For a standalone production server, use `@krantho/server-node/standalone`.
+ */
+export declare function createHandler(options: KranthoHandlerOptions): KranthoHandler;
+//# 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,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAG5E,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,YAAY,GACb,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,GACrB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC3E,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,YAAY,GACb,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAClD,YAAY,EAAE,qBAAqB,EAAE,CAAA;AAErC;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAqB5E"}

package/dist/index.js

@@ -0,0 +1,36 @@
+import { createKranthoHandler } from '@krantho/server';
+export { createContentLoader, createStudioServer, runPageRequest, verifyPreviewRequest, } from '@krantho/server';
+export { toWebRequest } from './node-request.js';
+export { writeResponseHeaders, writeWebResponse } from './node-response.js';
+export { renderCachedPage } from './page-cache.js';
+/**
+ * Create a raw handler for use with any Node.js HTTP server.
+ *
+ * Returns an object with `handle(request: Request): Promise<Response>`.
+ * The handler is initialized lazily on first request and reused (singleton).
+ *
+ * Use this when integrating with Express, Fastify, or a custom Node.js server.
+ * For Vite dev middleware, use `@krantho/server-node/vite` instead.
+ * For a standalone production server, use `@krantho/server-node/standalone`.
+ */
+export function createHandler(options) {
+    let handlerPromise;
+    function getHandler() {
+        if (!handlerPromise) {
+            handlerPromise = createKranthoHandler({ ...options, framework: 'node' });
+        }
+        return handlerPromise;
+    }
+    return {
+        async handle(request) {
+            const handler = await getHandler();
+            return handler.handle(request);
+        },
+        close() {
+            if (handlerPromise) {
+                handlerPromise.then((h) => h.close()).catch(() => { });
+            }
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAStD,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,GACrB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAQ3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAGlD;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,OAA8B;IAC1D,IAAI,cAAmD,CAAA;IAEvD,SAAS,UAAU;QACjB,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,cAAc,GAAG,oBAAoB,CAAC,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAA;QAC1E,CAAC;QACD,OAAO,cAAc,CAAA;IACvB,CAAC;IAED,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,OAAgB;YAC3B,MAAM,OAAO,GAAG,MAAM,UAAU,EAAE,CAAA;YAClC,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QAChC,CAAC;QACD,KAAK;YACH,IAAI,cAAc,EAAE,CAAC;gBACnB,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;YACvD,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/node-request.d.ts

@@ -0,0 +1,4 @@
+import type { IncomingMessage } from 'node:http';
+/** Convert a Node.js IncomingMessage to a Web Request */
+export declare function toWebRequest(req: IncomingMessage): Promise<Request>;
+//# sourceMappingURL=node-request.d.ts.map

package/dist/node-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-request.d.ts","sourceRoot":"","sources":["../src/node-request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAchD,yDAAyD;AACzD,wBAAsB,YAAY,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAsBzE"}

package/dist/node-request.js

@@ -0,0 +1,31 @@
+const METHODS_WITH_BODY = new Set(['POST', 'PUT', 'PATCH', 'DELETE']);
+/** Read the full request body from a Node.js IncomingMessage, byte for byte: an upload is not text */
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on('data', (chunk) => chunks.push(chunk));
+        req.on('end', () => resolve(new Uint8Array(Buffer.concat(chunks))));
+        req.on('error', reject);
+    });
+}
+/** Convert a Node.js IncomingMessage to a Web Request */
+export async function toWebRequest(req) {
+    const protocol = req.headers['x-forwarded-proto'] ?? 'http';
+    const host = req.headers.host ?? 'localhost';
+    const fullUrl = `${protocol}://${host}${req.url ?? '/'}`;
+    const headers = new Headers();
+    for (const [key, value] of Object.entries(req.headers)) {
+        if (typeof value === 'string') {
+            headers.set(key, value);
+        }
+    }
+    const init = { method: req.method ?? 'GET', headers };
+    if (req.method && METHODS_WITH_BODY.has(req.method)) {
+        const body = await readBody(req);
+        if (body.byteLength > 0) {
+            init.body = body;
+        }
+    }
+    return new Request(fullUrl, init);
+}
+//# sourceMappingURL=node-request.js.map

package/dist/node-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-request.js","sourceRoot":"","sources":["../src/node-request.ts"],"names":[],"mappings":"AAEA,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAA;AAErE,sGAAsG;AACtG,SAAS,QAAQ,CAAC,GAAoB;IACpC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAa,EAAE,CAAA;QAC3B,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;QACrD,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;QACnE,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IACzB,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,yDAAyD;AACzD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAoB;IACrD,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,mBAAmB,CAAC,IAAI,MAAM,CAAA;IAC3D,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,WAAW,CAAA;IAC5C,MAAM,OAAO,GAAG,GAAG,QAAQ,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,CAAA;IAExD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;IAC7B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACvD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACzB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAgB,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,KAAK,EAAE,OAAO,EAAE,CAAA;IAElE,IAAI,GAAG,CAAC,MAAM,IAAI,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAA;QAChC,IAAI,IAAI,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAClB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;AACnC,CAAC"}

package/dist/node-response.d.ts

@@ -0,0 +1,18 @@
+import type { ServerResponse } from 'node:http';
+/**
+ * Copy a Web Response's headers onto a Node ServerResponse.
+ *
+ * Set-Cookie is emitted as one header line per cookie: iterating a Web `Headers`
+ * object folds same-name headers (including Set-Cookie) into a single comma-joined
+ * value, which RFC 6265 forbids. `getSetCookie()` recovers the distinct values, and
+ * `res.setHeader(name, string[])` writes one line per array element.
+ */
+export declare function writeResponseHeaders(res: ServerResponse, response: Response): void;
+/**
+ * Write a Web Response to a Node response: headers (one Set-Cookie line per
+ * cookie), then the body chunk by chunk as it arrives, honouring backpressure.
+ * When the client goes away first, the body stream is cancelled; when the body
+ * fails after the headers were sent, the response is destroyed.
+ */
+export declare function writeWebResponse(res: ServerResponse, response: Response): Promise<void>;
+//# sourceMappingURL=node-response.d.ts.map

package/dist/node-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-response.d.ts","sourceRoot":"","sources":["../src/node-response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAE/C;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CASlF;AAgBD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CA4B7F"}

package/dist/node-response.js

@@ -0,0 +1,74 @@
+/**
+ * Copy a Web Response's headers onto a Node ServerResponse.
+ *
+ * Set-Cookie is emitted as one header line per cookie: iterating a Web `Headers`
+ * object folds same-name headers (including Set-Cookie) into a single comma-joined
+ * value, which RFC 6265 forbids. `getSetCookie()` recovers the distinct values, and
+ * `res.setHeader(name, string[])` writes one line per array element.
+ */
+export function writeResponseHeaders(res, response) {
+    for (const [key, value] of response.headers) {
+        if (key.toLowerCase() === 'set-cookie')
+            continue;
+        res.setHeader(key, value);
+    }
+    const cookies = response.headers.getSetCookie();
+    if (cookies.length > 0) {
+        res.setHeader('set-cookie', cookies);
+    }
+}
+/** Write one chunk, waiting for `drain` when the socket's buffer is full */
+function writeChunk(res, chunk) {
+    if (res.write(chunk))
+        return Promise.resolve();
+    return new Promise((resolve) => {
+        const done = () => {
+            res.off('drain', done);
+            res.off('close', done);
+            resolve();
+        };
+        res.once('drain', done);
+        res.once('close', done);
+    });
+}
+/**
+ * Write a Web Response to a Node response: headers (one Set-Cookie line per
+ * cookie), then the body chunk by chunk as it arrives, honouring backpressure.
+ * When the client goes away first, the body stream is cancelled; when the body
+ * fails after the headers were sent, the response is destroyed.
+ */
+export async function writeWebResponse(res, response) {
+    res.statusCode = response.status;
+    writeResponseHeaders(res, response);
+    res.flushHeaders();
+    if (!response.body) {
+        res.end();
+        return;
+    }
+    const reader = response.body.getReader();
+    const onClose = () => {
+        if (!res.writableFinished)
+            reader.cancel().catch(() => { });
+    };
+    res.once('close', onClose);
+    try {
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            if (res.destroyed)
+                break;
+            await writeChunk(res, value);
+        }
+        if (!res.destroyed)
+            res.end();
+    }
+    catch (err) {
+        res.destroy(err instanceof Error ? err : new Error(String(err)));
+    }
+    finally {
+        res.off('close', onClose);
+        reader.releaseLock();
+    }
+}
+//# sourceMappingURL=node-response.js.map

package/dist/node-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-response.js","sourceRoot":"","sources":["../src/node-response.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAmB,EAAE,QAAkB;IAC1E,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC5C,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,YAAY;YAAE,SAAQ;QAChD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IAC3B,CAAC;IACD,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,CAAA;IAC/C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,GAAG,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;IACtC,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,SAAS,UAAU,CAAC,GAAmB,EAAE,KAAiB;IACxD,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IAC9C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,IAAI,GAAG,GAAS,EAAE;YACtB,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;YACtB,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;YACtB,OAAO,EAAE,CAAA;QACX,CAAC,CAAA;QACD,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;QACvB,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;IACzB,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAmB,EAAE,QAAkB;IAC5E,GAAG,CAAC,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAA;IAChC,oBAAoB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;IACnC,GAAG,CAAC,YAAY,EAAE,CAAA;IAClB,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnB,GAAG,CAAC,GAAG,EAAE,CAAA;QACT,OAAM;IACR,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAA;IACxC,MAAM,OAAO,GAAG,GAAS,EAAE;QACzB,IAAI,CAAC,GAAG,CAAC,gBAAgB;YAAE,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IAC5D,CAAC,CAAA;IACD,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IAC1B,IAAI,CAAC;QACH,SAAS,CAAC;YACR,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;YAC3C,IAAI,IAAI;gBAAE,MAAK;YACf,IAAI,GAAG,CAAC,SAAS;gBAAE,MAAK;YACxB,MAAM,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QAC9B,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,SAAS;YAAE,GAAG,CAAC,GAAG,EAAE,CAAA;IAC/B,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,GAAG,CAAC,OAAO,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IAClE,CAAC;YAAS,CAAC;QACT,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACzB,MAAM,CAAC,WAAW,EAAE,CAAA;IACtB,CAAC;AACH,CAAC"}

package/dist/page-cache.d.ts

@@ -0,0 +1,58 @@
+import type { KranthoHandlerOptions } from '@krantho/server';
+/** A page request as Express (or any Node server) sees it */
+export interface PageRequestInfo {
+    /** The full request path with its query string (Express: `req.originalUrl`), or an absolute URL */
+    url: string;
+    method: string;
+}
+/**
+ * Response headers in Node's shape: what Express's `res.getHeaders()` returns,
+ * and what `res.setHeader(name, value)` takes (an `undefined` value is skipped).
+ */
+export type PageHeaders = Record<string, string | number | readonly string[] | undefined>;
+/** The headers to send with a page, each ready for `res.setHeader(name, value)` */
+export type CachedPageHeaders = Record<string, string | number | readonly string[]>;
+/** What a server-side render produced */
+export interface RenderedPage {
+    status: number;
+    html: string;
+    /**
+     * The page's own response headers — a `Set-Cookie` among them, or a
+     * `Cache-Control` saying `private`, `no-store` or `no-cache`, keeps the page
+     * off the CDN
+     */
+    headers?: PageHeaders | undefined;
+}
+/** A rendered page and every header to send with it */
+export interface CachedPage {
+    status: number;
+    html: string;
+    headers: CachedPageHeaders;
+}
+/**
+ * Render one page under the page cache rules.
+ *
+ * A `GET` or `HEAD` outside `/api` and `/studio` renders inside a page request
+ * scope, so the content loader records its tags. A verified signed preview
+ * link reads drafts and answers `private, no-store`, `noindex`, with no
+ * referrer. Under `cache.pages: 'cdn'` a published `200` or `404` whose
+ * headers set no cookie is cached at the CDN, tagged with every read that
+ * rendered it — unless its own `Cache-Control` says `private`, `no-store` or
+ * `no-cache`, which is then left as it is.
+ *
+ * The returned `headers` are the page's own merged with the cache headers,
+ * the cache headers winning on a name both set; a `Set-Cookie` is always
+ * passed through. Send every one:
+ *
+ * ```ts
+ * const page = await renderCachedPage(req, config, render)
+ * for (const [name, value] of Object.entries(page.headers)) res.setHeader(name, value)
+ * res.status(page.status).send(page.html)
+ * ```
+ *
+ * Start every content read inside `render`: a read made before it, or one that
+ * outlives it, records no tags. Never read `loader.preview` outside `render` —
+ * that puts a draft into a page the CDN caches.
+ */
+export declare function renderCachedPage(req: PageRequestInfo, config: KranthoHandlerOptions['config'], render: () => Promise<RenderedPage>): Promise<CachedPage>;
+//# sourceMappingURL=page-cache.d.ts.map

package/dist/page-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-cache.d.ts","sourceRoot":"","sources":["../src/page-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAG5D,6DAA6D;AAC7D,MAAM,WAAW,eAAe;IAC9B,mGAAmG;IACnG,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC,CAAA;AAEzF,mFAAmF;AACnF,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC,CAAA;AAEnF,yCAAyC;AACzC,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;CAClC;AAED,uDAAuD;AACvD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,iBAAiB,CAAA;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,eAAe,EACpB,MAAM,EAAE,qBAAqB,CAAC,QAAQ,CAAC,EACvC,MAAM,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,GAClC,OAAO,CAAC,UAAU,CAAC,CAUrB"}

package/dist/page-cache.js

@@ -0,0 +1,63 @@
+import { servePageRequest } from '@krantho/server';
+/**
+ * Render one page under the page cache rules.
+ *
+ * A `GET` or `HEAD` outside `/api` and `/studio` renders inside a page request
+ * scope, so the content loader records its tags. A verified signed preview
+ * link reads drafts and answers `private, no-store`, `noindex`, with no
+ * referrer. Under `cache.pages: 'cdn'` a published `200` or `404` whose
+ * headers set no cookie is cached at the CDN, tagged with every read that
+ * rendered it — unless its own `Cache-Control` says `private`, `no-store` or
+ * `no-cache`, which is then left as it is.
+ *
+ * The returned `headers` are the page's own merged with the cache headers,
+ * the cache headers winning on a name both set; a `Set-Cookie` is always
+ * passed through. Send every one:
+ *
+ * ```ts
+ * const page = await renderCachedPage(req, config, render)
+ * for (const [name, value] of Object.entries(page.headers)) res.setHeader(name, value)
+ * res.status(page.status).send(page.html)
+ * ```
+ *
+ * Start every content read inside `render`: a read made before it, or one that
+ * outlives it, records no tags. Never read `loader.preview` outside `render` —
+ * that puts a draft into a page the CDN caches.
+ */
+export async function renderCachedPage(req, config, render) {
+    const { value, headers } = await servePageRequest(req, config, render, (page) => ({
+        status: page.status,
+        header: (name) => headerValue(page.headers ?? {}, name),
+    }));
+    return {
+        status: value.status,
+        html: value.html,
+        headers: mergeHeaders(value.headers ?? {}, headers),
+    };
+}
+/** A header by name, in any case, several values joined with `, ` — null when absent */
+function headerValue(headers, name) {
+    const wanted = name.toLowerCase();
+    const values = [];
+    for (const [key, value] of Object.entries(headers)) {
+        if (value === undefined || key.toLowerCase() !== wanted)
+            continue;
+        if (typeof value === 'object')
+            values.push(...value);
+        else
+            values.push(String(value));
+    }
+    return values.length > 0 ? values.join(', ') : null;
+}
+/** The page's headers, less any the cache headers replace (by name, in any case), plus those */
+function mergeHeaders(page, cache) {
+    const replaced = new Set(Object.keys(cache).map((name) => name.toLowerCase()));
+    const merged = {};
+    for (const [name, value] of Object.entries(page)) {
+        if (value === undefined || replaced.has(name.toLowerCase()))
+            continue;
+        merged[name] = value;
+    }
+    return { ...merged, ...cache };
+}
+//# sourceMappingURL=page-cache.js.map

package/dist/page-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-cache.js","sourceRoot":"","sources":["../src/page-cache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAqClD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAoB,EACpB,MAAuC,EACvC,MAAmC;IAEnC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAChF,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,IAAI,CAAC;KACxD,CAAC,CAAC,CAAA;IACH,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,EAAE,OAAO,CAAC;KACpD,CAAA;AACH,CAAC;AAED,wFAAwF;AACxF,SAAS,WAAW,CAAC,OAAoB,EAAE,IAAY;IACrD,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;IACjC,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,IAAI,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,MAAM;YAAE,SAAQ;QACjE,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAA;;YAC/C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IACjC,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AACrD,CAAC;AAED,gGAAgG;AAChG,SAAS,YAAY,CAAC,IAAiB,EAAE,KAA6B;IACpE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAA;IAC9E,MAAM,MAAM,GAAsB,EAAE,CAAA;IACpC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,IAAI,KAAK,KAAK,SAAS,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YAAE,SAAQ;QACrE,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;IACtB,CAAC;IACD,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,KAAK,EAAE,CAAA;AAChC,CAAC"}

package/dist/standalone.d.ts

@@ -0,0 +1,17 @@
+import type { KranthoHandlerOptions } from '@krantho/server';
+/** Options for the standalone production server */
+export interface StandaloneOptions extends KranthoHandlerOptions {
+    /** Directory containing static files to serve (e.g., 'dist') */
+    staticDir?: string | undefined;
+    /** Port to listen on (default: 3000) */
+    port?: number | undefined;
+}
+/**
+ * Start a standalone HTTP server with API + optional static file serving.
+ *
+ * Requests to `/api/*` are routed to the krantho handler.
+ * All other requests serve static files from `staticDir` (if configured).
+ * Falls back to `index.html` for SPA client-side routing.
+ */
+export declare function startServer(options: StandaloneOptions): Promise<void>;
+//# sourceMappingURL=standalone.d.ts.map

package/dist/standalone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standalone.d.ts","sourceRoot":"","sources":["../src/standalone.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAK5D,mDAAmD;AACnD,MAAM,WAAW,iBAAkB,SAAQ,qBAAqB;IAC9D,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC1B;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+C3E"}

package/dist/standalone.js

@@ -0,0 +1,83 @@
+import { readFile, stat } from 'node:fs/promises';
+import { createServer } from 'node:http';
+import { extname, join, resolve, sep } from 'node:path';
+import { createKranthoHandler, MIME_TYPES } from '@krantho/server';
+import { toWebRequest } from './node-request.js';
+import { writeWebResponse } from './node-response.js';
+/**
+ * Start a standalone HTTP server with API + optional static file serving.
+ *
+ * Requests to `/api/*` are routed to the krantho handler.
+ * All other requests serve static files from `staticDir` (if configured).
+ * Falls back to `index.html` for SPA client-side routing.
+ */
+export async function startServer(options) {
+    const port = options.port ?? 3000;
+    const handler = await createKranthoHandler({ ...options, framework: 'node' });
+    const server = createServer(async (req, res) => {
+        const url = req.url ?? '/';
+        // API routes
+        if (url.startsWith('/api/')) {
+            try {
+                const webRequest = await toWebRequest(req);
+                const response = await handler.handle(webRequest);
+                await writeWebResponse(res, response);
+            }
+            catch {
+                if (res.headersSent) {
+                    res.destroy();
+                    return;
+                }
+                res.statusCode = 500;
+                res.setHeader('content-type', 'application/json');
+                res.end(JSON.stringify({ error: 'Internal server error' }));
+            }
+            return;
+        }
+        // Static files
+        if (options.staticDir) {
+            const served = await serveStatic(res, options.staticDir, url);
+            if (served)
+                return;
+            // SPA fallback — serve index.html for non-file paths
+            const indexServed = await serveStatic(res, options.staticDir, '/index.html');
+            if (indexServed)
+                return;
+        }
+        res.statusCode = 404;
+        res.setHeader('content-type', 'text/plain');
+        res.end('Not Found');
+    });
+    server.listen(port, () => {
+        console.log(`krantho server listening on http://localhost:${port}`);
+        if (options.staticDir) {
+            console.log(`  Static files: ${options.staticDir}`);
+        }
+        console.log(`  API: http://localhost:${port}/api/`);
+    });
+}
+async function serveStatic(res, staticDir, urlPath) {
+    const resolvedDir = resolve(staticDir);
+    const safeRoot = resolvedDir.endsWith(sep) ? resolvedDir : resolvedDir + sep;
+    const filePath = resolve(join(staticDir, urlPath));
+    // Prevent directory traversal — trailing separator prevents sibling-directory bypass
+    if (!filePath.startsWith(safeRoot) && filePath !== resolvedDir) {
+        return false;
+    }
+    try {
+        const stats = await stat(filePath);
+        if (!stats.isFile())
+            return false;
+        const content = await readFile(filePath);
+        const ext = extname(filePath);
+        const contentType = MIME_TYPES[ext] ?? 'application/octet-stream';
+        res.statusCode = 200;
+        res.setHeader('content-type', contentType);
+        res.end(content);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=standalone.js.map

package/dist/standalone.js.map

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

package/dist/vite.d.ts

@@ -0,0 +1,11 @@
+import type { KranthoHandlerOptions } from '@krantho/server';
+import type { Plugin } from 'vite';
+export type { KranthoHandlerOptions };
+/**
+ * Vite plugin that adds krantho API middleware to the dev server.
+ *
+ * Intercepts requests matching `/api/*` and routes them through the
+ * krantho handler. All other requests pass through to Vite normally.
+ */
+export declare function kranthoPlugin(options: KranthoHandlerOptions): Plugin;
+//# sourceMappingURL=vite.d.ts.map

package/dist/vite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAE5D,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAA;AAIjD,YAAY,EAAE,qBAAqB,EAAE,CAAA;AAErC;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAgEpE"}

package/dist/vite.js

@@ -0,0 +1,72 @@
+import { createLazyHandler, createStudioServer } from '@krantho/server';
+import { toWebRequest } from './node-request.js';
+import { writeWebResponse } from './node-response.js';
+/**
+ * Vite plugin that adds krantho API middleware to the dev server.
+ *
+ * Intercepts requests matching `/api/*` and routes them through the
+ * krantho handler. All other requests pass through to Vite normally.
+ */
+export function kranthoPlugin(options) {
+    const getHandler = createLazyHandler({ ...options, framework: 'node' });
+    const serveStudio = createStudioServer(options.config);
+    return {
+        name: 'krantho-api',
+        configureServer(server) {
+            // Serve Studio SPA
+            server.middlewares.use((req, res, next) => {
+                const url = req.url ?? '';
+                if (!url.startsWith('/studio')) {
+                    next();
+                    return;
+                }
+                let response;
+                try {
+                    response = serveStudio({
+                        url: new URL(url, 'http://localhost'),
+                        cookie: req.headers.cookie,
+                    });
+                }
+                catch (err) {
+                    next(err);
+                    return;
+                }
+                res.statusCode = response.status;
+                for (const [key, value] of response.headers) {
+                    res.setHeader(key, value);
+                }
+                response
+                    .arrayBuffer()
+                    .then((buf) => res.end(Buffer.from(buf)))
+                    .catch(() => {
+                    res.statusCode = 500;
+                    res.end('Failed to read Studio asset');
+                });
+            });
+            // Serve krantho API
+            server.middlewares.use(async (req, res, next) => {
+                const url = req.url ?? '';
+                if (!url.startsWith('/api/')) {
+                    next();
+                    return;
+                }
+                try {
+                    const handler = await getHandler();
+                    const webRequest = await toWebRequest(req);
+                    const response = await handler.handle(webRequest);
+                    await writeWebResponse(res, response);
+                }
+                catch {
+                    if (res.headersSent) {
+                        res.destroy();
+                        return;
+                    }
+                    res.statusCode = 500;
+                    res.setHeader('content-type', 'application/json');
+                    res.end(JSON.stringify({ error: 'Internal server error' }));
+                }
+            });
+        },
+    };
+}
+//# sourceMappingURL=vite.js.map

package/dist/vite.js.map

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

package/package.json

@@ -1,6 +1,56 @@
 {
   "name": "@krantho/server-node",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.1",
+  "description": "The krantho adapter for Node.js, Express and Vite: a request handler, a Vite plugin and a standalone server.",
+  "license": "MIT",
+  "homepage": "https://krantho.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/descoped/krantho.git",
+    "directory": "packages/server-node"
+  },
+  "bugs": {
+    "url": "https://github.com/descoped/krantho/issues"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./vite": {
+      "types": "./dist/vite.d.ts",
+      "import": "./dist/vite.js"
+    },
+    "./standalone": {
+      "types": "./dist/standalone.d.ts",
+      "import": "./dist/standalone.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@krantho/server": "1.0.1"
+  },
+  "peerDependencies": {
+    "vite": ">=8.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.9",
+    "typescript": "^6.0.3",
+    "vite": "^8.3.8",
+    "zod": "^4.6.7",
+    "@krantho/schema": "1.0.1"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.