lobstercage-cli 0.1.0

package/dist/commands/env.js

@@ -0,0 +1,287 @@
+"use strict";
+/**
+ * Environment Variable Commands
+ *
+ * env list, env set, env get, env delete, env scan
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.envListHandler = envListHandler;
+exports.envSetHandler = envSetHandler;
+exports.envGetHandler = envGetHandler;
+exports.envDeleteHandler = envDeleteHandler;
+exports.envScanHandler = envScanHandler;
+exports.createEnvCommands = createEnvCommands;
+const ora_1 = __importDefault(require("ora"));
+const api = __importStar(require("../lib/api"));
+const output = __importStar(require("../lib/output"));
+const utils_1 = require("../lib/utils");
+const error_handler_1 = require("../lib/error-handler");
+/**
+ * Validates environment variable name format
+ */
+function isValidEnvName(name) {
+    if (!name) {
+        return { valid: false, message: 'Variable name is required' };
+    }
+    if (!/^[A-Z_][A-Z0-9_]*$/.test(name)) {
+        return { valid: false, message: 'Variable name must be uppercase with underscores (e.g., MY_VAR)' };
+    }
+    if (name.length > 256) {
+        return { valid: false, message: 'Variable name must be at most 256 characters' };
+    }
+    return { valid: true };
+}
+/**
+ * Env list command handler
+ */
+async function envListHandler(nameOrId, options) {
+    const spinner = (0, ora_1.default)('Fetching environment variables...').start();
+    try {
+        (0, utils_1.requireAuth)();
+        const cageId = await (0, utils_1.resolveCageId)(nameOrId);
+        const vars = await api.listEnvVars(cageId);
+        spinner.stop();
+        if (options.json) {
+            output.json(vars);
+        }
+        else {
+            console.log();
+            console.log(output.formatEnvVars(vars));
+            console.log();
+        }
+    }
+    catch (err) {
+        (0, error_handler_1.handleError)(err, { spinner, json: options.json, context: 'fetching environment variables' });
+    }
+}
+/**
+ * Env set command handler
+ */
+async function envSetHandler(nameOrId, keyValues, options) {
+    if (keyValues.length === 0) {
+        output.error('No variables specified. Use KEY=VALUE format.');
+        process.exit(1);
+    }
+    // Parse KEY=VALUE pairs
+    const variables = {};
+    for (const kv of keyValues) {
+        const eqIndex = kv.indexOf('=');
+        if (eqIndex === -1) {
+            output.error(`Invalid format: "${kv}". Use KEY=VALUE`);
+            process.exit(1);
+        }
+        const key = kv.slice(0, eqIndex);
+        const value = kv.slice(eqIndex + 1);
+        const validation = isValidEnvName(key);
+        if (!validation.valid) {
+            output.error(`Invalid variable name "${key}": ${validation.message}`);
+            process.exit(1);
+        }
+        variables[key] = value;
+    }
+    const spinner = (0, ora_1.default)('Setting environment variables...').start();
+    try {
+        (0, utils_1.requireAuth)();
+        const cageId = await (0, utils_1.resolveCageId)(nameOrId);
+        const result = await api.setEnvVars(cageId, {
+            variables,
+            scan: !options.noScan,
+        });
+        spinner.stop();
+        if (options.json) {
+            output.json(result);
+        }
+        else {
+            output.success(`Set ${Object.keys(variables).length} environment variable(s)`);
+            // Show security warnings if any
+            if (result.securityWarnings && result.securityWarnings.length > 0) {
+                console.log();
+                output.warning('Security warnings:');
+                console.log();
+                console.log(output.formatSecurityWarnings(result.securityWarnings));
+                console.log();
+            }
+        }
+    }
+    catch (err) {
+        (0, error_handler_1.handleError)(err, { spinner, json: options.json, context: 'setting environment variables' });
+    }
+}
+/**
+ * Env get command handler
+ */
+async function envGetHandler(nameOrId, varName, options) {
+    const validation = isValidEnvName(varName);
+    if (!validation.valid) {
+        output.error(`Invalid variable name: ${validation.message}`);
+        process.exit(1);
+    }
+    const spinner = (0, ora_1.default)('Fetching environment variable...').start();
+    try {
+        (0, utils_1.requireAuth)();
+        const cageId = await (0, utils_1.resolveCageId)(nameOrId);
+        const result = await api.getEnvVar(cageId, varName);
+        spinner.stop();
+        if (options.json) {
+            output.json(result);
+        }
+        else {
+            // Output just the value for easy scripting
+            console.log(result.value);
+        }
+    }
+    catch (err) {
+        (0, error_handler_1.handleError)(err, { spinner, json: options.json, context: 'fetching environment variable' });
+    }
+}
+/**
+ * Env delete command handler
+ */
+async function envDeleteHandler(nameOrId, varNames, options) {
+    if (varNames.length === 0) {
+        output.error('No variables specified');
+        process.exit(1);
+    }
+    // Validate all names first
+    for (const varName of varNames) {
+        const validation = isValidEnvName(varName);
+        if (!validation.valid) {
+            output.error(`Invalid variable name "${varName}": ${validation.message}`);
+            process.exit(1);
+        }
+    }
+    const spinner = (0, ora_1.default)('Deleting environment variables...').start();
+    try {
+        (0, utils_1.requireAuth)();
+        const cageId = await (0, utils_1.resolveCageId)(nameOrId);
+        // Delete each variable
+        const results = [];
+        for (const varName of varNames) {
+            try {
+                await api.deleteEnvVar(cageId, varName);
+                results.push({ name: varName, success: true });
+            }
+            catch (err) {
+                if (err instanceof api.ApiClientError) {
+                    results.push({ name: varName, success: false, error: err.message });
+                }
+                else {
+                    throw err;
+                }
+            }
+        }
+        spinner.stop();
+        if (options.json) {
+            output.json(results);
+        }
+        else {
+            const successes = results.filter(r => r.success);
+            const failures = results.filter(r => !r.success);
+            if (successes.length > 0) {
+                output.success(`Deleted ${successes.length} variable(s)`);
+            }
+            for (const failure of failures) {
+                output.error(`Failed to delete ${failure.name}: ${failure.error}`);
+            }
+        }
+    }
+    catch (err) {
+        (0, error_handler_1.handleError)(err, { spinner, json: options.json, context: 'deleting environment variables' });
+    }
+}
+/**
+ * Env scan command handler
+ */
+async function envScanHandler(nameOrId, options) {
+    const spinner = (0, ora_1.default)('Scanning environment variables for security issues...').start();
+    try {
+        (0, utils_1.requireAuth)();
+        const cageId = await (0, utils_1.resolveCageId)(nameOrId);
+        const result = await api.scanEnvVars(cageId);
+        spinner.stop();
+        if (options.json) {
+            output.json(result);
+        }
+        else {
+            console.log();
+            console.log(output.formatSecurityWarnings(result.warnings));
+            console.log();
+        }
+    }
+    catch (err) {
+        (0, error_handler_1.handleError)(err, { spinner, json: options.json, context: 'scanning environment variables' });
+    }
+}
+/**
+ * Create env commands
+ */
+function createEnvCommands(program) {
+    const env = program
+        .command('env')
+        .description('Manage environment variables');
+    env
+        .command('list <cage>')
+        .alias('ls')
+        .description('List environment variables')
+        .option('--json', 'Output as JSON')
+        .action(envListHandler);
+    env
+        .command('set <cage> <keyValues...>')
+        .description('Set environment variables (KEY=VALUE format)')
+        .option('--no-scan', 'Skip security scan')
+        .option('--json', 'Output as JSON')
+        .action(envSetHandler);
+    env
+        .command('get <cage> <name>')
+        .description('Get environment variable value')
+        .option('--json', 'Output as JSON')
+        .action(envGetHandler);
+    env
+        .command('delete <cage> <names...>')
+        .alias('rm')
+        .description('Delete environment variables')
+        .option('--json', 'Output as JSON')
+        .action(envDeleteHandler);
+    env
+        .command('scan <cage>')
+        .description('Scan environment variables for security issues')
+        .option('--json', 'Output as JSON')
+        .action(envScanHandler);
+}
+//# sourceMappingURL=env.js.map

