skilldb 0.6.0 → 0.7.0

package/dist/cli.js

@@ -72,8 +72,26 @@ var SkillDBClient = class {
     }
     const res = await fetch(url.toString(), { headers: this.headers() });
     if (!res.ok) {
-      const body = await res.json().catch(() => ({}));
-      const msg = body.error || `HTTP ${res.status}`;
+      const body = await res.json().catch(() => null);
+      const apiError = body && typeof body === "object" ? body.error : null;
+      const status = res.status;
+      const statusText = res.statusText || "Unknown";
+      let msg;
+      if (apiError) {
+        msg = apiError;
+      } else if (status === 500) {
+        msg = `SkillDB API internal error (HTTP 500). The service may be experiencing issues. Check status at https://skilldb.dev/api/v1/status`;
+      } else if (status === 503) {
+        msg = `SkillDB API unavailable (HTTP 503). The skills index may not be loaded. Check status at https://skilldb.dev/api/v1/status`;
+      } else if (status === 401) {
+        msg = `Invalid or expired API key (HTTP 401). Get a free key at https://skilldb.dev/api-access`;
+      } else if (status === 429) {
+        msg = `Rate limit exceeded (HTTP 429). Authenticate with an API key for higher limits: https://skilldb.dev/api-access`;
+      } else if (status === 404) {
+        msg = `Resource not found (HTTP 404). The requested skill or endpoint does not exist.`;
+      } else {
+        msg = `SkillDB API error: HTTP ${status} ${statusText}. Check https://skilldb.dev/api/v1/status for service health.`;
+      }
       throw new Error(msg);
     }
     return res.json();