wrangler 4.19.1 → 4.20.0

package/config-schema.json

@@ -807,6 +807,10 @@
               "certificate_id": {
                 "type": "string",
                 "description": "The uuid of the uploaded mTLS certificate"
+              },
+              "remote": {
+                "type": "boolean",
+                "description": "Whether the mtls fetcher should be remote or not (only available under `--x-mixed-mode`)"
               }
             },
             "required": [
@@ -908,6 +912,28 @@
           "description": "Specifies Secret Store bindings 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": []
         },
+        "unsafe_hello_world": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "binding": {
+                "type": "string",
+                "description": "The binding name used to refer to the bound service."
+              },
+              "enable_timer": {
+                "type": "boolean",
+                "description": "Whether the timer is enabled"
+              }
+            },
+            "required": [
+              "binding"
+            ],
+            "additionalProperties": false
+          },
+          "description": "**DO NOT USE**. Hello World Binding Config to serve as an explanatory example.\n\nNOTE: This field is not automatically inherited from the top level environment, and so must be specified in every named environment.",
+          "default": []
+        },
         "pages_build_output_dir": {
           "type": "string",
           "description": "The directory of static assets to serve.\n\nThe presence of this field in a Wrangler configuration file indicates a Pages project, and will prompt the handling of the configuration file according to the Pages-specific validation rules."
@@ -1787,6 +1813,10 @@
               "certificate_id": {
                 "type": "string",
                 "description": "The uuid of the uploaded mTLS certificate"
+              },
+              "remote": {
+                "type": "boolean",
+                "description": "Whether the mtls fetcher should be remote or not (only available under `--x-mixed-mode`)"
               }
             },
             "required": [
@@ -1887,6 +1917,28 @@
           },
           "description": "Specifies Secret Store bindings 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": []
+        },
+        "unsafe_hello_world": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "binding": {
+                "type": "string",
+                "description": "The binding name used to refer to the bound service."
+              },
+              "enable_timer": {
+                "type": "boolean",
+                "description": "Whether the timer is enabled"
+              }
+            },
+            "required": [
+              "binding"
+            ],
+            "additionalProperties": false
+          },
+          "description": "**DO NOT USE**. Hello World Binding Config to serve as an explanatory example.\n\nNOTE: This field is not automatically inherited from the top level environment, and so must be specified in every named environment.",
+          "default": []
         }
       },
       "additionalProperties": false,
@@ -2097,8 +2149,18 @@
           "description": "How to handle requests that do not match an asset."
         },
         "run_worker_first": {
-          "type": "boolean",
-          "description": "If true, route every request to the User Worker, whether or not it matches an asset. If false, then respond to requests that match an asset with that asset directly."
+          "anyOf": [
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            {
+              "type": "boolean"
+            }
+          ],
+          "description": "Matches will be routed to the User Worker, and matches to negative rules will go to the Asset Worker.\n\nCan also be `true`, indicating that every request should be routed to the User Worker."
         }
       },
       "additionalProperties": false
@@ -2335,6 +2397,18 @@
                 ],
                 "additionalProperties": false
               }
+            },
+            "disk": {
+              "type": "object",
+              "properties": {
+                "size": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "size"
+              ],
+              "additionalProperties": false
             }
           },
           "required": [
@@ -2485,6 +2559,11 @@
         "host": {
           "type": "string",
           "description": "Host to forward requests to, defaults to the host of the first route of project"
+        },
+        "enable_containers": {
+          "type": "boolean",
+          "description": "When developing, whether to build and connect to containers. This requires a Docker daemon to be running. Defaults to `true`.",
+          "default": true
         }
       },
       "additionalProperties": false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wrangler",
-  "version": "4.19.1",
+  "version": "4.20.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.17",
-    "workerd": "1.20250525.0",
+    "workerd": "1.20250604.0",
     "@cloudflare/kv-asset-handler": "0.4.0",
