badgr-cli 1.0.3 → 1.0.4

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "badgr-cli",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Badgr — run or serve GPU workloads from one command",
   "type": "module",
   "bin": {
-    "badgr": "src/badgr.js"
+    "badgr": "./src/badgr.js"
   },
   "scripts": {
     "start": "node src/badgr.js",
@@ -21,14 +21,6 @@
   "engines": {
     "node": ">=18.0.0"
   },
-  "keywords": [
-    "gpu",
-    "cli",
-    "ai",
-    "compute",
-    "modal",
-    "gateway",
-    "openai"
-  ],
+  "keywords": ["gpu", "cli", "ai", "compute", "modal", "gateway", "openai"],
   "license": "MIT"
 }

package/src/api.js

@@ -1,16 +1,42 @@
 export async function callApi(path, { method = 'GET', apiKey, baseUrl, body } = {}) {
   const url = `${baseUrl}${path}`;
-  const res = await fetch(url, {
-    method,
-    headers: {
-      'Content-Type': 'application/json',
-      'Authorization': `Bearer ${apiKey}`,
-    },
-    body: body !== undefined ? JSON.stringify(body) : undefined,
-  });
+  let res;
+  try {
+    res = await fetch(url, {
+      method,
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${apiKey}`,
+      },
+      body: body !== undefined ? JSON.stringify(body) : undefined,
+    });
+  } catch (cause) {
+    // Network-level failure: DNS, connection refused, timeout, etc.
+    const msg = cause?.message ?? String(cause);
+    const hint =
+      msg.includes('ECONNREFUSED') ? `\n  Hint: Connection refused — is the server running at ${baseUrl}?` :
+      msg.includes('ENOTFOUND')    ? `\n  Hint: DNS lookup failed — check your internet connection or BADGR_API_URL` :
+      msg.includes('ETIMEDOUT')    ? `\n  Hint: Request timed out — the server may be overloaded` :
+                                     `\n  Hint: Check your network connection and that BADGR_API_URL is correct`;
+    throw new Error(`Cannot reach ${url} (${msg})${hint}`);
+  }
   if (!res.ok) {
-    const text = await res.text().catch(() => '');
-    throw new Error(`${method} ${path} → ${res.status}: ${text}`);
+    let detail = '';
+    try {
+      const text = await res.text();
+      // Try to extract a readable detail from JSON error bodies
+      const json = JSON.parse(text);
+      detail = json?.detail ?? json?.message ?? json?.error ?? text;
+    } catch {
+      detail = res.statusText || '';
+    }
+    const hint =
+      res.status === 401 ? '\n  Hint: Invalid or missing API key — run: badgr login' :
+      res.status === 403 ? '\n  Hint: Access denied — check your API key permissions' :
+      res.status === 404 ? `\n  Hint: Endpoint not found — check BADGR_API_URL (currently: ${baseUrl})` :
+      res.status === 502 || res.status === 503 ? '\n  Hint: Server error — no GPU capacity available or backend is down' :
+      '';
+    throw new Error(`${method} ${path} → HTTP ${res.status}: ${detail}${hint}`);
   }
   return res.json();
 }

package/src/commands/run.js

@@ -118,7 +118,9 @@ export async function runCommand(config, args, chalk) {
       },
     });
   } catch (err) {
-    console.error(chalk.red(`\n  ✗ Job failed to start: ${err.message}\n`));
+    console.error(chalk.red(`\n  ✗ Job failed to start: ${err.message}`));
+    console.error(chalk.dim(`\n  API URL: ${config.baseUrl}`));
+    console.error(chalk.dim(`  Config:  badgr config   Docs: badgr --help\n`));
     process.exit(1);
   }
 

package/src/commands/serve.js

@@ -86,7 +86,9 @@ export async function serveCommand(config, args, chalk) {
       },
     });
   } catch (err) {
-    console.error(chalk.red(`\n  ✗ Serve failed: ${err.message}\n`));
+    console.error(chalk.red(`\n  ✗ Serve failed: ${err.message}`));
+    console.error(chalk.dim(`\n  API URL: ${config.baseUrl}`));
+    console.error(chalk.dim(`  Config:  badgr config   Docs: badgr --help\n`));
     return;
   }