feat(unenv-preset): add support for native node:dgram module (#11701)

petebacondarwin · devin-ai-integration[bot] · web-flow · commit fec8f5b82e0b · 2026-01-13T20:56:14.000+01:00
Co-authored-by: Devin AI &lt;158243242+devin-ai-integration[bot]@users.noreply.github.com&gt;
diff --git a/.changeset/native-dgram-module.md b/.changeset/native-dgram-module.md
@@ -0,0 +1,5 @@
+---
+"@cloudflare/unenv-preset": minor
+---
+
+Add support for native `node:dgram` module when the `enable_nodejs_dgram_module` compatibility flag is enabled. This feature is currently experimental and requires both the `enable_nodejs_dgram_module` and `experimental` compatibility flags to be set.
diff --git a/packages/unenv-preset/package.json b/packages/unenv-preset/package.json
@@ -49,7 +49,7 @@
 	},
 	"peerDependencies": {
 		"unenv": "2.0.0-rc.24",
-		"workerd": "^1.20251202.0"
+		"workerd": "^1.20251221.0"
 	},
 	"peerDependenciesMeta": {
 		"workerd": {
diff --git a/packages/unenv-preset/src/preset.ts b/packages/unenv-preset/src/preset.ts
@@ -81,6 +81,7 @@ export function getCloudflarePreset({
 	const vmOverrides = getVmOverrides(compat);
 	const inspectorOverrides = getInspectorOverrides(compat);
 	const sqliteOverrides = getSqliteOverrides(compat);
+	const dgramOverrides = getDgramOverrides(compat);
 
 	// "dynamic" as they depend on the compatibility date and flags
 	const dynamicNativeModules = [
@@ -98,6 +99,7 @@ export function getCloudflarePreset({
 		...vmOverrides.nativeModules,
 		...inspectorOverrides.nativeModules,
 		...sqliteOverrides.nativeModules,
+		...dgramOverrides.nativeModules,
 	];
 
 	// "dynamic" as they depend on the compatibility date and flags
@@ -116,6 +118,7 @@ export function getCloudflarePreset({
 		...vmOverrides.hybridModules,
 		...inspectorOverrides.hybridModules,
 		...sqliteOverrides.hybridModules,
+		...dgramOverrides.hybridModules,
 	];
 
 	return {
@@ -674,3 +677,39 @@ function getSqliteOverrides({
 				hybridModules: [],
 			};
 }
+
+/**
+ * Returns the overrides for `node:dgram` (unenv or workerd)
+ *
+ * The native dgram implementation:
+ * - is experimental and has no default enable date
+ * - can be enabled with the "enable_nodejs_dgram_module" flag
+ * - can be disabled with the "disable_nodejs_dgram_module" flag
+ */
+function getDgramOverrides({
+	compatibilityFlags,
+}: {
+	compatibilityDate: string;
+	compatibilityFlags: string[];
+}): { nativeModules: string[]; hybridModules: string[] } {
+	const disabledByFlag = compatibilityFlags.includes(
+		"disable_nodejs_dgram_module"
+	);
+
+	const enabledByFlag =
+		compatibilityFlags.includes("enable_nodejs_dgram_module") &&
+		compatibilityFlags.includes("experimental");
+
+	const enabled = enabledByFlag && !disabledByFlag;
+
+	// When enabled, use the native `dgram` module from workerd
+	return enabled
+		? {
+				nativeModules: ["dgram"],
+				hybridModules: [],
+			}
+		: {
+				nativeModules: [],
+				hybridModules: [],
+			};
+}
diff --git a/packages/wrangler/e2e/unenv-preset/preset.test.ts b/packages/wrangler/e2e/unenv-preset/preset.test.ts
@@ -451,6 +451,27 @@ const localTestConfigs: TestConfig[] = [
 			},
 		},
 	],
+	// node:dgram (experimental, no default enable date)
+	[
+		// TODO: add test for disabled by date (no date defined yet)
+		// TODO: add test for enabled by date (no date defined yet)
+		{
+			name: "dgram enabled by flag",
+			compatibilityDate: "2024-09-23",
+			compatibilityFlags: ["enable_nodejs_dgram_module", "experimental"],
+			expectRuntimeFlags: {
+				enable_nodejs_dgram_module: true,
+			},
+		},
+		{
+			name: "dgram disabled by flag",
+			compatibilityDate: "2024-09-23",
+			compatibilityFlags: ["disable_nodejs_dgram_module", "experimental"],
+			expectRuntimeFlags: {
+				enable_nodejs_dgram_module: false,
+			},
+		},
+	],
 ].flat() as TestConfig[];
 
 describe.each(localTestConfigs)(
diff --git a/packages/wrangler/e2e/unenv-preset/worker/index.ts b/packages/wrangler/e2e/unenv-preset/worker/index.ts
@@ -832,6 +832,20 @@ export const WorkerdTests: Record<string, () => void> = {
 			);
 		}
 	},
+
+	async testDgram() {
+		const dgram = await import("node:dgram");
+
+		assertTypeOfProperties(dgram, {
+			createSocket: "function",
+			Socket: "function",
+		});
+
+		assertTypeOfProperties(dgram.default, {
+			createSocket: "function",
+			Socket: "function",
+		});
+	},
 };
 
 /**
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml

-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +---
 +"@cloudflare/unenv-preset": minor
 +---
++
 +Add support for native `node:dgram` module when the `enable_nodejs_dgram_module` compatibility flag is enabled. This feature is currently experimental and requires both the `enable_nodejs_dgram_module` and `experimental` compatibility flags to be set.