clinkx 0.2.3 → 1.0.0

package/dist/dashboard-companion/client.js

@@ -0,0 +1,210 @@
+import WebSocket from "ws";
+import { proxyDashboardApiRequest, proxyDashboardApiRequestV2, } from "./http-proxy.js";
+import { companionProxyFailure, companionProxyFailureV2, DASHBOARD_GATEWAY_V2_SUBPROTOCOL, MAX_GATEWAY_REQUEST_BYTES, MAX_GATEWAY_V2_REQUEST_BYTES, parseGatewayRequest, parseGatewayV2Request, } from "./protocol.js";
+const RECENT_REQUEST_IDS_MAX = 1_024;
+const IN_FLIGHT_REQUESTS_MAX = 8;
+function rawDataBuffer(raw) {
+    if (Buffer.isBuffer(raw))
+        return raw;
+    if (raw instanceof ArrayBuffer)
+        return Buffer.from(raw);
+    if (Array.isArray(raw))
+        return Buffer.concat(raw);
+    return Buffer.from(raw);
+}
+/**
+ * Maintains the companion's single outbound authenticated WebSocket and
+ * transports the negotiated bounded request/response protocol to the loopback API.
+ */
+export class DashboardGatewayClient {
+    options;
+    minimumReconnectMs;
+    maximumReconnectMs;
+    random;
+    recentRequestIds = new Set();
+    socket;
+    reconnectTimer;
+    reconnectAttempt = 0;
+    inFlightRequests = 0;
+    started = false;
+    closed = false;
+    constructor(options) {
+        this.options = options;
+        this.minimumReconnectMs = options.reconnect?.minimumMs ?? 250;
+        this.maximumReconnectMs = options.reconnect?.maximumMs ?? 15_000;
+        this.random = options.random ?? Math.random;
+        if (!Number.isFinite(this.minimumReconnectMs)
+            || !Number.isFinite(this.maximumReconnectMs)
+            || this.minimumReconnectMs < 0
+            || this.maximumReconnectMs < this.minimumReconnectMs) {
+            throw new Error("invalid dashboard gateway reconnect bounds");
+        }
+    }
+    start() {
+        if (this.started)
+            throw new Error("dashboard gateway client was already started");
+        this.started = true;
+        this.connect();
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        if (this.reconnectTimer !== undefined) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = undefined;
+        }
+        const socket = this.socket;
+        this.socket = undefined;
+        if (socket === undefined || socket.readyState === WebSocket.CLOSED)
+            return;
+        await new Promise((resolve) => {
+            let settled = false;
+            const finish = () => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                resolve();
+            };
+            const timer = setTimeout(() => {
+                socket.terminate();
+                finish();
+            }, 250);
+            timer.unref();
+            socket.once("close", finish);
+            socket.once("error", finish);
+            if (socket.readyState === WebSocket.CONNECTING)
+                socket.terminate();
+            else
+                socket.close(1000, "companion shutdown");
+        });
+    }
+    connect() {
+        if (this.closed)
+            return;
+        const connectionOptions = {
+            headers: { Authorization: `Bearer ${this.options.token}` },
+            followRedirects: false,
+            handshakeTimeout: 10_000,
+            maxPayload: this.options.protocol === "v2"
+                ? MAX_GATEWAY_V2_REQUEST_BYTES
+                : MAX_GATEWAY_REQUEST_BYTES,
+            perMessageDeflate: false,
+        };
+        const socket = this.options.protocol === "v2"
+            ? new WebSocket(this.options.url, DASHBOARD_GATEWAY_V2_SUBPROTOCOL, connectionOptions)
+            : new WebSocket(this.options.url, connectionOptions);
+        this.socket = socket;
+        socket.once("open", () => {
+            if (this.socket !== socket || this.closed)
+                return;
+            if (this.options.protocol === "v2"
+                && socket.protocol !== DASHBOARD_GATEWAY_V2_SUBPROTOCOL) {
+                socket.close(1002, "gateway v2 subprotocol required");
+                return;
+            }
+            this.reconnectAttempt = 0;
+            this.recentRequestIds.clear();
+        });
+        socket.on("message", (raw, isBinary) => {
+            if (this.socket !== socket || this.closed || isBinary) {
+                if (isBinary)
+                    socket.close(1008, "text frames required");
+                return;
+            }
+            void this.handleMessage(socket, raw).catch(() => {
+                if (this.socket === socket && socket.readyState === WebSocket.OPEN) {
+                    socket.close(1011, "gateway request failed");
+                }
+            });
+        });
+        // Error details can include network data. The close event owns bounded retry.
+        socket.on("error", () => undefined);
+        socket.once("close", () => {
+            if (this.socket === socket)
+                this.socket = undefined;
+            if (!this.closed)
+                this.scheduleReconnect();
+        });
+    }
+    async handleMessage(socket, raw) {
+        const v2 = this.options.protocol === "v2";
+        let request;
+        try {
+            const buffer = rawDataBuffer(raw);
+            request = v2
+                ? parseGatewayV2Request(buffer)
+                : parseGatewayRequest(buffer);
+        }
+        catch {
+            socket.close(1008, "invalid gateway request");
+            return;
+        }
+        if (this.recentRequestIds.has(request.id))
+            return;
+        if (this.recentRequestIds.size >= RECENT_REQUEST_IDS_MAX) {
+            socket.close(1008, "request id capacity exceeded");
+            return;
+        }
+        this.recentRequestIds.add(request.id);
+        if (this.inFlightRequests >= IN_FLIGHT_REQUESTS_MAX) {
+            if (this.socket === socket && socket.readyState === WebSocket.OPEN) {
+                try {
+                    await this.sendResponse(socket, v2
+                        ? companionProxyFailureV2(request.id)
+                        : companionProxyFailure(request.id));
+                }
+                catch {
+                    socket.close(1011, "gateway response failed");
+                }
+            }
+            return;
+        }
+        this.inFlightRequests += 1;
+        try {
+            const response = v2
+                ? await proxyDashboardApiRequestV2(request, {
+                    port: this.options.localPort,
+                })
+                : await proxyDashboardApiRequest(request, {
+                    port: this.options.localPort,
+                });
+            if (this.closed || this.socket !== socket || socket.readyState !== WebSocket.OPEN)
+                return;
+            try {
+                await this.sendResponse(socket, response);
+            }
+            catch {
+                socket.close(1011, "gateway response failed");
+            }
+        }
+        finally {
+            this.inFlightRequests -= 1;
+        }
+    }
+    sendResponse(socket, response) {
+        return new Promise((resolve, reject) => {
+            socket.send(JSON.stringify(response), (error) => {
+                if (error == null)
+                    resolve();
+                else
+                    reject(error);
+            });
+        });
+    }
+    scheduleReconnect() {
+        if (this.closed || this.reconnectTimer !== undefined)
+            return;
+        const exponential = Math.min(this.maximumReconnectMs, this.minimumReconnectMs * (2 ** Math.min(this.reconnectAttempt, 16)));
+        this.reconnectAttempt += 1;
+        const jitter = 0.5 + Math.max(0, Math.min(1, this.random())) * 0.5;
+        const delay = Math.min(this.maximumReconnectMs, Math.round(exponential * jitter));
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = undefined;
+            this.connect();
+        }, delay);
+        this.reconnectTimer.unref();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/dashboard-companion/client.js.map

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

