From c888e2070f8906b17bacf83e0791c5a2f2c0b851 Mon Sep 17 00:00:00 2001
From: Neville Mehta <nmehta@Nevilles-MacBook-Pro.local>
Date: Thu, 11 Jul 2024 20:27:26 -0700
Subject: [PATCH] [feat/standalonenode-withmiddleware-doc] Add docs for passing
 middleware option to be used with standalone mode

---
 .../en/guides/integrations-guide/node.mdx     | 61 +++++++++++++++++++
 1 file changed, 61 insertions(+)

diff --git a/src/content/docs/en/guides/integrations-guide/node.mdx b/src/content/docs/en/guides/integrations-guide/node.mdx
index b0eb98f2037c6..ac796c47a8755 100644
--- a/src/content/docs/en/guides/integrations-guide/node.mdx
+++ b/src/content/docs/en/guides/integrations-guide/node.mdx
@@ -102,6 +102,67 @@ Controls whether the adapter builds to `middleware` or `standalone` mode.
 
 * `standalone` mode builds to server that automatically starts with the entry module is run. This allows you to more easily deploy your build to a host without any additional code.
 
+### Standalone Middleware
+
+Ability to pass middleware to be used `only with standalone mode`. Gives you the ability to use packages such as [http-proxy-middleware](https://www.npmjs.com/package/http-proxy-middleware) in standalone mode.
+
+* `standaloneMiddleware` specify the filename thats going to export the one (or many combined) middleware. These middleware will be added when starting standalone server.
+
+  ```js title="astro.config.mjs"
+  import { defineConfig } from 'astro/config';
+  import node from '@astrojs/node';
+
+  export default defineConfig({
+    output: 'server',
+    adapter: node({
+      mode: 'standalone',
+      standaloneMiddleware: `${import.meta.dirname}/src/node_middleware.js`,
+    }),
+  });
+  ```
+
+  ```js title="src/node_middleware.js"
+  const combineMiddleware = (...middlewares) => {
+    return (req, res, next) => {
+        let index = 0;
+        const run = (err) => {
+            if (err) {
+                return next(err);
+            }
+            if (index >= middlewares.length) {
+                return next();
+            }
+            const middleware = middlewares[index++];
+            try {
+                middleware(req, res, run);
+            } catch (error) {
+                next(error);
+            }
+        };
+
+        run();
+    };
+  };
+
+  const middleware_one = (req, res, next) => {
+      if (req.url === '/middleware-one') {
+          res.end('This is middleware one');
+      } else {
+          next();
+      }
+  };
+
+  const middleware_two = (req, res, next) => {
+      if (req.url === '/middleware-two') {
+          res.end('This is middleware two');
+      } else {
+          next();
+      }
+  };
+
+  export default combineMiddleware(middleware_one, middleware_two);
+  ```
+
 ## Usage
 
 First, [performing a build](/en/guides/deploy/#building-your-site-locally). Depending on which `mode` selected (see above) follow the appropriate steps below: