livedesk 0.1.19 → 0.1.21

package/hub/src/remote-hub.js

@@ -27,7 +27,7 @@ const REMOTE_AGENT_PROTOCOL = 'mindexec.remote.agent';
 const REMOTE_FRAME_PROTOCOL = 'mindexec.remote.frame.v2';
 const REMOTE_FRAME_PROTOCOL_VERSION = 2;
 const REMOTE_FRAME_HANDSHAKE = 'smartview-request-open-frame';
-const DEFAULT_REMOTE_FRAME_MODE = 'remote-fast';
+const DEFAULT_REMOTE_FRAME_MODE = 'mode1-jpeg';
 const REMOTE_FRAME_MODE_PROFILES = Object.freeze({
     thumbnail: Object.freeze({
         mode: 'thumbnail',
@@ -40,54 +40,77 @@ const REMOTE_FRAME_MODE_PROFILES = Object.freeze({
         modeVersion: 1,
         implemented: true
     }),
-    'remote-fast': Object.freeze({
-        mode: 'remote-fast',
-        label: 'RemoteFast JPEG Binary',
+    'mode1-jpeg': Object.freeze({
+        mode: 'mode1-jpeg',
+        label: 'Mode 1 - Test JPEG Binary',
         transport: 'ws-binary',
         encoding: 'image',
         codec: 'jpeg',
         compression: 'image/jpeg',
-        profile: 'jpeg-binary-v1',
+        profile: 'mode1-jpeg-binary-v1',
         modeVersion: 1,
         implemented: true
     }),
-    'remote-quality': Object.freeze({
-        mode: 'remote-quality',
-        label: 'RemoteQuality JPEG Binary',
+    'mode2-lz4': Object.freeze({
+        mode: 'mode2-lz4',
+        label: 'Mode 2 - Raw BGRA LZ4',
         transport: 'ws-binary',
-        encoding: 'image',
-        codec: 'jpeg',
-        compression: 'image/jpeg',
-        profile: 'jpeg-quality-binary-v1',
-        modeVersion: 1,
+        encoding: 'image-raw',
+        codec: 'bgra32',
+        compression: 'lz4',
+        profile: 'mode2-lz4-bgra-v1',
+        modeVersion: 2,
         implemented: true
     }),
-    'video-codec': Object.freeze({
-        mode: 'video-codec',
-        label: 'Video Codec Stream',
+    'mode3-h264-hw': Object.freeze({
+        mode: 'mode3-h264-hw',
+        label: 'Mode 3 - Hardware H.264',
         transport: 'ws-binary',
         encoding: 'video',
-        codec: 'video',
-        compression: 'video/*',
-        profile: 'future-video-codec',
-        modeVersion: 0,
+        codec: 'h264',
+        compression: 'video/h264',
+        profile: 'mode3-h264-hardware-v1',
+        modeVersion: 3,
         implemented: false
     })
 });
 const REMOTE_FRAME_MODE_ALIASES = new Map([
-    ['fast', 'remote-fast'],
-    ['remotefast', 'remote-fast'],
-    ['remote_fast', 'remote-fast'],
-    ['remote-fast', 'remote-fast'],
-    ['quality', 'remote-quality'],
-    ['remotequality', 'remote-quality'],
-    ['remote_quality', 'remote-quality'],
-    ['remote-quality', 'remote-quality'],
+    ['1', 'mode1-jpeg'],
+    ['mode1', 'mode1-jpeg'],
+    ['mode-1', 'mode1-jpeg'],
+    ['mode1-jpeg', 'mode1-jpeg'],
+    ['jpeg', 'mode1-jpeg'],
+    ['jpg', 'mode1-jpeg'],
+    ['test', 'mode1-jpeg'],
+    ['fast', 'mode1-jpeg'],
+    ['remotefast', 'mode1-jpeg'],
+    ['remote_fast', 'mode1-jpeg'],
+    ['remote-fast', 'mode1-jpeg'],
+    ['quality', 'mode1-jpeg'],
+    ['remotequality', 'mode1-jpeg'],
+    ['remote_quality', 'mode1-jpeg'],
+    ['remote-quality', 'mode1-jpeg'],
+    ['2', 'mode2-lz4'],
+    ['mode2', 'mode2-lz4'],
+    ['mode-2', 'mode2-lz4'],
+    ['mode2-lz4', 'mode2-lz4'],
+    ['lz4', 'mode2-lz4'],
+    ['tile-lz4', 'mode2-lz4'],
+    ['tiles-lz4', 'mode2-lz4'],
+    ['3', 'mode3-h264-hw'],
+    ['mode3', 'mode3-h264-hw'],
+    ['mode-3', 'mode3-h264-hw'],
+    ['mode3-h264', 'mode3-h264-hw'],
+    ['mode3-h264-hw', 'mode3-h264-hw'],
+    ['h264', 'mode3-h264-hw'],
+    ['h264-hw', 'mode3-h264-hw'],
+    ['hardware', 'mode3-h264-hw'],
+    ['hardware-h264', 'mode3-h264-hw'],
     ['thumb', 'thumbnail'],
     ['thumbnail', 'thumbnail'],
-    ['video', 'video-codec'],
-    ['codec', 'video-codec'],
-    ['video-codec', 'video-codec']
+    ['video', 'mode3-h264-hw'],
+    ['codec', 'mode3-h264-hw'],
+    ['video-codec', 'mode3-h264-hw']
 ]);
 const MAX_SYNTHETIC_DEVICES = 1000;
 const DEFAULT_HOST_TARGET_LEASE_MS = 30000;
@@ -134,7 +157,7 @@ function safeString(value, maxLength = 200) {
     return String(value ?? '').replace(/[\r\n\t]/g, ' ').trim().slice(0, maxLength);
 }
 
-function normalizeRemoteFrameMode(value, fallback = DEFAULT_REMOTE_FRAME_MODE) {
+function normalizeRemoteFrameMode(value, fallback = DEFAULT_REMOTE_FRAME_MODE, { allowUnimplemented = false } = {}) {
     const requested = safeString(value, 80).toLowerCase();
     const fallbackMode = REMOTE_FRAME_MODE_PROFILES[fallback] ? fallback : DEFAULT_REMOTE_FRAME_MODE;
     if (!requested) {
@@ -143,7 +166,7 @@ function normalizeRemoteFrameMode(value, fallback = DEFAULT_REMOTE_FRAME_MODE) {
 
     const normalized = REMOTE_FRAME_MODE_ALIASES.get(requested) || requested;
     const profile = REMOTE_FRAME_MODE_PROFILES[normalized];
-    if (!profile || profile.implemented !== true) {
+    if (!profile || (!allowUnimplemented && profile.implemented !== true)) {
         return fallbackMode;
     }
 
@@ -164,14 +187,13 @@ function serializeRemoteFrameModeProfile(profile) {
     };
 }
 
-function getRemoteFrameModeProfile(value, fallback = DEFAULT_REMOTE_FRAME_MODE) {
-    const mode = normalizeRemoteFrameMode(value, fallback);
+function getRemoteFrameModeProfile(value, fallback = DEFAULT_REMOTE_FRAME_MODE, options = {}) {
+    const mode = normalizeRemoteFrameMode(value, fallback, options);
     return serializeRemoteFrameModeProfile(REMOTE_FRAME_MODE_PROFILES[mode]);
 }
 
 function getSupportedRemoteFrameModeProfiles() {
     return Object.values(REMOTE_FRAME_MODE_PROFILES)
-        .filter(profile => profile.implemented === true)
         .map(serializeRemoteFrameModeProfile);
 }
 
@@ -222,14 +244,14 @@ function normalizeIncomingFrameModeProfile(value) {
     }
 
     if (typeof value === 'string') {
-        return getRemoteFrameModeProfile(value);
+        return getRemoteFrameModeProfile(value, DEFAULT_REMOTE_FRAME_MODE, { allowUnimplemented: true });
     }
 
     if (typeof value !== 'object') {
         return null;
     }
 
-    const profile = buildRemoteFrameTransferDescriptor(value.mode || value.frameMode || value.profile);
+    const profile = getRemoteFrameModeProfile(value.mode || value.frameMode || value.profile, DEFAULT_REMOTE_FRAME_MODE, { allowUnimplemented: true });
     return {
         mode: profile.mode,
         label: safeString(value.label, 80) || profile.mode,
@@ -1593,8 +1615,8 @@ export function createRemoteHub(options = {}) {
             streamId: safeString(streamId, 128) || `${mode}-${Date.now()}`,
             frameSeq,
             commandId: safeString(options.commandId, 128),
-            width: clampNumber(options.width, 2, 2560, mode === 'remote-fast' ? 640 : 360),
-            height: clampNumber(options.height, 1, 1440, mode === 'remote-fast' ? 360 : 220),
+            width: clampNumber(options.width, 2, 2560, mode === 'thumbnail' ? 360 : 640),
+            height: clampNumber(options.height, 1, 1440, mode === 'thumbnail' ? 220 : 360),
             mimeType: 'image/png',
             format: 'image/png',
             mode,
@@ -1606,7 +1628,7 @@ export function createRemoteHub(options = {}) {
             transferProtocol: descriptor.transferProtocol,
             transferProtocolVersion: descriptor.transferProtocolVersion,
             handshake: descriptor.handshake,
-            fps: clampNumber(options.fps, 1, 24, mode === 'remote-fast' ? 2 : 1),
+            fps: clampNumber(options.fps, 1, 24, mode === 'thumbnail' ? 1 : 2),
             capturedAt: now,
             receivedAt: now,
             byteLength: 68,
@@ -2579,6 +2601,9 @@ export function createRemoteHub(options = {}) {
             encoding: transfer.encoding,
             codec: transfer.codec,
             compression: transfer.compression || mimeType,
+            pixelFormat: safeString(message.pixelFormat, 40),
+            bytesPerPixel: Number.isFinite(Number(message.bytesPerPixel)) ? Number(message.bytesPerPixel) : 0,
+            uncompressedByteLength: Number.isFinite(Number(message.uncompressedByteLength)) ? Number(message.uncompressedByteLength) : 0,
             transferProtocol: transfer.transferProtocol,
             transferProtocolVersion: transfer.transferProtocolVersion,
             handshake: transfer.handshake,
@@ -2714,6 +2739,9 @@ export function createRemoteHub(options = {}) {
             encoding: transfer.encoding,
             codec: transfer.codec,
             compression: transfer.compression || mimeType,
+            pixelFormat: safeString(message.pixelFormat, 40),
+            bytesPerPixel: Number.isFinite(Number(message.bytesPerPixel)) ? Number(message.bytesPerPixel) : 0,
+            uncompressedByteLength: Number.isFinite(Number(message.uncompressedByteLength)) ? Number(message.uncompressedByteLength) : 0,
             transferProtocol: transfer.transferProtocol,
             transferProtocolVersion: transfer.transferProtocolVersion,
             handshake: transfer.handshake,

package/hub/src/server.js

@@ -134,7 +134,7 @@ function normalizeTransferFiles(value) {
 }
 
 function normalizeLiveOptions(payload = {}) {
-  const mode = String(payload.frameMode || payload.mode || 'remote-fast').trim() || 'remote-fast';
+  const mode = String(payload.frameMode || payload.mode || 'mode2-lz4').trim() || 'mode2-lz4';
   return {
     fps: clampNumber(payload.fps, 1, 24, 2),
     maxWidth: clampNumber(payload.maxWidth, 320, 2560, 640),
@@ -230,6 +230,9 @@ function buildRemoteFrameBinaryPacket(frameEvent) {
     encoding: frame.encoding || '',
     codec: frame.codec || '',
     compression: frame.compression || frame.mimeType || frame.format || '',
+    pixelFormat: frame.pixelFormat || '',
+    bytesPerPixel: Number(frame.bytesPerPixel || 0) || 0,
+    uncompressedByteLength: Number(frame.uncompressedByteLength || 0) || 0,
     fps: Number(frame.fps || 0) || 0,
     capturedAt: frame.capturedAt || '',
     receivedAt: frame.receivedAt || '',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "livedesk",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "description": "LiveDesk Hub and client launcher",
   "type": "module",
   "bin": {
@@ -30,7 +30,7 @@
     "node": ">=20"
   },
   "dependencies": {
-    "@livedesk/client": "0.1.25",
+    "@livedesk/client": "0.1.27",
     "cors": "^2.8.5",
     "express": "^4.21.2",
     "ws": "^8.18.3"