herdr-remote 0.2.39 → 0.3.31

package/node_modules/herdr-remote-relay/dist/server/transport.js

@@ -1,110 +0,0 @@
-// Sending to windows and hosts: terminal output with back-pressure, JSON
-// broadcasts, and the development-only latency queue.
-import { detachClient } from './sessions.js';
-import { isOpen, jsonSend } from './sockets.js';
-/** Notify the host whether any browser currently needs business telemetry. */
-export function notifyHostClientCount(host) {
-    if (!host || !isOpen(host.ws))
-        return;
-    jsonSend(host.ws, { type: 'client_count', clientCount: host.clients.size });
-}
-/**
- * Forward output without allowing one slow browser to grow an unbounded ws
- * queue. Closing only that browser preserves low latency for the other views.
- */
-export function sendClientBinary(relay, host, client, payload) {
-    if (!client || !isOpen(client.ws))
-        return false;
-    const limit = relay.config.relay.maxBufferedBytesPerClient;
-    const buffered = Number(client.ws.bufferedAmount) || 0;
-    if (buffered + payload.length > limit) {
-        relay.metrics.recordCleanup('slowClientsDropped');
-        detachClient(relay, client, { notify: true, reason: 'slow_client', closeCode: 1013 });
-        return false;
-    }
-    let sent = false;
-    const doSend = () => {
-        if (!isOpen(client.ws))
-            return;
-        try {
-            client.ws.send(payload);
-            client.bytesSent += payload.length;
-            relay.metrics.recordOut(payload.length, host.id);
-            sent = true;
-        }
-        catch {
-            detachClient(relay, client, { notify: false, reason: 'client_send_failed', closeCode: 1011 });
-        }
-    };
-    if (relay.devLatencyMs > 0)
-        enqueueDelayedSend(relay, client.ws, doSend);
-    else
-        doSend();
-    return relay.devLatencyMs > 0 ? true : sent;
-}
-/**
- * Queue artificial delay per-socket rather than using naked setTimeout calls.
- * Concurrent timers experience event loop jitter that can deliver frames out of order;
- * a single FIFO queue per socket guarantees strict in-order delivery of terminal frames.
- */
-export function enqueueDelayedSend(relay, socket, task) {
-    let queue = relay.sendQueues.get(socket);
-    if (!queue) {
-        const created = { items: [], timer: null };
-        queue = created;
-        relay.sendQueues.set(socket, created);
-        socket.once('close', () => {
-            if (created.timer) {
-                clearTimeout(created.timer);
-                relay.activeDelayTimers.delete(created.timer);
-                created.timer = null;
-            }
-            created.items = [];
-        });
-    }
-    const sendAt = Date.now() + relay.devDelayMs;
-    queue.items.push({ sendAt, task });
-    if (!queue.timer) {
-        const pending = queue;
-        const timer = setTimeout(() => flushSendQueue(relay, socket, pending), relay.devDelayMs);
-        queue.timer = timer;
-        relay.activeDelayTimers.add(timer);
-    }
-}
-/**
- * Drain ready frames in FIFO order up to the current timestamp, then schedule the
- * single next timer if items remain. Ensures only one timer runs per socket at a time.
- */
-function flushSendQueue(relay, socket, queue) {
-    if (queue.timer) {
-        relay.activeDelayTimers.delete(queue.timer);
-        queue.timer = null;
-    }
-    const now = Date.now();
-    while (queue.items.length > 0 && queue.items[0].sendAt <= now) {
-        const item = queue.items.shift();
-        try {
-            item?.task();
-        }
-        catch {
-            // A send to a socket that closed while queued is dropped like any other.
-        }
-    }
-    if (queue.items.length > 0 && !queue.timer) {
-        const nextDelay = Math.max(0, queue.items[0].sendAt - Date.now());
-        const timer = setTimeout(() => flushSendQueue(relay, socket, queue), nextDelay);
-        queue.timer = timer;
-        relay.activeDelayTimers.add(timer);
-    }
-}
-/** Send one JSON message to every browser attached to `host`. */
-export function broadcastToClients(relay, host, build) {
-    for (const clientId of [...host.clients]) {
-        const client = relay.clients.get(clientId);
-        if (!client)
-            continue;
-        const payload = build(client);
-        if (payload)
-            jsonSend(client.ws, payload);
-    }
-}

