@runloop/rl-cli 1.9.0 → 1.10.0

package/dist/services/gatewayConfigService.js

@@ -68,6 +68,45 @@ export async function getGatewayConfig(id) {
         account_id: config.account_id ?? undefined,
     };
 }
+/**
+ * Get a single gateway config by ID or name
+ */
+export async function getGatewayConfigByIdOrName(idOrName) {
+    const client = getClient();
+    // Try to retrieve directly by ID first
+    try {
+        const config = await client.gatewayConfigs.retrieve(idOrName);
+        return {
+            id: config.id,
+            name: config.name,
+            description: config.description ?? undefined,
+            endpoint: config.endpoint,
+            create_time_ms: config.create_time_ms,
+            auth_mechanism: {
+                type: config.auth_mechanism.type,
+                key: config.auth_mechanism.key ?? undefined,
+            },
+            account_id: config.account_id ?? undefined,
+        };
+    }
+    catch {
+        // Not found by ID, try by name
+    }
+    // Search by name
+    const queryParams = {
+        limit: 100,
+        name: idOrName,
+    };
+    const pagePromise = client.gatewayConfigs.list(queryParams);
+    const page = (await pagePromise);
+    const configs = page.gateway_configs || [];
+    if (configs.length === 0) {
+        return null;
+    }
+    // Return the first exact match, or first result if no exact match
+    const match = configs.find((g) => g.name === idOrName) || configs[0];
+    return getGatewayConfig(match.id);
+}
 /**
  * Delete a gateway config
  */

package/dist/utils/commands.js

@@ -14,7 +14,9 @@ export function createProgram() {
     program
         .name("rli")
         .description("Beautiful CLI for Runloop devbox management")
-        .version(VERSION);
+        .version(VERSION)
+        .showHelpAfterError()
+        .showSuggestionAfterError();
     // Devbox commands
     const devbox = program
         .command("devbox")
@@ -119,22 +121,36 @@ export function createProgram() {
         await sshDevbox(id, options);
     });
     devbox
-        .command("scp <id> <src> <dst>")
-        .description("Copy files to/from a devbox using scp")
+        .command("scp <src> <dst>")
+        .description("Copy files to/from a devbox using scp. Use the devbox ID (dbx_*) as a hostname in src or dst.\n\n" +
+        "  Examples:\n" +
+        "    $ rli devbox scp dbx_abc123:/home/user/file.txt ./file.txt       # download from devbox\n" +
+        "    $ rli devbox scp ./file.txt dbx_abc123:/home/user/file.txt       # upload to devbox\n" +
+        "    $ rli devbox scp root@dbx_abc123:/etc/hosts ./hosts              # with explicit user\n" +
+        "    $ rli devbox scp dbx_src:/data/file.txt dbx_dst:/data/file.txt   # devbox to devbox\n\n" +
+        "  If no user is specified, the devbox's configured user is used.\n" +
+        "  Paths without a dbx_ hostname are treated as local.\n" +
+        "  Devbox-to-devbox transfers route through your local machine via scp -3.")
         .option("--scp-options <options>", "Additional scp options (quoted)")
         .option("-o, --output [format]", "Output format: text|json|yaml (default: text)")