-    "miniflare": "4.20250525.1"
+    "miniflare": "4.20250604.1"
   },
   "devDependencies": {
     "@aws-sdk/client-s3": "^3.721.0",
     "@cloudflare/types": "6.18.4",
-    "@cloudflare/workers-types": "^4.20250525.0",
+    "@cloudflare/workers-types": "^4.20250604.0",
     "@cspotcode/source-map-support": "0.8.1",
     "@iarna/toml": "^3.0.0",
     "@sentry/node": "^7.86.0",
@@ -83,7 +83,7 @@
     "@types/supports-color": "^8.1.1",
     "@types/ws": "^8.5.7",
     "@types/yargs": "^17.0.22",
-    "@vitest/ui": "~3.1.1",
+    "@vitest/ui": "~3.2.0",
     "@webcontainer/env": "^1.1.0",
     "chalk": "^5.2.0",
     "chokidar": "^4.0.1",
@@ -129,20 +129,21 @@
     "typescript": "^5.7.2",
     "undici": "^5.28.5",
     "update-check": "^1.5.4",
-    "vitest": "~3.1.1",
+    "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",
     "yargs": "^17.7.2",
     "@cloudflare/cli": "1.1.1",
+    "@cloudflare/containers-shared": "0.1.0",
     "@cloudflare/eslint-config-worker": "1.1.0",
-    "@cloudflare/pages-shared": "^0.13.43",
-    "@cloudflare/workers-shared": "0.17.5",
+    "@cloudflare/pages-shared": "^0.13.45",
+    "@cloudflare/workers-shared": "0.17.6",
     "@cloudflare/workers-tsconfig": "0.0.0"
   },
   "peerDependencies": {
-    "@cloudflare/workers-types": "^4.20250525.0"
+    "@cloudflare/workers-types": "^4.20250604.0"
   },
   "peerDependenciesMeta": {
     "@cloudflare/workers-types": {

package/wrangler-dist/cli.d.ts

@@ -78,6 +78,9 @@ type ContainerApp = {
             type: "env";
             secret: string;
         }[];
+        disk?: {
+            size: string;
+        };
     };
     /** Scheduling constraints */
     constraints?: {
@@ -835,6 +838,8 @@ interface EnvironmentNonInheritable {
         binding: string;
         /** The uuid of the uploaded mTLS certificate */
         certificate_id: string;
+        /** Whether the mtls fetcher should be remote or not (only available under `--x-mixed-mode`) */
+        remote?: boolean;
     }[];
     /**
      * Specifies a list of Tail Workers that are bound to this Worker environment
@@ -899,6 +904,21 @@ interface EnvironmentNonInheritable {
         /** Name of the secret */
         secret_name: string;
     }[];
+    /**
+     * **DO NOT USE**. Hello World Binding Config to serve as an explanatory example.
+     *
+     * NOTE: This field is not automatically inherited from the top level environment,
+     * and so must be specified in every named environment.
+     *
+     * @default []
+     * @nonInheritable
+     */
+    unsafe_hello_world: {
+        /** The binding name used to refer to the bound service. */
+        binding: string;
+        /** Whether the timer is enabled */
+        enable_timer?: boolean;
+    }[];
 }
 /**
  * The raw environment configuration that we read from the config file.
@@ -947,10 +967,11 @@ type Assets = {
     /** How to handle requests that do not match an asset. */
     not_found_handling?: "single-page-application" | "404-page" | "none";
     /**
-     * If true, route every request to the User Worker, whether or not it matches an asset.
-     * If false, then respond to requests that match an asset with that asset directly.
-     * */
-    run_worker_first?: boolean;
+     * Matches will be routed to the User Worker, and matches to negative rules will go to the Asset Worker.
+     *
+     * Can also be `true`, indicating that every request should be routed to the User Worker.
+     */
+    run_worker_first?: string[] | boolean;
 };
 interface Observability {
     /** If observability is enabled for this Worker */
@@ -1162,6 +1183,14 @@ interface DevConfig {
      * Host to forward requests to, defaults to the host of the first route of project
      */
     host: string | undefined;
+    /**
+     * When developing, whether to build and connect to containers. This requires a Docker daemon to be running.
+     * Defaults to `true`.
+     *
+     * @inheritable
+     * @default true
+     */
+    enable_containers: boolean;
 }
 type RawDevConfig = Partial<DevConfig>;
 interface EnvironmentMap {
@@ -1195,6 +1224,7 @@ type NormalizeAndValidateConfigArgs = {
     localProtocol?: string;
     upstreamProtocol?: string;
     script?: string;
+    enableContainers?: boolean;
 };
 
 type ReadConfigCommandArgs = NormalizeAndValidateConfigArgs & {
@@ -1347,6 +1377,10 @@ interface CfSecretsStoreSecrets {
     store_id: string;
     secret_name: string;
 }
+interface CfHelloWorld {
+    binding: string;
+    enable_timer?: boolean;
+}
 interface CfHyperdrive {
     binding: string;
     id: string;
@@ -1377,6 +1411,7 @@ interface CfDispatchNamespace {
 interface CfMTlsCertificate {
     binding: string;
     certificate_id: string;
+    remote?: boolean;
 }
 interface CfLogfwdrBinding {
     name: string;
@@ -1514,6 +1549,8 @@ interface Unstable_DevOptions {
         vectorizeBindToProd?: boolean;
         imagesLocalMode?: boolean;
         enableIpc?: boolean;
+        enableContainers?: boolean;
+        dockerPath?: string;
     };
 }
 interface Unstable_DevWorker {
@@ -1692,6 +1729,7 @@ type AssetsOptions = {
     assetConfig: AssetConfig;
     _redirects?: string;
     _headers?: string;
+    run_worker_first?: boolean | string[];
 };
 
 type ApiCredentials = {
@@ -1898,6 +1936,12 @@ interface StartDevWorkerInput {
         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 mixed mode feature should be enabled */
+        experimentalMixedMode?: boolean;
+        /** Whether to build and connect to containers during local dev. Requires Docker daemon to be running. Defaults to true. */
+        enableContainers?: boolean;
+        /** Path to the docker executable. Defaults to 'docker' */
+        dockerPath?: string;
     };
     legacy?: {
         site?: Hook<Config["site"], [Config]>;
@@ -2021,7 +2065,9 @@ type Binding = {
     type: "secrets_store_secret";
 } & BindingOmit<CfSecretsStoreSecrets>) | ({
     type: "logfwdr";
-} & NameOmit<CfLogfwdrBinding>) | {
+} & NameOmit<CfLogfwdrBinding>) | ({
+    type: "unsafe_hello_world";
+} & BindingOmit<CfHelloWorld>) | {
     type: `unsafe_${string}`;
 } | {
     type: "assets";
@@ -2375,11 +2421,13 @@ type MixedModeSession = Pick<Worker, "ready" | "dispose"> & {
     updateBindings: (bindings: StartDevWorkerInput["bindings"]) => Promise<void>;
     mixedModeConnectionString: MixedModeConnectionString;
 };
-declare function startMixedModeSession(bindings: StartDevWorkerInput["bindings"], options?: {
+type StartMixedModeSessionOptions = {
+    workerName?: string;
     auth?: NonNullable<StartDevWorkerInput["dev"]>["auth"];
     /** If running in a non-public compliance region, set this here. */
     complianceRegion?: Config["compliance_region"];
-}): Promise<MixedModeSession>;
+};
+declare function startMixedModeSession(bindings: StartDevWorkerInput["bindings"], options?: StartMixedModeSessionOptions): Promise<MixedModeSession>;
 declare function pickRemoteBindings(bindings: Record<string, Binding>): Record<string, Binding>;
 
 declare const LOGGER_LEVELS: {
@@ -2437,4 +2485,4 @@ interface Unstable_ASSETSBindingsOptions {
 }
 declare const generateASSETSBinding: (opts: Unstable_ASSETSBindingsOptions) => (request: Request) => Promise<Response$1>;
 
-export { type ConfigBindingOptions as Experimental_ConfigBindingOptions, type MixedModeSession as Experimental_MixedModeSession, type GetPlatformProxyOptions, type PlatformProxy, type SourcelessWorkerOptions, type Unstable_ASSETSBindingsOptions, type Config as Unstable_Config, type Unstable_DevOptions, type Unstable_DevWorker, type Unstable_MiniflareWorkerOptions, type RawConfig as Unstable_RawConfig, type RawEnvironment as Unstable_RawEnvironment, experimental_patchConfig, pickRemoteBindings as experimental_pickRemoteBindings, experimental_readRawConfig, startMixedModeSession as experimental_startMixedModeSession, getPlatformProxy, DevEnv as unstable_DevEnv, convertConfigBindingsToStartWorkerBindings as unstable_convertConfigBindingsToStartWorkerBindings, unstable_dev, generateASSETSBinding as unstable_generateASSETSBinding, unstable_getMiniflareWorkerOptions, unstable_pages, readConfig as unstable_readConfig, splitSqlQuery as unstable_splitSqlQuery, startWorker as unstable_startWorker };
+export { type ConfigBindingOptions as Experimental_ConfigBindingOptions, type MixedModeSession as Experimental_MixedModeSession, type GetPlatformProxyOptions, type PlatformProxy, type SourcelessWorkerOptions, type Unstable_ASSETSBindingsOptions, type Config as Unstable_Config, type Unstable_DevOptions, type Unstable_DevWorker, type Unstable_MiniflareWorkerOptions, type RawConfig as Unstable_RawConfig, type RawEnvironment as Unstable_RawEnvironment, type StartMixedModeSessionOptions as experimental_StartMixedModeSessionOptions, experimental_patchConfig, pickRemoteBindings as experimental_pickRemoteBindings, experimental_readRawConfig, startMixedModeSession as experimental_startMixedModeSession, getPlatformProxy, DevEnv as unstable_DevEnv, convertConfigBindingsToStartWorkerBindings as unstable_convertConfigBindingsToStartWorkerBindings, unstable_dev, generateASSETSBinding as unstable_generateASSETSBinding, unstable_getMiniflareWorkerOptions, unstable_pages, readConfig as unstable_readConfig, splitSqlQuery as unstable_splitSqlQuery, startWorker as unstable_startWorker };