wrangler 4.20.0 → 4.20.2

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",
@@ -305,7 +305,7 @@
           "items": {
             "$ref": "#/definitions/ContainerApp"
           },
-          "description": "Container related configuration",
+          "description": "Container related configuration\n\nNOTE: This field is not automatically inherited from the top level environment, and so must be specified in every named environment.",
           "default": []
         },
         "kv_namespaces": {
@@ -1169,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",
@@ -1311,7 +1311,7 @@
           "items": {
             "$ref": "#/definitions/ContainerApp"
           },
-          "description": "Container related configuration",
+          "description": "Container related configuration\n\nNOTE: This field is not automatically inherited from the top level environment, and so must be specified in every named environment.",
           "default": []
         },
         "kv_namespaces": {
@@ -2462,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": [
@@ -2564,9 +2557,45 @@
           "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
+        },
+        "container_engine": {
+          "$ref": "#/definitions/ContainerEngine",
+          "description": "Either the Docker unix socket i.e. `unix:/var/run/docker.sock` or a full configuration. Note that windows is only supported via WSL at the moment"
         }
       },
       "additionalProperties": false
+    },
+    "ContainerEngine": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "localDocker": {
+              "$ref": "#/definitions/DockerConfiguration"
+            }
+          },
+          "required": [
+            "localDocker"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "string"
+        }
+      ]
+    },
+    "DockerConfiguration": {
+      "type": "object",
+      "properties": {
+        "socketPath": {
+          "type": "string",
+          "description": "Socket used by miniflare to communicate with Docker"
+        }
+      },
+      "required": [
+        "socketPath"
+      ],
+      "additionalProperties": false
     }
   },
   "allowTrailingCommas": true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wrangler",
-  "version": "4.20.0",
+  "version": "4.20.2",
   "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.20250617.0",
     "@cloudflare/kv-asset-handler": "0.4.0",
-    "miniflare": "4.20250604.1"
+    "miniflare": "4.20250617.0"
   },
   "devDependencies": {
     "@aws-sdk/client-s3": "^3.721.0",
     "@cloudflare/types": "6.18.4",
-    "@cloudflare/workers-types": "^4.20250604.0",
+    "@cloudflare/workers-types": "^4.20250617.0",
     "@cspotcode/source-map-support": "0.8.1",
     "@iarna/toml": "^3.0.0",
     "@sentry/node": "^7.86.0",
@@ -138,12 +138,12 @@
     "@cloudflare/cli": "1.1.1",
     "@cloudflare/containers-shared": "0.1.0",
     "@cloudflare/eslint-config-worker": "1.1.0",
-    "@cloudflare/pages-shared": "^0.13.45",
+    "@cloudflare/pages-shared": "^0.13.47",
     "@cloudflare/workers-shared": "0.17.6",
     "@cloudflare/workers-tsconfig": "0.0.0"
   },
   "peerDependencies": {
-    "@cloudflare/workers-types": "^4.20250604.0"
+    "@cloudflare/workers-types": "^4.20250617.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;
@@ -502,6 +500,9 @@ interface EnvironmentNonInheritable {
     /**
      * Container related configuration
      *
+     * NOTE: This field is not automatically inherited from the top level environment,
+     * and so must be specified in every named environment.
+     *
      * @default []
      * @nonInheritable
      */
@@ -986,6 +987,13 @@ interface Observability {
         invocation_logs?: boolean;
     };
 }
+type DockerConfiguration = {
+    /** Socket used by miniflare to communicate with Docker */
+    socketPath: string;
+};
+type ContainerEngine = {
+    localDocker: DockerConfiguration;
+} | string;
 
 /**
  * This is the static type definition for the configuration object.
@@ -1191,6 +1199,11 @@ interface DevConfig {
      * @default true
      */
     enable_containers: boolean;
+    /**
+     * Either the Docker unix socket i.e. `unix:/var/run/docker.sock` or a full configuration.
+     * Note that windows is only supported via WSL at the moment
+     */
+    container_engine: ContainerEngine | undefined;
 }
 type RawDevConfig = Partial<DevConfig>;
 interface EnvironmentMap {
@@ -1225,6 +1238,7 @@ type NormalizeAndValidateConfigArgs = {
     upstreamProtocol?: string;
     script?: string;
     enableContainers?: boolean;
+    containerEngine?: ContainerEngine;
 };
 
 type ReadConfigCommandArgs = NormalizeAndValidateConfigArgs & {
@@ -1551,6 +1565,7 @@ interface Unstable_DevOptions {
         enableIpc?: boolean;
         enableContainers?: boolean;
         dockerPath?: string;
+        containerEngine?: string;
     };
 }
 interface Unstable_DevWorker {
@@ -1817,7 +1832,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"];
@@ -1892,12 +1907,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. */
@@ -1942,6 +1957,8 @@ interface StartDevWorkerInput {
         enableContainers?: boolean;
         /** Path to the docker executable. Defaults to 'docker' */
         dockerPath?: string;
+        /** Options for the container engine */
+        containerEngine?: ContainerEngine;
     };
     legacy?: {
         site?: Hook<Config["site"], [Config]>;
@@ -2120,7 +2137,7 @@ type ReadyEvent = {
     type: "ready";
     proxyWorker: Miniflare;
     url: URL;
-    inspectorUrl: URL;
+    inspectorUrl: URL | undefined;
 };
 type ProxyWorkerIncomingRequestBody = {
     type: "play";
@@ -2169,7 +2186,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;
@@ -2260,7 +2277,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;
@@ -2429,6 +2446,28 @@ type StartMixedModeSessionOptions = {
 };
 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;
@@ -2485,4 +2524,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, 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 };
+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 };