package/node_modules/herdr-remote-relay/dist/server/types.d.ts

@@ -1,133 +0,0 @@
-import type { WebSocket } from 'ws';
-import type { AuthStore } from '../auth-store.js';
-import type { RelayMetrics } from '../metrics.js';
-import type { ClientRole, HostPtySummary, ServerAgentStatusMessage, ServerUpdateStatusMessage, HostShellProfile } from '../protocol/messages.js';
-import type { HostTerminalFont, HostTerminalPalette } from '../protocol/terminal.js';
-import type { RelayConfig } from '../relay-config.js';
-/** A WebSocket plus the liveness flag the heartbeat keeps on it. */
-export type RelaySocket = WebSocket & {
-    isAlive?: boolean;
-};
-/** One browser window's PTY stream on its host. */
-interface ClientSession {
-    streamId: string;
-    /** The v2 frame index, when the host negotiated v2 frames and one was free. */
-    streamIndex: number | null;
-    cols: number;
-    rows: number;
-    ready: boolean;
-}
-/** A connected workstation. */
-export interface RelayHost {
-    id: string;
-    ws: RelaySocket | null;
-    hostname: string;
-    platform: string;
-    shellProfile?: HostShellProfile;
-    /** The host can open an administrator terminal as a Herdr tab. */
-    adminTabsAvailable: boolean;
-    arch: string;
-    connectedAt: string;
-    connectedAtMs: number;
-    terminalPalette: HostTerminalPalette | null;
-    terminalFont: HostTerminalFont | null;
-    /** Sanitized `keys.prefix` of the host's Herdr; absent when the host did not say. */
-    herdrPrefixKeys?: string[];
-    /** The latest agent summary, replayed to a window that joins late. */
-    agentStatus: ServerAgentStatusMessage | null;
-    /** Whether the workstation's herdr-remote is behind; replayed the same way. */
-    updateStatus: ServerUpdateStatusMessage | null;
-    /** The herdr-remote release the host runs; null when its hello did not say. */
-    version: string | null;
-    lastSeenAt: number;
-    /** Ids of the windows attached to this host. */
-    clients: Set<string>;
-    controllerId: null;
-    load: Record<string, unknown>;
-    ptys: HostPtySummary[];
-    reconnecting: boolean;
-    reconnectTimer: NodeJS.Timeout | null;
-    reconnectStartedAt?: number;
-    connectionGeneration: string;
-    handoffCapable: boolean;
-    binaryFrameV2: boolean;
-    /** v2 stream index → client id. */
-    streamIndices: Map<number, string>;
-    nextStreamIndex: number;
-    shutdownRequested: boolean;
-}
-/** A connected browser window. */
-export interface RelayClient {
-    id: string;
-    ws: RelaySocket | null;
-    hostId: string;
-    deviceId: string;
-    /** Stable per browser profile, supplied by the browser itself. */
-    browserClientId: string | null;
-    handoffCapable: boolean;
-    session: ClientSession | null;
-    role: ClientRole;
-    controllerId: null;
-    connectedAt: string;
-    connectedAtMs: number;
-    lastSeenAt: number;
-    lastPingAt: string | null;
-    bytesReceived: number;
-    bytesSent: number;
-    ip: string | null;
-    userAgent: string;
-    cols: number;
-    rows: number;
-    herdrStartAt?: number;
-    adminTabAt?: number;
-    fontRefreshAt?: number;
-    /** When each outstanding font chunk request was sent. */
-    fontChunkRequests?: number[];
-    fontSubsetRequests?: number[];
-    /** Cut fonts this window may pull by hash, with their sizes. */
-    fontSubsets?: Map<string, number>;
-}
-/** Requests from one address within the current minute. */
-export interface AttemptWindow {
-    startedAt: number;
-    count: number;
-}
-/** Frames held back by the development latency switch, in order. */
-export interface SendQueue {
-    items: {
-        sendAt: number;
-        task: () => void;
-    }[];
-    timer: NodeJS.Timeout | null;
-}
-/** What the server modules share: the relay's state and two of its methods. */
-export interface RelayContext {
-    config: RelayConfig;
-    relayMode: 'local' | 'remote';
-    hosts: Map<string, RelayHost>;
-    clients: Map<string, RelayClient>;
-    /** Stream id → client id. */
-    streams: Map<string, string>;
-    pairAttempts: Map<string, AttemptWindow>;
-    clientHandshakeAttempts: Map<string, AttemptWindow>;
-    hostHandshakeAttempts: Map<string, AttemptWindow>;
-    startedAt: number;
-    metrics: RelayMetrics;
-    auth: AuthStore;
-    adminToken: string | null;
-    trustProxy: boolean;
-    devLatencyMs: number;
-    devDelayMs: number;
-    /** Where the built web client is served from. */
-    publicDir: string;
-    sendQueues: WeakMap<RelaySocket, SendQueue>;
-    activeDelayTimers: Set<NodeJS.Timeout>;
-    finishHandshake(ws: RelaySocket): void;
-    address(): {
-        host: string;
-        port: number;
-    } | {
-        path: string;
-    } | null;
-}
-export {};

