livedesk 0.1.436 → 0.1.437

package/bin/livedesk.js

@@ -1198,7 +1198,11 @@ async function runManager(args, resolvedRole = null) {
     LIVEDESK_CLIENT_PACKAGE_VERSION: readClientVersion(),
     LIVEDESK_HUB_UPDATE_REQUEST_PATH: updateRequestPath,
     LIVEDESK_HUB_UPDATE_RESULT_PATH: hubUpdateResultPath,
-    REMOTE_HUB_PORT: String(remotePort),
+    LIVEDESK_UDP_ENABLED: String(process.env.LIVEDESK_UDP_ENABLED || '1'),
+    LIVEDESK_UDP_PREFER_P2P: String(process.env.LIVEDESK_UDP_PREFER_P2P || '0'),
+    LIVEDESK_UDP_RENDEZVOUS_HOST: String(process.env.LIVEDESK_UDP_RENDEZVOUS_HOST || 'www.gnsoftech.com'),
+    LIVEDESK_UDP_RENDEZVOUS_PORT: String(process.env.LIVEDESK_UDP_RENDEZVOUS_PORT || '5199'),
+    REMOTE_HUB_PORT: String(remotePort),
     REMOTE_HUB_PAIR_TOKEN: pairToken,
     LIVEDESK_WEB_DIST: existsSync(resolve(packagedWebDist, 'index.html')) ? packagedWebDist : (process.env.LIVEDESK_WEB_DIST || ''),
     LIVEDESK_RUNTIME_ROLE: 'hub',

package/client/bin/livedesk-client.js

@@ -3872,6 +3872,8 @@ function buildClientAgentEnvironment(prepared) {
     env.LIVEDESK_CLIENT_SLOT = String(prepared?.slot || env.LIVEDESK_CLIENT_SLOT || '');
     env.LIVEDESK_DEVICE_ID = String(prepared?.deviceId || env.LIVEDESK_DEVICE_ID || '');
     env.LIVEDESK_CLIENT_ENGINE = String(prepared?.engine || env.LIVEDESK_CLIENT_ENGINE || 'auto');
+    env.LIVEDESK_CLIENT_TRANSPORT = String(env.LIVEDESK_CLIENT_TRANSPORT || 'auto');
+    env.LIVEDESK_UDP_ENABLED = String(env.LIVEDESK_UDP_ENABLED || '1');
     env.LIVEDESK_CLIENT_UPDATE_STATE_PATH = CLIENT_UPDATE_STATE_PATH;
     env.LIVEDESK_CLIENT_UPDATE_ARGS_BASE64 = Buffer
         .from(JSON.stringify(buildClientUpdateRestartArgs(prepared)), 'utf8')

package/client/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livedesk/client",
-  "version": "0.1.192",
+  "version": "0.1.193",
   "description": "LiveDesk local remote client",
   "type": "module",
   "bin": {
@@ -41,10 +41,10 @@
     "ws": "^8.18.3"
   },
   "optionalDependencies": {
-    "@livedesk/fast-linux-x64": "0.1.399",
-    "@livedesk/fast-osx-arm64": "0.1.399",
-    "@livedesk/fast-osx-x64": "0.1.399",
-    "@livedesk/fast-win-x64": "0.1.399"
+    "@livedesk/fast-linux-x64": "0.1.400",
+    "@livedesk/fast-osx-arm64": "0.1.400",
+    "@livedesk/fast-osx-x64": "0.1.400",
+    "@livedesk/fast-win-x64": "0.1.400"
   },
   "publishConfig": {
     "access": "public"

package/hub/src/remote-hub.js

@@ -1456,7 +1456,9 @@ class RemoteHubWebSocketAgentSocket {
 }
 
 export function createRemoteHub(options = {}) {
-    const env = options.env || process.env;
+    const env = options.env || process.env;
+    const rejectFrameChannelForTest = isEnabledValue(env.LIVEDESK_TEST_MODE, false)
+        && isEnabledValue(env.LIVEDESK_TEST_REJECT_FRAME_CHANNEL, false);
     const logEvent = options.logEvent || (() => {});
     const logWarn = options.logWarn || (() => {});
     const emitEvent = options.emitEvent || (() => {});
@@ -4497,9 +4499,14 @@ export function createRemoteHub(options = {}) {
                 state.device = device;
                 state.inputOnly = true;
                 return;
-            }
-            if (channel === 'frame') {
-                const device = attachFrameSocket(socket, message);
+            }
+            if (channel === 'frame') {
+                if (rejectFrameChannelForTest) {
+                    writeJsonLine(socket, { type: 'error', error: 'test-frame-channel-unavailable' });
+                    socket.end();
+                    return;
+                }
+                const device = attachFrameSocket(socket, message);
                 if (!device) {
                     return;
                 }

package/hub/src/transport/udp-hub-transport.js

@@ -30,16 +30,16 @@ function sameEndpoint(left, right) {
     return !!left && !!right && String(left.address) === String(right.address) && Number(left.port) === Number(right.port);
 }
 
-export function createHubUdpTransport({ env = process.env, logEvent = () => {}, logWarn = () => {} } = {}) {
-    const enabled = isEnabled(env.LIVEDESK_UDP_ENABLED, false);
-    const preferP2p = isEnabled(env.LIVEDESK_UDP_PREFER_P2P, true);
+export function createHubUdpTransport({ env = process.env, logEvent = () => {}, logWarn = () => {} } = {}) {
+    const enabled = isEnabled(env.LIVEDESK_UDP_ENABLED, true);
+    const preferP2p = isEnabled(env.LIVEDESK_UDP_PREFER_P2P, false);
     const bindHost = safeText(env.LIVEDESK_UDP_BIND_HOST || '0.0.0.0', 128) || '0.0.0.0';
     const requestedPort = numberEnv(env.LIVEDESK_UDP_PORT, 0, 65535, 0);
     const advertiseHost = safeText(env.LIVEDESK_UDP_ADVERTISE_HOST || env.LIVEDESK_REMOTE_PUBLIC_HOST || '', 128);
-    const rendezvousHost = safeText(env.LIVEDESK_UDP_RENDEZVOUS_HOST || '', 128);
+    const rendezvousHost = safeText(env.LIVEDESK_UDP_RENDEZVOUS_HOST || 'www.gnsoftech.com', 128);
     const rendezvousPort = numberEnv(env.LIVEDESK_UDP_RENDEZVOUS_PORT, 1, 65535, 5199);
     const punchTimeoutMs = numberEnv(env.LIVEDESK_UDP_PUNCH_TIMEOUT_MS, 500, 10_000, 3000);
-    const frameTimeoutMs = numberEnv(env.LIVEDESK_UDP_FRAME_TIMEOUT_MS, 20, 2000, 80);
+    const frameTimeoutMs = numberEnv(env.LIVEDESK_UDP_FRAME_TIMEOUT_MS, 20, 2000, 500);
     const maxPendingFrames = numberEnv(env.LIVEDESK_UDP_MAX_PENDING_FRAMES, 1, 16, 2);
     const trace = isEnabled(env.LIVEDESK_UDP_TRACE, false);
     const socket = dgram.createSocket('udp4');
@@ -171,10 +171,16 @@ export function createHubUdpTransport({ env = process.env, logEvent = () => {},
             socket.once('error', onError);
             socket.once('listening', onListening);
             socket.bind(requestedPort, bindHost);
-        });
-        started = true;
-        boundPort = socket.address().port;
-        logEvent('udp', `UDP P2P socket listening on udp://${bindHost}:${boundPort}`);
+        });
+        started = true;
+        boundPort = socket.address().port;
+        try {
+            socket.setRecvBufferSize(8 * 1024 * 1024);
+            socket.setSendBufferSize(1024 * 1024);
+        } catch (error) {
+            logWarn('udp', `UDP socket buffer tuning was unavailable: ${error?.message || error}`);
+        }
+        logEvent('udp', `UDP P2P socket listening on udp://${bindHost}:${boundPort}`);
         return getStatus();
     }
 

package/hub/src/transport/udp-protocol.js

@@ -1,4 +1,5 @@
-import crypto from 'node:crypto';
+import crypto from 'node:crypto';
+import { inflateRawSync } from 'node:zlib';
 
 export const UDP_P2P_PROTOCOL = 'livedesk.udp.p2p.v1';
 export const UDP_P2P_VERSION = 1;
@@ -17,8 +18,10 @@ const UDP_FIXED_HEADER_BYTES = 15;
 const UDP_NONCE_BYTES = 12;
 const UDP_TAG_BYTES = 16;
 const UDP_MAX_SESSION_ID_BYTES = 96;
-const UDP_MAX_HEADER_BYTES = 4096;
-const UDP_MAX_PAYLOAD_BYTES = UDP_MAX_DATAGRAM_BYTES - UDP_FIXED_HEADER_BYTES - UDP_NONCE_BYTES - UDP_TAG_BYTES - 1;
+const UDP_MAX_HEADER_BYTES = 4096;
+const UDP_MAX_PAYLOAD_BYTES = UDP_MAX_DATAGRAM_BYTES - UDP_FIXED_HEADER_BYTES - UDP_NONCE_BYTES - UDP_TAG_BYTES - 1;
+const UDP_FRAME_PAYLOAD_MAGIC = Buffer.from('LDF1', 'ascii');
+const UDP_MAX_FRAME_HEADER_BYTES = 64 * 1024;
 
 function asBuffer(value) {
     if (Buffer.isBuffer(value)) return value;
@@ -32,13 +35,53 @@ function normalizeKey(key) {
     return value.length === 32 ? value : crypto.createHash('sha256').update(value).digest();
 }
 
-function normalizeSessionId(value) {
+function normalizeSessionId(value) {
     const sessionId = String(value || '').trim();
     if (!sessionId || Buffer.byteLength(sessionId, 'utf8') > UDP_MAX_SESSION_ID_BYTES) {
         throw new Error('invalid-udp-session-id');
     }
     return sessionId;
-}
+}
+
+function decodeFrameHeader(header) {
+    if (header?.frameHeader && typeof header.frameHeader === 'object') {
+        return header.frameHeader;
+    }
+    const encoded = String(header?.frameHeaderDeflate || '');
+    if (!encoded || encoded.length > 8192 || !/^[A-Za-z0-9+/]+={0,2}$/.test(encoded)) {
+        return null;
+    }
+    try {
+        const json = inflateRawSync(Buffer.from(encoded, 'base64'), { maxOutputLength: 64 * 1024 }).toString('utf8');
+        const value = JSON.parse(json);
+        return value && typeof value === 'object' && !Array.isArray(value) ? value : null;
+    } catch {
+        return null;
+    }
+}
+
+function decodeFramedPayload(payload, legacyHeader = null) {
+    const bytes = asBuffer(payload);
+    if (bytes.length < 8 || !bytes.subarray(0, 4).equals(UDP_FRAME_PAYLOAD_MAGIC)) {
+        return { header: legacyHeader || {}, payload: bytes };
+    }
+    const compressedHeaderLength = bytes.readUInt32BE(4);
+    if (compressedHeaderLength < 1 || compressedHeaderLength > UDP_MAX_FRAME_HEADER_BYTES
+        || 8 + compressedHeaderLength > bytes.length) return null;
+    try {
+        const json = inflateRawSync(bytes.subarray(8, 8 + compressedHeaderLength), {
+            maxOutputLength: UDP_MAX_FRAME_HEADER_BYTES
+        }).toString('utf8');
+        const header = JSON.parse(json);
+        if (!header || typeof header !== 'object' || Array.isArray(header)) return null;
+        return {
+            header,
+            payload: bytes.subarray(8 + compressedHeaderLength)
+        };
+    } catch {
+        return null;
+    }
+}
 
 function packetTypeCode(type) {
     const code = typeof type === 'number' ? type : UDP_PACKET_TYPES[String(type || '').toLowerCase()];
@@ -147,10 +190,10 @@ export class UdpReplayWindow {
     }
 }
 
-export class UdpFrameReassembler {
-    constructor({ maxPending = 2, timeoutMs = 80, maxFrameBytes = 8 * 1024 * 1024 } = {}) {
-        this.maxPending = Math.max(1, Math.min(16, Math.floor(Number(maxPending) || 2)));
-        this.timeoutMs = Math.max(20, Math.min(2000, Math.floor(Number(timeoutMs) || 80)));
+export class UdpFrameReassembler {
+    constructor({ maxPending = 2, timeoutMs = 500, maxFrameBytes = 8 * 1024 * 1024 } = {}) {
+        this.maxPending = Math.max(1, Math.min(16, Math.floor(Number(maxPending) || 2)));
+        this.timeoutMs = Math.max(20, Math.min(2000, Math.floor(Number(timeoutMs) || 500)));
         this.maxFrameBytes = Math.max(64 * 1024, Math.min(16 * 1024 * 1024, Math.floor(Number(maxFrameBytes) || 8 * 1024 * 1024)));
         this.pending = new Map();
     }
@@ -179,19 +222,25 @@ export class UdpFrameReassembler {
         state.chunks[chunkIndex] = payload;
         state.received += 1;
         state.totalBytes += payload.length;
-        if (header.frameHeader && typeof header.frameHeader === 'object') state.frameHeader = header.frameHeader;
+        const decodedFrameHeader = decodeFrameHeader(header);
+        if (decodedFrameHeader) state.frameHeader = decodedFrameHeader;
         if (state.totalBytes > this.maxFrameBytes) {
             this.pending.delete(frameId);
             return null;
-        }
-        if (state.received !== state.chunkCount) return null;
-        this.pending.delete(frameId);
-        return {
-            frameId,
-            header: state.frameHeader || header.frameHeader || {},
-            payload: Buffer.concat(state.chunks, state.totalBytes)
-        };
-    }
+        }
+        if (state.received !== state.chunkCount) return null;
+        this.pending.delete(frameId);
+        const complete = decodeFramedPayload(
+            Buffer.concat(state.chunks, state.totalBytes),
+            state.frameHeader || header.frameHeader || {}
+        );
+        if (!complete) return null;
+        return {
+            frameId,
+            header: complete.header,
+            payload: complete.payload
+        };
+    }
 
     expire(now = Date.now()) {
         for (const [frameId, state] of this.pending) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "livedesk",
-  "version": "0.1.436",
-  "livedeskClientVersion": "0.1.192",
+  "version": "0.1.437",
+  "livedeskClientVersion": "0.1.193",
   "buildFlavor": "production",
   "description": "LiveDesk Hub and client launcher",
   "type": "module",
@@ -50,10 +50,10 @@
     "ws": "^8.18.3"
   },
   "optionalDependencies": {
-    "@livedesk/fast-linux-x64": "0.1.399",
-    "@livedesk/fast-osx-arm64": "0.1.399",
-    "@livedesk/fast-osx-x64": "0.1.399",
-    "@livedesk/fast-win-x64": "0.1.399"
+    "@livedesk/fast-linux-x64": "0.1.400",
+    "@livedesk/fast-osx-arm64": "0.1.400",
+    "@livedesk/fast-osx-x64": "0.1.400",
+    "@livedesk/fast-win-x64": "0.1.400"
   },
   "publishConfig": {
     "access": "public"