wrangler 4.43.0 → 4.45.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": {
@@ -1397,6 +1435,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 +1927,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": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wrangler",
-  "version": "4.43.0",
+  "version": "4.45.0",
   "description": "Command-line interface for all things Cloudflare Workers",
   "keywords": [
     "wrangler",
@@ -54,15 +54,15 @@
     "esbuild": "0.25.4",
     "path-to-regexp": "6.3.0",
     "unenv": "2.0.0-rc.21",
-    "workerd": "1.20251008.0",
+    "workerd": "1.20251011.0",
     "@cloudflare/kv-asset-handler": "0.4.0",
-    "@cloudflare/unenv-preset": "2.7.7",
-    "miniflare": "4.20251008.0"
+    "@cloudflare/unenv-preset": "2.7.8",
+    "miniflare": "4.20251011.1"
   },
   "devDependencies": {
     "@aws-sdk/client-s3": "^3.721.0",
     "@cloudflare/types": "6.18.4",
-    "@cloudflare/workers-types": "^4.20251008.0",
+    "@cloudflare/workers-types": "^4.20251011.0",
     "@cspotcode/source-map-support": "0.8.1",
     "@iarna/toml": "^3.0.0",
     "@sentry/node": "^7.86.0",
@@ -72,6 +72,7 @@
     "@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",
@@ -105,6 +106,7 @@
     "is-ci": "^3.0.1",
     "itty-time": "^1.0.6",
     "javascript-time-ago": "^2.5.4",
+    "json-diff": "^1.0.6",
     "md5-file": "5.0.0",
     "mime": "^3.0.0",
     "minimatch": "^5.1.0",
@@ -140,15 +142,15 @@
     "yaml": "^2.8.1",
     "yargs": "^17.7.2",
     "@cloudflare/cli": "1.1.3",
-    "@cloudflare/containers-shared": "0.2.12",
+    "@cloudflare/containers-shared": "0.2.13",
     "@cloudflare/eslint-config-shared": "1.1.0",
-    "@cloudflare/pages-shared": "^0.13.79",
-    "@cloudflare/workers-shared": "0.18.8",
+    "@cloudflare/pages-shared": "^0.13.81",
     "@cloudflare/workers-tsconfig": "0.0.0",
-    "@cloudflare/workflows-shared": "0.3.7"
+    "@cloudflare/workers-shared": "0.18.8",
+    "@cloudflare/workflows-shared": "0.3.8"
   },
   "peerDependencies": {
-    "@cloudflare/workers-types": "^4.20251008.0"
+    "@cloudflare/workers-types": "^4.20251011.0"
   },
   "peerDependenciesMeta": {
     "@cloudflare/workers-types": {

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/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/cli.d.ts

@@ -532,6 +532,21 @@ interface EnvironmentInheritable {
      * it can be set to `undefined` in configuration to delegate to the CLOUDFLARE_COMPLIANCE_REGION environment variable.
      */
     compliance_region: "public" | "fedramp_high" | undefined;
+    /**
+     * Configuration for Python modules.
+     *
+     * @inheritable
+     */
+    python_modules: {
+        /**
+         * A list of glob patterns to exclude files from the python_modules directory when bundling.
+         *
+         * Patterns are relative to the python_modules directory and use glob syntax.
+         *
+         * @default ["**\*.pyc"]
+         */
+        exclude: string[];
+    };
 }
 type DurableObjectBindings = {
     /** The name of the binding used to refer to the Durable Object */
@@ -915,6 +930,20 @@ interface EnvironmentNonInheritable {
         /** Whether the Images binding should be remote or not in local development */
         remote?: boolean;
     } | undefined;
+    /**
+     * Binding to Cloudflare Media Transformations
+     *
+     * NOTE: This field is not automatically inherited from the top level environment,
+     * and so must be specified in every named environment.
+     *
+     * @default {}
+     * @nonInheritable
+     */
+    media: {
+        binding: string;
+        /** Whether the Media binding should be remote or not */
+        remote?: boolean;
+    } | undefined;
     /**
      * Binding to the Worker Version's metadata
      */
@@ -1321,6 +1350,13 @@ interface CfImagesBinding {
     raw?: boolean;
     remote?: boolean;
 }
+/**
+ * A binding to Cloudflare Media Transformations
+ */
+interface CfMediaBinding {
+    binding: string;
+    remote?: boolean;
+}
 /**
  * A Durable Object.
  */
@@ -1747,7 +1783,6 @@ interface CommonYargsOptions {
     env: string | undefined;
     "env-file": string[] | undefined;
     "experimental-provision": boolean | undefined;
-    "experimental-remote-bindings": boolean | undefined;
     "experimental-auto-create": boolean;
 }
 type CommonYargsArgv = Argv<CommonYargsOptions>;
@@ -1867,8 +1902,6 @@ interface Unstable_DevOptions {
         watch?: boolean;
         devEnv?: boolean;
         fileBasedRegistry?: boolean;
-        vectorizeBindToProd?: boolean;
-        imagesLocalMode?: boolean;
         enableIpc?: boolean;
         enableContainers?: boolean;
         dockerPath?: string;
@@ -2169,6 +2202,11 @@ interface StartDevWorkerInput {
     compatibilityFlags?: string[];
     /** Specify the compliance region mode of the Worker. */
     complianceRegion?: Config["compliance_region"];
+    /** Configuration for Python modules. */
+    pythonModules?: {
+        /** A list of glob patterns to exclude files from the python_modules directory when bundling. */
+        exclude?: string[];
+    };
     env?: string;
     /**
      * An array of paths to the .env files to load for this worker, relative to the project directory.
@@ -2231,7 +2269,11 @@ interface StartDevWorkerInput {
             port?: number;
             secure?: boolean;
         } | false;
-        /** Whether the worker runs on the edge or locally. Can also be set to "minimal" for minimal mode. */
+        /** Whether the worker runs on the edge or locally. This has several options:
+         *   - true | "minimal": Run your Worker's code & bindings in a remote preview session, optionally using minimal mode as an internal detail
+         *   - false: Run your Worker's code & bindings in a local simulator
+         *   - undefined (default): Run your Worker's code locally, and any configured remote bindings remotely
+         */
         remote?: boolean | "minimal";
         /** Cloudflare Account credentials. Can be provided upfront or as a function which will be called only when required. */
         auth?: AsyncHook<CfAccount, [Pick<Config, "account_id">]>;
@@ -2261,14 +2303,8 @@ interface StartDevWorkerInput {
         /** An undici MockAgent to declaratively mock fetch calls to particular resources. */
         mockFetch?: undici.MockAgent;
         testScheduled?: boolean;
-        /** Whether to use Vectorize as a remote binding -- the worker is run locally but accesses to Vectorize are made remotely */
-        bindVectorizeToProd?: boolean;
-        /** Whether to use Images local mode -- this is lower fidelity, but doesn't require network access */
-        imagesLocalMode?: boolean;
         /** Treat this as the primary worker in a multiworker setup (i.e. the first Worker in Miniflare's options) */
         multiworkerPrimary?: boolean;
-        /** Whether the experimental remote bindings feature should be enabled */
-        experimentalRemoteBindings?: boolean;
         containerBuildId?: string;
         /** Whether to build and connect to containers during local dev. Requires Docker daemon to be running. Defaults to true. */
         enableContainers?: boolean;
@@ -2281,7 +2317,7 @@ interface StartDevWorkerInput {
     };
     legacy?: {
         site?: Hook<Config["site"], [Config]>;
-        enableServiceEnvironments?: boolean;
+        useServiceEnvironments?: boolean;
     };
     unsafe?: Omit<CfUnsafe, "bindings">;
     assets?: string;
@@ -2410,7 +2446,9 @@ type Binding = {
     type: "worker_loader";
 } & BindingOmit<CfWorkerLoader>) | ({
     type: "vpc_service";
-} & BindingOmit<CfVpcService>) | {
+} & BindingOmit<CfVpcService>) | ({
+    type: "media";
+} & BindingOmit<CfMediaBinding>) | {
     type: `unsafe_${string}`;
 } | {
     type: "assets";
@@ -2751,13 +2789,6 @@ type GetPlatformProxyOptions = {
     persist?: boolean | {
         path: string;
     };
-    /**
-     * Experimental flags (note: these can change at any time and are not version-controlled use at your own risk)
-     */
-    experimental?: {
-        /** whether access to remove bindings should be enabled */
-        remoteBindings?: boolean;
-    };
 };
 /**
  * Result of the `getPlatformProxy` utility
@@ -2803,9 +2834,7 @@ interface Unstable_MiniflareWorkerOptions {
     externalWorkers: WorkerOptions[];
 }
 declare function unstable_getMiniflareWorkerOptions(configPath: string, env?: string, options?: {
-    imagesLocalMode?: boolean;
     remoteProxyConnectionString?: RemoteProxyConnectionString;
-    remoteBindingsEnabled?: boolean;
     overrides?: {
         assets?: Partial<AssetsOptions>;
         enableContainers?: boolean;
@@ -2813,9 +2842,7 @@ declare function unstable_getMiniflareWorkerOptions(configPath: string, env?: st
     containerBuildId?: string;
 }): Unstable_MiniflareWorkerOptions;
 declare function unstable_getMiniflareWorkerOptions(config: Config, env?: string, options?: {
-    imagesLocalMode?: boolean;
     remoteProxyConnectionString?: RemoteProxyConnectionString;
-    remoteBindingsEnabled?: boolean;
     overrides?: {
         assets?: Partial<AssetsOptions>;
         enableContainers?: boolean;
@@ -2967,7 +2994,6 @@ declare function fetchResult<ResponseType>(complianceConfig: ComplianceConfig, r
 type ExperimentalFlags = {
     MULTIWORKER: boolean;
     RESOURCES_PROVISION: boolean;
-    REMOTE_BINDINGS: boolean;
     DEPLOY_REMOTE_DIFF_CHECK: boolean;
     AUTOCREATE_RESOURCES: boolean;
 };
@@ -3213,16 +3239,10 @@ declare function createCLIParser(argv: string[]): {
             readonly array: true;
             readonly requiresArg: true;
         };
-        readonly "experimental-remote-bindings": {
-            readonly describe: "Experimental: Enable Remote Bindings";
-            readonly type: "boolean";
-            readonly hidden: true;
-            readonly default: true;
-            readonly alias: readonly ["x-remote-bindings"];
-        };
         readonly "experimental-provision": {
             readonly describe: "Experimental: Enable automatic resource provisioning";
             readonly type: "boolean";
+            readonly default: true;
             readonly hidden: true;
             readonly alias: readonly ["x-provision"];
         };