wrangler 4.19.2 → 4.20.1

package/config-schema.json

@@ -163,8 +163,8 @@
         },
         "keep_names": {
           "type": "boolean",
-          "description": "Keep function names after javascript transpilations.",
-          "default": "{true}"
+          "description": "Set the `name` property to the original name for functions and classes renamed during minification.\n\nSee https://esbuild.github.io/api/#keep-names",
+          "default": true
         },
         "first_party_worker": {
           "type": "boolean",
@@ -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."
@@ -1143,8 +1169,8 @@
         },
         "keep_names": {
           "type": "boolean",
-          "description": "Keep function names after javascript transpilations.",
-          "default": "{true}"
+          "description": "Set the `name` property to the original name for functions and classes renamed during minification.\n\nSee https://esbuild.github.io/api/#keep-names",
+          "default": true
         },
         "first_party_worker": {
           "type": "boolean",
@@ -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
@@ -2400,13 +2462,6 @@
             "full_manual"
           ],
           "description": "How a rollout should be created. It supports the following modes:  - full_auto: The container application will be rolled out fully automatically.  - none: The container application won't have a roll out or update.  - manual: The container application will be rollout fully by manually actioning progress steps."
-        },
-        "dev_exposed_ports": {
-          "type": "array",
-          "items": {
-            "type": "number"
-          },
-          "description": "Ports to be exposed by the container application. Only applies to dev, on non-linux machines, and if the Dockerfile doesn't already declare exposed ports."
         }
       },
       "required": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wrangler",
