@livedesk/hub 0.1.55 → 0.1.56

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livedesk/hub",
-  "version": "0.1.55",
+  "version": "0.1.56",
   "description": "VuvoDesk local Hub API and browser frame bridge",
   "type": "module",
   "main": "src/server.js",

package/src/console-relay.js

@@ -1,7 +1,8 @@
 import WebSocket from 'ws';
 
-const DEFAULT_CONSOLE_RELAY_URL = 'https://livedesk-wake.lovecrdm.workers.dev';
-const DEFAULT_RETRY_DELAYS_MS = [1_000, 2_000, 5_000, 10_000, 20_000];
+const DEFAULT_CONSOLE_RELAY_URL = 'https://livedesk-wake.lovecrdm.workers.dev';
+const DEFAULT_RETRY_DELAYS_MS = [1_000, 2_000, 5_000, 10_000, 20_000, 60_000];
+const HTTP_429_RETRY_DELAY_MS = 60_000;
 const MAX_CHANNELS = 32;
 const MAX_HTTP_REQUEST_BYTES = 1024 * 1024;
 const MAX_HTTP_RESPONSE_BYTES = 4 * 1024 * 1024;
@@ -103,9 +104,12 @@ export function createHubConsoleRelay(options = {}) {
   let generation = 0;
   let stopped = true;
   let state = relayUrl ? 'idle' : 'disabled';
-  let lastConnectedAt = '';
-  let lastError = relayUrl instanceof URL ? '' : relayUrl === '' ? '' : 'invalid-relay-url';
-  let droppedBinaryMessages = 0;
+  let lastConnectedAt = '';
+  let lastError = relayUrl instanceof URL ? '' : relayUrl === '' ? '' : 'invalid-relay-url';
+  let lastHttpStatus = 0;
+  let retryNotBeforeAt = 0;
+  let nextRetryAt = '';
+  let droppedBinaryMessages = 0;
 
   const sendRelay = (payload, bypassBackpressure = false) => {
     if (!relaySocket || relaySocket.readyState !== WebSocketImpl.OPEN) return false;
@@ -265,11 +269,15 @@ export function createHubConsoleRelay(options = {}) {
   const handleMessage = raw => {
     const payload = parseMessage(raw);
     if (!payload?.type) return;
-    if (payload.type === 'relay-ready') {
-      state = 'connected';
-      lastConnectedAt = new Date().toISOString();
-      lastError = '';
-      return;
+    if (payload.type === 'relay-ready') {
+      state = 'connected';
+      lastConnectedAt = new Date().toISOString();
+      lastError = '';
+      lastHttpStatus = 0;
+      retryAttempt = 0;
+      retryNotBeforeAt = 0;
+      nextRetryAt = '';
+      return;
     }
     if (payload.type === 'console-detached') {
       closeConsoleChannels(String(payload.consoleId || ''));
@@ -294,22 +302,27 @@ export function createHubConsoleRelay(options = {}) {
     }
   };
 
-  const scheduleReconnect = connect => {
-    if (stopped || retryTimer || !(relayUrl instanceof URL)) return;
-    const delayMs = retryDelaysMs[Math.min(retryAttempt, retryDelaysMs.length - 1)];
-    retryAttempt += 1;
-    state = 'waiting-retry';
-    retryTimer = setTimeout(() => {
-      retryTimer = null;
-      void connect();
+  const scheduleReconnect = connect => {
+    if (stopped || retryTimer || !(relayUrl instanceof URL)) return;
+    const sequenceDelayMs = retryDelaysMs[Math.min(retryAttempt, retryDelaysMs.length - 1)];
+    const delayMs = Math.max(sequenceDelayMs, retryNotBeforeAt - Date.now(), 0);
+    retryAttempt += 1;
+    state = 'waiting-retry';
+    nextRetryAt = new Date(Date.now() + delayMs).toISOString();
+    retryTimer = setTimeout(() => {
+      retryTimer = null;
+      nextRetryAt = '';
+      void connect();
     }, delayMs);
     retryTimer.unref?.();
   };
 
   const connect = async () => {
     if (stopped || !(relayUrl instanceof URL) || !deviceId) return;
-    const ownerGeneration = ++generation;
-    state = 'connecting';
+    const ownerGeneration = ++generation;
+    let ownerHttpStatus = 0;
+    state = 'connecting';
+    nextRetryAt = '';
     let accessToken = '';
     try {
       accessToken = String(await getAccessToken() || '').trim();
@@ -339,25 +352,46 @@ export function createHubConsoleRelay(options = {}) {
       try { socket.terminate?.(); } catch { /* stale connect is already gone */ }
       return;
     }
-    relaySocket = socket;
-    socket.once('open', () => {
-      if (relaySocket !== socket || ownerGeneration !== generation || stopped) return;
-      retryAttempt = 0;
-      state = 'authenticating';
-    });
+    relaySocket = socket;
+    socket.once('open', () => {
+      if (relaySocket !== socket || ownerGeneration !== generation || stopped) return;
+      state = 'authenticating';
+    });
+    socket.once('unexpected-response', (_request, response) => {
+      if (ownerGeneration !== generation || stopped) {
+        response.resume?.();
+        return;
+      }
+      const status = Math.max(0, Number(response?.statusCode || 0));
+      ownerHttpStatus = status;
+      lastHttpStatus = status;
+      lastError = status > 0
+        ? `Console relay returned HTTP ${status}`
+        : 'Console relay returned an unexpected response.';
+      if (status === 429) {
+        retryNotBeforeAt = Math.max(retryNotBeforeAt, Date.now() + HTTP_429_RETRY_DELAY_MS);
+      }
+      if (relaySocket === socket) relaySocket = null;
+      response.resume?.();
+      try { socket.terminate?.(); } catch { /* retry owns the rejected upgrade */ }
+      scheduleReconnect(connect);
+    });
     socket.on('message', raw => {
       if (relaySocket === socket && ownerGeneration === generation && !stopped) handleMessage(raw);
     });
-    socket.once('close', () => {
-      if (relaySocket === socket) relaySocket = null;
-      if (ownerGeneration !== generation || stopped) return;
-      state = 'disconnected';
-      closeAllLocalSockets('relay-disconnected');
-      scheduleReconnect(connect);
+    socket.once('close', () => {
+      if (relaySocket === socket) relaySocket = null;
+      if (ownerGeneration !== generation || stopped) return;
+      if (!retryTimer) state = 'disconnected';
+      closeAllLocalSockets('relay-disconnected');
+      scheduleReconnect(connect);
     });
-    socket.once('error', error => {
-      lastError = error instanceof Error ? error.message : String(error);
-      try { socket.terminate?.(); } catch { /* close handler owns retry */ }
+    socket.once('error', error => {
+      if (ownerHttpStatus <= 0) {
+        lastHttpStatus = 0;
+        lastError = error instanceof Error ? error.message : String(error);
+      }
+      try { socket.terminate?.(); } catch { /* close handler owns retry */ }
     });
   };
 
@@ -373,10 +407,13 @@ export function createHubConsoleRelay(options = {}) {
       return;
     }
     generation += 1;
-    if (retryTimer) {
+    if (retryTimer) {
       clearTimeout(retryTimer);
       retryTimer = null;
-    }
+    }
+    retryAttempt = 0;
+    retryNotBeforeAt = 0;
+    nextRetryAt = '';
     const socket = relaySocket;
     relaySocket = null;
     try { socket?.terminate?.(); } catch { /* refresh owns the exact socket */ }
@@ -389,7 +426,8 @@ export function createHubConsoleRelay(options = {}) {
     stopped = true;
     generation += 1;
     if (retryTimer) clearTimeout(retryTimer);
-    retryTimer = null;
+    retryTimer = null;
+    nextRetryAt = '';
     closeAllLocalSockets('hub-shutdown');
     const socket = relaySocket;
     relaySocket = null;
@@ -408,9 +446,12 @@ export function createHubConsoleRelay(options = {}) {
       connected: state === 'connected',
       localWebSocketChannels: localSockets.size,
       pendingHttpRequests: pendingHttp.size,
-      droppedBinaryMessages,
-      lastConnectedAt,
-      lastError
+      droppedBinaryMessages,
+      lastConnectedAt,
+      lastError,
+      lastHttpStatus,
+      retryAttempt,
+      nextRetryAt
     })
   };
 }
@@ -420,5 +461,5 @@ export const consoleRelayContract = Object.freeze({
   maxHttpRequestBytes: MAX_HTTP_REQUEST_BYTES,
   maxHttpResponseBytes: MAX_HTTP_RESPONSE_BYTES,
   maxBufferedBytes: MAX_RELAY_BUFFERED_BYTES,
-  binaryHeaderBytes: BINARY_HEADER_BYTES
-});
+  binaryHeaderBytes: BINARY_HEADER_BYTES
+});

package/src/server.js

@@ -4342,27 +4342,35 @@ app.post('/api/settings/agent/summary', async (req, res) => {
   }
 });
 
-app.get('/api/remote/status', (_req, res) => {
-  noStore(res);
-  if (runtimeRole !== 'hub') {
+app.get('/api/remote/status', async (_req, res) => {
+  noStore(res);
+  if (runtimeRole !== 'hub') {
     res.status(403).json({ ok: false, error: 'role-not-allowed' });
     return;
   }
-  const secretStatus = remoteHub.getStatus({ includeSecrets: true });
-  res.json({
-    ...remoteHub.getStatus({ includeSecrets: false }),
-    pairingPin: secretStatus.pairingPin,
-    product: 'LiveDesk',
-    runtimeRole,
-    deviceId: runtimeDeviceId,
-    deviceName: runtimeDeviceName,
-    roleSource: runtimeRoleSource,
-    agentPackage: '@livedesk/client',
-    consoleRelay: hubConsoleRelay?.inspect() || { enabled: false, state: 'starting' },
-    frameLanes: snapshotFrameLaneResourceHealth(),
-    update: getLiveDeskUpdateStatus()
-  });
-});
+  try {
+    const [secretStatus, wallPreferences] = await Promise.all([
+      Promise.resolve(remoteHub.getStatus({ includeSecrets: true })),
+      liveDeskSettingsStore.getWallPreferencesRecord()
+    ]);
+    res.json({
+      ...remoteHub.getStatus({ includeSecrets: false }),
+      pairingPin: secretStatus.pairingPin,
+      product: 'LiveDesk',
+      runtimeRole,
+      deviceId: runtimeDeviceId,
+      deviceName: runtimeDeviceName,
+      roleSource: runtimeRoleSource,
+      agentPackage: '@livedesk/client',
+      wallPreferences,
+      consoleRelay: hubConsoleRelay?.inspect() || { enabled: false, state: 'starting' },
+      frameLanes: snapshotFrameLaneResourceHealth(),
+      update: getLiveDeskUpdateStatus()
+    });
+  } catch (error) {
+    res.status(500).json({ ok: false, error: error instanceof Error ? error.message : String(error) });
+  }
+});
 
 app.post('/api/remote/diagnostics/transport/start', async (req, res) => {
   noStore(res);

package/src/settings/settings-schema.js

@@ -46,9 +46,11 @@ export const DEFAULT_LIVEDESK_SETTINGS = Object.freeze({
     rememberLastMonitor: true,
     keepControlReadyBetweenPages: true
   },
-  wall: {
-    performanceMode: 'auto',
-    autoStart: true,
+  wall: {
+    performanceMode: 'auto',
+    cadence: 'fast',
+    viewScale: 100,
+    autoStart: true,
     connectedOnly: false,
     keepEmptySlots: true,
     showDeviceStatus: true,
@@ -110,9 +112,10 @@ export const DEFAULT_LIVEDESK_SETTINGS = Object.freeze({
   }
 });
 
-const ENUMS = {
+const ENUMS = {
   accessMode: new Set(['trusted-only', 'ask-every-time', 'view-only', 'block-remote-access']),
-  performanceMode: new Set(['auto', 'responsive', 'quality', 'custom']),
+  performanceMode: new Set(['auto', 'responsive', 'quality', 'custom']),
+  wallCadence: new Set(['slow', 'fast']),
   permissionMode: new Set(['ask', 'safe-auto', 'full-access', 'custom']),
   wallFrameMode: new Set(['auto', 'mode2-lzo', 'mode3-h264-hw', 'mode4-h264-atlas']),
   controlFrameMode: new Set(['mode3-h264-hw', 'mode5-lzo-delta']),
@@ -169,9 +172,11 @@ const RULES = {
   control: {
     ...bools(['allowKeyboardMouse', 'allowSystemShortcuts', 'allowClipboardText', 'allowRemoteRestart', 'reconnectAfterRemoteRestart', 'allowSwitchingMonitors', 'showConnectionToolbar', 'showRemoteCursor', 'openControlOnDoubleClick', 'startRemoteAudioWithControl', 'fitRemoteScreen', 'rememberLastMonitor', 'keepControlReadyBetweenPages'])
   },
-  wall: {
-    performanceMode: { type: 'enum', values: ENUMS.performanceMode },
-    ...bools(['autoStart', 'connectedOnly', 'keepEmptySlots', 'showDeviceStatus', 'showPerformanceDetails', 'pauseHiddenTiles', 'reduceWhenHidden', 'autoAdjustTileQuality', 'rememberDevicePositions'])
+  wall: {
+    performanceMode: { type: 'enum', values: ENUMS.performanceMode },
+    cadence: { type: 'enum', values: ENUMS.wallCadence },
+    viewScale: { type: 'number', min: 0, max: 100 },
+    ...bools(['autoStart', 'connectedOnly', 'keepEmptySlots', 'showDeviceStatus', 'showPerformanceDetails', 'pauseHiddenTiles', 'reduceWhenHidden', 'autoAdjustTileQuality', 'rememberDevicePositions'])
   },
   filesAudio: {
     ...bools(['allowFileTransfer', 'allowFolderSync', 'askBeforeReceivingFiles', 'openReceivedFolder', 'notifyTransferComplete', 'allowOverwrite', 'allowRemoteAudio', 'startAudioMuted', 'rememberVolume', 'automaticallyRecoverAudio', 'showAudioTroubleshooting', 'rollingBufferEnabled', 'includeRemoteCursor']),

package/src/settings/settings-store.js

@@ -40,12 +40,22 @@ export class LiveDeskSettingsStore {
     return structuredClone(this.record);
   }
 
-  getCached() {
-    if (!this.record) return DEFAULT_LIVEDESK_SETTINGS;
-    return { ...this.record.settings, revision: this.record.revision };
-  }
-
-  async get() {
+  getCached() {
+    if (!this.record) return DEFAULT_LIVEDESK_SETTINGS;
+    return { ...this.record.settings, revision: this.record.revision };
+  }
+
+  async getWallPreferencesRecord() {
+    if (!this.record) await this.getRecord();
+    return {
+      revision: this.record.revision,
+      updatedAt: this.record.updatedAt,
+      cadence: this.record.settings.wall.cadence,
+      viewScale: this.record.settings.wall.viewScale
+    };
+  }
+
+  async get() {
     return publicSettings((await this.getRecord()).settings);
   }