@openluxeco/cli 0.5.0 → 0.5.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openluxeco/cli",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Official OpenLuxe command-line client — drive the OpenLuxe v1 API from your terminal or an AI agent.",
   "type": "module",
   "bin": {

package/src/api.js

@@ -8,6 +8,28 @@ export class ApiError extends Error {
     }
 }
 
+/**
+ * Node's fetch buries the real failure (TLS, DNS, refused) in `error.cause` and
+ * reports only "fetch failed" — surface the cause plus an actionable hint.
+ */
+function networkErrorMessage(e, url) {
+    const cause = e.cause || {};
+    const code = cause.code || '';
+    const causeMsg = cause.message || '';
+    let origin = '';
+    try { origin = ' (' + new URL(url).origin + ')'; } catch { /* keep plain */ }
+
+    let msg = `Network error: ${causeMsg || e.message}${origin}`;
+    if (/CERT|certificate|SSL|TLS/i.test(code + ' ' + causeMsg)) {
+        msg += '\n  Untrusted/self-signed certificate — for a local dev server, retry with OPENLUXE_INSECURE=1';
+    } else if (code === 'ENOTFOUND' || code === 'EAI_AGAIN') {
+        msg += '\n  Host not found — check the API base (OPENLUXE_API_URL, or `openluxe auth status` for the stored base)';
+    } else if (code === 'ECONNREFUSED') {
+        msg += '\n  Connection refused — is the server running at that base URL?';
+    }
+    return msg;
+}
+
 /**
  * Perform an authenticated v1 API request. `path` is everything after
  * /api/v1 (e.g. "/contacts"). `query` is an object, `body` is JSON-able.
@@ -36,7 +58,7 @@ export async function request(method, path, { query, body, token, base } = {}) {
     try {
         res = await fetch(url, init);
     } catch (e) {
-        throw new ApiError(0, `Network error: ${e.message}`);
+        throw new ApiError(0, networkErrorMessage(e, url));
     }
 
     const text = await res.text();
@@ -55,11 +77,16 @@ export async function request(method, path, { query, body, token, base } = {}) {
 /** Unauthenticated POST used only by the device-auth handshake. */
 export async function postPublic(base, path, body) {
     const url = base.replace(/\/$/, '') + '/api/v1' + path;
-    const res = await fetch(url, {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
-        body: JSON.stringify(body || {}),
-    });
+    let res;
+    try {
+        res = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
+            body: JSON.stringify(body || {}),
+        });
+    } catch (e) {
+        throw new ApiError(0, networkErrorMessage(e, url));
+    }
     const text = await res.text();
     let parsed;
     try { parsed = text ? JSON.parse(text) : null; } catch { parsed = text; }

package/src/cli.js

@@ -187,7 +187,7 @@ async function callApi(method, path, { positionals = [], flags = {}, body }) {
                 printInsufficientCredits(e.body || {});
                 process.exit(1);
             }
-            console.error(C.red(`✗ ${e.status} ${e.message}`));
+            console.error(C.red('✗ ' + (e.status ? e.status + ' ' : '') + e.message));
             if (e.body && typeof e.body === 'object') console.error(C.dim(JSON.stringify(e.body, null, 2)));
             if (e.status === 401) console.error(C.dim('  Run: openluxe auth login'));
             process.exit(1);