-  "version": "4.19.2",
+  "version": "4.20.1",
   "description": "Command-line interface for all things Cloudflare Workers",
   "keywords": [
     "wrangler",
@@ -50,19 +50,19 @@
     "config-schema.json"
   ],
   "dependencies": {
-    "@cloudflare/unenv-preset": "2.3.2",
+    "@cloudflare/unenv-preset": "2.3.3",
     "blake3-wasm": "2.1.5",
     "esbuild": "0.25.4",
     "path-to-regexp": "6.3.0",
     "unenv": "2.0.0-rc.17",
-    "workerd": "1.20250604.0",
+    "workerd": "1.20250612.0",
     "@cloudflare/kv-asset-handler": "0.4.0",
-    "miniflare": "4.20250604.0"
+    "miniflare": "4.20250612.0"
   },
   "devDependencies": {
     "@aws-sdk/client-s3": "^3.721.0",
     "@cloudflare/types": "6.18.4",
-    "@cloudflare/workers-types": "^4.20250604.0",
+    "@cloudflare/workers-types": "^4.20250612.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.44",
+    "@cloudflare/pages-shared": "^0.13.46",
     "@cloudflare/workers-shared": "0.17.6",
     "@cloudflare/workers-tsconfig": "0.0.0"
   },
   "peerDependencies": {
-    "@cloudflare/workers-types": "^4.20250604.0"
+    "@cloudflare/workers-types": "^4.20250612.0"
   },
   "peerDependenciesMeta": {
     "@cloudflare/workers-types": {

package/wrangler-dist/cli.d.ts

@@ -1,4 +1,4 @@
-import { Json, DispatchFetch, WorkerOptions, NodeJSCompatMode, Request, Response as Response$1, Miniflare, MiniflareOptions, Mutex, ModuleRule, MixedModeConnectionString } from 'miniflare';
+import { Json, Request, Response as Response$1, DispatchFetch, WorkerOptions, NodeJSCompatMode, Miniflare, MiniflareOptions, Mutex, ModuleRule, MixedModeConnectionString } from 'miniflare';
 import * as undici from 'undici';
 import { RequestInfo, RequestInit, Response, FormData } from 'undici';
 import { RouterConfig, AssetConfig } from '@cloudflare/workers-shared';
@@ -100,10 +100,6 @@ type ContainerApp = {
      *  - manual: The container application will be rollout fully by manually actioning progress steps.
      */
     rollout_kind?: "full_auto" | "none" | "full_manual";
-    /**
-     * Ports to be exposed by the container application. Only applies to dev, on non-linux machines, and if the Dockerfile doesn't already declare exposed ports.
-     */
-    dev_exposed_ports?: number[];
 };
 /**
  * Configuration in wrangler for Durable Object Migrations
@@ -328,9 +324,11 @@ interface EnvironmentInheritable {
      */
     minify: boolean | undefined;
     /**
-     * Keep function names after javascript transpilations.
+     * Set the `name` property to the original name for functions and classes renamed during minification.
      *
-     * @default {true}
+     * See https://esbuild.github.io/api/#keep-names
+     *
+     * @default true
      * @inheritable
      */
     keep_names: boolean | undefined;
@@ -838,6 +836,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
@@ -902,6 +902,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.
@@ -950,10 +965,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 */
@@ -1359,6 +1375,10 @@ interface CfSecretsStoreSecrets {
     store_id: string;
     secret_name: string;
 }
+interface CfHelloWorld {
+    binding: string;
+    enable_timer?: boolean;
+}
 interface CfHyperdrive {
     binding: string;
     id: string;
@@ -1389,6 +1409,7 @@ interface CfDispatchNamespace {
 interface CfMTlsCertificate {
     binding: string;
     certificate_id: string;
+    remote?: boolean;
 }
 interface CfLogfwdrBinding {
     name: string;
@@ -1706,6 +1727,7 @@ type AssetsOptions = {
     assetConfig: AssetConfig;
     _redirects?: string;
     _headers?: string;
+    run_worker_first?: boolean | string[];
 };
 
 type ApiCredentials = {
@@ -1793,7 +1815,7 @@ type MiniflareWorker = Awaited<ReturnType<Miniflare["getWorker"]>>;
 interface Worker {
     ready: Promise<void>;
     url: Promise<URL>;
-    inspectorUrl: Promise<URL>;
+    inspectorUrl: Promise<URL | undefined>;
     config: StartDevWorkerOptions;
     setConfig: ConfigController["set"];
     patchConfig: ConfigController["patch"];
@@ -1868,12 +1890,12 @@ interface StartDevWorkerInput {
     };
     /** Options applying to the worker's development preview environment. */
     dev?: {
-        /** Options applying to the worker's inspector server. */
+        /** Options applying to the worker's inspector server. False disables the inspector server. */
         inspector?: {
             hostname?: string;
             port?: number;
             secure?: boolean;
-        };
+        } | false;
         /** Whether the worker runs on the edge or locally. Can also be set to "minimal" for minimal mode. */
         remote?: boolean | "minimal";
         /** Cloudflare Account credentials. Can be provided upfront or as a function which will be called only when required. */
@@ -2041,7 +2063,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";
@@ -2094,7 +2118,7 @@ type ReadyEvent = {
     type: "ready";
     proxyWorker: Miniflare;
     url: URL;
-    inspectorUrl: URL;
+    inspectorUrl: URL | undefined;
 };
 type ProxyWorkerIncomingRequestBody = {
     type: "play";
@@ -2143,7 +2167,7 @@ type UrlOriginParts = Pick<URL, "protocol" | "hostname" | "port">;
 type UrlOriginAndPathnameParts = Pick<URL, "protocol" | "hostname" | "port" | "pathname">;
 type ProxyData = {
     userWorkerUrl: UrlOriginParts;
-    userWorkerInspectorUrl: UrlOriginAndPathnameParts;
+    userWorkerInspectorUrl?: UrlOriginAndPathnameParts;
     userWorkerInnerUrlOverrides?: Partial<UrlOriginParts>;
     headers: Record<string, string>;
     liveReload?: boolean;
@@ -2234,7 +2258,7 @@ declare class ProxyController extends Controller<ProxyControllerEventMap> {
     onInspectorProxyWorkerRequest(message: InspectorProxyWorkerOutgoingRequestBody): Promise<Response$1>;
     _torndown: boolean;
     teardown(): Promise<void>;
-    emitReadyEvent(proxyWorker: Miniflare, url: URL, inspectorUrl: URL): void;
+    emitReadyEvent(proxyWorker: Miniflare, url: URL, inspectorUrl: URL | undefined): void;
     emitPreviewTokenExpiredEvent(proxyData: ProxyData): void;
     emitErrorEvent(data: ErrorEvent): void;
     emitErrorEvent(reason: string, cause?: Error | SerializedError): void;
@@ -2395,12 +2419,36 @@ 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>;
+/**
+ * Utility for potentially starting or updating a mixed mode session.
+ *
+ * It uses an internal map for storing existing mixed mode session indexed by worker names. If no worker name is provided
+ * the mixed mode session won't be retrieved nor saved to/from the internal map.
+ *
+ * @param configPathOrWorkerConfig either a file path to a wrangler configuration file or an object containing the name of
+ *                                 the target worker alongside its bindings.
+ * @param preExistingMixedModeSessionData the data of a pre-existing mixed mode session if there was one null otherwise
+ * @returns null if no existing mixed mode session was provided and one should not be created (because the worker is not
+ *          defining any remote bindings), the data associated to the created/updated mixed mode session otherwise.
+ */
+declare function maybeStartOrUpdateMixedModeSession(configPathOrWorkerConfig: string | {
+    name?: string;
+    bindings: NonNullable<StartDevWorkerInput["bindings"]>;
+}, preExistingMixedModeSessionData: {
+    session: MixedModeSession;
+    remoteBindings: Record<string, Binding>;
+} | null): Promise<{
+    session: MixedModeSession;
+    remoteBindings: Record<string, Binding>;
+} | null>;
 
 declare const LOGGER_LEVELS: {
     readonly none: -1;
@@ -2457,4 +2505,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 Binding as Unstable_Binding, 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, maybeStartOrUpdateMixedModeSession as experimental_maybeStartOrUpdateMixedModeSession, 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 };