@arabold/docs-mcp-server 2.0.0 → 2.0.2

package/README.md

@@ -20,7 +20,7 @@ The open-source alternative to **Context7**, **Nia**, and **Ref.Tools**.
 
 ## 🚀 Quick Start
 
-**1. Start the server** (requires Node.js 24+):
+**1. Start the server** (requires Node.js 22+):
 
 ```bash
 npx @arabold/docs-mcp-server@latest

package/dist/index.js

@@ -4407,9 +4407,11 @@ class DocumentPipeline extends BasePipeline {
         chunks: []
       };
     }
-    const extension = this.extractExtension(rawContent.source);
+    const extension = this.extractExtension(rawContent.source, rawContent.mimeType);
     if (!extension) {
-      logger.warn(`Could not determine file extension: ${rawContent.source}`);
+      logger.warn(
+        `Could not determine file extension for ${rawContent.source} (MIME type: ${rawContent.mimeType})`
+      );
       return {
         title: null,
         contentType: rawContent.mimeType,
@@ -4464,7 +4466,16 @@ class DocumentPipeline extends BasePipeline {
       };
     }
   }
-  extractExtension(source) {
+  /**
+   * Extracts file extension, trying multiple strategies:
+   * 1. Use MIME type from rawContent (most reliable, from Content-Type header)
+   * 2. Parse extension from URL/path
+   */
+  extractExtension(source, mimeType) {
+    const extensionFromMime = this.getExtensionFromMimeType(mimeType);
+    if (extensionFromMime) {
+      return extensionFromMime;
+    }
     try {
       const url = new URL(source);
       return this.getExtensionFromPath(url.pathname);
@@ -4472,9 +4483,23 @@ class DocumentPipeline extends BasePipeline {
       return this.getExtensionFromPath(source);
     }
   }
+  /**
+   * Gets file extension from MIME type using the mime package.
+   */
+  getExtensionFromMimeType(mimeType) {
+    if (!mimeType || mimeType === "application/octet-stream") {
+      return null;
+    }
+    return mime.getExtension(mimeType);
+  }
+  /**
+   * Parses file extension from URL path or file path.
+   * Strips query parameters and hash fragments, then extracts extension from the last path segment (filename).
+   */
   getExtensionFromPath(pathStr) {
-    const lastSlash = pathStr.lastIndexOf("/");
-    const filename = lastSlash >= 0 ? pathStr.substring(lastSlash + 1) : pathStr;
+    const cleanPath = pathStr.split("?")[0].split("#")[0];
+    const lastSlash = cleanPath.lastIndexOf("/");
+    const filename = lastSlash >= 0 ? cleanPath.substring(lastSlash + 1) : cleanPath;
     const lastDot = filename.lastIndexOf(".");
     if (lastDot > 0) {
       return filename.substring(lastDot + 1).toLowerCase();
@@ -12013,7 +12038,7 @@ const Layout = ({
   children,
   eventClientConfig
 }) => {
-  const versionString = version || "2.0.0";
+  const versionString = version || "2.0.2";
   const versionInitializer = `versionUpdate({ currentVersion: ${`'${versionString}'`} })`;
   return /* @__PURE__ */ jsxs("html", { lang: "en", children: [
     /* @__PURE__ */ jsxs("head", { children: [
@@ -14363,7 +14388,7 @@ class AppServer {
       try {
         if (telemetry.isEnabled()) {
           telemetry.setGlobalContext({
-            appVersion: "2.0.0",
+            appVersion: "2.0.2",
             appPlatform: process.platform,
             appNodeVersion: process.version,
             appServicesEnabled: this.getActiveServicesList(),
@@ -18616,7 +18641,7 @@ function createCli(argv) {
   let globalEventBus = null;
   let globalTelemetryService = null;
   const commandStartTimes = /* @__PURE__ */ new Map();
-  const cli = yargs(hideBin(argv)).scriptName("docs-mcp-server").strict().usage("Usage: $0 <command> [options]").version("2.0.0").option("verbose", {
+  const cli = yargs(hideBin(argv)).scriptName("docs-mcp-server").strict().usage("Usage: $0 <command> [options]").version("2.0.2").option("verbose", {
     type: "boolean",
     description: "Enable verbose (debug) logging",
     default: false
@@ -18676,7 +18701,7 @@ function createCli(argv) {
     if (shouldEnableTelemetry() && telemetry.isEnabled()) {
       const commandName = argv2._[0]?.toString() || "default";
       telemetry.setGlobalContext({
-        appVersion: "2.0.0",
+        appVersion: "2.0.2",
         appPlatform: process.platform,
         appNodeVersion: process.version,
         appInterface: "cli",