Part 4️⃣ of removing CfWorkerInit["bindings"] (#12461)

Author: penalosa

.changeset/two-humans-sing.md

@@ -0,0 +1,8 @@
+---
+"@cloudflare/workers-utils": minor
+"wrangler": minor
+---
+
+Support `type: inherit` bindings when using startWorker()
+
+This is an internal binding type that should not be used by external users of the API

packages/workers-utils/src/config/validation.ts

@@ -111,7 +111,7 @@ export const friendlyBindingNames: Record<
  * Friendly names for binding types (keyed by Binding["type"] discriminator).
  * These are mostly (but not always) non-plural versions of friendlyBindingNames
  */
-export const bindingTypeFriendlyNames: Record<Binding["type"], string> = {
+const bindingTypeFriendlyNames: Record<Binding["type"], string> = {
 	// The 3 binding types below are all rendered as "Environment Variable" to preserve existing behaviour (friendlyBindingNames.vars)
 	plain_text: "Environment Variable",
 	secret_text: "Environment Variable",
@@ -146,6 +146,7 @@ export const bindingTypeFriendlyNames: Record<Binding["type"], string> = {
 	vpc_service: "VPC Service",
 	media: "Media",
 	assets: "Assets",
+	inherit: "Inherited",
 } as const;
 
 /**

packages/workers-utils/src/types.ts

@@ -312,4 +312,5 @@ export type Binding =
 	| ({ type: "vpc_service" } & BindingOmit<CfVpcService>)
 	| ({ type: "media" } & BindingOmit<CfMediaBinding>)
 	| ({ type: `unsafe_${string}` } & Omit<CfUnsafeBinding, "name" | "type">)
-	| { type: "assets" };
+	| { type: "assets" }
+	| { type: "inherit" };

packages/wrangler/src/__tests__/api/startDevWorker/RemoteRuntimeController.test.ts

@@ -24,6 +24,7 @@ import type {
 	PreviewTokenExpiredEvent,
 	StartDevWorkerOptions,
 } from "../../../api";
+import type { StartDevWorkerInput } from "../../../api/startDevWorker/types";
 import type { CfWorkerInit } from "@cloudflare/workers-utils";
 
 // Mock the API modules
@@ -147,7 +148,7 @@ describe("RemoteRuntimeController", () => {
 				content: "export default { fetch() { return new Response('hello'); } }",
 			},
 			modules: [],
-			bindings: {} as CfWorkerInit["bindings"],
+			bindings: {} as StartDevWorkerInput["bindings"],
 			migrations: undefined,
 			compatibility_date: "2025-11-11",
 			compatibility_flags: [],

packages/wrangler/src/api/startDevWorker/RemoteRuntimeController.ts

@@ -19,7 +19,7 @@ import { realishPrintLogs } from "../../tail/printing";
 import { getAccessToken } from "../../user/access";
 import { RuntimeController } from "./BaseController";
 import { castErrorCause } from "./events";
-import { convertBindingsToCfWorkerInitBindings, unwrapHook } from "./utils";
+import { unwrapHook } from "./utils";
 import type {
 	CfAccount,
 	CfPreviewSession,
@@ -257,10 +257,6 @@ export class RemoteRuntimeController extends RuntimeController {
 		routes: Route[] | undefined,
 		bundleId: number
 	) {
-		const { bindings } = await convertBindingsToCfWorkerInitBindings(
-			config.bindings
-		);
-
 		// If we received a new `bundleComplete` event before we were able to
 		// dispatch a `reloadComplete` for this bundle, ignore this bundle.
 		if (bundleId !== this.#currentBundleId) {
@@ -286,8 +282,7 @@ export class RemoteRuntimeController extends RuntimeController {
 					}
 				: undefined,
 			format: bundle.entry.format,
-			// TODO: Remove this passthrough
-			bindings: bindings,
+			bindings: config.bindings,
 			compatibilityDate: config.compatibilityDate,
 			compatibilityFlags: config.compatibilityFlags,
 			routes,