package/dist/dashboard-companion/config.d.ts

@@ -0,0 +1,8 @@
+export declare const DASHBOARD_GATEWAY_URL_ENV = "CLINKX_DASHBOARD_GATEWAY_URL";
+export declare const DASHBOARD_GATEWAY_TOKEN_ENV = "CLINKX_DASHBOARD_GATEWAY_TOKEN";
+export interface DashboardGatewayConfig {
+    readonly url: string;
+    readonly token: string;
+}
+/** Resolve the atomic, environment-only gateway opt-in. */
+export declare function resolveDashboardGatewayConfig(env?: NodeJS.ProcessEnv): DashboardGatewayConfig | undefined;

package/dist/dashboard-companion/config.js

@@ -0,0 +1,52 @@
+import { isDashboardPairingToken } from "../dashboard-pairing-token.js";
+export const DASHBOARD_GATEWAY_URL_ENV = "CLINKX_DASHBOARD_GATEWAY_URL";
+export const DASHBOARD_GATEWAY_TOKEN_ENV = "CLINKX_DASHBOARD_GATEWAY_TOKEN";
+function isLoopback(hostname) {
+    return hostname === "localhost" || hostname === "127.0.0.1" || hostname === "[::1]";
+}
+function parseGatewayUrl(raw) {
+    let parsed;
+    try {
+        parsed = new URL(raw);
+    }
+    catch {
+        throw new Error(`${DASHBOARD_GATEWAY_URL_ENV} must be an absolute HTTP(S) or WS(S) URL`);
+    }
+    if (parsed.username !== ""
+        || parsed.password !== ""
+        || parsed.search !== ""
+        || parsed.hash !== "") {
+        throw new Error(`${DASHBOARD_GATEWAY_URL_ENV} must not contain credentials, query, or fragment`);
+    }
+    if (parsed.protocol === "https:")
+        parsed.protocol = "wss:";
+    if (parsed.protocol === "http:")
+        parsed.protocol = "ws:";
+    if (parsed.protocol !== "wss:" && parsed.protocol !== "ws:") {
+        throw new Error(`${DASHBOARD_GATEWAY_URL_ENV} must use HTTPS/WSS`);
+    }
+    if (parsed.protocol === "ws:" && !isLoopback(parsed.hostname)) {
+        throw new Error(`${DASHBOARD_GATEWAY_URL_ENV} permits plaintext only on loopback`);
+    }
+    return parsed.href;
+}
+/** Resolve the atomic, environment-only gateway opt-in. */
+export function resolveDashboardGatewayConfig(env = process.env) {
+    const rawUrl = env[DASHBOARD_GATEWAY_URL_ENV];
+    const rawToken = env[DASHBOARD_GATEWAY_TOKEN_ENV];
+    const hasUrl = rawUrl !== undefined && rawUrl !== "";
+    const hasToken = rawToken !== undefined && rawToken !== "";
+    if (!hasUrl && !hasToken)
+        return undefined;
+    if (hasUrl !== hasToken) {
+        throw new Error(`${DASHBOARD_GATEWAY_URL_ENV} and ${DASHBOARD_GATEWAY_TOKEN_ENV} must be configured together`);
+    }
+    if (!isDashboardPairingToken(rawToken)) {
+        throw new Error(`${DASHBOARD_GATEWAY_TOKEN_ENV} is invalid`);
+    }
+    if (rawUrl !== rawUrl.trim()) {
+        throw new Error(`${DASHBOARD_GATEWAY_URL_ENV} is invalid`);
+    }
+    return { url: parseGatewayUrl(rawUrl), token: rawToken };
+}
+//# sourceMappingURL=config.js.map

