@qodalis/cli-scp 2.0.0-beta.2 → 2.0.0-beta.20

package/public-api.mjs

@@ -1,15 +1,11 @@
-import { DefaultLibraryAuthor, ICliFileTransferService_TOKEN } from '@qodalis/cli-core';
+import { createCliToken, DefaultLibraryAuthor, resolveServerHeaders, ICliFileTransferService_TOKEN, resolveHeaders, splitShellWords } from '@qodalis/cli-core';
 
 // src/lib/processors/cli-scp-command-processor.ts
 
 // src/lib/version.ts
-var LIBRARY_VERSION = "2.0.0-beta.2";
+var LIBRARY_VERSION = "2.0.0-beta.20";
 var API_VERSION = 2;
-
-// src/lib/interfaces/index.ts
-var IScpTransferService_TOKEN = "scp-transfer-service";
-
-// src/lib/processors/scp-utils.ts
+var IScpTransferService_TOKEN = createCliToken("scp-transfer-service");
 function resolveServer(serverName, context) {
   const servers = context.options?.servers;
   if (!servers || servers.length === 0) {
@@ -47,10 +43,10 @@ function parseServerAndPath(value, context, args) {
   if (serverArg && pathArg) {
     return [String(serverArg), String(pathArg)];
   }
-  if (!value?.trim()) {
+  const parts = splitShellWords(value ?? "");
+  if (parts.length === 0) {
     return null;
   }
-  const parts = value.trim().split(/\s+/);
   if (parts.length < 2) {
     if (serverArg && parts.length >= 1) {
       return [String(serverArg), parts.join(" ")];
@@ -62,8 +58,6 @@ function parseServerAndPath(value, context, args) {
   }
   return [parts[0], parts.slice(1).join(" ")];
 }
-
-// src/lib/processors/cli-scp-ls-processor.ts
 var CliScpLsProcessor = class {
   constructor() {
     this.command = "ls";
@@ -94,7 +88,7 @@ var CliScpLsProcessor = class {
     const [serverName, path] = parsed;
     const server = resolveServer(serverName, context);
     if (!server) return;
-    const transferService = context.services.get(
+    const transferService = context.services.getRequired(
       IScpTransferService_TOKEN
     );
     if (!transferService) {
@@ -106,7 +100,7 @@ var CliScpLsProcessor = class {
       const entries = await transferService.ls(
         serverUrl(server),
         path,
-        server.headers
+        resolveServerHeaders(context.services, server.name, server.headers)
       );
       context.spinner?.hide();
       if (entries.length === 0) {
@@ -131,8 +125,6 @@ var CliScpLsProcessor = class {
     context.writer.writeln("List files and directories on a remote server.");
   }
 };
-
-// src/lib/processors/cli-scp-cat-processor.ts
 var CliScpCatProcessor = class {
   constructor() {
     this.command = "cat";
@@ -163,7 +155,7 @@ var CliScpCatProcessor = class {
     const [serverName, path] = parsed;
     const server = resolveServer(serverName, context);
     if (!server) return;
-    const transferService = context.services.get(
+    const transferService = context.services.getRequired(
       IScpTransferService_TOKEN
     );
     if (!transferService) {
@@ -175,7 +167,7 @@ var CliScpCatProcessor = class {
       const content = await transferService.cat(
         serverUrl(server),
         path,
-        server.headers
+        resolveServerHeaders(context.services, server.name, server.headers)
       );
       context.spinner?.hide();
       context.writer.writeln(content);
@@ -233,12 +225,11 @@ var CliScpDownloadProcessor = class {
       remotePath = String(args["remote-path"] || args["path"]);
       localPath = args["local-path"] ? String(args["local-path"]) : void 0;
     } else {
-      const value = command.value?.trim();
-      if (!value) {
+      const parts = command.positionals ?? [];
+      if (parts.length === 0) {
         context.writer.writeError("Usage: scp download <server> <remote-path> [local-path]");
         return;
       }
-      const parts = value.split(/\s+/);
       if (parts.length < 2) {
         context.writer.writeError("Usage: scp download <server> <remote-path> [local-path]");
         return;
@@ -254,7 +245,7 @@ var CliScpDownloadProcessor = class {
     localPath = localPath || remotePath.split("/").pop() || "download";
     const server = resolveServer(serverName, context);
     if (!server) return;
-    const transferService = context.services.get(
+    const transferService = context.services.getRequired(
       IScpTransferService_TOKEN
     );
     if (!transferService) {
@@ -263,6 +254,7 @@ var CliScpDownloadProcessor = class {
     }
     const useBrowserDownload = command.args?.["save"] === true;
     context.spinner?.show(`Downloading ${remotePath} from ${server.name}...`);
+    context.notifier.info(`scp: downloading from ${server.name}`);
     const abortController = new AbortController();
     const abortSub = context.onAbort.subscribe(() => abortController.abort());
     try {
@@ -270,7 +262,7 @@ var CliScpDownloadProcessor = class {
       const { content, size } = await transferService.download(
         serverUrl(server),
         remotePath,
-        server.headers,
+        resolveServerHeaders(context.services, server.name, server.headers),
         (received, total) => {
           const now = Date.now();
           if (now - lastProgressUpdate < 200) return;
@@ -280,17 +272,19 @@ var CliScpDownloadProcessor = class {
             context.spinner?.show(
               `Downloading ${remotePath}... ${pct}% (${formatBytes(received)}/${formatBytes(total)})`
             );
+            context.notifier.info(`scp: download ${pct}%`);
           } else {
             context.spinner?.show(
               `Downloading ${remotePath}... ${formatBytes(received)}`
             );
+            context.notifier.info(`scp: download ${formatBytes(received)}`);
           }
         },
         abortController.signal
       );
       context.spinner?.hide();
       if (useBrowserDownload) {
-        const fileService = context.services.get(
+        const fileService = context.services.getRequired(
           ICliFileTransferService_TOKEN
         );
         if (fileService) {
@@ -302,7 +296,7 @@ var CliScpDownloadProcessor = class {
           context.writer.writeError("File transfer service not available for browser download.");
         }
       } else {
-        const fileService = context.services.get(
+        const fileService = context.services.getRequired(
           ICliFileTransferService_TOKEN
         );
         if (fileService) {
@@ -331,7 +325,7 @@ var CliScpUploadProcessor = class {
   constructor() {
     this.command = "upload";
     this.aliases = ["put"];
-    this.description = "Upload a local file to a remote server";
+    this.description = "Upload a file to a remote server (use --local to pick from your machine)";
     this.acceptsRawInput = true;
     this.valueRequired = true;
     this.parameters = [
@@ -343,8 +337,8 @@ var CliScpUploadProcessor = class {
       },
       {
         name: "local-path",
-        description: "Local file path",
-        required: true,
+        description: "Local file path (from virtual filesystem)",
+        required: false,
         type: "string"
       },
       {
@@ -352,71 +346,103 @@ var CliScpUploadProcessor = class {
         description: "Remote destination path",
         required: true,
         type: "string"
+      },
+      {
+        name: "local",
+        description: "Pick a file from your local machine via browser file picker",
+        required: false,
+        type: "boolean"
       }
     ];
   }
   async processCommand(command, context) {
     const args = command.args || {};
+    const useLocalPicker = !!args["local"];
     let serverName;
     let localPath;
     let remotePath;
-    if (args["server"] && args["local-path"] && args["remote-path"]) {
+    if (args["server"] && args["remote-path"]) {
       serverName = String(args["server"]);
-      localPath = String(args["local-path"]);
+      localPath = args["local-path"] ? String(args["local-path"]) : void 0;
       remotePath = String(args["remote-path"]);
     } else {
-      const value = command.value?.trim();
-      if (!value) {
-        context.writer.writeError("Usage: scp upload <server> <local-path> <remote-path>");
+      const parts = command.positionals ?? [];
+      if (parts.length === 0) {
+        context.writer.writeError(
+          useLocalPicker ? "Usage: scp upload --local <server> <remote-path>" : "Usage: scp upload <server> <local-path> <remote-path>"
+        );
         return;
       }
-      const parts = value.split(/\s+/);
-      if (parts.length < 3) {
-        context.writer.writeError("Usage: scp upload <server> <local-path> <remote-path>");
-        return;
+      if (useLocalPicker) {
+        if (parts.length < 2) {
+          context.writer.writeError("Usage: scp upload --local <server> <remote-path>");
+          return;
+        }
+        serverName = parts[0];
+        remotePath = parts[1];
+      } else {
+        if (parts.length < 3) {
+          context.writer.writeError("Usage: scp upload <server> <local-path> <remote-path>");
+          return;
+        }
+        serverName = parts[0];
+        localPath = parts[1];
+        remotePath = parts[2];
       }
-      serverName = parts[0];
-      localPath = parts[1];
-      remotePath = parts[2];
     }
-    if (!serverName || !localPath || !remotePath) {
-      context.writer.writeError("Usage: scp upload <server> <local-path> <remote-path>");
+    if (!serverName || !useLocalPicker && !localPath || !remotePath) {
+      context.writer.writeError(
+        useLocalPicker ? "Usage: scp upload --local <server> <remote-path>" : "Usage: scp upload <server> <local-path> <remote-path>"
+      );
       return;
     }
     const server = resolveServer(serverName, context);
     if (!server) return;
-    const fileService = context.services.get(
+    const fileService = context.services.getRequired(
       ICliFileTransferService_TOKEN
     );
     if (!fileService) {
       context.writer.writeError("File transfer service not available.");
       return;
     }
-    const transferService = context.services.get(
+    const transferService = context.services.getRequired(
       IScpTransferService_TOKEN
     );
     if (!transferService) {
       context.writer.writeError("SCP transfer service not available.");
       return;
     }
-    context.spinner?.show(`Reading local file "${localPath}"...`);
-    try {
-      const content = await fileService.readFile(localPath);
+    let content;
+    let filename;
+    if (useLocalPicker) {
+      const picked = await fileService.uploadFromBrowser();
+      if (!picked) {
+        context.writer.writeln("Upload cancelled.");
+        return;
+      }
+      content = picked.content;
+      filename = picked.name;
+    } else {
+      context.spinner?.show(`Reading local file "${localPath}"...`);
+      content = await fileService.readFile(localPath);
       if (content === null) {
         context.spinner?.hide();
         context.writer.writeError(`Local file not found: ${localPath}`);
         return;
       }
-      const filename = localPath.split("/").pop() || "file";
-      context.spinner?.show(
-        `Uploading "${filename}" (${formatBytes(content.length)}) to ${server.name}:${remotePath}...`
-      );
+      filename = localPath.split("/").pop() || "file";
+    }
+    context.spinner?.show(
+      `Uploading "${filename}" (${formatBytes(content.length)}) to ${server.name}:${remotePath}...`
+    );
+    context.notifier.info(`scp: uploading to ${server.name}`);
+    try {
       await transferService.upload(
         serverUrl(server),
         remotePath,
         content,
         filename,
-        server.headers
+        resolveServerHeaders(context.services, server.name, server.headers)
       );
       context.spinner?.hide();
       context.writer.writeSuccess(
@@ -428,12 +454,13 @@ var CliScpUploadProcessor = class {
     }
   }
   writeDescription(context) {
-    context.writer.writeln("Upload a local file to a remote server.");
-    context.writer.writeln("Usage: scp upload <server> <local-path> <remote-path>");
+    context.writer.writeln("Upload a file to a remote server.");
+    context.writer.writeln("");
+    context.writer.writeln("Usage:");
+    context.writer.writeln("  scp upload <server> <local-path> <remote-path>    Upload from virtual filesystem");
+    context.writer.writeln("  scp upload --local <server> <remote-path>         Pick from your machine via browser");
   }
 };
-
-// src/lib/processors/cli-scp-rm-processor.ts
 var CliScpRmProcessor = class {
   constructor() {
     this.command = "rm";
@@ -464,7 +491,7 @@ var CliScpRmProcessor = class {
     const [serverName, path] = parsed;
     const server = resolveServer(serverName, context);
     if (!server) return;
-    const transferService = context.services.get(
+    const transferService = context.services.getRequired(
       IScpTransferService_TOKEN
     );
     if (!transferService) {
@@ -476,7 +503,7 @@ var CliScpRmProcessor = class {
       await transferService.rm(
         serverUrl(server),
         path,
-        server.headers
+        resolveServerHeaders(context.services, server.name, server.headers)
       );
       context.spinner?.hide();
       context.writer.writeSuccess(`Deleted: ${server.name}:${path}`);
@@ -489,8 +516,6 @@ var CliScpRmProcessor = class {
     context.writer.writeln("Delete a file on a remote server.");
   }
 };
-
-// src/lib/processors/cli-scp-mkdir-processor.ts
 var CliScpMkdirProcessor = class {
   constructor() {
     this.command = "mkdir";
@@ -521,7 +546,7 @@ var CliScpMkdirProcessor = class {
     const [serverName, path] = parsed;
     const server = resolveServer(serverName, context);
     if (!server) return;
-    const transferService = context.services.get(
+    const transferService = context.services.getRequired(
       IScpTransferService_TOKEN
     );
     if (!transferService) {
@@ -533,7 +558,7 @@ var CliScpMkdirProcessor = class {
       await transferService.mkdir(
         serverUrl(server),
         path,
-        server.headers
+        resolveServerHeaders(context.services, server.name, server.headers)
       );
       context.spinner?.hide();
       context.writer.writeSuccess(`Created directory: ${server.name}:${path}`);
@@ -546,8 +571,6 @@ var CliScpMkdirProcessor = class {
     context.writer.writeln("Create a directory on a remote server.");
   }
 };
-
-// src/lib/processors/cli-scp-stat-processor.ts
 var CliScpStatProcessor = class {
   constructor() {
     this.command = "stat";
@@ -578,7 +601,7 @@ var CliScpStatProcessor = class {
     const [serverName, path] = parsed;
     const server = resolveServer(serverName, context);
     if (!server) return;
-    const transferService = context.services.get(
+    const transferService = context.services.getRequired(
       IScpTransferService_TOKEN
     );
     if (!transferService) {
@@ -590,7 +613,7 @@ var CliScpStatProcessor = class {
       const stat = await transferService.stat(
         serverUrl(server),
         path,
-        server.headers
+        resolveServerHeaders(context.services, server.name, server.headers)
       );
       context.spinner?.hide();
       const entries = {
@@ -621,6 +644,7 @@ var CliScpCommandCommandProcessor = class {
     this.description = "SCP-like file transfer between browser and remote servers";
     this.author = DefaultLibraryAuthor;
     this.version = LIBRARY_VERSION;
+    this.metadata = { icon: "\u{1F4C1}", module: "file management" };
     this.acceptsRawInput = true;
     this.processors = [
       new CliScpLsProcessor(),
@@ -633,33 +657,25 @@ var CliScpCommandCommandProcessor = class {
     ];
   }
   async processCommand(command, context) {
-    const value = command.value?.trim();
-    if (value && value.includes(":") && !value.startsWith("-")) {
-      const colonIdx = value.indexOf(":");
-      const spaceBeforeColon = value.lastIndexOf(" ", colonIdx);
-      if (spaceBeforeColon === -1) {
-        const serverName = value.substring(0, colonIdx);
-        const rest = value.substring(colonIdx + 1);
-        const parts2 = rest.trim().split(/\s+/);
-        const remotePath = parts2[0];
-        const localPath = parts2[1] || remotePath.split("/").pop() || "download";
+    const [first = "", second] = command.positionals ?? [];
+    if (first && !first.startsWith("-")) {
+      const colonIdx = first.indexOf(":");
+      if (colonIdx !== -1) {
+        const serverName = first.substring(0, colonIdx);
+        const remotePath = first.substring(colonIdx + 1);
+        const localPath = second || remotePath.split("/").pop() || "download";
         if (remotePath) {
           await this.doDownload(serverName, remotePath, localPath, command, context);
           return;
         }
       }
-      const parts = value.split(/\s+/);
-      if (parts.length >= 2) {
-        const secondPart = parts[1];
-        if (secondPart.includes(":")) {
-          const localPath = parts[0];
-          const srvColonIdx = secondPart.indexOf(":");
-          const serverName = secondPart.substring(0, srvColonIdx);
-          const remotePath = secondPart.substring(srvColonIdx + 1);
-          if (remotePath) {
-            await this.doUpload(serverName, localPath, remotePath, context);
-            return;
-          }
+      if (second?.includes(":")) {
+        const srvColonIdx = second.indexOf(":");
+        const serverName = second.substring(0, srvColonIdx);
+        const remotePath = second.substring(srvColonIdx + 1);
+        if (remotePath) {
+          await this.doUpload(serverName, first, remotePath, context);
+          return;
         }
       }
     }
@@ -671,7 +687,7 @@ var CliScpCommandCommandProcessor = class {
   async doDownload(serverName, remotePath, localPath, command, context) {
     const server = resolveServer(serverName, context);
     if (!server) return;
-    const transferService = context.services.get(
+    const transferService = context.services.getRequired(
       IScpTransferService_TOKEN
     );
     if (!transferService) {
@@ -680,12 +696,13 @@ var CliScpCommandCommandProcessor = class {
     }
     const useBrowserDownload = command.args?.["save"] === true;
     context.spinner?.show(`Downloading ${remotePath} from ${server.name}...`);
+    context.notifier.info(`scp: downloading from ${server.name}`);
     try {
       let lastProgressUpdate = 0;
       const { content, size } = await transferService.download(
         serverUrl(server),
         remotePath,
-        server.headers,
+        resolveServerHeaders(context.services, server.name, server.headers),
         (received, total) => {
           const now = Date.now();
           if (now - lastProgressUpdate < 200) return;
@@ -695,15 +712,17 @@ var CliScpCommandCommandProcessor = class {
             context.spinner?.show(
               `Downloading ${remotePath}... ${pct}% (${formatBytes(received)}/${formatBytes(total)})`
             );
+            context.notifier.info(`scp: download ${pct}%`);
           } else {
             context.spinner?.show(
               `Downloading ${remotePath}... ${formatBytes(received)}`
             );
+            context.notifier.info(`scp: download ${formatBytes(received)}`);
           }
         }
       );
       context.spinner?.hide();
-      const fileService = context.services.get(
+      const fileService = context.services.getRequired(
         ICliFileTransferService_TOKEN
       );
       if (!fileService) {
@@ -729,14 +748,14 @@ var CliScpCommandCommandProcessor = class {
   async doUpload(serverName, localPath, remotePath, context) {
     const server = resolveServer(serverName, context);
     if (!server) return;
-    const fileService = context.services.get(
+    const fileService = context.services.getRequired(
       ICliFileTransferService_TOKEN
     );
     if (!fileService) {
       context.writer.writeError("File transfer service not available.");
       return;
     }
-    const transferService = context.services.get(
+    const transferService = context.services.getRequired(
       IScpTransferService_TOKEN
     );
     if (!transferService) {
@@ -744,6 +763,7 @@ var CliScpCommandCommandProcessor = class {
       return;
     }
     context.spinner?.show(`Reading local file "${localPath}"...`);
+    context.notifier.info(`scp: reading ${localPath}`);
     try {
       const content = await fileService.readFile(localPath);
       if (content === null) {
@@ -755,12 +775,13 @@ var CliScpCommandCommandProcessor = class {
       context.spinner?.show(
         `Uploading "${filename}" (${formatBytes(content.length)}) to ${server.name}:${remotePath}...`
       );
+      context.notifier.info(`scp: uploading to ${server.name}`);
       await transferService.upload(
         serverUrl(server),
         remotePath,
         content,
         filename,
-        server.headers
+        resolveServerHeaders(context.services, server.name, server.headers)
       );
       context.spinner?.hide();
       context.writer.writeSuccess(
@@ -772,32 +793,30 @@ var CliScpCommandCommandProcessor = class {
     }
   }
 };
-
-// src/lib/services/scp-transfer.service.ts
 var ScpTransferService = class {
   async ls(serverUrl2, path, headers) {
-    const res = await this._fetch(`${serverUrl2}/api/cli/fs/ls?path=${encodeURIComponent(path)}`, {
-      headers
+    const res = await this._fetch(`${serverUrl2}/api/qcli/fs/ls?path=${encodeURIComponent(path)}`, {
+      headers: resolveHeaders(headers)
     });
     const data = await res.json();
     return data.entries;
   }
   async cat(serverUrl2, path, headers) {
-    const res = await this._fetch(`${serverUrl2}/api/cli/fs/cat?path=${encodeURIComponent(path)}`, {
-      headers
+    const res = await this._fetch(`${serverUrl2}/api/qcli/fs/cat?path=${encodeURIComponent(path)}`, {
+      headers: resolveHeaders(headers)
     });
     const data = await res.json();
     return data.content;
   }
   async stat(serverUrl2, path, headers) {
-    const res = await this._fetch(`${serverUrl2}/api/cli/fs/stat?path=${encodeURIComponent(path)}`, {
-      headers
+    const res = await this._fetch(`${serverUrl2}/api/qcli/fs/stat?path=${encodeURIComponent(path)}`, {
+      headers: resolveHeaders(headers)
     });
     return await res.json();
   }
   async download(serverUrl2, path, headers, onProgress, signal) {
-    const res = await this._fetch(`${serverUrl2}/api/cli/fs/download?path=${encodeURIComponent(path)}`, {
-      headers,
+    const res = await this._fetch(`${serverUrl2}/api/qcli/fs/download?path=${encodeURIComponent(path)}`, {
+      headers: resolveHeaders(headers),
       signal
     });
     const contentLength = parseInt(res.headers.get("content-length") || "0", 10);
@@ -830,23 +849,23 @@ var ScpTransferService = class {
     const formData = new FormData();
     formData.append("path", remotePath);
     formData.append("file", new Blob([content]), filename);
-    await this._fetch(`${serverUrl2}/api/cli/fs/upload`, {
+    await this._fetch(`${serverUrl2}/api/qcli/fs/upload`, {
       method: "POST",
       body: formData,
-      headers
+      headers: resolveHeaders(headers)
     });
   }
   async mkdir(serverUrl2, path, headers) {
-    await this._fetch(`${serverUrl2}/api/cli/fs/mkdir`, {
+    await this._fetch(`${serverUrl2}/api/qcli/fs/mkdir`, {
       method: "POST",
-      headers: { "Content-Type": "application/json", ...headers },
+      headers: { "Content-Type": "application/json", ...resolveHeaders(headers) },
       body: JSON.stringify({ path })
     });
   }
   async rm(serverUrl2, path, headers) {
-    await this._fetch(`${serverUrl2}/api/cli/fs/rm?path=${encodeURIComponent(path)}`, {
+    await this._fetch(`${serverUrl2}/api/qcli/fs/rm?path=${encodeURIComponent(path)}`, {
       method: "DELETE",
-      headers
+      headers: resolveHeaders(headers)
     });
   }
   async _fetch(url, init) {