[vite-plugin] Fix cloudflare:node server dispatch in Vite and Vitest

.changeset/dependabot-update-15633.md

@@ -0,0 +1,13 @@
+---
+"miniflare": patch
+"wrangler": patch
+---
+
+Update dependencies of "miniflare", "wrangler"
+
+The following dependency versions have been updated:
+
+| Dependency                | From          | To            |
+| ------------------------- | ------------- | ------------- |
+| @cloudflare/workers-types | ^5.20260911.1 | ^5.20260914.1 |
+| workerd                   | 1.20260911.1  | 1.20260914.1  |

.changeset/warm-runners-listen.md

@@ -0,0 +1,9 @@
+---
+"@cloudflare/vite-plugin": patch
+"@cloudflare/vitest-plugin": patch
+"miniflare": minor
+---
+
+Fix `cloudflare:node` HTTP server dispatch in Vite and Vitest
+
+Vite and Vitest evaluate user modules inside pinned runner Durable Objects but invoke exported handlers from another context. Their internal singleton runners now expose that actor's Node.js server port registrations to the isolate, allowing handlers created with `httpServerHandler()` to find servers started during module evaluation without changing port isolation for other actors.

fixtures/vitest-plugin-examples/misc/src/cloudflare-node.ts

@@ -0,0 +1,10 @@
+import http from "node:http";
+import { httpServerHandler } from "cloudflare:node";
+
+const server = http.createServer((_, response) => {
+	response.end("Hello from an httpServerHandler");
+});
+
+server.listen(8080);
+
+export default httpServerHandler({ port: 8080 });

fixtures/vitest-plugin-examples/misc/src/tsconfig.json

@@ -0,0 +1,8 @@
+{
+	"extends": "../../tsconfig.workerd.json",
+	"compilerOptions": {
+		"skipLibCheck": true,
+		"types": ["@cloudflare/workers-types/experimental", "@types/node"]
+	},
+	"include": ["./**/*.ts"]
+}

fixtures/vitest-plugin-examples/misc/test/nodejs.test.ts

@@ -1,3 +1,4 @@
+import { SELF } from "cloudflare:test";
 import { it } from "vitest";
 
 it("runs in Node.js compatibility mode", ({ expect }) => {
@@ -6,3 +7,11 @@ it("runs in Node.js compatibility mode", ({ expect }) => {
 	expect(process.versions.node).toBeDefined();
 	expect(typeof Buffer).toBe("function");
 });
+
+it("dispatches to an HTTP server registered with `cloudflare:node`", async ({
+	expect,
+}) => {
+	const response = await SELF.fetch("https://example.com");
+
+	expect(await response.text()).toBe("Hello from an httpServerHandler");
+});

fixtures/vitest-plugin-examples/misc/wrangler.nodejs.jsonc

@@ -1,5 +1,6 @@
 {
 	"$schema": "../node_modules/wrangler/config-schema.json",
+	"main": "src/cloudflare-node.ts",
 	// Pin a compatibility date from before `nodejs_compat` became enabled by
 	// default, so that this fixture keeps covering the explicit-flag path.
 	// Specifying the flag on a later date is a workerd validation error.

packages/miniflare/src/config/schema.ts

@@ -349,18 +349,21 @@ const MiniflareBindingSchema = z.unknown().transform((value, ctx) => {
  * Extends live DO exports with miniflare-internal fields:
  * - `unsafeUniqueKey` — custom unique key for DO namespace identity
  * - `unsafePreventEviction` — prevents the DO from being evicted
+ * - `unsafeUseIsolateNodePortScopeForActor` — shares one actor's Node.js server ports across the isolate
  * - `container` — container config for container-attached DOs
  */
 export const MiniflareDurableObjectExportSchema =
 	DurableObjectCreatedExportSchema.extend({
 		unsafeUniqueKey: z.custom<UnsafeUniqueKey>().optional(),
 		unsafePreventEviction: z.boolean().optional(),
+		unsafeUseIsolateNodePortScopeForActor: z.string().optional(),
 		container: z.custom<DOContainerOptions>().optional(),
 	});
 export const MiniflareDurableObjectExpectingTransferExportSchema =
 	DurableObjectExpectingTransferExportSchema.extend({
 		unsafeUniqueKey: z.custom<UnsafeUniqueKey>().optional(),
 		unsafePreventEviction: z.boolean().optional(),
+		unsafeUseIsolateNodePortScopeForActor: z.string().optional(),
 		container: z.custom<DOContainerOptions>().optional(),
 	});
 

packages/miniflare/src/config/v4-convert.ts

@@ -441,6 +441,8 @@ function addDurableObjectExport(
 		storage: object.useSQLite ? "sqlite" : "legacy-kv",
 		unsafeUniqueKey: object.unsafeUniqueKey,
 		unsafePreventEviction: object.unsafePreventEviction,
+		unsafeUseIsolateNodePortScopeForActor:
+			object.unsafeUseIsolateNodePortScopeForActor,
 		container: object.container,
 	};
 	exports[object.className] = exported as Exports[string];

packages/miniflare/src/config/v4-schema.ts

@@ -244,6 +244,7 @@ const V4DurableObjectSchema = z.object({
 		])
 		.optional(),
 	unsafePreventEviction: z.boolean().optional(),
+	unsafeUseIsolateNodePortScopeForActor: z.string().optional(),
 	remoteProxyConnectionString: RemoteProxyConnectionStringSchema.optional(),
 	container: z.object({ imageName: z.string() }).optional(),
 });
@@ -743,6 +744,7 @@ export type V4DurableObject = {
 	useSQLite?: boolean;
 	unsafeUniqueKey?: string | symbol;
 	unsafePreventEviction?: boolean;
+	unsafeUseIsolateNodePortScopeForActor?: string;
 	remoteProxyConnectionString?: RemoteProxyConnectionString;
 	container?: { imageName: string };
 };

packages/miniflare/src/index.ts

@@ -365,6 +365,8 @@ function getDurableObjectClassNames(
 				enableSql: exported.storage === "sqlite",
 				unsafeUniqueKey: exported.unsafeUniqueKey,
 				unsafePreventEviction: exported.unsafePreventEviction,
+				unsafeUseIsolateNodePortScopeForActor:
+					exported.unsafeUseIsolateNodePortScopeForActor,
 				container: exported.container,
 			});
 		}

packages/miniflare/src/plugins/do/namespaces.ts

@@ -51,6 +51,7 @@ export function getDurableObjectNamespaces(
 				enableSql,
 				unsafeUniqueKey,
 				unsafePreventEviction: preventEviction,
+				unsafeUseIsolateNodePortScopeForActor,
 				container,
 			},
 		]) => {
@@ -70,13 +71,15 @@ export function getDurableObjectNamespaces(
 						enableSql,
 						ephemeralLocal: kVoid,
 						preventEviction,
+						unsafeUseIsolateNodePortScopeForActor,
 						container: containerOptions,
 					}
 				: {
 						className,
 						enableSql,
 						uniqueKey,
 						preventEviction,
+						unsafeUseIsolateNodePortScopeForActor,
 						container: containerOptions,
 					};
 		}

