@arabold/docs-mcp-server 2.0.2 → 2.0.4

package/dist/index.js

@@ -5243,6 +5243,16 @@ class HtmlPlaywrightMiddleware {
    * @param credentials Optional credentials for same-origin requests
    * @param origin The origin for same-origin credential checking
    */
+  /**
+   * Checks if an error is a Playwright "Route is already handled" error.
+   * This specific error occurs when multiple handlers attempt to handle the same route.
+   */
+  isRouteAlreadyHandledError(error) {
+    if (error instanceof Error) {
+      return error.message.includes("Route is already handled");
+    }
+    return false;
+  }
   async setupCachingRouteInterception(page, customHeaders = {}, credentials, origin) {
     await page.route("**/*", async (route) => {
       const reqUrl = route.request().url();
@@ -5255,17 +5265,33 @@ class HtmlPlaywrightMiddleware {
       })();
       const resourceType = route.request().resourceType();
       if (["image", "font", "media"].includes(resourceType)) {
-        return route.abort();
+        try {
+          return await route.abort();
+        } catch (error) {
+          if (this.isRouteAlreadyHandledError(error)) {
+            logger.debug(`Route already handled (abort): ${reqUrl}`);
+            return;
+          }
+          throw error;
+        }
       }
       if (route.request().method() === "GET") {
         const cached = HtmlPlaywrightMiddleware.resourceCache.get(reqUrl);
         if (cached !== void 0) {
           logger.debug(`✓ Cache hit for ${resourceType}: ${reqUrl}`);
-          return route.fulfill({
-            status: 200,
-            contentType: cached.contentType,
-            body: cached.body
-          });
+          try {
+            return await route.fulfill({
+              status: 200,
+              contentType: cached.contentType,
+              body: cached.body
+            });
+          } catch (error) {
+            if (this.isRouteAlreadyHandledError(error)) {
+              logger.debug(`Route already handled (fulfill cached): ${reqUrl}`);
+              return;
+            }
+            throw error;
+          }
         }
         const headers2 = mergePlaywrightHeaders(
           route.request().headers(),
@@ -5291,13 +5317,29 @@ class HtmlPlaywrightMiddleware {
               );
             }
           }
-          return route.fulfill({ response });
+          try {
+            return await route.fulfill({ response });
+          } catch (error) {
+            if (this.isRouteAlreadyHandledError(error)) {
+              logger.debug(`Route already handled (fulfill): ${reqUrl}`);
+              return;
+            }
+            throw error;
+          }
         } catch (error) {
           const errorMessage = error instanceof Error ? error.message : String(error);
           logger.debug(
             `Network error fetching ${resourceType} ${reqUrl}: ${errorMessage}`
           );
-          return route.abort("failed");
+          try {
+            return await route.abort("failed");
+          } catch (abortError) {
+            if (this.isRouteAlreadyHandledError(abortError)) {
+              logger.debug(`Route already handled (abort after error): ${reqUrl}`);
+              return;
+            }
+            throw abortError;
+          }
         }
       }
       const headers = mergePlaywrightHeaders(
@@ -5310,9 +5352,21 @@ class HtmlPlaywrightMiddleware {
       try {
         return await route.continue({ headers });
       } catch (error) {
+        if (this.isRouteAlreadyHandledError(error)) {
+          logger.debug(`Route already handled (continue): ${reqUrl}`);
+          return;
+        }
         const errorMessage = error instanceof Error ? error.message : String(error);
-        logger.debug(`Network error for ${resourceType} ${reqUrl}: ${errorMessage}`);
-        return route.abort("failed");
+        logger.debug(`Error continuing ${resourceType} ${reqUrl}: ${errorMessage}`);
+        try {
+          return await route.abort("failed");
+        } catch (abortError) {
+          if (this.isRouteAlreadyHandledError(abortError)) {
+            logger.debug(`Route already handled (abort after continue error): ${reqUrl}`);
+            return;
+          }
+          throw abortError;
+        }
       }
     });
   }
