wrangler 4.40.2 → 4.51.0

package/config-schema.json

@@ -248,6 +248,26 @@
           ],
           "description": "Specify the compliance region mode of the Worker.\n\nAlthough if the user does not specify a compliance region, the default is `public`, it can be set to `undefined` in configuration to delegate to the CLOUDFLARE_COMPLIANCE_REGION environment variable."
         },
+        "python_modules": {
+          "type": "object",
+          "properties": {
+            "exclude": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "A list of glob patterns to exclude files from the python_modules directory when bundling.\n\nPatterns are relative to the python_modules directory and use glob syntax.",
+              "default": [
+                "***.pyc"
+              ]
+            }
+          },
+          "required": [
+            "exclude"
+          ],
+          "additionalProperties": false,
+          "description": "Configuration for Python modules."
+        },
         "define": {
           "type": "object",
           "additionalProperties": {
@@ -720,6 +740,24 @@
           "description": "Binding to Cloudflare Images\n\nNOTE: This field is not automatically inherited from the top level environment, and so must be specified in every named environment.\n\nFor reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#images",
           "default": {}
         },
+        "media": {
+          "type": "object",
+          "properties": {
+            "binding": {
+              "type": "string"
+            },
+            "remote": {
+              "type": "boolean",
+              "description": "Whether the Media binding should be remote or not"
+            }
+          },
+          "required": [
+            "binding"
+          ],
+          "additionalProperties": false,
+          "description": "Binding to Cloudflare Media Transformations\n\nNOTE: This field is not automatically inherited from the top level environment, and so must be specified in every named environment.",
+          "default": {}
+        },
         "version_metadata": {
           "type": "object",
           "properties": {
@@ -877,6 +915,14 @@
           "description": "Specifies a list of Tail Workers that are bound to this Worker environment\n\nNOTE: This field is not automatically inherited from the top level environment, and so must be specified in every named environment.",
           "default": []
         },
+        "streaming_tail_consumers": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/StreamingTailConsumer"
+          },
+          "description": "Specifies a list of Streaming Tail Workers that are bound to this Worker environment\n\nNOTE: This field is not automatically inherited from the top level environment, and so must be specified in every named environment.",
+          "default": []
+        },
         "dispatch_namespaces": {
           "type": "array",
           "items": {
@@ -1397,6 +1443,26 @@
           ],
           "description": "Specify the compliance region mode of the Worker.\n\nAlthough if the user does not specify a compliance region, the default is `public`, it can be set to `undefined` in configuration to delegate to the CLOUDFLARE_COMPLIANCE_REGION environment variable."
         },
+        "python_modules": {
+          "type": "object",
+          "properties": {
+            "exclude": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "A list of glob patterns to exclude files from the python_modules directory when bundling.\n\nPatterns are relative to the python_modules directory and use glob syntax.",
+              "default": [
+                "***.pyc"
+              ]
+            }
+          },
+          "required": [
+            "exclude"
+          ],
+          "additionalProperties": false,
+          "description": "Configuration for Python modules."
+        },
         "define": {
           "type": "object",
           "additionalProperties": {
@@ -1869,6 +1935,24 @@
           "description": "Binding to Cloudflare Images\n\nNOTE: This field is not automatically inherited from the top level environment, and so must be specified in every named environment.\n\nFor reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#images",
           "default": {}
         },
+        "media": {
+          "type": "object",
+          "properties": {
+            "binding": {
+              "type": "string"
+            },
+            "remote": {
+              "type": "boolean",
+              "description": "Whether the Media binding should be remote or not"
+            }
+          },
+          "required": [
+            "binding"
+          ],
+          "additionalProperties": false,
+          "description": "Binding to Cloudflare Media Transformations\n\nNOTE: This field is not automatically inherited from the top level environment, and so must be specified in every named environment.",
+          "default": {}
+        },
         "version_metadata": {
           "type": "object",
           "properties": {
@@ -2026,6 +2110,14 @@
           "description": "Specifies a list of Tail Workers that are bound to this Worker environment\n\nNOTE: This field is not automatically inherited from the top level environment, and so must be specified in every named environment.",
           "default": []
         },
+        "streaming_tail_consumers": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/StreamingTailConsumer"
+          },
+          "description": "Specifies a list of Streaming Tail Workers that are bound to this Worker environment\n\nNOTE: This field is not automatically inherited from the top level environment, and so must be specified in every named environment.",
+          "default": []
+        },
         "dispatch_namespaces": {
           "type": "array",
           "items": {
@@ -2524,33 +2616,31 @@
     "Json": {
       "anyOf": [
         {
-          "$ref": "#/definitions/Literal"
+          "type": "string"
         },
         {
-          "type": "object",
-          "additionalProperties": {
-            "$ref": "#/definitions/Json"
-          }
+          "type": "number"
+        },
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "null"
         },
         {
           "type": "array",
           "items": {
             "$ref": "#/definitions/Json"
           }
+        },
+        {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/definitions/Json"
+          }
         }
       ]
     },