packages/miniflare/src/plugins/shared/index.ts

@@ -42,6 +42,7 @@ export type DurableObjectClassNames = Map<
 			enableSql?: boolean;
 			unsafeUniqueKey?: UnsafeUniqueKey;
 			unsafePreventEviction?: boolean;
+			unsafeUseIsolateNodePortScopeForActor?: string;
 			container?: DOContainerOptions;
 		}
 	>

packages/miniflare/src/runtime/config/workerd.ts

@@ -201,12 +201,19 @@ export type Worker_DurableObjectNamespace = {
 	className?: string;
 	preventEviction?: boolean;
 	enableSql?: boolean;
+	unsafeUseIsolateNodePortScopeForActor?: string;
 	container?: Worker_DurableObjectNamespace_ContainerOptions;
 } & ({ uniqueKey?: string } | { ephemeralLocal?: Void });
 
 export interface Worker_DurableObjectNamespace_ContainerOptions {
 	imageName?: string;
 	privileges?: Worker_DurableObjectNamespace_ContainerOptions_ContainerPrivileges;
+	images?: Worker_DurableObjectNamespace_ContainerOptions_NamedImage[];
+}
+
+export interface Worker_DurableObjectNamespace_ContainerOptions_NamedImage {
+	name?: string;
+	image?: string;
 }
 
 export interface Worker_DurableObjectNamespace_ContainerOptions_ContainerPrivileges {

packages/miniflare/test/config/v4-convert.spec.ts

@@ -1,6 +1,7 @@
 import path from "node:path";
 import { describe, test } from "vitest";
 import { convertV4MiniflareOptions } from "../../src/config/v4-convert";
+import { kUnsafeEphemeralUniqueKey } from "../../src/plugins/shared/unsafe-unique-key";
 import type { RemoteProxyConnectionString } from "../../src/plugins/shared";
 
 describe("convertV4MiniflareOptions", () => {
@@ -16,7 +17,12 @@ describe("convertV4MiniflareOptions", () => {
 					className: "LocalObject",
 					useSQLite: true,
 					unsafeUniqueKey: "local-key",
+				},
+				RUNNER: {
+					className: "RunnerObject",
+					unsafeUniqueKey: kUnsafeEphemeralUniqueKey,
 					unsafePreventEviction: true,
+					unsafeUseIsolateNodePortScopeForActor: "singleton",
 				},
 				SELF_EXPLICIT: {
 					className: "SelfExplicitObject",
@@ -38,6 +44,11 @@ describe("convertV4MiniflareOptions", () => {
 				worker: "worker",
 				exportName: "LocalObject",
 			},
+			RUNNER: {
+				type: "durable-object",
+				worker: "worker",
+				exportName: "RunnerObject",
+			},
 			EXTERNAL: {
 				type: "durable-object",
 				worker: "external-worker",
@@ -54,7 +65,13 @@ describe("convertV4MiniflareOptions", () => {
 				type: "durable-object",
 				storage: "sqlite",
 				unsafeUniqueKey: "local-key",
+			},
+			RunnerObject: {
+				type: "durable-object",
+				storage: "legacy-kv",
+				unsafeUniqueKey: kUnsafeEphemeralUniqueKey,
 				unsafePreventEviction: true,
+				unsafeUseIsolateNodePortScopeForActor: "singleton",
 			},
 			SelfExplicitObject: {
 				type: "durable-object",