wrangler 4.14.4 → 4.15.0

package/config-schema.json

@@ -321,6 +321,10 @@
               "preview_id": {
                 "type": "string",
                 "description": "The ID of the KV namespace used during `wrangler dev`"
+              },
+              "remote": {
+                "type": "boolean",
+                "description": "Whether the KV namespace should be remote or not (only available under `--x-mixed-mode`)"
               }
             },
             "required": [
@@ -379,6 +383,10 @@
                   "delivery_delay": {
                     "type": "number",
                     "description": "The number of seconds to wait before delivering a message"
+                  },
+                  "remote": {
+                    "type": "boolean",
+                    "description": "Whether the Queue producer should be remote or not (only available under `--x-mixed-mode`)"
                   }
                 },
                 "required": [
@@ -469,6 +477,10 @@
               "jurisdiction": {
                 "type": "string",
                 "description": "The jurisdiction that the bucket exists in. Default if not present."
+              },
+              "remote": {
+                "type": "boolean",
+                "description": "Whether the R2 bucket should be remote or not (only available under `--x-mixed-mode`)"
               }
             },
             "required": [
@@ -511,6 +523,10 @@
               "database_internal_env": {
                 "type": "string",
                 "description": "Internal use only."
+              },
+              "remote": {
+                "type": "boolean",
+                "description": "Whether the D1 database should be remote or not (only available under `--x-mixed-mode`)"
               }
             },
             "required": [
@@ -596,6 +612,10 @@
                 "type": "object",
                 "additionalProperties": {},
                 "description": "Optional properties that will be made available to the service via ctx.props."
+              },
+              "remote": {
+                "type": "boolean",
+                "description": "Whether the service binding should be remote or not (only available under `--x-mixed-mode`)"
               }
             },
             "required": [
@@ -1258,6 +1278,10 @@
               "preview_id": {
                 "type": "string",
                 "description": "The ID of the KV namespace used during `wrangler dev`"
+              },
+              "remote": {
+                "type": "boolean",
+                "description": "Whether the KV namespace should be remote or not (only available under `--x-mixed-mode`)"
               }
             },
             "required": [
@@ -1316,6 +1340,10 @@
                   "delivery_delay": {
                     "type": "number",
                     "description": "The number of seconds to wait before delivering a message"
+                  },
+                  "remote": {
+                    "type": "boolean",
+                    "description": "Whether the Queue producer should be remote or not (only available under `--x-mixed-mode`)"
                   }
                 },
                 "required": [
@@ -1406,6 +1434,10 @@
               "jurisdiction": {
                 "type": "string",
                 "description": "The jurisdiction that the bucket exists in. Default if not present."
+              },
+              "remote": {
+                "type": "boolean",
+                "description": "Whether the R2 bucket should be remote or not (only available under `--x-mixed-mode`)"
               }
             },
             "required": [
@@ -1448,6 +1480,10 @@
               "database_internal_env": {
                 "type": "string",
                 "description": "Internal use only."
+              },
+              "remote": {
+                "type": "boolean",
+                "description": "Whether the D1 database should be remote or not (only available under `--x-mixed-mode`)"
               }
             },
             "required": [
@@ -1533,6 +1569,10 @@
                 "type": "object",
                 "additionalProperties": {},
                 "description": "Optional properties that will be made available to the service via ctx.props."
+              },
+              "remote": {
+                "type": "boolean",
+                "description": "Whether the service binding should be remote or not (only available under `--x-mixed-mode`)"
               }
             },
             "required": [
@@ -2125,6 +2165,10 @@
         "script_name": {
           "type": "string",
           "description": "The script where the Workflow is defined (if it's external to this Worker)"
+        },
+        "remote": {
+          "type": "boolean",
+          "description": "Whether the Workflow should be remote or not (only available under `--x-mixed-mode`)"
         }
       },
       "required": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wrangler",