package/dist/dashboard-companion/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/dashboard-companion/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAExE,MAAM,CAAC,MAAM,yBAAyB,GAAG,8BAA8B,CAAC;AACxE,MAAM,CAAC,MAAM,2BAA2B,GAAG,gCAAgC,CAAC;AAO5E,SAAS,UAAU,CAAC,QAAgB;IAClC,OAAO,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,OAAO,CAAC;AACtF,CAAC;AAED,SAAS,eAAe,CAAC,GAAW;IAClC,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,GAAG,yBAAyB,2CAA2C,CAAC,CAAC;IAC3F,CAAC;IACD,IACE,MAAM,CAAC,QAAQ,KAAK,EAAE;WACnB,MAAM,CAAC,QAAQ,KAAK,EAAE;WACtB,MAAM,CAAC,MAAM,KAAK,EAAE;WACpB,MAAM,CAAC,IAAI,KAAK,EAAE,EACrB,CAAC;QACD,MAAM,IAAI,KAAK,CACb,GAAG,yBAAyB,mDAAmD,CAChF,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ;QAAE,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC;IAC3D,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO;QAAE,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC;IACzD,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,IAAI,MAAM,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CAAC,GAAG,yBAAyB,qBAAqB,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,KAAK,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,GAAG,yBAAyB,qCAAqC,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,6BAA6B,CAC3C,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,MAAM,GAAG,GAAG,CAAC,yBAAyB,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,GAAG,CAAC,2BAA2B,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,EAAE,CAAC;IACrD,MAAM,QAAQ,GAAG,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,EAAE,CAAC;IAC3D,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC3C,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,GAAG,yBAAyB,QAAQ,2BAA2B,8BAA8B,CAC9F,CAAC;IACJ,CAAC;IACD,IACE,CAAC,uBAAuB,CAAC,QAAS,CAAC,EACnC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,GAAG,2BAA2B,aAAa,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,MAAM,KAAK,MAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,GAAG,yBAAyB,aAAa,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,eAAe,CAAC,MAAO,CAAC,EAAE,KAAK,EAAE,QAAS,EAAE,CAAC;AAC7D,CAAC"}

