herdr-remote-relay 0.3.21 → 0.3.23

package/dist/protocol/http.d.ts

@@ -65,6 +65,10 @@ export interface HostInfo {
     connectedDeviceCount?: number;
     /** Devices holding a valid pairing token for this host, online or not. */
     pairedDeviceCount?: number;
+    /** The herdr-remote release the host runs; null when it is too old to say. */
+    version?: string | null;
+    /** A newer release the host found on npm, if it found one. */
+    latestVersion?: string | null;
 }
 export interface PtyInfo {
     id: string;

package/dist/protocol/messages.d.ts

@@ -92,6 +92,8 @@ export interface ServerReadyMessage {
     terminalFont?: HostTerminalFont | null;
     /** How many windows share this terminal, this one included. */
     clientCount?: number;
+    /** The workstation's herdr-remote release; null when it is too old to say. */
+    hostVersion?: string | null;
 }
 export interface ServerPairedMessage {
     type: 'paired';
@@ -129,6 +131,8 @@ export interface ServerSessionRestartedMessage {
     adminTerminalSupported?: boolean;
     terminalPalette?: HostTerminalPalette | null;
     terminalFont?: HostTerminalFont | null;
+    /** As in `ready`: the host may have come back on another release. */
+    hostVersion?: string | null;
 }
 export interface ServerExitMessage {
     type: 'exit';
@@ -231,6 +235,8 @@ export interface HostHelloMessage {
     platform?: string;
     shellProfile?: HostShellProfile;
     arch?: string;
+    /** The herdr-remote release the host runs. Connectors before 0.2.31 leave it out. */
+    version?: string;
     terminalPalette?: HostTerminalPalette | null;
     terminalFont?: HostTerminalFont | null;
     capabilities?: string[];

package/dist/server/client-channel.js

@@ -147,6 +147,7 @@ export function handleClientConnection(relay, ws, req) {
                 terminalPalette: host.terminalPalette || null,
                 terminalFont: host.terminalFont || null,
                 clientCount: host.clients.size,
+                hostVersion: host.version,
             });
             if (host.agentStatus)
                 jsonSend(ws, host.agentStatus);

package/dist/server/host-broadcasts.d.ts

@@ -4,6 +4,8 @@ import type { RelayContext, RelayHost } from './types.js';
 type Unchecked<T> = {
     [K in keyof T]?: unknown;
 };
+/** `value` if it is a release version, else null: it ends up as text in browsers. */
+export declare function releaseVersion(value: unknown): string | null;
 /**
  * Pass on what the workstation's agents are doing.
  *

package/dist/server/host-broadcasts.js

@@ -6,6 +6,10 @@ import { text } from './sockets.js';
 import { broadcastToClients } from './transport.js';
 /** A release version as npm writes it; anything else is not forwarded. */
 const RELEASE_VERSION = /^\d{1,6}\.\d{1,6}\.\d{1,6}(?:-[0-9A-Za-z.-]{1,32})?$/;
+/** `value` if it is a release version, else null: it ends up as text in browsers. */
+export function releaseVersion(value) {
+    return typeof value === 'string' && RELEASE_VERSION.test(value) ? value : null;
+}
 /** Matches the host's own cap; the relay re-applies it rather than trusting it. */
 const MAX_AGENT_STATUS_ENTRIES = 16;
 /**
@@ -55,15 +59,14 @@ export function broadcastAgentStatus(relay, host, message) {
  * browser, and the host is not the relay's to trust.
  */
 export function broadcastUpdateStatus(relay, host, message) {
-    const version = (value) => typeof value === 'string' && RELEASE_VERSION.test(value) ? value : null;
-    const current = version(message.current);
-    const latest = version(message.latest);
+    const current = releaseVersion(message.current);
+    const latest = releaseVersion(message.latest);
     if (!current || !latest)
         return;
     const payload = {
         type: 'update_status',
         current,
-        installed: version(message.installed) || current,
+        installed: releaseVersion(message.installed) || current,
         latest,
         updateAvailable: message.updateAvailable === true,
         restartPending: message.restartPending === true,

package/dist/server/host-channel.js

@@ -3,7 +3,7 @@
 import os from 'node:os';
 import { CAPABILITY, PROTOCOL_VERSION, sanitizeTerminalFont, sanitizeTerminalPalette, unpackStreamFrame, } from '../protocol/index.js';
 import { forwardFontChunk, forwardFontSubset, settleFontChunk, settleFontSubset, } from './font-proxy.js';
-import { broadcastAgentStatus, broadcastTerminalFont, broadcastUpdateStatus, } from './host-broadcasts.js';
+import { broadcastAgentStatus, broadcastTerminalFont, broadcastUpdateStatus, releaseVersion, } from './host-broadcasts.js';
 import { allowHostHandshake } from './requests.js';
 import { beginHostReconnect, canHandoffHost, detachClient, detachHost, releaseSession, startSession, } from './sessions.js';
 import { closeSocket, isOpen, jsonSend, parseJson, randomId, rejectHandshake } from './sockets.js';
@@ -27,6 +27,7 @@ function createHostRecord(message, ws, pending, clients = new Set()) {
         agentStatus: null,
         /** Whether the workstation's herdr-remote is behind; replayed the same way. */
         updateStatus: null,
+        version: releaseVersion(message.version),
         lastSeenAt: Date.now(),
         clients,
         controllerId: null,

package/dist/server/sessions.js

@@ -71,6 +71,7 @@ export function startSession(relay, host, client, { restarted = false } = {}) {
             adminTerminalSupported: host.adminTabsAvailable,
             terminalPalette: host.terminalPalette || null,
             terminalFont: host.terminalFont || null,
+            hostVersion: host.version,
         });
     }
 }

package/dist/server/status.js

@@ -43,6 +43,10 @@ export function statusSnapshot(relay, { sample = true, includeDevices = false, s
             .map((id) => relay.clients.get(id))
             .filter((client) => Boolean(client))),
         pairedDeviceCount: pairedPerHost.get(host.id) || 0,
+        // A connector too old to name itself in its hello may still have said
+        // which release it runs when it checked npm.
+        version: host.version ?? host.updateStatus?.current ?? null,
+        latestVersion: host.updateStatus?.updateAvailable ? host.updateStatus.latest : null,
         load: host.load,
     }));
     // The workstation counts one PTY per stream and cannot know how many

package/dist/server/types.d.ts

@@ -35,6 +35,8 @@ export interface RelayHost {
     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>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "herdr-remote-relay",
-  "version": "0.3.21",
+  "version": "0.3.23",
   "description": "Standalone relay server and web terminal for Herdr Remote",
   "license": "MIT",
   "type": "module",