refactor(dts-plugin): replace Koa dev server with native HTTP (#4419)

ScriptedAlchemy · cursoragent · web-flow · commit 623571176ef7 · 2026-02-12T12:50:41.000-08:00
Co-authored-by: Cursor Agent &lt;cursoragent@cursor.com&gt;
Co-authored-by: Zack Jackson &lt;ScriptedAlchemy@users.noreply.github.com&gt;
diff --git a/.changeset/bright-squids-float.md b/.changeset/bright-squids-float.md
@@ -0,0 +1,5 @@
+---
+'@module-federation/dts-plugin': patch
+---
+
+Replace the Koa-based dev types server with a native Node HTTP server to reduce dependencies and keep type generation behavior unchanged.
diff --git a/apps/metro-example-host/android/settings.gradle b/apps/metro-example-host/android/settings.gradle
@@ -1,6 +1,6 @@
-pluginManagement { includeBuild("../../../node_modules/@react-native/gradle-plugin") }
+pluginManagement { includeBuild("../node_modules/@react-native/gradle-plugin") }
 plugins { id("com.facebook.react.settings") }
 extensions.configure(com.facebook.react.ReactSettingsExtension){ ex -> ex.autolinkLibrariesFromCommand(['npx', 'rnef', 'config', '-p', 'android']) }
 rootProject.name = "MFExampleHost"
 include ':app'
-includeBuild('../../../node_modules/@react-native/gradle-plugin')
+includeBuild('../node_modules/@react-native/gradle-plugin')
diff --git a/apps/metro-example-host/metro.config.js b/apps/metro-example-host/metro.config.js
@@ -47,8 +47,8 @@ module.exports = withModuleFederation(
       lodash: {
         singleton: false,
         eager: false,
-        requiredVersion: '4.16.6',
-        version: '4.16.6',
+        requiredVersion: '4.17.23',
+        version: '4.17.23',
       },
     },
     shareStrategy: 'loaded-first',
diff --git a/apps/metro-example-host/package.json b/apps/metro-example-host/package.json
@@ -34,6 +34,7 @@
     "@module-federation/runtime": "workspace:*",
     "@react-native/babel-preset": "0.80.0",
     "@react-native/eslint-config": "0.80.0",
+    "@react-native/gradle-plugin": "0.80.0",
     "@react-native/metro-config": "0.80.0",
     "@react-native/typescript-config": "0.80.0",
     "@rnef/cli": "^0.7.25",
diff --git a/apps/metro-example-mini/metro.config.js b/apps/metro-example-mini/metro.config.js
@@ -48,7 +48,7 @@ module.exports = withModuleFederation(
       lodash: {
         singleton: false,
         eager: false,
-        version: '4.17.21',
+        version: '4.17.23',
       },
     },
     shareStrategy: 'version-first',
diff --git a/apps/metro-example-nested-mini/metro.config.js b/apps/metro-example-nested-mini/metro.config.js
@@ -51,8 +51,8 @@ module.exports = withModuleFederation(
       lodash: {
         singleton: false,
         eager: false,
-        requiredVersion: '4.17.21',
-        version: '4.17.21',
+        requiredVersion: '4.17.23',
+        version: '4.17.23',
       },
     },
     shareStrategy: 'version-first',
diff --git a/packages/dts-plugin/package.json b/packages/dts-plugin/package.json
@@ -58,7 +58,6 @@
     "chalk": "3.0.0",
     "fs-extra": "9.1.0",
     "isomorphic-ws": "5.0.0",
-    "koa": "3.0.3",
     "lodash.clonedeepwith": "4.5.0",
     "log4js": "6.9.1",
     "node-schedule": "2.1.1",
@@ -67,7 +66,6 @@
   },
   "devDependencies": {
     "@module-federation/runtime": "workspace:*",
-    "@types/koa": "2.15.0",
     "@types/node-schedule": "2.1.7",
     "@types/ws": "8.5.12",
     "@vue/tsconfig": "^0.7.0",
diff --git a/packages/dts-plugin/src/core/lib/typeScriptCompiler.test.ts b/packages/dts-plugin/src/core/lib/typeScriptCompiler.test.ts
@@ -449,7 +449,7 @@ describe('typeScriptCompiler', () => {
                         name: 'constant.d.ts',
                       },
                       {
-                        name: 'createKoaServer.d.ts',
+                        name: 'createHttpServer.d.ts',
                       },
                       {
                         name: 'createWebsocket.d.ts',
diff --git a/packages/dts-plugin/src/dev-worker/forkDevWorker.ts b/packages/dts-plugin/src/dev-worker/forkDevWorker.ts
@@ -14,7 +14,7 @@ import {
   UpdateCallbackOptions,
   UpdateKind,
   ModuleFederationDevServer,
-  createKoaServer,
+  createHttpServer,
   fileLog,
   getIPV4,
   DEFAULT_TAR_NAME,
@@ -114,7 +114,7 @@ export async function forkDevWorker(
       const mfTypesZipPath = retrieveTypesZipPath(mfTypesPath, remoteOptions);
 
       await Promise.all([
-        createKoaServer({
+        createHttpServer({
           typeTarPath: mfTypesZipPath,
         }).then((res) => {
           serverAddress = res.serverAddress;
diff --git a/packages/dts-plugin/src/server/createHttpServer.ts b/packages/dts-plugin/src/server/createHttpServer.ts
@@ -0,0 +1,50 @@
+import http from 'http';
+import fs from 'fs-extra';
+import { getFreePort, getIPV4 } from './utils';
+import { DEFAULT_TAR_NAME } from './constant';
+
+interface CreateHttpServerOptions {
+  typeTarPath: string;
+}
+
+export async function createHttpServer(
+  options: CreateHttpServerOptions,
+): Promise<{
+  server: http.Server;
+  serverAddress: string;
+}> {
+  const { typeTarPath } = options;
+  const freeport = await getFreePort();
+  const server = http.createServer((req, res) => {
+    const requestPath = req.url?.split('?')[0] ?? '/';
+    if (requestPath === `/${DEFAULT_TAR_NAME}`) {
+      res.statusCode = 200;
+      res.setHeader('Content-Type', 'application/x-gzip');
+      if (req.method === 'HEAD') {
+        res.end();
+        return;
+      }
+      const stream = fs.createReadStream(typeTarPath);
+      stream.on('error', () => {
+        if (!res.headersSent) {
+          res.statusCode = 500;
+        }
+        res.end();
+      });
+      res.on('close', () => {
+        stream.destroy();
+      });
+      stream.pipe(res);
+      return;
+    }
+    res.statusCode = 404;
+    res.end();
+  });
+
+  server.listen(freeport);
+
+  return {
+    server,
+    serverAddress: `http://${getIPV4()}:${freeport}`,
+  };
+}
diff --git a/packages/dts-plugin/src/server/createKoaServer.ts b/packages/dts-plugin/src/server/createKoaServer.ts
diff --git a/packages/dts-plugin/src/server/index.ts b/packages/dts-plugin/src/server/index.ts
@@ -1,7 +1,7 @@
 export * from './Publisher';
 export * from './DevServer';
 export * from './constant';
-export * from './createKoaServer';
+export * from './createHttpServer';
 export * from './message/Action/Update';
 export * from './utils/getIPV4';
 export * from './utils/log';
diff --git a/packages/enhanced/test/ConfigTestCases.rstest.ts b/packages/enhanced/test/ConfigTestCases.rstest.ts
@@ -37,6 +37,7 @@ const casesPath = path.join(__dirname, 'configCases');
 const ensureTreeShakingFixtures = (testDirectory: string) => {
   const nodeModulesDir = path.join(testDirectory, 'node_modules');
   const isReshake = path.basename(testDirectory) === 'reshake-share';
+  fs.mkdirSync(nodeModulesDir, { recursive: true });
   const ensurePackage = (
     pkgName: string,
     entryContents: string,
diff --git a/packages/enhanced/test/scripts/ensure-reshake-fixtures.js b/packages/enhanced/test/scripts/ensure-reshake-fixtures.js
@@ -132,6 +132,12 @@ const uiLibSideEffectEntry = [
 ].join('\n');
 
 for (const baseDir of fixtureRoots) {
+  try {
+    fs.rmSync(baseDir, { recursive: true, force: true });
+  } catch {
+    // ignore cleanup errors and ensure the directory exists
+  }
+  fs.mkdirSync(baseDir, { recursive: true });
   const isReshake = baseDir.includes(`${path.sep}reshake-share${path.sep}`);
   if (isReshake) {
     ensureFixture(baseDir, 'ui-lib-dep', uiLibDepEntry);
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml

-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +---
 +'@module-federation/dts-plugin': patch
 +---
++
 +Replace the Koa-based dev types server with a native Node HTTP server to reduce dependencies and keep type generation behavior unchanged.
Original file line number	Diff line number	Diff line change
`@@ -449,7 +449,7 @@ describe('typeScriptCompiler', () => {`
`449`	`449`	`name: 'constant.d.ts',`
`450`	`450`	`},`
`451`	`451`	`{`
`452`		`- name: 'createKoaServer.d.ts',`
	`452`	`+ name: 'createHttpServer.d.ts',`
`453`	`453`	`},`
`454`	`454`	`{`
`455`	`455`	`name: 'createWebsocket.d.ts',`