package/dist/dashboard-companion/http-proxy.d.ts

@@ -0,0 +1,10 @@
+import { type GatewayRequest, type GatewayResponse, type GatewayV2Request, type GatewayV2Response } from "./protocol.js";
+export interface DashboardHttpProxyOptions {
+    readonly port: number;
+    readonly maxResponseBytes?: number;
+    readonly requestTimeoutMs?: number;
+}
+/** Proxy one already-admitted gateway request to the loopback dashboard API. */
+export declare function proxyDashboardApiRequest(input: GatewayRequest, options: DashboardHttpProxyOptions): Promise<GatewayResponse>;
+/** Proxy one already-admitted gateway v2 request to the loopback passkey API. */
+export declare function proxyDashboardApiRequestV2(input: GatewayV2Request, options: DashboardHttpProxyOptions): Promise<GatewayV2Response>;

package/dist/dashboard-companion/http-proxy.js

@@ -0,0 +1,234 @@
+import { request as httpRequest } from "node:http";
+import { companionProxyFailure, companionProxyFailureV2, MAX_DASHBOARD_RESPONSE_BYTES, parseGatewayV2Response, } from "./protocol.js";
+const RESPONSE_HEADER_ALLOWLIST = new Set([
+    "access-control-allow-headers",
+    "access-control-allow-methods",
+    "access-control-allow-origin",
+    "access-control-expose-headers",
+    "access-control-max-age",
+    "allow",
+    "cache-control",
+    "content-length",
+    "content-type",
+    "etag",
+    "vary",
+    "x-clinkx-agent-instance-id",
+]);
+function requestHeaders(input) {
+    const headers = { Host: input.headers.host };
+    if (input.headers.origin !== undefined)
+        headers.Origin = input.headers.origin;
+    if (input.headers.authorization !== undefined) {
+        headers.Authorization = input.headers.authorization;
+    }
+    if (input.headers.accessControlRequestMethod !== undefined) {
+        headers["Access-Control-Request-Method"] = input.headers.accessControlRequestMethod;
+    }
+    if (input.headers.accessControlRequestHeaders !== undefined) {
+        headers["Access-Control-Request-Headers"] = input.headers.accessControlRequestHeaders;
+    }
+    if (input.headers.agentInstanceId !== undefined) {
+        headers["X-ClinkX-Agent-Instance-Id"] = input.headers.agentInstanceId;
+    }
+    return headers;
+}
+function responseHeaders(headers) {
+    const admitted = {};
+    for (const [name, values] of Object.entries(headers)) {
+        if (!RESPONSE_HEADER_ALLOWLIST.has(name) || values === undefined)
+            continue;
+        admitted[name] = Array.isArray(values) ? values.join(", ") : values;
+    }
+    return admitted;
+}
+function v2RequestHeaders(input, body) {
+    const headers = { Host: input.headers.host };
+    if (input.headers.origin !== undefined)
+        headers.Origin = input.headers.origin;
+    if (input.headers.cookie !== undefined)
+        headers.Cookie = input.headers.cookie;
+    if (input.headers.contentType !== undefined) {
+        headers["Content-Type"] = input.headers.contentType;
+    }
+    if (input.headers.enrollmentCode !== undefined) {
+        headers["X-Enrollment-Code"] = input.headers.enrollmentCode;
+    }
+    if (input.method === "POST") {
+        headers["Content-Length"] = String(body.byteLength);
+    }
+    return headers;
+}
+function singleResponseHeader(headers, name) {
+    const value = headers[name];
+    if (value === undefined)
+        return undefined;
+    return Array.isArray(value) ? value.join(", ") : value;
+}
+function v2ResponseHeaders(headers) {
+    const allow = singleResponseHeader(headers, "allow");
+    const cacheControl = singleResponseHeader(headers, "cache-control");
+    const contentLength = singleResponseHeader(headers, "content-length");
+    const contentType = singleResponseHeader(headers, "content-type");
+    const etag = singleResponseHeader(headers, "etag");
+    const retryAfter = singleResponseHeader(headers, "retry-after");
+    const validatorSchemaId = singleResponseHeader(headers, "x-clinkx-validator-schema-id");
+    const vary = singleResponseHeader(headers, "vary");
+    const setCookie = headers["set-cookie"];
+    const setCookies = setCookie === undefined
+        ? undefined
+        : Array.isArray(setCookie)
+            ? setCookie
+            : [setCookie];
+    return {
+        ...(allow === undefined ? {} : { allow }),
+        ...(cacheControl === undefined ? {} : { cacheControl }),
+        ...(contentLength === undefined ? {} : { contentLength }),
+        ...(contentType === undefined ? {} : { contentType }),
+        ...(etag === undefined ? {} : { etag }),
+        ...(retryAfter === undefined ? {} : { retryAfter }),
+        ...(setCookies === undefined ? {} : { setCookies }),
+        ...(validatorSchemaId === undefined ? {} : { validatorSchemaId }),
+        ...(vary === undefined ? {} : { vary }),
+    };
+}
+function admittedV2Response(response) {
+    try {
+        return parseGatewayV2Response(JSON.stringify(response));
+    }
+    catch {
+        return companionProxyFailureV2(response.id);
+    }
+}
+/** Proxy one already-admitted gateway request to the loopback dashboard API. */
+export function proxyDashboardApiRequest(input, options) {
+    const maxResponseBytes = options.maxResponseBytes ?? MAX_DASHBOARD_RESPONSE_BYTES;
+    const requestTimeoutMs = options.requestTimeoutMs ?? 30_000;
+    if (!Number.isInteger(options.port) || options.port < 1 || options.port > 65_535) {
+        return Promise.resolve(companionProxyFailure(input.id));
+    }
+    if (!Number.isInteger(maxResponseBytes) || maxResponseBytes < 0) {
+        return Promise.resolve(companionProxyFailure(input.id));
+    }
+    return new Promise((resolve) => {
+        let settled = false;
+        const settle = (response) => {
+            if (settled)
+                return;
+            settled = true;
+            resolve(response);
+        };
+        const outgoing = httpRequest({
+            host: "127.0.0.1",
+            port: options.port,
+            method: input.method,
+            path: input.path,
+            headers: requestHeaders(input),
+            timeout: requestTimeoutMs,
+        }, (incoming) => {
+            const declaredLength = Number(incoming.headers["content-length"]);
+            if (Number.isFinite(declaredLength)
+                && declaredLength > maxResponseBytes) {
+                incoming.destroy();
+                settle(companionProxyFailure(input.id));
+                return;
+            }
+            const chunks = [];
+            let bytes = 0;
+            incoming.on("data", (chunk) => {
+                const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+                bytes += buffer.byteLength;
+                if (bytes > maxResponseBytes) {
+                    incoming.destroy();
+                    settle(companionProxyFailure(input.id));
+                    return;
+                }
+                chunks.push(buffer);
+            });
+            incoming.once("error", () => settle(companionProxyFailure(input.id)));
+            incoming.once("end", () => {
+                settle({
+                    v: 1,
+                    type: "response",
+                    id: input.id,
+                    status: incoming.statusCode ?? 502,
+                    headers: responseHeaders(incoming.headersDistinct),
+                    bodyBase64: input.method === "HEAD"
+                        ? ""
+                        : Buffer.concat(chunks, bytes).toString("base64"),
+                });
+            });
+        });
+        outgoing.once("timeout", () => outgoing.destroy(new Error("dashboard API timed out")));
+        outgoing.once("error", () => settle(companionProxyFailure(input.id)));
+        outgoing.end();
+    });
+}
+/** Proxy one already-admitted gateway v2 request to the loopback passkey API. */
+export function proxyDashboardApiRequestV2(input, options) {
+    const maxResponseBytes = options.maxResponseBytes ?? MAX_DASHBOARD_RESPONSE_BYTES;
+    const requestTimeoutMs = options.requestTimeoutMs ?? 30_000;
+    if (!Number.isInteger(options.port) || options.port < 1 || options.port > 65_535) {
+        return Promise.resolve(companionProxyFailureV2(input.id));
+    }
+    if (!Number.isInteger(maxResponseBytes) || maxResponseBytes < 0) {
+        return Promise.resolve(companionProxyFailureV2(input.id));
+    }
+    if (!Number.isSafeInteger(requestTimeoutMs) || requestTimeoutMs <= 0) {
+        return Promise.resolve(companionProxyFailureV2(input.id));
+    }
+    const body = Buffer.from(input.bodyBase64, "base64");
+    return new Promise((resolve) => {
+        let settled = false;
+        const settle = (response) => {
+            if (settled)
+                return;
+            settled = true;
+            resolve(response);
+        };
+        const outgoing = httpRequest({
+            host: "127.0.0.1",
+            port: options.port,
+            method: input.method,
+            path: input.path,
+            headers: v2RequestHeaders(input, body),
+            timeout: requestTimeoutMs,
+        }, (incoming) => {
+            const declaredLength = Number(incoming.headers["content-length"]);
+            if (Number.isFinite(declaredLength)
+                && declaredLength > maxResponseBytes) {
+                incoming.destroy();
+                settle(companionProxyFailureV2(input.id));
+                return;
+            }
+            const chunks = [];
+            let bytes = 0;
+            incoming.on("data", (chunk) => {
+                const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+                bytes += buffer.byteLength;
+                if (bytes > maxResponseBytes) {
+                    incoming.destroy();
+                    settle(companionProxyFailureV2(input.id));
+                    return;
+                }
+                chunks.push(buffer);
+            });
+            incoming.once("error", () => settle(companionProxyFailureV2(input.id)));
+            incoming.once("end", () => {
+                settle(admittedV2Response({
+                    v: 2,
+                    type: "response",
+                    id: input.id,
+                    status: incoming.statusCode ?? 502,
+                    headers: v2ResponseHeaders(incoming.headersDistinct),
+                    bodyBase64: input.method === "HEAD"
+                        ? ""
+                        : Buffer.concat(chunks, bytes).toString("base64"),
+                }));
+            });
+        });
+        outgoing.once("timeout", () => outgoing.destroy(new Error("dashboard API timed out")));
+        outgoing.once("error", () => settle(companionProxyFailureV2(input.id)));
+        outgoing.end(body);
+    });
+}
+//# sourceMappingURL=http-proxy.js.map

