@livedesk/client 0.1.90 → 0.1.92

package/bin/livedesk-client-node.js

@@ -466,6 +466,76 @@ async function handleFileTransferCommand(options, payload = {}) {
     };
 }
 
+async function handleFileTransferChunkCommand(options, payload = {}) {
+    const baseDir = normalizeDirectoryPath(payload.remoteDirectory || options.filesDir);
+    const name = sanitizePathSegment(payload.name, 'file');
+    const relativePath = sanitizeRelativeFilePath(payload.relativePath || name, name);
+    const targetPath = path.resolve(baseDir, relativePath);
+    const relativeFromBase = path.relative(baseDir, targetPath);
+    if (relativeFromBase.startsWith('..') || path.isAbsolute(relativeFromBase)) {
+        throw new Error(`Unsafe file path: ${relativePath}`);
+    }
+
+    const transferId = String(payload.transferId || '').replace(/[^a-zA-Z0-9_.:-]/g, '-').slice(0, 128);
+    const offset = Math.max(0, Math.floor(Number(payload.offset) || 0));
+    const totalBytes = Math.max(0, Math.floor(Number(payload.totalBytes) || 0));
+    const final = payload.final === true;
+    const buffer = payload.dataBase64 ? Buffer.from(String(payload.dataBase64), 'base64') : Buffer.alloc(0);
+    if (!transferId || offset > totalBytes || offset + buffer.length > totalBytes || buffer.length > 512 * 1024) {
+        throw new Error('Invalid file transfer chunk.');
+    }
+    if (buffer.length === 0 && !(final && totalBytes === 0 && offset === 0)) {
+        throw new Error('Empty file chunks are not allowed.');
+    }
+
+    await fs.mkdir(path.dirname(targetPath), { recursive: true });
+    const tempPath = `${targetPath}.livedesk-${transferId}.part`;
+    const handle = await fs.open(tempPath, offset === 0 ? 'w+' : 'r+');
+    let completedSize = 0;
+    try {
+        const before = await handle.stat();
+        if (offset > before.size) {
+            throw new Error(`File chunk gap detected at ${offset}; current length is ${before.size}.`);
+        }
+        if (buffer.length > 0) {
+            await handle.write(buffer, 0, buffer.length, offset);
+        }
+        const after = await handle.stat();
+        completedSize = after.size;
+        if (final) {
+            await handle.sync();
+            if (after.size !== totalBytes) {
+                throw new Error(`File transfer is incomplete (${after.size}/${totalBytes}).`);
+            }
+        }
+    } finally {
+        await handle.close();
+    }
+
+    if (final) {
+        await fs.rm(targetPath, { force: true });
+        await fs.rename(tempPath, targetPath);
+        const lastModified = Number(payload.lastModified || 0);
+        if (lastModified > 0) {
+            const modifiedAt = new Date(lastModified);
+            await fs.utimes(targetPath, modifiedAt, modifiedAt).catch(() => undefined);
+        }
+    }
+
+    return {
+        kind: 'file.transfer.chunk',
+        transferId,
+        status: final ? 'completed' : 'receiving',
+        relativePath: relativePath.split(path.sep).join('/'),
+        offset,
+        bytes: buffer.length,
+        totalBytes,
+        completedSize,
+        final,
+        completedAt: final ? new Date().toISOString() : null
+    };
+}
+
 function clampNumber(value, min, max, fallback) {
     const number = Number(value);
     if (!Number.isFinite(number)) {
@@ -996,6 +1066,24 @@ async function handleRemoteCommand(socket, options, message, nextFrameSeq, activ
         return;
     }
 
+    if (command === 'file.transfer.chunk') {
+        try {
+            const result = await handleFileTransferChunkCommand(options, message.payload || {});
+            writeJsonLine(socket, {
+                type: 'command.result',
+                commandId: message.commandId,
+                result
+            });
+        } catch (error) {
+            writeJsonLine(socket, {
+                type: 'command.result',
+                commandId: message.commandId,
+                error: error?.message || String(error)
+            });
+        }
+        return;
+    }
+
     if (command === 'audio.start' || command === 'audio.stop') {
         writeJsonLine(socket, {
             type: 'command.result',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livedesk/client",
-  "version": "0.1.90",
+  "version": "0.1.92",
   "description": "LiveDesk local remote client",
   "type": "module",
   "bin": {