package/dist/commands/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/commands/env.ts"],"names":[],"mappings":"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"}

package/dist/commands/exec.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Exec Command
+ *
+ * Execute commands in a cage or open an interactive shell.
+ * Uses the API when --api-url is configured, otherwise local Docker.
+ */
+import { Command } from 'commander';
+export declare function execHandler(name: string, args: string[], options: {
+    local?: boolean;
+}): Promise<void>;
+export declare function createExecCommand(program: Command): void;
+//# sourceMappingURL=exec.d.ts.map

package/dist/commands/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/commands/exec.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAK3G;AAqED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CASxD"}

package/dist/commands/exec.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * Exec Command
+ *
+ * Execute commands in a cage or open an interactive shell.
+ * Uses the API when --api-url is configured, otherwise local Docker.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execHandler = execHandler;
+exports.createExecCommand = createExecCommand;
+const child_process_1 = require("child_process");
+const api = __importStar(require("../lib/api"));
+const docker = __importStar(require("../lib/docker"));
+const output = __importStar(require("../lib/output"));
+const utils_1 = require("../lib/utils");
+const error_handler_1 = require("../lib/error-handler");
+async function execHandler(name, args, options) {
+    if (options.local) {
+        return execHandlerLocal(name, args);
+    }
+    return execHandlerApi(name, args);
+}
+/**
+ * Exec via API endpoint
+ */
+async function execHandlerApi(name, args) {
+    if (args.length === 0) {
+        output.error('Interactive shell is not supported in API mode. Provide a command to execute.');
+        process.exit(1);
+    }
+    try {
+        const cageId = await (0, utils_1.resolveCageId)(name);
+        const result = await api.execInCage(cageId, args);
+        if (result.stdout) {
+            process.stdout.write(result.stdout);
+        }
+        if (result.stderr) {
+            process.stderr.write(result.stderr);
+        }
+        process.exit(result.exitCode ?? 0);
+    }
+    catch (err) {
+        (0, error_handler_1.handleError)(err, { context: 'executing command in cage' });
+    }
+}
+/**
+ * Exec via local Docker
+ */
+async function execHandlerLocal(name, args) {
+    // Verify cage exists and is running
+    try {
+        const cage = await docker.getCage(name);
+        if (cage.status !== 'running') {
+            output.error(`Cage "${name}" is not running (status: ${cage.status})`);
+            process.exit(1);
+        }
+    }
+    catch (err) {
+        (0, error_handler_1.handleError)(err, { context: 'checking cage status' });
+    }
+    const containerName = docker.getContainerName(name);
+    const isInteractive = args.length === 0;
+    const spawnArgs = ['exec'];
+    if (isInteractive) {
+        spawnArgs.push('-it', containerName, '/bin/bash');
+    }
+    else {
+        if (process.stdin.isTTY) {
+            spawnArgs.push('-it');
+        }
+        spawnArgs.push(containerName, ...args);
+    }
+    const child = (0, child_process_1.spawn)('docker', spawnArgs, {
+        stdio: 'inherit',
+    });
+    child.on('exit', (code) => {
+        process.exit(code ?? 0);
+    });
+    child.on('error', (err) => {
+        output.error(`Failed to exec: ${err.message}`);
+        process.exit(1);
+    });
+}
+function createExecCommand(program) {
+    program
+        .command('exec <name> [command...]')
+        .description('Execute a command in a cage (interactive shell if no command given)')
+        .option('-l, --local', 'Use local Docker instead of remote API')
+        .passThroughOptions()
+        .action(async (name, command, options) => {
+        await execHandler(name, command, options);
+    });
+}
+//# sourceMappingURL=exec.js.map

package/dist/commands/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/commands/exec.ts"],"names":[],"mappings":"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"}

package/dist/commands/tunnel.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Tunnel Commands
+ *
+ * tunnel, ssh
+ */
+import { Command } from 'commander';
+/**
+ * Tunnel command handler
+ */
+export declare function tunnelHandler(nameOrId: string, options: {
+    port?: string;
+    localPort?: string;
+    ssh?: boolean;
+    json?: boolean;
+}): Promise<void>;
+/**
+ * SSH command handler
+ *
+ * This is a convenience wrapper around tunnel --ssh
+ */
+export declare function sshHandler(nameOrId: string, options: {
+    localPort?: string;
+    json?: boolean;
+}): Promise<void>;
+/**
+ * Create tunnel commands
+ */
+export declare function createTunnelCommands(program: Command): void;
+//# sourceMappingURL=tunnel.d.ts.map

package/dist/commands/tunnel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel.d.ts","sourceRoot":"","sources":["../../src/commands/tunnel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmGpC;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;IACP,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,GACA,OAAO,CAAC,IAAI,CAAC,CAkDf;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9C,OAAO,CAAC,IAAI,CAAC,CAyCf;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgB3D"}