@underlingscloud/cli 0.1.0 → 0.2.0

package/dist/commands/run.d.ts

@@ -1,2 +1,17 @@
 export declare const run: (commandParts: string[]) => Promise<void>;
-export declare const env: () => Promise<void>;
+/**
+ * Print resolved environment variables.
+ *
+ * Options:
+ *   --service <slug>  Override service slug (otherwise reads from ulservice.json)
+ *   --branch <name>   Override branch (otherwise detects from git)
+ *   --format <fmt>    Output format: 'shell' (default), 'yaml', 'docker-build-args'
+ *   --filter <prefix> Only include vars matching prefix (e.g. 'VITE_')
+ */
+export declare const env: (options: {
+    service?: string;
+    branch?: string;
+    format?: string;
+    filter?: string;
+}) => Promise<void>;
+export declare function fetchServiceVariables(serviceSlug: string, branch: string, token: string): Promise<Record<string, string>>;

package/dist/commands/run.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.env = exports.run = void 0;
+exports.fetchServiceVariables = fetchServiceVariables;
 const cross_spawn_1 = __importDefault(require("cross-spawn"));
 const child_process_1 = require("child_process");
 const chalk_1 = __importDefault(require("chalk"));
@@ -81,29 +82,92 @@ const run = async (commandParts) => {
     });
 };
 exports.run = run;
-const env = async () => {
+/**
+ * Print resolved environment variables.
+ *
+ * Options:
+ *   --service <slug>  Override service slug (otherwise reads from ulservice.json)
+ *   --branch <name>   Override branch (otherwise detects from git)
+ *   --format <fmt>    Output format: 'shell' (default), 'yaml', 'docker-build-args'
+ *   --filter <prefix> Only include vars matching prefix (e.g. 'VITE_')
+ */
+const env = async (options) => {
     if (!(0, auth_1.isAuthenticated)()) {
         console.error(chalk_1.default.red('Error: You are not logged in.'));
-        return;
+        process.exit(1);
     }
     const token = (0, auth_1.getAuthToken)();
-    if (!(0, config_1.hasServiceConfig)()) {
-        console.error(chalk_1.default.red('Error: No service config found in the current directory.'));
-        return;
+    // Determine service slug
+    let serviceSlug = options.service;
+    if (!serviceSlug) {
+        if (!(0, config_1.hasServiceConfig)()) {
+            console.error(chalk_1.default.red('Error: No service config found. Use --service <slug> or run from a directory with ulservice.json.'));
+            process.exit(1);
+        }
+        serviceSlug = (0, config_1.readServiceConfig)().service;
     }
-    const config = (0, config_1.readServiceConfig)();
-    let branch;
-    try {
-        branch = (0, child_process_1.execSync)('git rev-parse --abbrev-ref HEAD').toString().trim();
+    // Determine branch
+    let branch = options.branch || 'main';
+    if (!options.branch) {
+        try {
+            branch = (0, child_process_1.execSync)('git rev-parse --abbrev-ref HEAD').toString().trim();
+        }
+        catch {
+            // Fall back to 'main' if not in a git repo
+        }
     }
-    catch {
-        console.error(chalk_1.default.red('Error: Could not determine git branch.'));
-        return;
+    // Fetch vars
+    let envVars;
+    try {
+        envVars = await fetchServiceVariables(serviceSlug, branch, token);
     }
-    console.log(chalk_1.default.blue(`Variables for ${config.service} on branch "${branch}":\n`));
-    const envVars = await fetchServiceVariables(config.service, branch, token);
-    for (const [key, value] of Object.entries(envVars).sort(([a], [b]) => a.localeCompare(b))) {
-        console.log(`${chalk_1.default.cyan(key)}=${value}`);
+    catch (error) {
+        console.error(chalk_1.default.red('Failed to fetch variables:'), error.message);
+        process.exit(1);
+    }
+    // Apply filter
+    if (options.filter) {
+        const prefix = options.filter;
+        envVars = Object.fromEntries(Object.entries(envVars).filter(([key]) => key.startsWith(prefix)));
+    }
+    const format = options.format || 'shell';
+    const sorted = Object.entries(envVars).sort(([a], [b]) => a.localeCompare(b));
+    switch (format) {
+        case 'yaml':
+            // YAML format for gcloud --env-vars-file
+            for (const [key, value] of sorted) {
+                // YAML values with special chars need quoting
+                const needsQuote = /[:{}\[\],&*#?|\-<>=!%@`"'\n\\]/.test(value) || value.includes(' ');
+                if (needsQuote) {
+                    // Use double-quoted YAML string, escaping backslashes and double quotes
+                    const escaped = value.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n');
+                    console.log(`${key}: "${escaped}"`);
+                }
+                else {
+                    console.log(`${key}: ${value}`);
+                }
+            }
+            break;
+        case 'docker-build-args':
+            // Output as --build-arg KEY=VALUE flags for docker build
+            for (const [key, value] of sorted) {
+                console.log(`--build-arg ${key}=${value}`);
+            }
+            break;
+        case 'dotenv':
+            // .env file format
+            for (const [key, value] of sorted) {
+                const escaped = value.replace(/"/g, '\\"');
+                console.log(`${key}="${escaped}"`);
+            }
+            break;
+        case 'shell':
+        default:
+            // Human-readable shell format (default)
+            for (const [key, value] of sorted) {
+                console.log(`${chalk_1.default.cyan(key)}=${value}`);
+            }
+            break;
     }
 };
 exports.env = env;

package/dist/index.js

@@ -94,8 +94,12 @@ program.command('run [command...]')
 // ─── Env ────────────────────────────────────────────────────────────────────
 program.command('env')
     .description('Print resolved environment variables for current service + branch')
-    .action(async () => {
+    .option('-s, --service <slug>', 'Service slug (overrides ulservice.json)')
+    .option('-b, --branch <name>', 'Branch name (overrides git detection)')
+    .option('-f, --format <fmt>', 'Output format: shell, yaml, docker-build-args, dotenv', 'shell')
+    .option('--filter <prefix>', 'Only include vars matching prefix (e.g. VITE_)')
+    .action(async (options) => {
     const { env } = await Promise.resolve().then(() => __importStar(require('./commands/run')));
-    await env();
+    await env(options);
 });
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@underlingscloud/cli",
-    "version": "0.1.0",
+    "version": "0.2.0",
     "description": "Underlings Developer Utilities CLI",
     "main": "dist/index.js",
     "bin": {