-    "Literal": {
-      "$ref": "#/definitions/TypeOf%3CZodUnion%3C%5Bdef-class-1315922706-6501-8772-1315922706-0-54395%2Cdef-class-1315922706-9299-10989-1315922706-0-54395%2Cdef-class-1315922706-12937-13365-1315922706-0-54395%2Cdef-class-1315922706-15083-15273-1315922706-0-54395%5D%3E%3E"
-    },
-    "TypeOf<ZodUnion<[def-class-1315922706-6501-8772-1315922706-0-54395,def-class-1315922706-9299-10989-1315922706-0-54395,def-class-1315922706-12937-13365-1315922706-0-54395,def-class-1315922706-15083-15273-1315922706-0-54395]>>": {
-      "type": [
-        "string",
-        "number",
-        "boolean",
-        "null"
-      ]
-    },
     "DurableObjectBindings": {
       "type": "array",
       "items": {
@@ -2625,7 +2715,12 @@
           "enum": [
             "dev",
             "basic",
-            "standard"
+            "standard",
+            "lite",
+            "standard-1",
+            "standard-2",
+            "standard-3",
+            "standard-4"
           ]
         },
         "vcpu": {
@@ -2695,6 +2790,26 @@
               "type": "string",
               "const": "standard"
             },
+            {
+              "type": "string",
+              "const": "lite"
+            },
+            {
+              "type": "string",
+              "const": "standard-1"
+            },
+            {
+              "type": "string",
+              "const": "standard-2"
+            },
+            {
+              "type": "string",
+              "const": "standard-3"
+            },
+            {
+              "type": "string",
+              "const": "standard-4"
+            },
             {
               "type": "object",
               "properties": {
@@ -2711,7 +2826,7 @@
               "additionalProperties": false
             }
           ],
-          "description": "The instance type to be used for the container. Select from one of the following named instance types:  - dev: 1/16 vCPU, 256 MiB memory, and 2 GB disk  - basic: 1/4 vCPU, 1 GiB memory, and 4 GB disk  - standard: 1/2 vCPU, 4 GiB memory, and 4 GB disk\n\nCustomers on an enterprise plan have the additional option to set custom limits.",
+          "description": "The instance type to be used for the container. Select from one of the following named instance types:  - lite: 1/16 vCPU, 256 MiB memory, and 2 GB disk  - basic: 1/4 vCPU, 1 GiB memory, and 4 GB disk  - standard-1: 1/2 vCPU, 4 GiB memory, and 8 GB disk  - standard-2: 1 vCPU, 6 GiB memory, and 12 GB disk  - standard-3: 2 vCPU, 8 GiB memory, and 16 GB disk  - standard-4: 4 vCPU, 12 GiB memory, and 20 GB disk  - dev: 1/16 vCPU, 256 MiB memory, and 2 GB disk (deprecated, use \"lite\" instead)  - standard: 1 vCPU, 4 GiB memory, and 4 GB disk (deprecated, use \"standard-1\" instead)\n\nCustomers on an enterprise plan have the additional option to set custom limits.",
           "default": "dev"
         },
         "rollout_step_percentage": {
@@ -2762,6 +2877,19 @@
       ],
       "additionalProperties": false
     },