-  "version": "4.14.4",
+  "version": "4.15.0",
   "description": "Command-line interface for all things Cloudflare Workers",
   "keywords": [
     "wrangler",
@@ -55,14 +55,14 @@
     "esbuild": "0.25.4",
     "path-to-regexp": "6.3.0",
     "unenv": "2.0.0-rc.15",
-    "workerd": "1.20250507.0",
-    "miniflare": "4.20250507.0",
-    "@cloudflare/kv-asset-handler": "0.4.0"
+    "workerd": "1.20250508.0",
+    "@cloudflare/kv-asset-handler": "0.4.0",
+    "miniflare": "4.20250508.0"
   },
   "devDependencies": {
     "@aws-sdk/client-s3": "^3.721.0",
     "@cloudflare/types": "6.18.4",
-    "@cloudflare/workers-types": "^4.20250507.0",
+    "@cloudflare/workers-types": "^4.20250508.0",
     "@cspotcode/source-map-support": "0.8.1",
     "@iarna/toml": "^3.0.0",
     "@microsoft/api-extractor": "^7.47.0",
@@ -135,14 +135,14 @@
     "xdg-app-paths": "^8.3.0",
     "xxhash-wasm": "^1.0.1",
     "yargs": "^17.7.2",
-    "@cloudflare/cli": "1.1.1",
     "@cloudflare/eslint-config-worker": "1.1.0",
-    "@cloudflare/pages-shared": "^0.13.36",
     "@cloudflare/workers-shared": "0.17.5",
-    "@cloudflare/workers-tsconfig": "0.0.0"
+    "@cloudflare/workers-tsconfig": "0.0.0",
+    "@cloudflare/pages-shared": "^0.13.37",
+    "@cloudflare/cli": "1.1.1"
   },
   "peerDependencies": {
-    "@cloudflare/workers-types": "^4.20250507.0"
+    "@cloudflare/workers-types": "^4.20250508.0"
   },
   "peerDependenciesMeta": {
     "@cloudflare/workers-types": {

package/templates/mixedMode/proxyServerWorker/index.ts

@@ -1,5 +1,26 @@
 export default {
-	fetch() {
-		return new Response("no-op mixed-mode proxyServerWorker");
+	async fetch(request, env) {
+		const targetBinding = request.headers.get("MF-Binding");
+
+		if (targetBinding) {
+			const originalHeaders = new Headers();
+			for (const [name, value] of request.headers) {
+				if (name.startsWith("mf-header-")) {
+					originalHeaders.set(name.slice("mf-header-".length), value);
+				} else if (name === "upgrade") {
+					// The `Upgrade` header needs to be special-cased to prevent:
+					//   TypeError: Worker tried to return a WebSocket in a response to a request which did not contain the header "Upgrade: websocket"
+					originalHeaders.set(name, value);
+				}
+			}
+			return env[targetBinding].fetch(
+				request.headers.get("MF-URL")!,
+				new Request(request, {
+					redirect: "manual",
+					headers: originalHeaders,
+				})
+			);
+		}
+		return new Response("Provide a binding", { status: 400 });
 	},
-};
+} satisfies ExportedHandler<Record<string, Fetcher>>;

package/wrangler-dist/cli.d.ts

@@ -13,6 +13,7 @@ import type { MessagePort as MessagePort_2 } from 'worker_threads';
 import type { Metafile } from 'esbuild';
 import { Miniflare } from 'miniflare';
 import type { MiniflareOptions } from 'miniflare';
+import type { MixedModeConnectionString } from 'miniflare';
 import type { ModuleRule } from 'miniflare';
 import { Mutex } from 'miniflare';
 import type { NodeJSCompatMode } from 'miniflare';
@@ -30,8 +31,6 @@ import type { WorkerOptions } from 'miniflare';
 import { Writable } from 'stream';
 import { z } from 'zod';
 
-declare const __brand: unique symbol;
-
 declare type AbortSignal_2 = unknown;
 
 declare interface AddEventListenerOptions extends EventListenerOptions {
@@ -588,6 +587,7 @@ declare interface CfD1Database {
     database_internal_env?: string;
     migrations_table?: string;
     migrations_dir?: string;
+    remote?: boolean;
 }
 
 declare interface CfDispatchNamespace {
@@ -622,6 +622,7 @@ declare interface CfHyperdrive {
 declare interface CfKvNamespace {
     binding: string;
     id?: string | typeof INHERIT_SYMBOL;
+    remote?: boolean;
 }
 
 declare interface CfLogfwdrBinding {
@@ -693,12 +694,14 @@ declare interface CfQueue {
     binding: string;
     queue_name: string;
     delivery_delay?: number;
+    remote?: boolean;
 }
 
 declare interface CfR2Bucket {
     binding: string;
     bucket_name?: string | typeof INHERIT_SYMBOL;
     jurisdiction?: string;
+    remote?: boolean;
 }
 
 /**
@@ -729,6 +732,7 @@ declare interface CfService {
     environment?: string;
     entrypoint?: string;
     props?: Record<string, unknown>;
+    remote?: boolean;
 }
 
 declare interface CfTailConsumer {
@@ -785,6 +789,7 @@ declare interface CfWorkflow {
     class_name: string;
     binding: string;
     script_name?: string;
+    remote?: boolean;
 }
 
 /**
@@ -2010,6 +2015,8 @@ declare interface EnvironmentNonInheritable {
         id?: string;
         /** The ID of the KV namespace used during `wrangler dev` */
         preview_id?: string;
+        /** Whether the KV namespace should be remote or not (only available under `--x-mixed-mode`) */
+        remote?: boolean;
     }[];
     /**
      * These specify bindings to send email from inside your Worker.
@@ -2046,6 +2053,8 @@ declare interface EnvironmentNonInheritable {
             queue: string;
             /** The number of seconds to wait before delivering a message */
             delivery_delay?: number;
+            /** Whether the Queue producer should be remote or not (only available under `--x-mixed-mode`) */
+            remote?: boolean;
         }[];
         /** Consumer configuration */
         consumers?: {
@@ -2087,6 +2096,8 @@ declare interface EnvironmentNonInheritable {
         preview_bucket_name?: string;
         /** The jurisdiction that the bucket exists in. Default if not present. */
         jurisdiction?: string;
+        /** Whether the R2 bucket should be remote or not (only available under `--x-mixed-mode`) */
+        remote?: boolean;
     }[];
     /**
      * Specifies D1 databases that are bound to this Worker environment.
@@ -2112,6 +2123,8 @@ declare interface EnvironmentNonInheritable {
         migrations_dir?: string;
         /** Internal use only. */
         database_internal_env?: string;
+        /** Whether the D1 database should be remote or not (only available under `--x-mixed-mode`) */
+        remote?: boolean;
     }[];
     /**
      * Specifies Vectorize indexes that are bound to this Worker environment.
@@ -2165,6 +2178,8 @@ declare interface EnvironmentNonInheritable {
         entrypoint?: string;
         /** Optional properties that will be made available to the service via ctx.props. */
         props?: Record<string, unknown>;
+        /** Whether the service binding should be remote or not (only available under `--x-mixed-mode`) */
+        remote?: boolean;
     }[] | undefined;
     /**
      * Specifies analytics engine datasets that are bound to this Worker environment.
@@ -2557,7 +2572,9 @@ export declare const experimental_readRawConfig: (args: ReadConfigCommandArgs, o
     userConfigPath: string | undefined;
 };
 
-export declare function experimental_startMixedModeSession(bindings: BindingsOpt): Promise<MixedModeSession>;
+export declare function experimental_startMixedModeSession(bindings: BindingsOpt, options?: {
+    auth: NonNullable<StartDevWorkerInput["dev"]>["auth"];
+}): Promise<MixedModeSession>;
 
 declare function fetch_2 (
 input: RequestInfo,
@@ -2932,10 +2949,6 @@ declare interface MIMEType {
 
 declare type MiniflareWorker = Awaited<ReturnType<Miniflare["getWorker"]>>;
 
-declare type MixedModeConnectionString = Awaited<Worker["url"]> & {
-    [__brand]: "MixedModeConnectionString";
-};
-
 declare type MixedModeSession = Pick<Worker, "ready" | "dispose"> & {
     ["setConfig"]: (bindings: BindingsOpt) => Promise<void>;
     ["mixedModeConnectionString"]: MixedModeConnectionString;
@@ -26535,6 +26548,7 @@ export declare interface Unstable_DevOptions {
         binding: string;
         id?: string;
         preview_id?: string;
+        remote?: boolean;
     }[];
     durableObjects?: {
         name: string;
@@ -26547,11 +26561,13 @@ export declare interface Unstable_DevOptions {
         service: string;
         environment?: string | undefined;
         entrypoint?: string | undefined;
+        remote?: boolean;
     }[];
     r2?: {
         binding: string;
         bucket_name?: string;
         preview_bucket_name?: string;
+        remote?: boolean;
     }[];
     ai?: {
         binding: string;
@@ -26766,6 +26782,8 @@ declare type WorkflowBinding = {
     class_name: string;
     /** The script where the Workflow is defined (if it's external to this Worker) */
     script_name?: string;
+    /** Whether the Workflow should be remote or not (only available under `--x-mixed-mode`) */
+    remote?: boolean;
 };
 
 declare type ZoneIdRoute = {