@@ -5465,11 +5519,19 @@ ${frame.content}
       await page.route("**/*", async (route) => {
         const reqUrl = route.request().url();
         if (reqUrl === context.source) {
-          return route.fulfill({
-            status: 200,
-            contentType: "text/html; charset=utf-8",
-            body: context.content
-          });
+          try {
+            return await route.fulfill({
+              status: 200,
+              contentType: "text/html; charset=utf-8",
+              body: context.content
+            });
+          } catch (error) {
+            if (this.isRouteAlreadyHandledError(error)) {
+              logger.debug(`Route already handled (initial page): ${reqUrl}`);
+              return;
+            }
+            throw error;
+          }
         }
         const reqOrigin = (() => {
           try {
@@ -5480,17 +5542,33 @@ ${frame.content}
         })();
         const resourceType = route.request().resourceType();
         if (["image", "font", "media"].includes(resourceType)) {
-          return route.abort();
+          try {
+            return await route.abort();
+          } catch (error) {
+            if (this.isRouteAlreadyHandledError(error)) {
+              logger.debug(`Route already handled (abort): ${reqUrl}`);
+              return;
+            }
+            throw error;
+          }
         }
         if (route.request().method() === "GET") {
           const cached = HtmlPlaywrightMiddleware.resourceCache.get(reqUrl);
           if (cached !== void 0) {
             logger.debug(`✓ Cache hit for ${resourceType}: ${reqUrl}`);
-            return route.fulfill({
-              status: 200,
-              contentType: cached.contentType,
-              body: cached.body
-            });
+            try {
+              return await route.fulfill({
+                status: 200,
+                contentType: cached.contentType,
+                body: cached.body
+              });
+            } catch (error) {
+              if (this.isRouteAlreadyHandledError(error)) {
+                logger.debug(`Route already handled (fulfill cached): ${reqUrl}`);
+                return;
+              }
+              throw error;
+            }
           }
           const headers2 = mergePlaywrightHeaders(
             route.request().headers(),
@@ -5517,13 +5595,29 @@ ${frame.content}
                 );
               }
             }
-            return route.fulfill({ response });
+            try {
+              return await route.fulfill({ response });
+            } catch (error) {
+              if (this.isRouteAlreadyHandledError(error)) {
+                logger.debug(`Route already handled (fulfill): ${reqUrl}`);
+                return;
+              }
+              throw error;
+            }
           } catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
             logger.debug(
               `Network error fetching ${resourceType} ${reqUrl}: ${errorMessage}`
             );
-            return route.abort("failed");
+            try {
+              return await route.abort("failed");
+            } catch (abortError) {
+              if (this.isRouteAlreadyHandledError(abortError)) {
+                logger.debug(`Route already handled (abort after error): ${reqUrl}`);
+                return;
+              }
+              throw abortError;
+            }
           }
         }
         const headers = mergePlaywrightHeaders(
@@ -5536,9 +5630,23 @@ ${frame.content}
         try {
           return await route.continue({ headers });
         } catch (error) {
+          if (this.isRouteAlreadyHandledError(error)) {
+            logger.debug(`Route already handled (continue): ${reqUrl}`);
+            return;
+          }
           const errorMessage = error instanceof Error ? error.message : String(error);
-          logger.debug(`Network error for ${resourceType} ${reqUrl}: ${errorMessage}`);
-          return route.abort("failed");
+          logger.debug(`Error continuing ${resourceType} ${reqUrl}: ${errorMessage}`);
+          try {
+            return await route.abort("failed");
+          } catch (abortError) {
+            if (this.isRouteAlreadyHandledError(abortError)) {
+              logger.debug(
+                `Route already handled (abort after continue error): ${reqUrl}`
+              );
+              return;
+            }
+            throw abortError;
+          }
         }
       });
       await page.goto(context.source, { waitUntil: "load" });
@@ -12038,7 +12146,7 @@ const Layout = ({
   children,
   eventClientConfig
 }) => {
-  const versionString = version || "2.0.2";
+  const versionString = version || "2.0.4";
   const versionInitializer = `versionUpdate({ currentVersion: ${`'${versionString}'`} })`;
   return /* @__PURE__ */ jsxs("html", { lang: "en", children: [
     /* @__PURE__ */ jsxs("head", { children: [
@@ -14388,7 +14496,7 @@ class AppServer {
       try {
         if (telemetry.isEnabled()) {
           telemetry.setGlobalContext({
-            appVersion: "2.0.2",
+            appVersion: "2.0.4",
             appPlatform: process.platform,
             appNodeVersion: process.version,
             appServicesEnabled: this.getActiveServicesList(),
@@ -18641,7 +18749,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.2").option("verbose", {
+  const cli = yargs(hideBin(argv)).scriptName("docs-mcp-server").strict().usage("Usage: $0 <command> [options]").version("2.0.4").option("verbose", {
     type: "boolean",
     description: "Enable verbose (debug) logging",
     default: false
@@ -18701,7 +18809,7 @@ function createCli(argv) {
     if (shouldEnableTelemetry() && telemetry.isEnabled()) {
       const commandName = argv2._[0]?.toString() || "default";
       telemetry.setGlobalContext({
-        appVersion: "2.0.2",
+        appVersion: "2.0.4",
         appPlatform: process.platform,
         appNodeVersion: process.version,
         appInterface: "cli",