+    "StreamingTailConsumer": {
+      "type": "object",
+      "properties": {
+        "service": {
+          "type": "string",
+          "description": "The name of the service streaming tail events will be forwarded to."
+        }
+      },
+      "required": [
+        "service"
+      ],
+      "additionalProperties": false
+    },
     "DispatchNamespaceOutbound": {
       "type": "object",
       "properties": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wrangler",
-  "version": "4.40.2",
+  "version": "4.51.0",
   "description": "Command-line interface for all things Cloudflare Workers",
   "keywords": [
     "wrangler",
@@ -53,25 +53,27 @@
     "blake3-wasm": "2.1.5",
     "esbuild": "0.25.4",
     "path-to-regexp": "6.3.0",
-    "unenv": "2.0.0-rc.21",
-    "workerd": "1.20250924.0",
-    "@cloudflare/kv-asset-handler": "0.4.0",
-    "miniflare": "4.20250924.0",
-    "@cloudflare/unenv-preset": "2.7.4"
+    "unenv": "2.0.0-rc.24",
+    "workerd": "1.20251125.0",
+    "@cloudflare/kv-asset-handler": "0.4.1",
+    "@cloudflare/unenv-preset": "2.7.11",
+    "miniflare": "4.20251125.0"
   },
   "devDependencies": {
     "@aws-sdk/client-s3": "^3.721.0",
     "@cloudflare/types": "6.18.4",
-    "@cloudflare/workers-types": "^4.20250924.0",
+    "@cloudflare/workers-types": "^4.20251125.0",
     "@cspotcode/source-map-support": "0.8.1",
-    "@iarna/toml": "^3.0.0",
+    "@netlify/build-info": "^10.0.9",
     "@sentry/node": "^7.86.0",
     "@sentry/types": "^7.86.0",
     "@sentry/utils": "^7.86.0",
     "@types/command-exists": "^1.2.0",
+    "@types/cross-spawn": "^6.0.2",
     "@types/glob-to-regexp": "^0.4.1",
     "@types/is-ci": "^3.0.0",
     "@types/javascript-time-ago": "^2.0.3",
+    "@types/json-diff": "^1.0.3",
     "@types/mime": "^3.0.4",
     "@types/minimatch": "^5.1.2",
     "@types/node": "^20.19.9",
@@ -89,14 +91,16 @@
     "chalk": "^5.2.0",
     "chokidar": "^4.0.1",
     "cli-table3": "^0.6.3",
-    "cloudflare": "^5.1.0",
+    "cloudflare": "^5.2.0",
     "cmd-shim": "^4.1.0",
     "command-exists": "^1.2.9",
     "concurrently": "^8.2.2",
+    "cross-spawn": "^7.0.3",
     "date-fns": "^4.1.0",
     "devtools-protocol": "^0.0.1182435",
     "dotenv": "^16.3.1",
     "dotenv-expand": "^12.0.2",
+    "eslint": "^9.39.1",
     "execa": "^6.1.0",
     "find-up": "^6.3.0",
     "get-port": "^7.0.0",
@@ -105,6 +109,8 @@
     "is-ci": "^3.0.1",
     "itty-time": "^1.0.6",
     "javascript-time-ago": "^2.5.4",
+    "json-diff": "^1.0.6",
+    "jsonc-parser": "^3.2.0",
     "md5-file": "5.0.0",
     "mime": "^3.0.0",
     "minimatch": "^5.1.0",
@@ -112,7 +118,7 @@
     "msw": "2.4.3",
     "node-forge": "^1.3.1",
     "open": "^8.4.0",
-    "p-queue": "^7.2.0",
+    "p-queue": "^9.0.0",
     "patch-console": "^1.0.0",
     "pretty-bytes": "^6.0.0",
     "prompts": "^2.4.2",
@@ -122,6 +128,7 @@
     "semiver": "^1.1.0",
     "shell-quote": "^1.8.1",
     "signal-exit": "^3.0.7",
+    "smol-toml": "^1.5.2",
     "source-map": "^0.6.1",
     "strip-ansi": "^7.1.0",
     "supports-color": "^9.2.2",
@@ -135,18 +142,20 @@
     "vitest": "~3.2.0",
     "vitest-websocket-mock": "^0.4.0",
     "ws": "8.18.0",
-    "xdg-app-paths": "^8.3.0",
     "xxhash-wasm": "^1.0.1",
+    "yaml": "^2.8.1",
     "yargs": "^17.7.2",
-    "@cloudflare/cli": "1.1.2",
-    "@cloudflare/containers-shared": "0.2.10",
-    "@cloudflare/pages-shared": "^0.13.75",
+    "@cloudflare/cli": "1.1.3",
+    "@cloudflare/containers-shared": "0.3.0",
     "@cloudflare/eslint-config-shared": "1.1.0",
+    "@cloudflare/pages-shared": "^0.13.89",
+    "@cloudflare/workers-shared": "0.18.8",
     "@cloudflare/workers-tsconfig": "0.0.0",
-    "@cloudflare/workers-shared": "0.18.8"
+    "@cloudflare/workers-utils": "0.3.0",
+    "@cloudflare/workflows-shared": "0.3.8"
   },
   "peerDependencies": {
-    "@cloudflare/workers-types": "^4.20250924.0"
+    "@cloudflare/workers-types": "^4.20251125.0"
   },
   "peerDependenciesMeta": {
     "@cloudflare/workers-types": {
@@ -157,7 +166,7 @@
     "fsevents": "~2.3.2"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   },
   "volta": {
     "extends": "../../package.json"

package/templates/new-worker-scheduled.js

@@ -1,10 +1,10 @@
 /**
  * Welcome to Cloudflare Workers! This is your first scheduled worker.
  *
- * - Run `wrangler dev --local` in your terminal to start a development server
- * - Run `curl "http://localhost:8787/cdn-cgi/mf/scheduled"` to trigger the scheduled event
+ * - Run `wrangler dev` in your terminal to start a development server
+ * - Run `curl "http://localhost:8787/cdn-cgi/handler/scheduled"` to trigger the scheduled event
  * - Go back to the console to see what your worker has logged
- * - Update the Cron trigger in wrangler.toml (see https://developers.cloudflare.com/workers/wrangler/configuration/#triggers)
+ * - Update the Cron trigger in wrangler.toml (see https://developers.cloudflare.com/workers/configuration/cron-triggers/)
  * - Run `wrangler publish --name my-worker` to publish your worker
  *
  * Learn more at https://developers.cloudflare.com/workers/runtime-apis/scheduled-event/

package/templates/new-worker-scheduled.ts

@@ -1,10 +1,10 @@
 /**
  * Welcome to Cloudflare Workers! This is your first scheduled worker.
  *
- * - Run `wrangler dev --local` in your terminal to start a development server
- * - Run `curl "http://localhost:8787/cdn-cgi/mf/scheduled"` to trigger the scheduled event
+ * - Run `wrangler dev` in your terminal to start a development server
+ * - Run `curl "http://localhost:8787/cdn-cgi/handler/scheduled"` to trigger the scheduled event
  * - Go back to the console to see what your worker has logged
- * - Update the Cron trigger in wrangler.toml (see https://developers.cloudflare.com/workers/wrangler/configuration/#triggers)
+ * - Update the Cron trigger in wrangler.toml (see https://developers.cloudflare.com/workers/configuration/cron-triggers/)
  * - Run `wrangler deploy --name my-worker` to deploy your worker
  *
  * Learn more at https://developers.cloudflare.com/workers/runtime-apis/scheduled-event/

package/templates/remoteBindings/ProxyServerWorker.ts

@@ -9,6 +9,39 @@ class BindingNotFoundError extends Error {
 	}
 }
 
+/**
+ * Here be dragons! capnweb does not currently support ReadableStreams, which Media
+ * bindings use for input. As such, Media Bindings cannot be directly used via capnweb,
+ * and need to be special cased.
+ */
+
+function isSpecialCaseMediaBindingRequest(headers: Headers): boolean {
+	return headers.has("x-cf-media-input-options");
+}
+async function evaluateMediaBinding(
+	headers: Headers,
+	stream: ReadableStream,
+	binding: MediaBinding
+): Promise<Response> {
+	const inputOptions = JSON.parse(
+		headers.get("x-cf-media-input-options") as string
+	);
+	const outputOptions = JSON.parse(
+		headers.get("x-cf-media-output-options") as string
+	);
+
+	const result = await binding
+		.input(stream)
+		.transform(inputOptions)
+		.output(outputOptions);
+
+	return new Response(await result.media(), {
+		headers: {
+			"x-cf-media-content-type": await result.contentType(),
+		},
+	});
+}
+
 /**
  * For most bindings, we expose them as
  *  - RPC stubs directly to capnweb, or
@@ -114,6 +147,13 @@ export default {
 						originalHeaders.set(name, value);
 					}
 				}
+				if (isSpecialCaseMediaBindingRequest(originalHeaders)) {
+					return evaluateMediaBinding(
+						originalHeaders,
+						request.body as ReadableStream,
+						fetcher as unknown as MediaBinding
+					);
+				}
 
 				return fetcher.fetch(
 					request.headers.get("MF-URL") ?? "http://example.com",

package/templates/startDevWorker/ProxyWorker.ts

@@ -151,11 +151,12 @@ export class ProxyWorker implements DurableObject {
 
 			// explicitly NOT await-ing this promise, we are in a loop and want to process the whole queue quickly + synchronously
 			void fetch(userWorkerUrl, new Request(request, { headers }))
-				.then((res) => {
+				.then(async (res) => {
 					res = new Response(res.body, res);
 					rewriteUrlRelatedHeaders(res.headers, innerUrl, outerUrl);
 
 					if (isHtmlResponse(res)) {
+						await checkForPreviewTokenError(res, this.env, proxyData);
 						res = insertLiveReloadScript(request, res, this.env, proxyData);
 					}
 
@@ -242,6 +243,28 @@ function sendMessageToProxyController(
 	});
 }
 
+async function checkForPreviewTokenError(
+	response: Response,
+	env: Env,
+	proxyData: ProxyData
+) {
+	if (response.status !== 400) {
+		return;
+	}
+
+	// At this point HTMLRewriter tries to parse the compressed stream,
+	// so we clone and read the text instead.
+	const clone = response.clone();
+	const text = await clone.text();
+	// Naive string match should be good enough when combined with status code check
+	if (text.includes("Invalid Workers Preview configuration")) {
+		void sendMessageToProxyController(env, {
+			type: "previewTokenExpired",
+			proxyData,
+		});
+	}
+}
+
 function insertLiveReloadScript(
 	request: Request,
 	response: Response,
@@ -250,26 +273,8 @@ function insertLiveReloadScript(
 ) {
 	const htmlRewriter = new HTMLRewriter();
 
-	// if preview-token-expired response, errorDetails will contain "Invalid Workers Preview configuration"
-	let errorDetails = "";
-	htmlRewriter.on("#cf-error-details", {
-		text(element) {
-			errorDetails += element.text;
-		},
-	});
-
 	htmlRewriter.onDocument({
 		end(end) {
-			if (
-				response.status === 400 &&
-				errorDetails.includes("Invalid Workers Preview configuration")
-			) {
-				void sendMessageToProxyController(env, {
-					type: "previewTokenExpired",
-					proxyData,
-				});
-			}
-
 			// if liveReload enabled, append a script tag
 			// TODO: compare to existing nodejs implementation
 			if (proxyData.liveReload) {

package/wrangler-dist/InspectorProxyWorker.js

@@ -17,12 +17,6 @@ function serialiseError(e) {
 
 // src/api/startDevWorker/utils.ts
 import assert from "node:assert";
-
-// src/utils/assert-never.ts
-function assertNever(_value) {
-}
-
-// src/api/startDevWorker/utils.ts
 function createDeferred(previousDeferred) {
   let resolve, reject;
   const newPromise = new Promise((_resolve, _reject) => {
@@ -44,6 +38,10 @@ function urlFromParts(parts, base = "http://localhost") {
   return url;
 }
 
+// src/utils/assert-never.ts
+function assertNever(_value) {
+}
+
 // templates/startDevWorker/InspectorProxyWorker.ts
 var ALLOWED_HOST_HOSTNAMES = ["127.0.0.1", "[::1]", "localhost"];
 var ALLOWED_ORIGIN_HOSTNAMES = [

package/wrangler-dist/ProxyServerWorker.js

@@ -2412,6 +2412,23 @@ var BindingNotFoundError = class extends Error {
     super(`Binding ${name ? `"${name}"` : ""} not found`);
   }
 };
+function isSpecialCaseMediaBindingRequest(headers) {
+  return headers.has("x-cf-media-input-options");
+}
+async function evaluateMediaBinding(headers, stream, binding) {
+  const inputOptions = JSON.parse(
+    headers.get("x-cf-media-input-options")
+  );
+  const outputOptions = JSON.parse(
+    headers.get("x-cf-media-output-options")
+  );
+  const result = await binding.input(stream).transform(inputOptions).output(outputOptions);
+  return new Response(await result.media(), {
+    headers: {
+      "x-cf-media-content-type": await result.contentType()
+    }
+  });
+}
 function getExposedJSRPCBinding(request, env) {
   const url = new URL(request.url);
   const bindingName = url.searchParams.get("MF-Binding");
@@ -2478,6 +2495,13 @@ var ProxyServerWorker_default = {
             originalHeaders.set(name, value);
           }
         }
+        if (isSpecialCaseMediaBindingRequest(originalHeaders)) {
+          return evaluateMediaBinding(
+            originalHeaders,
+            request.body,
+            fetcher
+          );
+        }
         return fetcher.fetch(
           request.headers.get("MF-URL") ?? "http://example.com",
           new Request(request, {

package/wrangler-dist/ProxyWorker.js

@@ -110,10 +110,11 @@ var ProxyWorker = class {
           headers.set(key, value);
         }
       }
-      void fetch(userWorkerUrl, new Request(request, { headers })).then((res) => {
+      void fetch(userWorkerUrl, new Request(request, { headers })).then(async (res) => {
         res = new Response(res.body, res);
         rewriteUrlRelatedHeaders(res.headers, innerUrl, outerUrl);
         if (isHtmlResponse(res)) {
+          await checkForPreviewTokenError(res, this.env, proxyData);
           res = insertLiveReloadScript(request, res, this.env, proxyData);
         }
         deferredResponse.resolve(res);
@@ -164,22 +165,23 @@ function sendMessageToProxyController(env, message) {
     body: JSON.stringify(message)
   });
 }
+async function checkForPreviewTokenError(response, env, proxyData) {
+  if (response.status !== 400) {
+    return;
+  }
+  const clone = response.clone();
+  const text = await clone.text();
+  if (text.includes("Invalid Workers Preview configuration")) {
+    void sendMessageToProxyController(env, {
+      type: "previewTokenExpired",
+      proxyData
+    });
+  }
+}
 function insertLiveReloadScript(request, response, env, proxyData) {
   const htmlRewriter = new HTMLRewriter();
-  let errorDetails = "";
-  htmlRewriter.on("#cf-error-details", {
-    text(element) {
-      errorDetails += element.text;
-    }
-  });
   htmlRewriter.onDocument({
     end(end) {
-      if (response.status === 400 && errorDetails.includes("Invalid Workers Preview configuration")) {
-        void sendMessageToProxyController(env, {
-          type: "previewTokenExpired",
-          proxyData
-        });
-      }
       if (proxyData.liveReload) {
         const websocketUrl = new URL(request.url);
         websocketUrl.protocol = websocketUrl.protocol === "http:" ? "ws:" : "wss:";