@lovrozagar/honey 0.6.8 → 0.7.1

package/dist/node.js

@@ -0,0 +1,396 @@
+import { createServer, ServerResponse } from "node:http";
+import { Readable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+import { bodyKind, rawBodyOf } from "./body-kind.js";
+import { isHoneyResponse } from "./honey-response.js";
+import { ABORT_REQUEST, BODY_OVERFLOW, DEFAULT_MAX_REQUEST_BODY, incomingToNodeRequest, nodeRequestUrl, } from "./node-request.js";
+/** Buffer known-size bodies up to this many bytes, then `res.end(buf)`. */
+const BUFFER_BODY_MAX = 256 * 1024;
+const DEFAULT_UPGRADE_TIMEOUT = 30_000;
+/**
+ * Hop-by-hop headers (RFC 9110 §7.6.1): they describe one connection, so a response from
+ * somewhere else (a proxied `fetch()`) must not carry them onto this one. Node writes its own.
+ */
+const HOP_BY_HOP = new Set([
+    "connection",
+    "keep-alive",
+    "proxy-connection",
+    "te",
+    "trailer",
+    "transfer-encoding",
+    "upgrade",
+]);
+// Node's `Readable.fromWeb` wants `node:stream/web` streams; DOM/Bun brands do not overlap.
+function asNodeWebStream(stream) {
+    return stream;
+}
+/** `null` when the request target or `Host` is invalid (see `nodeRequestUrl`); the caller answers 400. */
+function incomingToRequest(req, opts) {
+    const url = nodeRequestUrl(req);
+    return url === null ? null : incomingToNodeRequest(req, url, opts);
+}
+function collectNodeHeaders(response, extra) {
+    const headerObj = {};
+    let hasSetCookie = false;
+    /* headers a `Connection` header names are hop-by-hop too */
+    const named = response.headers.get("connection");
+    const dropNamed = named === null
+        ? null
+        : named
+            .toLowerCase()
+            .split(",")
+            .map((t) => t.trim());
+    response.headers.forEach((value, key) => {
+        if (key === "set-cookie") {
+            hasSetCookie = true;
+            return;
+        }
+        if (HOP_BY_HOP.has(key) && !(key === "upgrade" && response.status === 101))
+            return;
+        if (dropNamed !== null && dropNamed.includes(key))
+            return;
+        headerObj[key] = value;
+    });
+    if (hasSetCookie) {
+        const setCookies = response.headers.getSetCookie();
+        if (setCookies.length > 0)
+            headerObj["set-cookie"] = setCookies;
+    }
+    if (extra)
+        Object.assign(headerObj, extra);
+    return headerObj;
+}
+/**
+ * Buffer a body only when its size is known and small: a body Honey built in memory, or one
+ * that declares `content-length`. Everything else (SSE, `generate()`, a proxied stream, an
+ * untagged `new Response(stream)`) is piped as it is produced, whatever its content type.
+ */
+function shouldBufferBody(response) {
+    if (bodyKind(response) !== "buffered")
+        return false;
+    const len = Number(response.headers.get("content-length"));
+    return Number.isFinite(len) && len <= BUFFER_BODY_MAX;
+}
+/**
+ * Pipe a body to the socket. When the response closes first (client gone, shutdown), the
+ * reader is cancelled so the producer stops; nothing is left reading.
+ */
+async function pipeBody(stream, res) {
+    const readable = Readable.fromWeb(asNodeWebStream(stream));
+    const onClose = () => {
+        if (!res.writableFinished)
+            readable.destroy();
+    };
+    res.once("close", onClose);
+    try {
+        await pipeline(readable, res);
+    }
+    catch {
+        if (!res.destroyed)
+            res.destroy();
+        /* `destroy()` cancels the web reader; this covers a stream that errored on its own */
+        stream.cancel().catch(() => { });
+    }
+    finally {
+        res.off("close", onClose);
+    }
+}
+function statusMessage(response) {
+    return response.statusText === "" ? undefined : response.statusText;
+}
+async function responseToNode(response, res) {
+    if (isHoneyResponse(response)) {
+        const raw = response.rawBody;
+        if (typeof raw === "string" || raw instanceof Uint8Array) {
+            const byteLength = typeof raw === "string" ? Buffer.byteLength(raw) : raw.byteLength;
+            res.writeHead(response.status, { ...response.plainHeaders, "content-length": String(byteLength) });
+            res.end(raw);
+            return;
+        }
+        const stream = response.body;
+        if (stream === null) {
+            res.writeHead(response.status, response.plainHeaders);
+            res.end();
+            return;
+        }
+        res.writeHead(response.status, response.plainHeaders);
+        await pipeBody(stream, res);
+        return;
+    }
+    const raw = rawBodyOf(response);
+    if (typeof raw === "string" || raw instanceof Uint8Array) {
+        const byteLength = typeof raw === "string" ? Buffer.byteLength(raw) : raw.byteLength;
+        res.writeHead(response.status, statusMessage(response), collectNodeHeaders(response, { "content-length": String(byteLength) }));
+        res.end(raw);
+        return;
+    }
+    const body = response.body;
+    if (body === null) {
+        res.writeHead(response.status, statusMessage(response), collectNodeHeaders(response));
+        res.end();
+        return;
+    }
+    if (shouldBufferBody(response)) {
+        const buf = Buffer.from(await response.arrayBuffer());
+        if (res.destroyed)
+            return;
+        res.writeHead(response.status, statusMessage(response), collectNodeHeaders(response, { "content-length": String(buf.byteLength) }));
+        res.end(buf);
+        return;
+    }
+    const headers = collectNodeHeaders(response);
+    /* a stream's declared length is never trusted (`fetch()` keeps the encoded length of a body it
+     * decoded): Node chunks it, so a wrong length cannot truncate it or desynchronize keep-alive */
+    delete headers["content-length"];
+    res.writeHead(response.status, statusMessage(response), headers);
+    await pipeBody(body, res);
+}
+function isWebSocketUpgrade(req) {
+    return req.headers.upgrade?.toLowerCase() === "websocket";
+}
+/**
+ * The body of a request that came in on Node's `'upgrade'` path but is served as a normal
+ * request. Node with `shouldUpgradeCallback` never sends those there; before that,
+ * some versions leave the body on the socket (the first bytes in `head`). Only a declared
+ * `content-length` can be read back that way.
+ */
+function upgradeBodySource(req, socket, head) {
+    /* newer Node parses the body into `req` itself */
+    if (!req.complete)
+        return null;
+    if (req.headers["transfer-encoding"] !== undefined)
+        return "unsupported";
+    const declared = Number(req.headers["content-length"] ?? 0);
+    if (!Number.isSafeInteger(declared) || declared <= 0)
+        return null;
+    return (async function* () {
+        let remaining = declared;
+        if (head.byteLength > 0) {
+            const first = head.subarray(0, remaining);
+            remaining -= first.byteLength;
+            yield first;
+        }
+        if (remaining <= 0)
+            return;
+        for await (const chunk of socket) {
+            const part = chunk.subarray(0, remaining);
+            remaining -= part.byteLength;
+            yield part;
+            if (remaining <= 0)
+                return;
+        }
+    })();
+}
+/** Answer on a socket Node handed over through `'upgrade'`, with a real `ServerResponse`. */
+function responseOnSocket(req, socket) {
+    const res = new ServerResponse(req);
+    /* the connection ends with this response */
+    res.shouldKeepAlive = false;
+    res.assignSocket(socket);
+    res.once("finish", () => {
+        res.detachSocket(socket);
+        socket.end();
+    });
+    return res;
+}
+/** A response written before any Request exists (bad target or `Host`): plain text, then close. */
+function writeRawStatus(socket, status, text) {
+    if (socket.destroyed)
+        return;
+    socket.end(`HTTP/1.1 ${status} ${text}\r\nconnection: close\r\ncontent-type: text/plain\r\ncontent-length: ${text.length}\r\n\r\n${text}`);
+}
+export function serve(app, options) {
+    const env = options.env;
+    const requestOpts = { maxBodySize: options.maxRequestBodySize ?? DEFAULT_MAX_REQUEST_BODY };
+    const upgradeTimeout = options.upgradeTimeout ?? DEFAULT_UPGRADE_TIMEOUT;
+    const reportError = options.onError ??
+        ((err) => {
+            console.error("honey: request failed in the Node adapter", err);
+        });
+    /* in-flight requests and their responses: shutdown aborts their signals */
+    const inflight = new Map();
+    /* sockets that became WebSockets: shutdown closes them */
+    const upgraded = new Set();
+    let draining = false;
+    const abort = (request, reason) => {
+        ;
+        request[ABORT_REQUEST]?.(reason);
+    };
+    const wsAdapter = () => app._graph.settings.wsAdapter;
+    /** One HTTP request, whether it came in normally or on the `'upgrade'` path. */
+    const handle = async (req, res, bodySource = null) => {
+        if (draining) {
+            res.writeHead(503, { connection: "close" });
+            res.end("Service Unavailable");
+            return;
+        }
+        let request = null;
+        try {
+            request = incomingToRequest(req, bodySource === null ? requestOpts : { ...requestOpts, bodySource });
+            if (request === null) {
+                res.writeHead(400, { connection: "close", "content-type": "text/plain" });
+                res.end("Bad Request");
+                return;
+            }
+            const tracked = request;
+            inflight.set(res, tracked);
+            /* the response closed before it finished: the client left (or shutdown cut it) */
+            res.once("close", () => {
+                if (!res.writableFinished)
+                    abort(tracked, new DOMException("The client disconnected", "AbortError"));
+            });
+            const maybe = app.fetch(request, env);
+            const response = maybe instanceof Promise ? await maybe : maybe;
+            /* while draining, tell keep-alive clients this connection ends with the response */
+            if (draining)
+                res.shouldKeepAlive = false;
+            /* a body over the cap was left unread on the socket: never reuse the connection */
+            if (request[BODY_OVERFLOW] === true)
+                res.shouldKeepAlive = false;
+            await responseToNode(response, res);
+        }
+        catch (err) {
+            reportError(err);
+            if (!res.headersSent) {
+                res.writeHead(500, { "content-type": "text/plain" });
+                res.end("Internal Server Error");
+            }
+            else if (!res.destroyed) {
+                res.destroy();
+            }
+        }
+        finally {
+            if (request !== null)
+                inflight.delete(res);
+            /* a keep-alive connection that just went idle would hold `close()` open until it times out */
+            if (draining)
+                setImmediate(() => server.closeIdleConnections());
+        }
+    };
+    const server = createServer({
+        /* only a WebSocket handshake takes the upgrade path; `Upgrade: h2c` and the like are
+         * served as the normal requests they are (where Node has `shouldUpgradeCallback`; older Node ignores the option) */
+        shouldUpgradeCallback: isWebSocketUpgrade,
+    }, (req, res) => {
+        void handle(req, res);
+    });
+    if (options.headersTimeout !== undefined)
+        server.headersTimeout = options.headersTimeout;
+    if (options.requestTimeout !== undefined)
+        server.requestTimeout = options.requestTimeout;
+    if (options.keepAliveTimeout !== undefined)
+        server.keepAliveTimeout = options.keepAliveTimeout;
+    /** A WebSocket handshake, or (on Node without `shouldUpgradeCallback`) any request with `Upgrade`. */
+    const handleUpgrade = async (req, socket, head) => {
+        if (!isWebSocketUpgrade(req)) {
+            const source = upgradeBodySource(req, socket, head);
+            if (source === "unsupported") {
+                writeRawStatus(socket, 400, "Bad Request");
+                return;
+            }
+            socket.setTimeout(0);
+            await handle(req, responseOnSocket(req, socket), source);
+            return;
+        }
+        if (draining) {
+            writeRawStatus(socket, 503, "Service Unavailable");
+            return;
+        }
+        const request = incomingToRequest(req, requestOpts);
+        if (request === null) {
+            writeRawStatus(socket, 400, "Bad Request");
+            return;
+        }
+        socket.once("close", () => {
+            abort(request, new DOMException("The client disconnected", "AbortError"));
+        });
+        const state = { head, req, socket, upgraded: false };
+        const envWithUpgrade = { ...env, __nodeUpgrade: state };
+        let response;
+        try {
+            const maybe = app.fetch(request, envWithUpgrade);
+            response = maybe instanceof Promise ? await maybe : maybe;
+        }
+        catch (err) {
+            reportError(err);
+            /* once ws wrote the 101 the socket is a WebSocket: an HTTP status would corrupt it */
+            if (!state.upgraded) {
+                socket.setTimeout(0);
+                const res = responseOnSocket(req, socket);
+                res.writeHead(500, { "content-type": "text/plain" });
+                res.end("Internal Server Error");
+            }
+            return;
+        }
+        if (state.upgraded) {
+            socket.setTimeout(0);
+            upgraded.add(socket);
+            socket.once("close", () => upgraded.delete(socket));
+            return;
+        }
+        if (socket.destroyed) {
+            await response.body?.cancel().catch(() => { });
+            return;
+        }
+        /* not upgraded (auth rejected, 404, 426, an SSE route…): a real response, streamed, every header kept */
+        socket.setTimeout(0);
+        try {
+            await responseToNode(response, responseOnSocket(req, socket));
+        }
+        catch (err) {
+            reportError(err);
+            socket.destroy();
+        }
+    };
+    server.on("upgrade", (req, duplex, head) => {
+        const socket = duplex;
+        /* first: a reset while the app is still deciding must not become an uncaught 'error' event */
+        socket.on("error", () => {
+            socket.destroy();
+        });
+        if (upgradeTimeout > 0)
+            socket.setTimeout(upgradeTimeout, () => socket.destroy());
+        handleUpgrade(req, socket, head).catch((err) => {
+            reportError(err);
+            socket.destroy();
+        });
+    });
+    server.listen(options?.port ?? 0, options?.hostname);
+    const honeyServer = server;
+    /**
+     * Stop accepting connections and let in-flight requests finish. Responses already streaming
+     * (SSE, `generate()`) never finish on their own, so their `ctx.signal` aborts now and they
+     * end; WebSockets get a 1001 close. Handlers still working get until `timeout`; then their
+     * signal aborts and every connection, WebSockets included, is closed.
+     */
+    honeyServer.shutdown = (timeout) => {
+        draining = true;
+        const shutdownReason = () => new DOMException("The server is shutting down", "AbortError");
+        return new Promise((resolve) => {
+            let timer;
+            /* fires once every connection has closed */
+            server.close(() => {
+                if (timer !== undefined)
+                    clearTimeout(timer);
+                resolve();
+            });
+            server.closeIdleConnections();
+            for (const [res, request] of inflight) {
+                if (res.headersSent)
+                    abort(request, shutdownReason());
+            }
+            wsAdapter()?.closeAll?.(1001, "server shutting down");
+            if (timeout !== undefined) {
+                timer = setTimeout(() => {
+                    for (const request of inflight.values())
+                        abort(request, shutdownReason());
+                    for (const socket of upgraded)
+                        socket.destroy();
+                    server.closeAllConnections();
+                }, timeout);
+            }
+        });
+    };
+    return honeyServer;
+}
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

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

package/dist/openapi/collect.d.ts

@@ -1,4 +1,4 @@
-import type { RouteHandler, TreeNode, WSRouteHandler } from "../tree.ts";
+import type { RouteHandler, WSRouteHandler } from "../tree.ts";
 import type { InputSchemaEntry, StandardSchemaLike } from "../types.ts";
 export type CollectedRoute = {
     handler: RouteHandler;
@@ -9,9 +9,12 @@ export type CollectedWSRoute = {
     handler: WSRouteHandler;
     path: string;
 };
+/** Path parameter names of a route pattern, as OpenAPI names them (wildcards included). */
 export declare function extractParams(path: string): string[];
 export declare function toOpenApiPath(path: string): string;
-export declare function walkTree(node: TreeNode, currentPath: string, routes: CollectedRoute[], includeSkipped?: boolean): void;
-export declare function walkWSRoutes(node: TreeNode, currentPath: string, routes: CollectedWSRoute[]): void;
+/** Every served HTTP route of an app, one entry per concrete path. */
+export declare function collectRoutes(app: unknown, includeSkipped?: boolean): CollectedRoute[];
+/** Every websocket route of an app, one entry per concrete path. */
+export declare function collectWsRoutes(app: unknown): CollectedWSRoute[];
 export declare function unwrapEntry(entry: InputSchemaEntry): StandardSchemaLike;
 //# sourceMappingURL=collect.d.ts.map

package/dist/openapi/collect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../../src/openapi/collect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAEvE,MAAM,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,YAAY,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC9B,OAAO,EAAE,cAAc,CAAA;IACvB,IAAI,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAQpD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,QAAQ,CACvB,IAAI,EAAE,QAAQ,EACd,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EAAE,EACxB,cAAc,CAAC,EAAE,OAAO,GACtB,IAAI,CAsBN;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAUlG;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,kBAAkB,CAKvE"}
+{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../../src/openapi/collect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAEvE,MAAM,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,YAAY,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC9B,OAAO,EAAE,cAAc,CAAA;IACvB,IAAI,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,2FAA2F;AAC3F,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAOpD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAOD,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,OAAO,GAAG,cAAc,EAAE,CAEtF;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,EAAE,CAEhE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,kBAAkB,CAKvE"}

package/dist/openapi/collect.js

@@ -0,0 +1,30 @@
+import { parsePattern, toOpenApiTemplate, UNNAMED_WILDCARD } from "../pattern.js";
+/** Path parameter names of a route pattern, as OpenAPI names them (wildcards included). */
+export function extractParams(path) {
+    const out = [];
+    for (const seg of parsePattern(path)) {
+        if (seg.k === "param")
+            out.push(seg.n);
+        else if (seg.k === "wildcard")
+            out.push(seg.n === UNNAMED_WILDCARD ? "wildcard" : seg.n);
+    }
+    return out;
+}
+export function toOpenApiPath(path) {
+    return toOpenApiTemplate(parsePattern(path));
+}
+/** Every served HTTP route of an app, one entry per concrete path. */
+export function collectRoutes(app, includeSkipped) {
+    return app._collectRoutes(includeSkipped);
+}
+/** Every websocket route of an app, one entry per concrete path. */
+export function collectWsRoutes(app) {
+    return app._collectWsRoutes();
+}
+export function unwrapEntry(entry) {
+    if ("_tag" in entry) {
+        return entry.schema;
+    }
+    return entry;
+}
+//# sourceMappingURL=collect.js.map

package/dist/openapi/collect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect.js","sourceRoot":"","sources":["../../src/openapi/collect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAejF,2FAA2F;AAC3F,MAAM,UAAU,aAAa,CAAC,IAAY;IACzC,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,KAAK,MAAM,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,IAAI,GAAG,CAAC,CAAC,KAAK,OAAO;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;aACjC,IAAI,GAAG,CAAC,CAAC,KAAK,UAAU;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,gBAAgB,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IACzF,CAAC;IACD,OAAO,GAAG,CAAA;AACX,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACzC,OAAO,iBAAiB,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAA;AAC7C,CAAC;AAOD,sEAAsE;AACtE,MAAM,UAAU,aAAa,CAAC,GAAY,EAAE,cAAwB;IACnE,OAAQ,GAAmB,CAAC,cAAc,CAAC,cAAc,CAAC,CAAA;AAC3D,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,eAAe,CAAC,GAAY;IAC3C,OAAQ,GAAmB,CAAC,gBAAgB,EAAE,CAAA;AAC/C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAuB;IAClD,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC,MAA4B,CAAA;IAC1C,CAAC;IACD,OAAO,KAAK,CAAA;AACb,CAAC"}

package/dist/openapi/docs-page.d.ts

@@ -0,0 +1,42 @@
+import type { TypedResponse } from "../response.ts";
+/**
+ * Pinned docs UI assets with Subresource Integrity. The page runs on the API's own origin, so
+ * an unpinned CDN script could read anything the origin can; a pinned version with an
+ * integrity hash can only ever be these bytes.
+ */
+export declare const SWAGGER_UI: {
+    readonly css: {
+        readonly integrity: "sha384-Ov4/wv3j2bmct8cDc5X4ngJZohVPzEmc6uDPH8WeljUxO5vtoykvMEfbu9Vh6RaW";
+        readonly url: "https://cdn.jsdelivr.net/npm/swagger-ui-dist@5.33.1/swagger-ui.css";
+    };
+    readonly js: {
+        readonly integrity: "sha384-ZPehFMQommnnuaZ4rpxgkgTT2DKFVp4hZC/7pLit+9Lek9T1YGSo23eHFbvNkXkw";
+        readonly url: "https://cdn.jsdelivr.net/npm/swagger-ui-dist@5.33.1/swagger-ui-bundle.js";
+    };
+};
+export declare const SCALAR: {
+    readonly js: {
+        readonly integrity: "sha384-kYDGzV91Jnn3TbHINV3nt54riK2uMJDfN5Al8dAkz4FssELTBWbD8rgw32sTKfOi";
+        readonly url: "https://cdn.jsdelivr.net/npm/@scalar/api-reference@1.73.1/dist/browser/standalone.js";
+    };
+};
+/**
+ * JSON for an inline `<script>`: `<` cannot end the element, and U+2028/U+2029 cannot end a
+ * string literal in older engines.
+ */
+export declare function inlineJson(value: unknown): string;
+export declare function escapeAttribute(value: string): string;
+type DocsCtx = {
+    res: {
+        html(sk: "ok", body: string, opts?: {
+            headers?: Record<string, string>;
+        }): TypedResponse;
+    };
+};
+/**
+ * A docs page handler: a fresh script nonce per response, a CSP that allows only that inline
+ * script and the pinned CDN, and `nosniff`.
+ */
+export declare function docsPage(render: (nonce: string) => string): (ctx: DocsCtx) => TypedResponse;
+export {};
+//# sourceMappingURL=docs-page.d.ts.map

package/dist/openapi/docs-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-page.d.ts","sourceRoot":"","sources":["../../src/openapi/docs-page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD;;;;GAIG;AACH,eAAO,MAAM,UAAU;aACtB,GAAG;iBACF,SAAS,EAAE,yEAAyE;iBACpF,GAAG,EAAE,oEAAoE;;aAE1E,EAAE;iBACD,SAAS,EAAE,yEAAyE;iBACpF,GAAG,EAAE,0EAA0E;;CAEvE,CAAA;AAEV,eAAO,MAAM,MAAM;aAClB,EAAE;iBACD,SAAS,EAAE,yEAAyE;iBACpF,GAAG,EAAE,sFAAsF;;CAEnF,CAAA;AAQV;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOjD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAUD,KAAK,OAAO,GAAG;IAAE,GAAG,EAAE;QAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;SAAE,GAAG,aAAa,CAAA;KAAE,CAAA;CAAE,CAAA;AAEpH;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,aAAa,CA0B3F"}

package/dist/openapi/docs-page.js

@@ -0,0 +1,80 @@
+/**
+ * Pinned docs UI assets with Subresource Integrity. The page runs on the API's own origin, so
+ * an unpinned CDN script could read anything the origin can; a pinned version with an
+ * integrity hash can only ever be these bytes.
+ */
+export const SWAGGER_UI = {
+    css: {
+        integrity: "sha384-Ov4/wv3j2bmct8cDc5X4ngJZohVPzEmc6uDPH8WeljUxO5vtoykvMEfbu9Vh6RaW",
+        url: "https://cdn.jsdelivr.net/npm/swagger-ui-dist@5.33.1/swagger-ui.css",
+    },
+    js: {
+        integrity: "sha384-ZPehFMQommnnuaZ4rpxgkgTT2DKFVp4hZC/7pLit+9Lek9T1YGSo23eHFbvNkXkw",
+        url: "https://cdn.jsdelivr.net/npm/swagger-ui-dist@5.33.1/swagger-ui-bundle.js",
+    },
+};
+export const SCALAR = {
+    js: {
+        integrity: "sha384-kYDGzV91Jnn3TbHINV3nt54riK2uMJDfN5Al8dAkz4FssELTBWbD8rgw32sTKfOi",
+        url: "https://cdn.jsdelivr.net/npm/@scalar/api-reference@1.73.1/dist/browser/standalone.js",
+    },
+};
+const CDN_ORIGIN = "https://cdn.jsdelivr.net";
+/* built from char codes: a formatter may turn an escape in a literal into the raw separator */
+const LINE_SEPARATOR = String.fromCharCode(0x2028);
+const PARAGRAPH_SEPARATOR = String.fromCharCode(0x2029);
+/**
+ * JSON for an inline `<script>`: `<` cannot end the element, and U+2028/U+2029 cannot end a
+ * string literal in older engines.
+ */
+export function inlineJson(value) {
+    return JSON.stringify(value)
+        .replace(/</g, "\\u003c")
+        .replace(/>/g, "\\u003e")
+        .replace(/&/g, "\\u0026")
+        .replaceAll(LINE_SEPARATOR, "\\u2028")
+        .replaceAll(PARAGRAPH_SEPARATOR, "\\u2029");
+}
+export function escapeAttribute(value) {
+    return value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function nonce() {
+    const bytes = new Uint8Array(16);
+    crypto.getRandomValues(bytes);
+    let s = "";
+    for (const b of bytes)
+        s += String.fromCharCode(b);
+    return btoa(s);
+}
+/**
+ * A docs page handler: a fresh script nonce per response, a CSP that allows only that inline
+ * script and the pinned CDN, and `nosniff`.
+ */
+export function docsPage(render) {
+    const handler = (ctx) => {
+        const n = nonce();
+        const csp = [
+            "default-src 'none'",
+            `script-src 'nonce-${n}' ${CDN_ORIGIN}`,
+            `style-src 'self' 'unsafe-inline' ${CDN_ORIGIN}`,
+            "img-src 'self' data: https:",
+            "font-src 'self' data: https:",
+            "connect-src 'self' https:",
+            "worker-src blob:",
+            "base-uri 'none'",
+            "form-action 'none'",
+            "frame-ancestors 'self'",
+            "object-src 'none'",
+        ].join("; ");
+        return ctx.res.html("ok", render(n), {
+            headers: {
+                "content-security-policy": csp,
+                "referrer-policy": "no-referrer",
+                "x-content-type-options": "nosniff",
+            },
+        });
+    };
+    Object.defineProperty(handler, Symbol.for("honey.internal"), { value: true });
+    return handler;
+}
+//# sourceMappingURL=docs-page.js.map

package/dist/openapi/docs-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-page.js","sourceRoot":"","sources":["../../src/openapi/docs-page.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACzB,GAAG,EAAE;QACJ,SAAS,EAAE,yEAAyE;QACpF,GAAG,EAAE,oEAAoE;KACzE;IACD,EAAE,EAAE;QACH,SAAS,EAAE,yEAAyE;QACpF,GAAG,EAAE,0EAA0E;KAC/E;CACQ,CAAA;AAEV,MAAM,CAAC,MAAM,MAAM,GAAG;IACrB,EAAE,EAAE;QACH,SAAS,EAAE,yEAAyE;QACpF,GAAG,EAAE,sFAAsF;KAC3F;CACQ,CAAA;AAEV,MAAM,UAAU,GAAG,0BAA0B,CAAA;AAE7C,+FAA+F;AAC/F,MAAM,cAAc,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;AAClD,MAAM,mBAAmB,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;AAEvD;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,KAAc;IACxC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;SAC1B,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC;SACxB,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC;SACxB,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC;SACxB,UAAU,CAAC,cAAc,EAAE,SAAS,CAAC;SACrC,UAAU,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAA;AAC7C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAa;IAC5C,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;AACxG,CAAC;AAED,SAAS,KAAK;IACb,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAA;IAChC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAA;IAC7B,IAAI,CAAC,GAAG,EAAE,CAAA;IACV,KAAK,MAAM,CAAC,IAAI,KAAK;QAAE,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IAClD,OAAO,IAAI,CAAC,CAAC,CAAC,CAAA;AACf,CAAC;AAID;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAiC;IACzD,MAAM,OAAO,GAAG,CAAC,GAAY,EAAE,EAAE;QAChC,MAAM,CAAC,GAAG,KAAK,EAAE,CAAA;QACjB,MAAM,GAAG,GAAG;YACX,oBAAoB;YACpB,qBAAqB,CAAC,KAAK,UAAU,EAAE;YACvC,oCAAoC,UAAU,EAAE;YAChD,6BAA6B;YAC7B,8BAA8B;YAC9B,2BAA2B;YAC3B,kBAAkB;YAClB,iBAAiB;YACjB,oBAAoB;YACpB,wBAAwB;YACxB,mBAAmB;SACnB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACZ,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE;YACpC,OAAO,EAAE;gBACR,yBAAyB,EAAE,GAAG;gBAC9B,iBAAiB,EAAE,aAAa;gBAChC,wBAAwB,EAAE,SAAS;aACnC;SACD,CAAC,CAAA;IACH,CAAC,CAAA;IACD,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IAC7E,OAAO,OAAO,CAAA;AACf,CAAC"}

package/dist/openapi/document.d.ts

@@ -17,6 +17,10 @@ export type OpenApiSpec = {
     info: OpenApiInfo;
     openapi: string;
     paths: Record<string, Record<string, Record<string, unknown>>>;
+    servers?: Array<{
+        description?: string;
+        url: string;
+    }>;
 };
 export declare const DEFAULT_ERROR_JSON_SCHEMA: Record<string, unknown>;
 export declare function generateOpenApiFromTree<TMeta = unknown>(app: unknown, options: {

package/dist/openapi/document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/openapi/document.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAA4B,MAAM,wBAAwB,CAAA;AAsB7F,MAAM,MAAM,gBAAgB,CAAC,KAAK,GAAG,OAAO,IAAI;IAC/C,IAAI,EAAE,KAAK,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACzB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACzB,UAAU,CAAC,EAAE;QACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;QACjD,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACzC,CAAA;IACD,IAAI,EAAE,WAAW,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;CAC9D,CAAA;AAED,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAyB7D,CAAA;AAwND,wBAAgB,uBAAuB,CAAC,KAAK,GAAG,OAAO,EACtD,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE;IACR,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,OAAO,CAAA;IAC1D,IAAI,EAAE,WAAW,CAAA;IACjB,UAAU,CAAC,EAAE,qBAAqB,CAAA;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACzC,GACC,WAAW,CA4Tb"}
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/openapi/document.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAA4B,MAAM,wBAAwB,CAAA;AAyB7F,MAAM,MAAM,gBAAgB,CAAC,KAAK,GAAG,OAAO,IAAI;IAC/C,IAAI,EAAE,KAAK,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACzB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACzB,UAAU,CAAC,EAAE;QACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;QACjD,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACzC,CAAA;IACD,IAAI,EAAE,WAAW,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;IAC9D,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACtD,CAAA;AAED,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAyB7D,CAAA;AAibD,wBAAgB,uBAAuB,CAAC,KAAK,GAAG,OAAO,EACtD,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE;IACR,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,OAAO,CAAA;IAC1D,IAAI,EAAE,WAAW,CAAA;IACjB,UAAU,CAAC,EAAE,qBAAqB,CAAA;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACzC,GACC,WAAW,CAkQb"}