package/dist/dashboard-companion/http-proxy.js.map

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

package/dist/dashboard-companion/protocol.d.ts

@@ -0,0 +1,80 @@
+export declare const MAX_GATEWAY_REQUEST_BYTES: number;
+export declare const MAX_GATEWAY_REQUEST_PATH_CHARS = 2048;
+export declare const MAX_DASHBOARD_RESPONSE_BYTES: number;
+export declare const DASHBOARD_GATEWAY_V2_SUBPROTOCOL = "clinkx-dashboard-gateway-v2";
+export declare const MAX_GATEWAY_V2_REQUEST_BYTES: number;
+export declare const MAX_GATEWAY_V2_REQUEST_BODY_BYTES: number;
+export declare const MAX_GATEWAY_V2_REQUEST_PATH_BYTES = 2048;
+export declare const MAX_GATEWAY_V2_HEADER_BYTES: number;
+export declare const MAX_GATEWAY_V2_RESPONSE_BYTES: number;
+export declare const MAX_GATEWAY_V2_COOKIE_BYTES: number;
+export type GatewayMethod = "GET" | "HEAD" | "OPTIONS";
+export interface GatewayRequestHeaders {
+    readonly host: string;
+    readonly origin?: string;
+    readonly authorization?: string;
+    readonly accessControlRequestMethod?: string;
+    readonly accessControlRequestHeaders?: string;
+    readonly agentInstanceId?: string;
+}
+export interface GatewayRequest {
+    readonly v: 1;
+    readonly type: "request";
+    readonly id: string;
+    readonly method: GatewayMethod;
+    readonly path: string;
+    readonly headers: GatewayRequestHeaders;
+}
+export interface GatewayResponse {
+    readonly v: 1;
+    readonly type: "response";
+    readonly id: string;
+    readonly status: number;
+    readonly headers: Readonly<Record<string, string>>;
+    readonly bodyBase64: string;
+}
+export type GatewayV2Method = "GET" | "HEAD" | "POST";
+export interface GatewayV2RequestHeaders {
+    readonly host: string;
+    readonly origin?: string;
+    readonly cookie?: string;
+    readonly contentType?: string;
+    readonly enrollmentCode?: string;
+}
+export interface GatewayV2Request {
+    readonly v: 2;
+    readonly type: "request";
+    readonly id: string;
+    readonly method: GatewayV2Method;
+    readonly path: string;
+    readonly headers: GatewayV2RequestHeaders;
+    readonly bodyBase64: string;
+}
+export interface GatewayV2ResponseHeaders {
+    readonly allow?: string;
+    readonly cacheControl?: string;
+    readonly contentLength?: string;
+    readonly contentType?: string;
+    readonly etag?: string;
+    readonly retryAfter?: string;
+    readonly setCookies?: readonly string[];
+    readonly validatorSchemaId?: string;
+    readonly vary?: string;
+}
+export interface GatewayV2Response {
+    readonly v: 2;
+    readonly type: "response";
+    readonly id: string;
+    readonly status: number;
+    readonly headers: GatewayV2ResponseHeaders;
+    readonly bodyBase64: string;
+}
+export declare function isForwardableV2PostPath(path: string): boolean;
+/** Strictly admit one bounded gateway v1 request frame. */
+export declare function parseGatewayRequest(raw: string | Buffer): GatewayRequest;
+/** Strictly admit one negotiated gateway v2 request frame. */
+export declare function parseGatewayV2Request(raw: string | Buffer): GatewayV2Request;
+/** Strictly admit one negotiated gateway v2 response frame. */
+export declare function parseGatewayV2Response(raw: string | Buffer): GatewayV2Response;
+export declare function companionProxyFailureV2(id: string): GatewayV2Response;
+export declare function companionProxyFailure(id: string): GatewayResponse;