@fre4x/fred 1.0.42 → 1.0.45

package/dist/index.js

@@ -18436,6 +18436,30 @@ var require_follow_redirects = __commonJS({
 });
 
 // ../packages/shared/dist/errors.js
+function createApiError(message, statusCode) {
+  let hint = "Check your network connection and retry.";
+  if (statusCode === 429) {
+    hint = "Rate limit exceeded. Suggestion: Wait for 60 seconds (Exponential Backoff) before retrying or reduce concurrent calls.";
+  } else if (statusCode === 401 || statusCode === 403) {
+    hint = "Authentication failed. Suggestion: Verify your API key or token in the environment configuration.";
+  } else if (statusCode && statusCode >= 500) {
+    hint = "Upstream service is having issues. Suggestion: This is a temporary external error. Try again in a few minutes.";
+  } else if (statusCode === 404) {
+    hint = "The requested resource was not found. Suggestion: Check if the ID or Ticker is correct, or search for it first.";
+  }
+  const detail = statusCode ? ` (HTTP ${statusCode})` : "";
+  return {
+    isError: true,
+    content: [
+      {
+        type: "text",
+        text: `API Error${detail}: ${message}
+
+**Next Action**: ${hint}`
+      }
+    ]
+  };
+}
 function createNotFoundError(resource) {
   return {
     isError: true,
@@ -45951,6 +45975,7 @@ var MOCK_FIXTURES = {
     ]
   },
   getSeriesInfo: {
+    series_id: "GDP",
     realtime_start: "2023-01-01",
     realtime_end: "2023-01-01",
     seriess: [
@@ -45974,6 +45999,7 @@ var MOCK_FIXTURES = {
     ]
   },
   getSeriesObservations: {
+    series_id: "GDP",
     realtime_start: "2023-01-01",
     realtime_end: "2023-01-01",
     observation_start: "1947-01-01",
@@ -46002,6 +46028,7 @@ var MOCK_FIXTURES = {
     ]
   },
   getCategorySeries: {
+    category_id: 125,
     realtime_start: "2023-01-01",
     realtime_end: "2023-01-01",
     order_by: "popularity",
@@ -46048,6 +46075,7 @@ var MOCK_FIXTURES = {
     ]
   },
   getReleaseSeries: {
+    release_id: 53,
     realtime_start: "2023-01-01",
     realtime_end: "2023-01-01",
     order_by: "series_id",
@@ -46093,6 +46121,7 @@ var MOCK_FIXTURES = {
     ]
   },
   getSource: {
+    source_id: 1,
     realtime_start: "2023-01-01",
     realtime_end: "2023-01-01",
     sources: [
@@ -46119,6 +46148,46 @@ function getClient() {
   }
   return clientInstance;
 }
+function extractErrorMessage(err) {
+  if (typeof err !== "object" || err === null) {
+    return String(err);
+  }
+  const error48 = err;
+  const responseData = error48.response?.data;
+  if (typeof responseData === "string" && responseData.trim()) {
+    return responseData.trim();
+  }
+  if (responseData && typeof responseData === "object") {
+    const data = responseData;
+    const nestedMessage = data.error_message ?? data.message ?? data.error ?? data.detail;
+    if (nestedMessage !== void 0 && nestedMessage !== null) {
+      return String(nestedMessage);
+    }
+  }
+  if (error48.message !== void 0 && error48.message !== null) {
+    return String(error48.message);
+  }
+  return "Request failed.";
+}
+function handleFredError(err) {
+  if (typeof err === "object" && err !== null) {
+    const error48 = err;
+    const status = Number(
+      error48.response?.status ?? error48.status ?? error48.statusCode ?? 0
+    );
+    const message = extractErrorMessage(err);
+    if (status === 404) {
+      return createNotFoundError(message);
+    }
+    if (status === 429) {
+      return createApiError(`${message} Please try again later.`, 429);
+    }
+    if (status === 401 || status === 403 || status >= 500) {
+      return createApiError(message, status);
+    }
+  }
+  return createInternalError(err);
+}
 function formatSeriesList(seriess, total, offset) {
   if (!seriess || seriess.length === 0) return "No series found.";
   const rows = seriess.map(
@@ -46203,7 +46272,7 @@ server.registerTool(
       const text = formatSeriesList(res.seriess, res.count, offset);
       return { content: [{ type: "text", text: truncateToLimit(text) }] };
     } catch (err) {
-      return createInternalError(err);
+      return handleFredError(err);
     }
   }
 );
@@ -46225,6 +46294,11 @@ server.registerTool(
     try {
       if (IS_MOCK) {
         const res2 = MOCK_FIXTURES.getSeriesInfo;
+        if (res2.series_id !== series_id) {
+          return createNotFoundError(
+            `Series '${series_id}' not found.`
+          );
+        }
         const text2 = formatSeriesInfo(res2.seriess[0]);
         return { content: [{ type: "text", text: text2 }] };
       }
@@ -46236,7 +46310,7 @@ server.registerTool(
       const text = formatSeriesInfo(res.seriess[0]);
       return { content: [{ type: "text", text }] };
     } catch (err) {
-      return createInternalError(err);
+      return handleFredError(err);
     }
   }
 );
@@ -46259,6 +46333,11 @@ server.registerTool(
     try {
       if (IS_MOCK) {
         const res2 = MOCK_FIXTURES.getSeriesObservations;
+        if (res2.series_id !== series_id) {
+          return createNotFoundError(
+            `No data found for series '${series_id}'.`
+          );
+        }
         const text2 = formatObservations(
           res2.observations,
           res2.count,
@@ -46286,7 +46365,7 @@ server.registerTool(
       );
       return { content: [{ type: "text", text: truncateToLimit(text) }] };
     } catch (err) {
-      return createInternalError(err);
+      return handleFredError(err);
     }
   }
 );
@@ -46309,6 +46388,11 @@ server.registerTool(
     try {
       if (IS_MOCK) {
         const res2 = MOCK_FIXTURES.getCategorySeries;
+        if (res2.category_id !== category_id) {
+          return createNotFoundError(
+            `Category '${category_id}' not found.`
+          );
+        }
         const text2 = formatSeriesList(res2.seriess, res2.count, offset);
         return {
           content: [{ type: "text", text: truncateToLimit(text2) }]
@@ -46323,7 +46407,7 @@ server.registerTool(
       const text = formatSeriesList(res.seriess, res.count, offset);
       return { content: [{ type: "text", text: truncateToLimit(text) }] };
     } catch (err) {
-      return createInternalError(err);
+      return handleFredError(err);
     }
   }
 );
@@ -46353,7 +46437,7 @@ server.registerTool(
       const text = formatReleases(res.releases, res.count);
       return { content: [{ type: "text", text: truncateToLimit(text) }] };
     } catch (err) {
-      return createInternalError(err);
+      return handleFredError(err);
     }
   }
 );
@@ -46376,6 +46460,11 @@ server.registerTool(
     try {
       if (IS_MOCK) {
         const res2 = MOCK_FIXTURES.getReleaseSeries;
+        if (res2.release_id !== release_id) {
+          return createNotFoundError(
+            `Release '${release_id}' not found.`
+          );
+        }
         const text2 = formatSeriesList(res2.seriess, res2.count, offset);
         return {
           content: [{ type: "text", text: truncateToLimit(text2) }]
@@ -46390,7 +46479,7 @@ server.registerTool(
       const text = formatSeriesList(res.seriess, res.count, offset);
       return { content: [{ type: "text", text: truncateToLimit(text) }] };
     } catch (err) {
-      return createInternalError(err);
+      return handleFredError(err);
     }
   }
 );
@@ -46437,7 +46526,7 @@ server.registerTool(
       );
       return { content: [{ type: "text", text: truncateToLimit(text) }] };
     } catch (err) {
-      return createInternalError(err);
+      return handleFredError(err);
     }
   }
 );
@@ -46459,6 +46548,11 @@ server.registerTool(
     try {
       if (IS_MOCK) {
         const res2 = MOCK_FIXTURES.getSource;
+        if (res2.source_id !== source_id) {
+          return createNotFoundError(
+            `Source '${source_id}' not found.`
+          );
+        }
         const s2 = res2.sources[0];
         const text2 = [
           `## Source: ${s2.name} (ID: ${s2.id})`,
@@ -46482,7 +46576,7 @@ server.registerTool(
       ].filter(Boolean).join("\n");
       return { content: [{ type: "text", text }] };
     } catch (err) {
-      return createInternalError(err);
+      return handleFredError(err);
     }
   }
 );
@@ -46490,10 +46584,16 @@ async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
 }
-main().catch((err) => {
-  console.error("Fatal error:", err);
-  process.exit(1);
-});
+if (process.env.NODE_ENV !== "test") {
+  main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+  });
+}
+export {
+  handleFredError,
+  server
+};
 /*! Bundled license information:
 
 mime-db/index.js:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fre4x/fred",
-  "version": "1.0.42",
+  "version": "1.0.45",
   "description": "A FRED economic data MCP server for LLMs.",
   "type": "module",
   "main": "dist/index.js",
@@ -16,6 +16,7 @@
     "start": "node dist/index.js",
     "dev": "tsx src/index.ts",
     "watch": "tsc -w",
+    "inspector": "cross-env MOCK=true npx @modelcontextprotocol/inspector node dist/index.js",
     "test": "vitest run --passWithNoTests --exclude dist"
   },
   "keywords": [