@termlink/cli 0.1.0

package/dist/relay/device.js

@@ -0,0 +1,83 @@
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { httpBase } from "./api.js";
+/** A problem only the user can fix, by signing in again. */
+export class DeviceError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "DeviceError";
+    }
+}
+const RENEW_WHEN_LEFT_MS = 30 * 24 * 60 * 60 * 1000;
+export function defaultCredentialPath() {
+    return path.join(os.homedir(), ".termlink", "device.json");
+}
+const normalize = (url) => url.trim().replace(/\/+$/, "").toLowerCase();
+export async function loadDevice(file, server, now = Date.now()) {
+    let raw;
+    try {
+        raw = await readFile(file, "utf8");
+    }
+    catch {
+        throw new DeviceError(`no TermLink sign-in found at ${file}; run \`termlink login\` first`);
+    }
+    let credential;
+    try {
+        credential = JSON.parse(raw);
+    }
+    catch {
+        throw new DeviceError(`${file} is not valid JSON; run \`termlink login\` again`);
+    }
+    if (typeof credential.token !== "string" || !credential.token) {
+        throw new DeviceError(`${file} has no device token; run \`termlink login\` again`);
+    }
+    if (normalize(String(credential.master ?? "")) !== normalize(server)) {
+        throw new DeviceError(`the sign-in in ${file} is for ${credential.master}, not ${server}; run \`termlink login\``);
+    }
+    if (!(Date.parse(credential.expires_at) > now)) {
+        throw new DeviceError("the TermLink sign-in on this machine has expired; run `termlink login`");
+    }
+    return credential;
+}
+/** Renews the device token when less than 30 days are left, like the Go CLI does at startup. */
+export async function renewIfDue(file, server, credential, fetchFn, now = Date.now()) {
+    if (Date.parse(credential.expires_at) - now > RENEW_WHEN_LEFT_MS)
+        return credential;
+    let res;
+    try {
+        res = await fetchFn(`${httpBase(server)}/devices/renew`, {
+            method: "POST",
+            headers: { authorization: `Bearer ${credential.token}` },
+            signal: AbortSignal.timeout(15_000),
+        });
+    }
+    catch {
+        return credential; // Offline: the current token still works; try again next start.
+    }
+    if (res.status === 401 || res.status === 403) {
+        throw new DeviceError("this machine was signed out of TermLink; run `termlink login`");
+    }
+    if (!res.ok)
+        return credential;
+    const body = (await res.json());
+    if (!body.device_token || !body.expires_at)
+        return credential;
+    const fresh = {
+        ...credential,
+        token: body.device_token,
+        expires_at: body.expires_at,
+        ...(body.device_id ? { id: body.device_id } : {}),
+        ...(body.email ? { email: body.email } : {}),
+        ...(body.name ? { name: body.name } : {}),
+    };
+    await saveDevice(file, fresh);
+    return fresh;
+}
+export async function saveDevice(file, credential) {
+    await mkdir(path.dirname(file), { recursive: true });
+    const temp = `${file}.${process.pid}.tmp`;
+    await writeFile(temp, `${JSON.stringify(credential, null, 2)}\n`, { mode: 0o600 });
+    await rename(temp, file);
+}
+//# sourceMappingURL=device.js.map

package/dist/relay/device.js.map

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

package/dist/relay/relay-host.d.ts

@@ -0,0 +1,41 @@
+import { type HostInfo } from "@termlink/protocol";
+import type { SessionManager } from "../session/manager.js";
+import { type Fetch } from "./api.js";
+export declare const DEFAULT_SERVER = "wss://connect.getterm.link:9000";
+export interface RelayHostOptions {
+    manager: SessionManager;
+    hostInfo: () => Promise<HostInfo>;
+    /** Master relay. */
+    server: string;
+    /** Relay session name. One per host process; every agent session travels inside it. */
+    session: string;
+    name?: string;
+    /** Shown in the host list; the first allowed root is a good value. */
+    cwd?: string;
+    credentialPath?: string;
+    fetch?: Fetch;
+    minBackoffMs?: number;
+    maxBackoffMs?: number;
+    pingIntervalMs?: number;
+    log?: (line: string) => void;
+    /** The relay connection ended for good: the session was ended from the account, or sign-in is needed. */
+    onStopped?: (reason: string) => void;
+}
+/**
+ * Connects the host to the TermLink relay as `role=host&caps=agent`. The relay
+ * merges every client into this one socket and broadcasts what the host sends,
+ * so the whole relay link is served by a single ClientConnection.
+ */
+export declare class RelayHost {
+    #private;
+    readonly relayUrl: string;
+    /** Resolves on the first successful connection. */
+    readonly ready: Promise<void>;
+    private constructor();
+    /** Signs in with the device credential, registers the session and starts connecting. */
+    static start(options: RelayHostOptions): Promise<RelayHost>;
+    close(): Promise<void>;
+}
+/** Relay session name for this machine: stable, so a restarted host takes its slot back. */
+export declare function defaultRelaySession(): string;
+//# sourceMappingURL=relay-host.d.ts.map

