skilldb 0.5.2 → 0.7.0

package/dist/cli.js

@@ -57,7 +57,13 @@ var SkillDBClient = class {
     }
     return h;
   }
-  async request(endpoint, params) {
+  /** Make an authenticated request to any endpoint (used by MCP tools for private skills). */
+  async rawRequest(endpoint, init) {
+    const url = `${this.baseUrl}${endpoint}`;
+    const headers = { ...this.headers(), ...init?.headers || {} };
+    return fetch(url, { ...init, headers });
+  }
+  async typedRequest(endpoint, params) {
     const url = new URL(`${this.baseUrl}${endpoint}`);
     if (params) {
       for (const [k, v] of Object.entries(params)) {
@@ -66,15 +72,33 @@ 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();
   }
   /** Search skills by keyword. */
   async search(query, options) {
-    return this.request("/skills", {
+    return this.typedRequest("/skills", {
       search: query,
       category: options?.category ?? "",
       pack: options?.pack ?? "",
@@ -86,7 +110,7 @@ var SkillDBClient = class {
   }
   /** List skills with optional filters and sorting. */
   async list(options) {
-    return this.request("/skills", {
+    return this.typedRequest("/skills", {
       category: options?.category ?? "",
       pack: options?.pack ?? "",
       search: options?.search ?? "",
@@ -99,21 +123,21 @@ var SkillDBClient = class {
   /** Get a single skill by ID (e.g. "software-skills/code-review.md"). */
   async get(id) {
     const encoded = encodeURIComponent(id);
-    const res = await this.request(`/skills/${encoded}`, {
+    const res = await this.typedRequest(`/skills/${encoded}`, {
       include_content: "true"
     });
     return "skill" in res ? res.skill : res;
   }
   /** Batch retrieve multiple skills by IDs (max 50). */
   async batch(ids) {
-    return this.request("/skills", {
+    return this.typedRequest("/skills", {
       ids: ids.slice(0, 50).join(","),
       include_content: "true"
     });
   }
   /** Get search autocomplete suggestions. */
   async suggest(query) {
-    return this.request("/skills/suggest", { q: query });
+    return this.typedRequest("/skills/suggest", { q: query });
   }
   /** Validate that the configured API key works. */
   async validate() {
@@ -1922,7 +1946,7 @@ async function purgeCommand(options) {
     }
     stats.activeKept = 0;
   }
-  writeManifest(cwd, manifest);
+  writeManifest(manifest, cwd);
   console.log(pc18.green(`
   \u2713 Purge complete`));
   console.log(`    Skills removed:  ${stats.skillsRemoved}`);