package/node_modules/herdr-remote-relay/dist/server/types.js

@@ -1,3 +0,0 @@
-// The relay's records for connected hosts and browser windows, and the state
-// every server module works on.
-export {};

package/node_modules/herdr-remote-relay/dist/server/version.d.ts

@@ -1,2 +0,0 @@
-/** This relay's release, as its package.json names it. */
-export declare const VERSION: string;

package/node_modules/herdr-remote-relay/dist/server/version.js

@@ -1,5 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { PACKAGE_ROOT } from '../relay-config.js';
-/** This relay's release, as its package.json names it. */
-export const VERSION = JSON.parse(fs.readFileSync(path.join(PACKAGE_ROOT, 'package.json'), 'utf8')).version;

package/node_modules/herdr-remote-relay/dist/state.d.ts

@@ -1,6 +0,0 @@
-declare function ensureDir(dirPath: string): void;
-declare function writeJsonAtomic(filePath: string, value: unknown): void;
-/** Parsed JSON at `filePath`, or `fallback` when it is missing or unreadable. */
-declare function readJson<T>(filePath: string, fallback: T): T;
-declare function randomToken(bytes?: number): string;
-export { ensureDir, writeJsonAtomic, readJson, randomToken };

package/node_modules/herdr-remote-relay/dist/state.js

@@ -1,47 +0,0 @@
-import crypto from 'node:crypto';
-import fs from 'node:fs';
-import path from 'node:path';
-function ensureDir(dirPath) {
-    fs.mkdirSync(dirPath, { recursive: true, mode: 0o700 });
-    try {
-        fs.chmodSync(dirPath, 0o700);
-    }
-    catch {
-        // Some filesystems (Windows, some mounts) ignore modes; mkdir already asked for 0700.
-    }
-}
-function writeJsonAtomic(filePath, value) {
-    ensureDir(path.dirname(filePath));
-    const tempPath = `${filePath}.${process.pid}.${crypto.randomBytes(4).toString('hex')}.tmp`;
-    fs.writeFileSync(tempPath, `${JSON.stringify(value, null, 2)}\n`, { mode: 0o600 });
-    try {
-        fs.chmodSync(tempPath, 0o600);
-    }
-    catch {
-        // Some filesystems ignore modes; the file was written with 0600 already.
-    }
-    fs.renameSync(tempPath, filePath);
-    try {
-        fs.chmodSync(filePath, 0o600);
-    }
-    catch {
-        // Some filesystems ignore modes; the file was written with 0600 already.
-    }
-}
-/** Parsed JSON at `filePath`, or `fallback` when it is missing or unreadable. */
-function readJson(filePath, fallback) {
-    try {
-        return JSON.parse(fs.readFileSync(filePath, 'utf8'));
-    }
-    catch (error) {
-        const { code, message } = error;
-        if (code !== 'ENOENT') {
-            process.stderr.write(`herdr-remote: invalid state at ${filePath}: ${message}\n`);
-        }
-        return fallback;
-    }
-}
-function randomToken(bytes = 32) {
-    return crypto.randomBytes(bytes).toString('base64url');
-}
-export { ensureDir, writeJsonAtomic, readJson, randomToken };

package/node_modules/ws/LICENSE

@@ -1,20 +0,0 @@
-Copyright (c) 2011 Einar Otto Stangvik <einaros@gmail.com>
-Copyright (c) 2013 Arnout Kazemier and contributors
-Copyright (c) 2016 Luigi Pinca and contributors
-
-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.