-        .action(async (id, src, dst, options) => {
+        .action(async (src, dst, options) => {
         const { scpFiles } = await import("../commands/devbox/scp.js");
-        await scpFiles(id, { src, dst, ...options });
+        await scpFiles(src, dst, options);
     });
     devbox
-        .command("rsync <id> <src> <dst>")
-        .description("Sync files to/from a devbox using rsync")
+        .command("rsync <src> <dst>")
+        .description("Sync files to/from a devbox using rsync. Use the devbox ID (dbx_*) as a hostname in src or dst.\n\n" +
+        "  Examples:\n" +
+        "    $ rli devbox rsync dbx_abc123:/home/user/data/ ./data/             # download from devbox\n" +
+        "    $ rli devbox rsync ./data/ dbx_abc123:/home/user/data/             # upload to devbox\n" +
+        "    $ rli devbox rsync root@dbx_abc123:/etc/config/ ./config/          # with explicit user\n\n" +
+        "  If no user is specified, the devbox's configured user is used.\n" +
+        "  Paths without a dbx_ hostname are treated as local.")
         .option("--rsync-options <options>", "Additional rsync options (quoted)")
         .option("-o, --output [format]", "Output format: text|json|yaml (default: text)")
-        .action(async (id, src, dst, options) => {
+        .action(async (src, dst, options) => {
         const { rsyncFiles } = await import("../commands/devbox/rsync.js");
-        await rsyncFiles(id, { src, dst, ...options });
+        await rsyncFiles(src, dst, options);
     });
     devbox
         .command("tunnel <id> <ports>")
@@ -530,8 +546,8 @@ export function createProgram() {
         .description("Create a new gateway configuration")
         .requiredOption("--name <name>", "Gateway config name (required)")
         .requiredOption("--endpoint <url>", "Target endpoint URL (required)")
-        .requiredOption("--auth-type <type>", "Authentication type: bearer or header (required)")
-        .option("--auth-key <key>", "Header key name (required for header auth type)")
+        .option("--bearer-auth", "Use Bearer token authentication (default)")
+        .option("--header-auth <header>", "Use custom header authentication (specify header key name)")
         .option("--description <description>", "Description")
         .option("-o, --output [format]", "Output format: text|json|yaml (default: text)")
         .action(async (options) => {
@@ -551,8 +567,8 @@ export function createProgram() {
         .description("Update a gateway configuration")
         .option("--name <name>", "New name")
         .option("--endpoint <url>", "New endpoint URL")
-        .option("--auth-type <type>", "New authentication type: bearer or header")
-        .option("--auth-key <key>", "New header key name (required for header auth type)")
+        .option("--bearer-auth", "Use Bearer token authentication")
+        .option("--header-auth <header>", "Use custom header authentication (specify header key name)")
         .option("--description <description>", "New description")
         .option("-o, --output [format]", "Output format: text|json|yaml (default: text)")
         .action(async (id, options) => {

package/dist/utils/gatewayConfigValidation.js

@@ -0,0 +1,58 @@
+/**
+ * Shared validation for gateway config create/update operations.
+ * Used by both CLI commands and UI components.
+ */
+/**
+ * Validate and sanitize gateway config fields.
+ *
+ * @param input - The fields to validate
+ * @param opts.requireName - Whether name is required (true for create, false for update)
+ * @param opts.requireEndpoint - Whether endpoint is required (true for create, false for update)
+ */
+export function validateGatewayConfig(input, opts = {}) {
+    const errors = [];
+    const name = input.name?.trim();
+    const endpoint = input.endpoint?.trim();
+    const authType = input.authType?.toLowerCase();
+    const authKey = input.authKey?.trim();
+    // Name validation
+    if (opts.requireName && !name) {
+        errors.push("Name is required");
+    }
+    // Endpoint validation
+    if (opts.requireEndpoint && !endpoint) {
+        errors.push("Endpoint URL is required");
+    }
+    if (endpoint) {
+        if (!endpoint.startsWith("https://") && !endpoint.startsWith("http://")) {
+            errors.push("Endpoint must be a valid URL starting with https:// or http://");
+        }
+        // Basic URL structure validation
+        try {
+            new URL(endpoint);
+        }
+        catch {
+            errors.push("Endpoint is not a valid URL");
+        }
+    }
+    // Auth validation
+    if (authType && authType !== "bearer" && authType !== "header") {
+        errors.push('Auth type must be either "bearer" or "header"');
+    }
+    if (authType === "header" && !authKey) {
+        errors.push("Auth header key is required when using header authentication");
+    }
+    if (errors.length > 0) {
+        return { valid: false, errors };
+    }
+    return {
+        valid: true,
+        errors: [],
+        sanitized: {
+            name,
+            endpoint,
+            authType,
+            authKey,
+        },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runloop/rl-cli",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "Beautiful CLI for the Runloop platform",
   "type": "module",
   "bin": {
@@ -103,6 +103,7 @@
     "test:watch": "NODE_OPTIONS='--experimental-vm-modules' jest --watch",
     "test:coverage": "NODE_OPTIONS='--experimental-vm-modules' jest --coverage",
     "test:components": "NODE_OPTIONS='--experimental-vm-modules' jest --config jest.components.config.js --coverage --forceExit",
+    "test:e2e": "NODE_OPTIONS='--experimental-vm-modules' jest --config jest.e2e.config.js --forceExit",
     "docs:commands": "pnpm run build && node scripts/generate-command-docs.js"
   }
 }