@vercel/microfrontends 2.3.3 → 2.3.5

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @vercel/microfrontends
 
+## 2.3.5
+
+### Patch Changes
+
+- 5fbc4e3: Preserve absolute URLs in query parameters when the local proxy normalizes request URLs and rewrites redirect Location headers.
+- 9a01e16: Route Vercel Toolbar well-known requests through the local proxy to the locally running application that served the page. This supports `@vercel/toolbar@0.2.6+`, which uses `/.well-known/vercel-toolbar/*` for local dev server access.
+
+## 2.3.4
+
+### Patch Changes
+
+- 7af3542: Prevent local proxy crashes when upstream errors occur after response headers have already been sent.
+
 ## 2.3.3
 
 ### Patch Changes

package/dist/bin/cli.cjs

@@ -30,7 +30,7 @@ var import_commander = require("commander");
 // package.json
 var package_default = {
   name: "@vercel/microfrontends",
-  version: "2.3.3",
+  version: "2.3.5",
   private: false,
   description: "Defines configuration and utilities for microfrontends development",
   keywords: [
@@ -2370,6 +2370,20 @@ var localAuthHtml = ({
 var MFE_LOCAL_PROXY_HEADER = "x-vercel-mfe-local-proxy-origin";
 var MFE_FLAG_VALUE = "vercel-mfe-flag-value";
 var MFE_FLAG_VALUE_HEADER = `x-${MFE_FLAG_VALUE}`;
+var VERCEL_TOOLBAR_PROXY_BASE_PATH = "/.well-known/vercel-toolbar";
+function normalizeRepeatedSlashesInPath(url) {
+  const searchStart = url.indexOf("?");
+  const path7 = searchStart === -1 ? url : url.slice(0, searchStart);
+  const search = searchStart === -1 ? "" : url.slice(searchStart);
+  return `${path7.replaceAll(/\/[\\/]+/g, "/")}${search}`;
+}
+function rewriteRedirectLocation(locationHeader, localhost) {
+  const redirectUrl = new import_node_url.URL(locationHeader, localhost);
+  const localUrl = new import_node_url.URL(localhost);
+  redirectUrl.protocol = localUrl.protocol;
+  redirectUrl.host = localUrl.host;
+  return redirectUrl.toString();
+}
 var ProxyRequestRouter = class {
   constructor(config, {
     localApps
@@ -2494,6 +2508,15 @@ var ProxyRequestRouter = class {
     middlewareMfeZone = void 0,
     mfeFlagValue = void 0
   }) {
+    const toolbarTarget = this.checkVercelToolbar({
+      path: path7,
+      url,
+      referer,
+      applications
+    });
+    if (toolbarTarget) {
+      return toolbarTarget;
+    }
     for (const application of Object.values(applications)) {
       const target = this.getApplicationTarget(application);
       if (middlewareMfeZone) {
@@ -2606,6 +2629,46 @@ var ProxyRequestRouter = class {
       path: `${url.pathname}${url.search}`
     };
   }
+  checkVercelToolbar({
+    path: path7,
+    url,
+    referer = void 0,
+    applications
+  }) {
+    const isVercelToolbarRequest = url.pathname === VERCEL_TOOLBAR_PROXY_BASE_PATH || url.pathname.startsWith(`${VERCEL_TOOLBAR_PROXY_BASE_PATH}/`);
+    if (!isVercelToolbarRequest) {
+      return null;
+    }
+    if (referer) {
+      const refererURL = new import_node_url.URL(referer);
+      const refererTarget = this.findMatchingApplication({
+        path: `${refererURL.pathname}${refererURL.search}`,
+        url: refererURL,
+        applications
+      }) ?? this.getDefaultHost(this.config);
+      if (refererTarget.isLocal) {
+        logger.debug(
+          ` ${path7} - Routing Vercel Toolbar request to referring application: ${formatProxyTarget(refererTarget)}`
+        );
+        return {
+          ...refererTarget,
+          path: `${url.pathname}${url.search}`
+        };
+      }
+    }
+    const localApp = this.getSingleLocalApp();
+    if (!localApp) {
+      return null;
+    }
+    const target = this.getApplicationTarget(localApp);
+    logger.debug(
+      ` ${path7} - Routing Vercel Toolbar request to only locally running application: ${formatProxyTarget(target)}`
+    );
+    return {
+      ...target,
+      path: `${url.pathname}${url.search}`
+    };
+  }
   checkNextSourceMap({ url }) {
     const isSourceMap = (0, import_path_to_regexp3.pathToRegexp)("/__nextjs_source-map").test(url.pathname);
     if (!isSourceMap) {
@@ -2662,20 +2725,26 @@ var ProxyRequestRouter = class {
   }
   isDefaultAppLocal() {
     const defaultApp = this.config.getDefaultApplication();
-    return Boolean(
-      this.localApps.find(
-        (name) => name === defaultApp.name || name === defaultApp.packageName
-      )
-    );
+    return this.isApplicationLocal(defaultApp);
   }
   getArbitraryLocalApp() {
     for (const application of this.config.getAllApplications()) {
-      const name = application.name;
-      if (this.localApps.includes(name)) {
+      if (this.isApplicationLocal(application)) {
         return application;
       }
     }
   }
+  getSingleLocalApp() {
+    const localApplications = this.config.getAllApplications().filter((application) => this.isApplicationLocal(application));
+    return localApplications.length === 1 ? localApplications[0] : void 0;
+  }
+  isApplicationLocal(application) {
+    return Boolean(
+      this.localApps.find(
+        (name) => name === application.name || name === application.packageName
+      )
+    );
+  }
 };
 var LocalProxy = class {
   constructor(config, {
@@ -2689,6 +2758,12 @@ var LocalProxy = class {
     this.proxy = import_http_proxy.default.createProxyServer({ secure: true });
     this.proxy.on("error", (err, req, res) => {
       if (res instanceof http.ServerResponse) {
+        if (res.destroyed || res.writableEnded)
+          return;
+        if (res.headersSent) {
+          res.destroy(err);
+          return;
+        }
         res.writeHead(500, {
           "Content-Type": "text/plain"
         });
@@ -2772,7 +2847,7 @@ var LocalProxy = class {
     if (req.url?.includes("//")) {
       const originalUrl = req.url;
       if (originalUrl) {
-        const normalizedUrl = originalUrl.replaceAll(/\/[\\/]+/g, "/");
+        const normalizedUrl = normalizeRepeatedSlashesInPath(originalUrl);
         if (normalizedUrl !== originalUrl) {
           res.writeHead(307, {
             Location: normalizedUrl,
@@ -2845,11 +2920,10 @@ var LocalProxy = class {
         if (realRes.statusCode === 307 || realRes.statusCode === 308 || realRes.statusCode === 302 || realRes.statusCode === 301) {
           const locationHeader = realRes.headers.location;
           if (locationHeader) {
-            const redirectUrl = new import_node_url.URL(
-              locationHeader.replace(/https:\/\/[^/]+\//, "/"),
+            realRes.headers.location = rewriteRedirectLocation(
+              locationHeader,
               localhost
             );
-            realRes.headers.location = redirectUrl.toString();
           }
         }
         res.writeHead(realRes.statusCode || 200, realRes.headers);
@@ -2858,6 +2932,12 @@ var LocalProxy = class {
       req.pipe(proxyReq);
       proxyReq.on("error", (err) => {
         logger.error("Proxy request error: ", err);
+        if (res.destroyed || res.writableEnded)
+          return;
+        if (res.headersSent) {
+          res.destroy(err);
+          return;
+        }
         res.writeHead(500, { "Content-Type": "text/plain" });
         res.end(
           `Error proxying request for ${target.application} to ${hostname}:${port}${path7}`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/microfrontends",
-  "version": "2.3.3",
+  "version": "2.3.5",
   "private": false,
   "description": "Defines configuration and utilities for microfrontends development",
   "keywords": [