@fre4x/hn 1.0.51 → 1.0.54

package/dist/index.js

@@ -42026,6 +42026,14 @@ function applyPagination(items, params) {
   };
 }
 
+// ../packages/shared/dist/package.js
+import { createRequire as createJsonRequire } from "node:module";
+function getPackageVersion(moduleUrl) {
+  const require2 = createJsonRequire(moduleUrl);
+  const packageJson = require2("../package.json");
+  return packageJson.version ?? "0.0.0";
+}
+
 // src/api.ts
 import https2 from "node:https";
 
@@ -45806,6 +45814,46 @@ var {
   mergeConfig: mergeConfig2
 } = axios_default;
 
+// src/mock.ts
+function isMock() {
+  return process.env.MOCK === "true" || process.env.HN_MOCK === "true";
+}
+var MOCK_ITEM = {
+  id: 1001,
+  type: "story",
+  by: "fre4x",
+  time: 1712232e3,
+  title: "Mock HN Story",
+  url: "https://example.com/mock-hn-story",
+  score: 42,
+  descendants: 7,
+  kids: [1002, 1003],
+  text: "Mock story content for offline development."
+};
+var MOCK_USER = {
+  id: "fre4x",
+  created: 16e8,
+  karma: 1337,
+  about: "Mock Hacker News user for MCP development.",
+  submitted: [1001, 1002, 1003]
+};
+var MOCK_UPDATES = {
+  items: [1003, 1002, 1001],
+  profiles: ["fre4x", "b1te"]
+};
+var MOCK_FIXTURES = {
+  item: MOCK_ITEM,
+  user: MOCK_USER,
+  maxItem: 1003,
+  topStories: [1003, 1002, 1001],
+  newStories: [1003, 1002, 1001],
+  bestStories: [1001, 1003, 1002],
+  askStories: [2003, 2002, 2001],
+  showStories: [3003, 3002, 3001],
+  jobStories: [4003, 4002, 4001],
+  updates: MOCK_UPDATES
+};
+
 // src/api.ts
 var BASE_URL = "https://hacker-news.firebaseio.com/v0";
 var httpClient = axios_default.create({
@@ -45842,36 +45890,69 @@ var HNApiClient = class {
     return response.data;
   }
   async getItem(id) {
+    if (isMock()) {
+      return { ...MOCK_FIXTURES.item, id };
+    }
     const response = await httpClient.get(`/item/${id}.json`);
     return response.data;
   }
   async getUser(id) {
+    if (isMock()) {
+      return { ...MOCK_FIXTURES.user, id };
+    }
     const response = await httpClient.get(`/user/${id}.json`);
     return response.data;
   }
   async getMaxItem() {
+    if (isMock()) {
+      return MOCK_FIXTURES.maxItem;
+    }
     const response = await httpClient.get(`/maxitem.json`);
     return response.data;
   }
   async getTopStories() {
+    if (isMock()) {
+      return [...MOCK_FIXTURES.topStories];
+    }
     return this.fetchWithCache(`/topstories`);
   }
   async getNewStories() {
+    if (isMock()) {
+      return [...MOCK_FIXTURES.newStories];
+    }
     return this.fetchWithCache(`/newstories`);
   }
   async getBestStories() {
+    if (isMock()) {
+      return [...MOCK_FIXTURES.bestStories];
+    }
     return this.fetchWithCache(`/beststories`);
   }
   async getAskStories() {
+    if (isMock()) {
+      return [...MOCK_FIXTURES.askStories];
+    }
     return this.fetchWithCache(`/askstories`);
   }
   async getShowStories() {
+    if (isMock()) {
+      return [...MOCK_FIXTURES.showStories];
+    }
     return this.fetchWithCache(`/showstories`);
   }
   async getJobStories() {
+    if (isMock()) {
+      return [...MOCK_FIXTURES.jobStories];
+    }
     return this.fetchWithCache(`/jobstories`);
   }
   async getUpdates() {
+    if (isMock()) {
+      return {
+        items: [...MOCK_FIXTURES.updates.items],
+        profiles: [...MOCK_FIXTURES.updates.profiles]
+      };
+    }
     const response = await httpClient.get(`/updates.json`);
     return response.data;
   }
@@ -45887,22 +45968,28 @@ var CHARACTER_LIMIT = 12e3;
 
 // src/index.ts
 var api = new HNApiClient();
+var PACKAGE_VERSION = getPackageVersion(import.meta.url);
 var server = new McpServer({
   name: "hackernews-mcp-server",
-  version: "1.0.0"
+  version: PACKAGE_VERSION
 });
 function formatItemMarkdown(item) {
   if (!item) return "Item not found.";
   const lines = [];
   if (item.title) lines.push(`# ${item.title}
 `);
-  lines.push(formatFields([
-    ["By", item.by],
-    ["Time", item.time ? new Date(item.time * 1e3).toLocaleString() : void 0],
-    ["Score", item.score],
-    ["URL", item.url],
-    ["Comments", item.descendants]
-  ]));
+  lines.push(
+    formatFields([
+      ["By", item.by],
+      [
+        "Time",
+        item.time ? new Date(item.time * 1e3).toLocaleString() : void 0
+      ],
+      ["Score", item.score],
+      ["URL", item.url],
+      ["Comments", item.descendants]
+    ])
+  );
   if (item.text) lines.push(`
 ${item.text}`);
   if (item.kids && item.kids.length > 0) {
@@ -45918,18 +46005,17 @@ function handleLimit(content, format) {
 
 > [!NOTE]
 > Content truncated due to size limit. Use pagination (limit/offset) to fetch specific parts if applicable.`;
-  } else {
-    return JSON.stringify({
-      content: content.substring(0, CHARACTER_LIMIT),
-      truncated: true,
-      hint: "Content truncated due to size limit. Use limit/offset for lists."
-    });
   }
+  return JSON.stringify({
+    content: content.substring(0, CHARACTER_LIMIT),
+    truncated: true,
+    hint: "Content truncated due to size limit. Use limit/offset for lists."
+  });
 }
 var storySchema = paginationSchema.extend({
   response_format: external_exports3.enum(Object.values(ResponseFormat)).default("markdown" /* MARKDOWN */).describe("Output format (markdown or json)")
 });
-async function handleStories(ids, params) {
+async function handleHNStories(ids, params) {
   const paginated = applyPagination(ids, params);
   const result = {
     total: paginated.total,
@@ -45957,7 +46043,11 @@ async function handleStories(ids, params) {
 ` + formatListItems(
     paginated.items,
     (id, i) => `${i + 1 + paginated.offset}. [${id}](https://news.ycombinator.com/item?id=${id})`
-  ) + (paginated.hasMore ? formatPaginationFooter(paginated.offset, paginated.limit, paginated.total) : "");
+  ) + (paginated.hasMore ? formatPaginationFooter(
+    paginated.offset,
+    paginated.limit,
+    paginated.total
+  ) : "");
   return {
     content: [
       {
@@ -45967,6 +46057,45 @@ async function handleStories(ids, params) {
     ]
   };
 }
+async function handleHNGetTopStories(params) {
+  try {
+    return await handleHNStories(await api.getTopStories(), params);
+  } catch (error48) {
+    return createInternalError(error48);
+  }
+}
+async function handleHNGetItem(params) {
+  try {
+    const item = await api.getItem(params.id);
+    if (params.response_format === "json" /* JSON */) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: handleLimit(
+              JSON.stringify(item, null, 2),
+              "json" /* JSON */
+            )
+          }
+        ],
+        structuredContent: item
+      };
+    }
+    return {
+      content: [
+        {
+          type: "text",
+          text: handleLimit(
+            formatItemMarkdown(item),
+            "markdown" /* MARKDOWN */
+          )
+        }
+      ]
+    };
+  } catch (error48) {
+    return createInternalError(error48);
+  }
+}
 server.registerTool(
   "hn_get_top_stories",
   {
@@ -45979,13 +46108,8 @@ server.registerTool(
       openWorldHint: true
     }
   },
-  async (params) => {
-    try {
-      return await handleStories(await api.getTopStories(), params);
-    } catch (error48) {
-      return createInternalError(error48);
-    }
-  }
+  // @ts-expect-error
+  handleHNGetTopStories
 );
 server.registerTool(
   "hn_get_new_stories",
@@ -46001,7 +46125,10 @@ server.registerTool(
   },
   async (params) => {
     try {
-      return await handleStories(await api.getNewStories(), params);
+      return await handleHNStories(
+        await api.getNewStories(),
+        params
+      );
     } catch (error48) {
       return createInternalError(error48);
     }
@@ -46021,7 +46148,10 @@ server.registerTool(
   },
   async (params) => {
     try {
-      return await handleStories(await api.getBestStories(), params);
+      return await handleHNStories(
+        await api.getBestStories(),
+        params
+      );
     } catch (error48) {
       return createInternalError(error48);
     }
@@ -46041,7 +46171,10 @@ server.registerTool(
   },
   async (params) => {
     try {
-      return await handleStories(await api.getAskStories(), params);
+      return await handleHNStories(
+        await api.getAskStories(),
+        params
+      );
     } catch (error48) {
       return createInternalError(error48);
     }
@@ -46061,7 +46194,10 @@ server.registerTool(
   },
   async (params) => {
     try {
-      return await handleStories(await api.getShowStories(), params);
+      return await handleHNStories(
+        await api.getShowStories(),
+        params
+      );
     } catch (error48) {
       return createInternalError(error48);
     }
@@ -46081,7 +46217,10 @@ server.registerTool(
   },
   async (params) => {
     try {
-      return await handleStories(await api.getJobStories(), params);
+      return await handleHNStories(
+        await api.getJobStories(),
+        params
+      );
     } catch (error48) {
       return createInternalError(error48);
     }
@@ -46102,38 +46241,8 @@ server.registerTool(
       openWorldHint: true
     }
   },
-  async (params) => {
-    try {
-      const item = await api.getItem(params.id);
-      if (params.response_format === "json" /* JSON */) {
-        return {
-          content: [
-            {
-              type: "text",
-              text: handleLimit(
-                JSON.stringify(item, null, 2),
-                "json" /* JSON */
-              )
-            }
-          ],
-          structuredContent: item
-        };
-      }
-      return {
-        content: [
-          {
-            type: "text",
-            text: handleLimit(
-              formatItemMarkdown(item),
-              "markdown" /* MARKDOWN */
-            )
-          }
-        ]
-      };
-    } catch (error48) {
-      return createInternalError(error48);
-    }
-  }
+  // @ts-expect-error
+  handleHNGetItem
 );
 server.registerTool(
   "hn_get_user",
@@ -46242,15 +46351,23 @@ server.registerTool(
           structuredContent: result
         };
       }
-      let markdown = `# HN Recent Updates
-
-`;
-      markdown += `## Items
-` + formatListItems(paginatedItems.items, (id) => `- [${id}](https://news.ycombinator.com/item?id=${id})`) + (paginatedItems.hasMore ? formatPaginationFooter(paginatedItems.offset, paginatedItems.limit, paginatedItems.total) : "") + `
-
-`;
-      markdown += `## Profiles
-` + formatListItems(paginatedProfiles.items, (profile) => `- [${profile}](https://news.ycombinator.com/user?id=${profile})`) + (paginatedProfiles.hasMore ? formatPaginationFooter(paginatedProfiles.offset, paginatedProfiles.limit, paginatedProfiles.total) : "");
+      let markdown = "# HN Recent Updates\n\n";
+      markdown += "## Items\n" + formatListItems(
+        paginatedItems.items,
+        (id) => `- [${id}](https://news.ycombinator.com/item?id=${id})`
+      ) + (paginatedItems.hasMore ? formatPaginationFooter(
+        paginatedItems.offset,
+        paginatedItems.limit,
+        paginatedItems.total
+      ) : "") + "\n\n";
+      markdown += "## Profiles\n" + formatListItems(
+        paginatedProfiles.items,
+        (profile) => `- [${profile}](https://news.ycombinator.com/user?id=${profile})`
+      ) + (paginatedProfiles.hasMore ? formatPaginationFooter(
+        paginatedProfiles.offset,
+        paginatedProfiles.limit,
+        paginatedProfiles.total
+      ) : "");
       return {
         content: [
           {
@@ -46298,10 +46415,18 @@ async function run() {
   await server.connect(transport);
   console.error("Hacker News MCP server running via stdio");
 }
-run().catch((error48) => {
-  console.error("Fatal error:", error48);
-  process.exit(1);
-});
+if (process.env.NODE_ENV !== "test") {
+  run().catch((error48) => {
+    console.error("Fatal error:", error48);
+    process.exit(1);
+  });
+}
+export {
+  handleHNGetItem,
+  handleHNGetTopStories,
+  handleHNStories,
+  server
+};
 /*! Bundled license information:
 
 mime-db/index.js:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fre4x/hn",
-  "version": "1.0.51",
+  "version": "1.0.54",
   "description": "A Hacker News MCP server for LLMs.",
   "type": "module",
   "main": "dist/index.js",
@@ -11,7 +11,7 @@
     "dist"
   ],
   "scripts": {
-    "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && npx esbuild src/index.ts --bundle --outfile=dist/index.js --platform=node --format=esm --banner:js=\"import{createRequire}from'module';const require=createRequire(import.meta.url);\" && node -e \"const fs=require('fs');const p='dist/index.js';const c=fs.readFileSync(p,'utf8');const next=c.startsWith('#!/usr/bin/env node')?c:'#!/usr/bin/env node\\n'+c;fs.writeFileSync(p,next);fs.chmodSync(p,0o755);\"",
+    "build": "node ../scripts/build-package.mjs",
     "typecheck": "cross-env NODE_OPTIONS=--max-old-space-size=4096 tsc --noEmit",
     "start": "node dist/index.js",
     "dev": "tsx src/index.ts",
@@ -28,12 +28,12 @@
   "author": "fritzprix",
   "license": "MIT",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.26.0",
+    "@modelcontextprotocol/sdk": "^1.27.1",
     "axios": "^1.13.5",
-    "zod": "^4.0.0"
+    "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@types/node": "^25.3.0",
+    "@types/node": "^25.3.5",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"