package/dist/relay/relay-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-host.d.ts","sourceRoot":"","sources":["../../src/relay/relay-host.ts"],"names":[],"mappings":"AACA,OAAO,EAAmD,KAAK,QAAQ,EAAoB,MAAM,oBAAoB,CAAC;AAMtH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAA2D,KAAK,KAAK,EAAE,MAAM,UAAU,CAAC;AAG/F,eAAO,MAAM,cAAc,oCAAoC,CAAC;AAEhE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClC,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,uFAAuF;IACvF,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,yGAAyG;IACzG,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAWD;;;;GAIG;AACH,qBAAa,SAAS;;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAa9B,OAAO,eAON;IAED,wFAAwF;IACxF,OAAa,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC,CAUhE;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAU3B;CA6JF;AAYD,4FAA4F;AAC5F,wBAAgB,mBAAmB,IAAI,MAAM,CAG5C"}

package/dist/relay/relay-host.js

@@ -0,0 +1,238 @@
+import os from "node:os";
+import { FrameAssembler, RELAY_FRAME_BYTES, encodeFrames } from "@termlink/protocol";
+import { WebSocket } from "ws";
+import { errorMessage } from "../errors.js";
+import { DeltaCoalescer } from "../server/coalesce.js";
+import { ClientConnection } from "../server/connection.js";
+import { toBytes } from "../server/local-server.js";
+import { newId } from "../util/id.js";
+import { RelayHttpError, pickRelay, registerHost, unregisterHost } from "./api.js";
+import { DeviceError, defaultCredentialPath, loadDevice, renewIfDue } from "./device.js";
+export const DEFAULT_SERVER = "wss://connect.getterm.link:9000";
+const PONG_TIMEOUT_MS = 60_000;
+/**
+ * Connects the host to the TermLink relay as `role=host&caps=agent`. The relay
+ * merges every client into this one socket and broadcasts what the host sends,
+ * so the whole relay link is served by a single ClientConnection.
+ */
+export class RelayHost {
+    relayUrl;
+    /** Resolves on the first successful connection. */
+    ready;
+    #options;
+    #fetch;
+    #deviceToken;
+    #hostToken = null;
+    #live = null;
+    #socket = null;
+    #backoffMs;
+    #reconnectTimer = null;
+    #stopped = false;
+    #lastLogged = "";
+    #markReady = () => { };
+    constructor(options, relayUrl, deviceToken, fetchFn) {
+        this.#options = options;
+        this.relayUrl = relayUrl;
+        this.#deviceToken = deviceToken;
+        this.#fetch = fetchFn;
+        this.#backoffMs = options.minBackoffMs ?? 1_000;
+        this.ready = new Promise((resolve) => (this.#markReady = resolve));
+    }
+    /** Signs in with the device credential, registers the session and starts connecting. */
+    static async start(options) {
+        const fetchFn = options.fetch ?? fetch;
+        const credentialPath = options.credentialPath ?? defaultCredentialPath();
+        let device = await loadDevice(credentialPath, options.server);
+        device = await renewIfDue(credentialPath, options.server, device, fetchFn);
+        const relayUrl = await pickRelay(options.server, fetchFn);
+        const host = new RelayHost(options, relayUrl, device.token, fetchFn);
+        await host.#register();
+        host.#connect();
+        return host;
+    }
+    async close() {
+        this.#stopped = true;
+        if (this.#reconnectTimer)
+            clearTimeout(this.#reconnectTimer);
+        this.#teardown();
+        const socket = this.#socket;
+        this.#socket = null;
+        socket?.close(1000, "host shutting down");
+        if (this.#hostToken) {
+            await unregisterHost(this.#options.server, this.#hostToken, this.#options.session, this.#fetch).catch(() => { });
+        }
+    }
+    async #register() {
+        try {
+            this.#hostToken = await registerHost(this.#options.server, this.#deviceToken, this.#options.session, this.#fetch);
+        }
+        catch (err) {
+            // 401/403 is a sign-in problem or the plan's session limit; retrying will not help.
+            if (err instanceof RelayHttpError && (err.status === 401 || err.status === 403)) {
+                throw new DeviceError(`the relay refused this host: ${err.message}`);
+            }
+            throw err;
+        }
+    }
+    #connect() {
+        this.#reconnectTimer = null;
+        if (this.#stopped)
+            return;
+        this.#dial().catch((err) => {
+            if (err instanceof DeviceError)
+                this.#stop(err.message);
+            else {
+                this.#log(`relay: ${errorMessage(err)}`);
+                this.#scheduleReconnect();
+            }
+        });
+    }
+    async #dial() {
+        if (!this.#hostToken)
+            await this.#register();
+        const query = new URLSearchParams({
+            session: this.#options.session,
+            role: "host",
+            token: this.#hostToken ?? "",
+            name: this.#options.name ?? os.hostname(),
+            term: "termlink-agent",
+            cwd: this.#options.cwd ?? process.cwd(),
+            os: process.platform,
+            arch: process.arch,
+            relay: this.relayUrl,
+            caps: "agent",
+        });
+        const ws = new WebSocket(`${this.relayUrl}/ws?${query}`, { handshakeTimeout: 15_000 });
+        this.#socket = ws;
+        ws.on("error", (err) => {
+            // A rejected host token (expired, or signed with an old relay secret): register again.
+            const status = /Unexpected server response: (\d+)/.exec(err.message)?.[1];
+            if (status === "401" || status === "403")
+                this.#hostToken = null;
+            this.#log(`relay: ${err.message}`);
+        });
+        ws.on("open", () => {
+            this.#backoffMs = this.#options.minBackoffMs ?? 1_000;
+            this.#lastLogged = "";
+            this.#log(`relay: connected to ${this.relayUrl} as ${this.#options.session}`);
+            this.#serve(ws);
+            this.#markReady();
+        });
+        ws.on("close", (code, reason) => {
+            if (this.#socket === ws) {
+                this.#teardown();
+                this.#socket = null;
+            }
+            if (this.#stopped)
+                return;
+            this.#log(`relay: disconnected (${code}${reason.length > 0 ? ` ${reason.toString()}` : ""}), reconnecting`);
+            this.#scheduleReconnect();
+        });
+    }
+    #serve(ws) {
+        const coalescer = new DeltaCoalescer((message) => this.#write(ws, message));
+        const connection = new ClientConnection(this.#options.manager, {
+            send: (message) => coalescer.push(message),
+            sendBinary: (frame) => {
+                // Keep terminal bytes in order with the JSON events around them.
+                coalescer.flush();
+                if (ws.readyState === WebSocket.OPEN)
+                    ws.send(frame, { binary: true });
+            },
+        }, this.#options.hostInfo);
+        const assembler = new FrameAssembler();
+        let clients = -1;
+        let lastPong = Date.now();
+        ws.on("pong", () => (lastPong = Date.now()));
+        ws.on("message", (data, isBinary) => {
+            if (isBinary) {
+                connection.handleBinary(toBytes(data));
+                return;
+            }
+            let message;
+            try {
+                message = assembler.push(data.toString());
+            }
+            catch {
+                return;
+            }
+            if (message === undefined)
+                return;
+            if (!isRelayControl(message)) {
+                void connection.handleMessage(message);
+                return;
+            }
+            if (message.type === "clients") {
+                // Greet newly joined clients; everyone else just sees host.ready again.
+                const count = Array.isArray(message.clients) ? message.clients.length : 0;
+                if (count > clients && clients >= 0)
+                    void connection.announce();
+                clients = count;
+            }
+            else if (message.type === "terminated") {
+                this.#stop(typeof message.reason === "string" ? message.reason : "the session was ended");
+            }
+        });
+        const heartbeat = setInterval(() => {
+            if (Date.now() - lastPong > PONG_TIMEOUT_MS)
+                ws.terminate();
+            else
+                ws.ping();
+        }, this.#options.pingIntervalMs ?? 25_000);
+        this.#live = { ws, connection, coalescer, heartbeat };
+        void connection.open();
+    }
+    #write(ws, message) {
+        if (ws.readyState !== WebSocket.OPEN)
+            return;
+        for (const frame of encodeFrames(message, RELAY_FRAME_BYTES, () => newId("ck")))
+            ws.send(frame);
+    }
+    #teardown() {
+        const live = this.#live;
+        this.#live = null;
+        if (!live)
+            return;
+        clearInterval(live.heartbeat);
+        live.coalescer.dispose();
+        live.connection.dispose();
+    }
+    #scheduleReconnect() {
+        if (this.#stopped || this.#reconnectTimer)
+            return;
+        const delay = this.#backoffMs;
+        this.#backoffMs = Math.min(this.#backoffMs * 2, this.#options.maxBackoffMs ?? 30_000);
+        this.#reconnectTimer = setTimeout(() => this.#connect(), delay);
+    }
+    #stop(reason) {
+        if (this.#stopped)
+            return;
+        this.#stopped = true;
+        if (this.#reconnectTimer)
+            clearTimeout(this.#reconnectTimer);
+        this.#log(`relay: stopped: ${reason}`);
+        this.#teardown();
+        this.#socket?.close(1000, "host stopped");
+        this.#options.onStopped?.(reason);
+    }
+    // Reconnect loops repeat the same failure; log each distinct message once.
+    #log(line) {
+        if (line === this.#lastLogged)
+            return;
+        this.#lastLogged = line;
+        this.#options.log?.(line);
+    }
+}
+function isRelayControl(message) {
+    return (typeof message === "object" &&
+        message !== null &&
+        !("kind" in message) &&
+        "type" in message &&
+        typeof message.type === "string");
+}
+/** Relay session name for this machine: stable, so a restarted host takes its slot back. */
+export function defaultRelaySession() {
+    const host = os.hostname().toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^-+|-+$/g, "") || "host";
+    return `${host}-agent`;
+}
+//# sourceMappingURL=relay-host.js.map

package/dist/relay/relay-host.js.map

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

package/dist/server/coalesce.d.ts

@@ -0,0 +1,15 @@
+import type { HostMessage } from "@termlink/protocol";
+/**
+ * Merges consecutive item.delta events for the same item and field that arrive
+ * within a short window, so a streaming reply is not one relay frame per token.
+ * Any other message flushes first, so ordering is preserved.
+ */
+export declare class DeltaCoalescer {
+    #private;
+    constructor(send: (message: HostMessage) => void, windowMs?: number);
+    push(message: HostMessage): void;
+    flush(): void;
+    /** Drops anything pending without sending it. */
+    dispose(): void;
+}
+//# sourceMappingURL=coalesce.d.ts.map

package/dist/server/coalesce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coalesce.d.ts","sourceRoot":"","sources":["../../src/server/coalesce.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItD;;;;GAIG;AACH,qBAAa,cAAc;;IAMzB,YAAY,IAAI,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,EAAE,QAAQ,SAAK,EAG9D;IAED,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAmB/B;IAED,KAAK,IAAI,IAAI,CAMZ;IAED,iDAAiD;IACjD,OAAO,IAAI,IAAI,CAId;CACF"}

package/dist/server/coalesce.js

@@ -0,0 +1,50 @@
+/**
+ * Merges consecutive item.delta events for the same item and field that arrive
+ * within a short window, so a streaming reply is not one relay frame per token.
+ * Any other message flushes first, so ordering is preserved.
+ */
+export class DeltaCoalescer {
+    #send;
+    #windowMs;
+    #pending = null;
+    #timer = null;
+    constructor(send, windowMs = 40) {
+        this.#send = send;
+        this.#windowMs = windowMs;
+    }
+    push(message) {
+        if (message.kind === "evt" && message.type === "item.delta") {
+            const pending = this.#pending;
+            if (pending &&
+                pending.sessionId === message.sessionId &&
+                pending.payload.itemId === message.payload.itemId &&
+                pending.payload.field === message.payload.field) {
+                pending.payload = { ...pending.payload, delta: pending.payload.delta + message.payload.delta };
+                return;
+            }
+            this.flush();
+            this.#pending = { ...message, payload: { ...message.payload } };
+            this.#timer = setTimeout(() => this.flush(), this.#windowMs);
+            return;
+        }
+        this.flush();
+        this.#send(message);
+    }
+    flush() {
+        if (this.#timer)
+            clearTimeout(this.#timer);
+        this.#timer = null;
+        const pending = this.#pending;
+        this.#pending = null;
+        if (pending)
+            this.#send(pending);
+    }
+    /** Drops anything pending without sending it. */
+    dispose() {
+        if (this.#timer)
+            clearTimeout(this.#timer);
+        this.#timer = null;
+        this.#pending = null;
+    }
+}
+//# sourceMappingURL=coalesce.js.map

package/dist/server/coalesce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coalesce.js","sourceRoot":"","sources":["../../src/server/coalesce.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,OAAO,cAAc;IAChB,KAAK,CAAiC;IACtC,SAAS,CAAS;IAC3B,QAAQ,GAAsB,IAAI,CAAC;IACnC,MAAM,GAA0B,IAAI,CAAC;IAErC,YAAY,IAAoC,EAAE,QAAQ,GAAG,EAAE;QAC7D,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAED,IAAI,CAAC,OAAoB;QACvB,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC9B,IACE,OAAO;gBACP,OAAO,CAAC,SAAS,KAAK,OAAO,CAAC,SAAS;gBACvC,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,MAAM;gBACjD,OAAO,CAAC,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,KAAK,EAC/C,CAAC;gBACD,OAAO,CAAC,OAAO,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBAC/F,OAAO;YACT,CAAC;YACD,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,QAAQ,GAAG,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YAChE,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAC7D,OAAO;QACT,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,MAAM;YAAE,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,OAAO;YAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,iDAAiD;IACjD,OAAO;QACL,IAAI,IAAI,CAAC,MAAM;YAAE,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACvB,CAAC;CACF"}

package/dist/server/connection.d.ts

@@ -0,0 +1,30 @@
+import { type HostInfo, type HostMessage } from "@termlink/protocol";
+import type { SessionManager } from "../session/manager.js";
+type Send = (message: HostMessage) => void;
+/** How messages reach the client. Binary frames carry terminal bytes; a transport without them has no terminals. */
+export interface ConnectionTransport {
+    send: Send;
+    sendBinary?: ((frame: Uint8Array) => void) | undefined;
+}
+/**
+ * One client's view of the host, independent of transport. The local WebSocket
+ * server and the relay link both use it.
+ */
+export declare class ClientConnection {
+    #private;
+    constructor(manager: SessionManager, transport: Send | ConnectionTransport, hostInfo: () => Promise<HostInfo>);
+    open(): Promise<void>;
+    /** Sends host.ready. The relay transport repeats it when a new client joins. */
+    announce(): Promise<void>;
+    handle(raw: string): Promise<void>;
+    /** Handles an already parsed message, such as one reassembled from chunks. */
+    handleMessage(data: unknown): Promise<void>;
+    /**
+     * Terminal input from a binary frame. Only for sessions this connection is attached
+     * to; anything else is dropped without a reply, since frames carry no reqId.
+     */
+    handleBinary(data: Uint8Array): void;
+    dispose(): void;
+}
+export {};
+//# sourceMappingURL=connection.d.ts.map

package/dist/server/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/server/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,QAAQ,EACb,KAAK,WAAW,EACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAI5D,KAAK,IAAI,GAAG,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;AAE3C,oHAAoH;AACpH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,IAAI,CAAC;IACX,UAAU,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACxD;AAED;;;GAGG;AACH,qBAAa,gBAAgB;;IAS3B,YAAY,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,IAAI,GAAG,mBAAmB,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,EAM5G;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAM1B;IAED,gFAAgF;IAC1E,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAI9B;IAEK,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASvC;IAED,8EAA8E;IACxE,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAahD;IAED;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAKnC;IAED,OAAO,IAAI,IAAI,CAKd;CAgGF"}