feat(unenv-preset): add support for native node:inspector/promises module (#11744)

* use the native implementation of `inspector/promises` when available

* add changeset for inspector/promises support

Co-Authored-By: pbacondarwin@cloudflare.com <pete@bacondarwin.com>

---------

Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

Author: petebacondarwin

.changeset/native-inspector-promises-module.md

@@ -0,0 +1,23 @@
+---
+"@cloudflare/unenv-preset": minor
+---
+
+Add support for native `node:inspector/promises` module when the `enable_nodejs_inspector_module` compatibility flag is enabled. This extends the existing `node:inspector` support to include the promises-based API.
+
+To enable the native inspector/promises module, add the following to your `wrangler.jsonc`:
+
+```jsonc
+{
+	"compatibility_flags": ["experimental", "enable_nodejs_inspector_module"],
+}
+```
+
+Then you can import and use the inspector/promises module in your Worker:
+
+```javascript
+import inspector from "node:inspector/promises";
+
+// Access inspector APIs (note: workerd's implementation is a non-functional stub)
+inspector.url(); // returns undefined
+inspector.close(); // no-op
+```

packages/unenv-preset/src/preset.ts

@@ -601,7 +601,7 @@ function getVmOverrides({
 }
 
 /**
- * Returns the overrides for `node:inspector` (unenv or workerd)
+ * Returns the overrides for `node:inspector` and `node:inspector/promises` (unenv or workerd)
  *
  * The native inspector implementation:
  * - is experimental and has no default enable date
@@ -627,7 +627,7 @@ function getInspectorOverrides({
 	// When enabled, use the native `inspector` module from workerd
 	return enabled
 		? {
-				nativeModules: ["inspector"],
+				nativeModules: ["inspector/promises", "inspector"],
 				hybridModules: [],
 			}
 		: {

packages/wrangler/e2e/unenv-preset/preset.test.ts

@@ -410,7 +410,7 @@ const localTestConfigs: TestConfig[] = [
 			},
 		},
 	],
-	// node:inspector (experimental, no default enable date)
+	// node:inspector and node:inspector/promises (experimental, no default enable date)
 	[
 		{
 			name: "inspector enabled by flag",

packages/wrangler/e2e/unenv-preset/worker/index.ts

@@ -752,6 +752,37 @@ export const WorkerdTests: Record<string, () => void> = {
 			Network: "object",
 		});
 	},
+
+	async testInspectorPromises() {
+		const inspectorPromises = await import("node:inspector/promises");
+		assertTypeOfProperties(inspectorPromises, {
+			Session: "function",
+			close: "function",
+			console: "object",
+			open: "function",
+			url: "function",
+			waitForDebugger: "function",
+		});
+
+		if (getRuntimeFlagValue("enable_nodejs_inspector_module")) {
+			// In unenv this object is polyfilled by a "notImplementedClass" which has type function.
+			assertTypeOf(inspectorPromises, "Network", "object");
+		}
+
+		assertTypeOfProperties(inspectorPromises.default, {
+			Session: "function",
+			close: "function",
+			console: "object",
+			open: "function",
+			url: "function",
+			waitForDebugger: "function",
+		});
+
+		if (getRuntimeFlagValue("enable_nodejs_inspector_module")) {
+			// In unenv this object is polyfilled by a "notImplementedClass" which has type function.
+			assertTypeOf(inspectorPromises.default, "Network", "object");
+		}
+	},
 };
 
 /**