wrangler 4.31.0 → 4.32.0

package/config-schema.json

@@ -605,11 +605,7 @@
               },
               "service": {
                 "type": "string",
-                "description": "The name of the service."
-              },
-              "environment": {
-                "type": "string",
-                "description": "The environment of the service (e.g. production, staging, etc)."
+                "description": "The name of the service. To bind to a worker in a specific environment, you should use the format `<worker_name>-<environment_name>`."
               },
               "entrypoint": {
                 "type": "string",
@@ -1611,11 +1607,7 @@
               },
               "service": {
                 "type": "string",
-                "description": "The name of the service."
-              },
-              "environment": {
-                "type": "string",
-                "description": "The environment of the service (e.g. production, staging, etc)."
+                "description": "The name of the service. To bind to a worker in a specific environment, you should use the format `<worker_name>-<environment_name>`."
               },
               "entrypoint": {
                 "type": "string",
@@ -2390,19 +2382,22 @@
           "default": "dev"
         },
         "rollout_step_percentage": {
-          "type": "number",
-          "description": "How a rollout should be done, defining the size of it",
-          "default": 25
-        },
-        "rollout_kind": {
-          "type": "string",
-          "enum": [
-            "full_auto",
-            "none",
-            "full_manual"
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "number"
+              }
+            }
           ],
-          "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.",
-          "default": "full_auto"
+          "description": "Configures what percentage of instances should be updated at each step of a rollout. You can specify this as a single number, or an array of numbers.\n\nIf this is a single number, each step will progress by that percentage. The options are 5, 10, 20, 25, 50 or 100.\n\nIf this is an array, each step specifies the cumulative rollout progress. The final step must be 100.\n\nThis can be overridden adhoc by deploying with the `--containers-rollout=immediate` flag, which will roll out to 100% of instances in one step.",
+          "default": [
+            10,
+            100
+          ]
         },
         "rollout_active_grace_period": {
           "type": "number",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wrangler",
-  "version": "4.31.0",
+  "version": "4.32.0",
   "description": "Command-line interface for all things Cloudflare Workers",
   "keywords": [
     "wrangler",
@@ -55,9 +55,9 @@
     "path-to-regexp": "6.3.0",
     "unenv": "2.0.0-rc.19",
     "workerd": "1.20250816.0",
-    "miniflare": "4.20250816.0",
+    "@cloudflare/kv-asset-handler": "0.4.0",
     "@cloudflare/unenv-preset": "2.6.2",
-    "@cloudflare/kv-asset-handler": "0.4.0"
+    "miniflare": "4.20250816.1"
   },
   "devDependencies": {
     "@aws-sdk/client-s3": "^3.721.0",
@@ -137,12 +137,12 @@
     "xdg-app-paths": "^8.3.0",
     "xxhash-wasm": "^1.0.1",
     "yargs": "^17.7.2",
-    "@cloudflare/containers-shared": "0.2.10",
-    "@cloudflare/eslint-config-worker": "1.1.0",
     "@cloudflare/cli": "1.1.1",
-    "@cloudflare/pages-shared": "^0.13.64",
     "@cloudflare/workers-tsconfig": "0.0.0",
-    "@cloudflare/workers-shared": "0.18.5"
+    "@cloudflare/eslint-config-worker": "1.1.0",
+    "@cloudflare/pages-shared": "^0.13.65",
+    "@cloudflare/workers-shared": "0.18.6",
+    "@cloudflare/containers-shared": "0.2.10"
   },
   "peerDependencies": {
     "@cloudflare/workers-types": "^4.20250816.0"

package/wrangler-dist/cli.d.ts

@@ -1,11 +1,11 @@
-import { Json, Request, Response as Response$1, DispatchFetch, NodeJSCompatMode, Miniflare, MiniflareOptions, Mutex, WorkerOptions, ModuleRule, RemoteProxyConnectionString } from 'miniflare';
+import { Json, Request, Response as Response$1, DispatchFetch, NodeJSCompatMode, Miniflare, WorkerRegistry, MiniflareOptions, Mutex, WorkerOptions, ModuleRule, RemoteProxyConnectionString } from 'miniflare';
 import * as undici from 'undici';
 import { RequestInfo, RequestInit, Response, FormData } from 'undici';
 import { CamelCaseKey, ArgumentsCamelCase, InferredOptionTypes, Alias, PositionalOptions, Options } from 'yargs';
 import { RouterConfig, AssetConfig } from '@cloudflare/workers-shared';
+import { Metafile } from 'esbuild';
 import { EventEmitter } from 'node:events';
 import Protocol from 'devtools-protocol/types/protocol-mapping';
-import { Metafile } from 'esbuild';
 import { ContainerNormalizedConfig } from '@cloudflare/containers-shared';
 import { IncomingRequestCfProperties } from '@cloudflare/workers-types/experimental';
 import { URLSearchParams } from 'node:url';
@@ -150,11 +150,22 @@ type ContainerApp = {
         namespace_id: string;
     };
     /**
-     * How a rollout should be done, defining the size of it
+     * Configures what percentage of instances should be updated at each step of a rollout.
+     * You can specify this as a single number, or an array of numbers.
+     *
+     * If this is a single number, each step will progress by that percentage.
+     * The options are 5, 10, 20, 25, 50 or 100.
+     *
+     * If this is an array, each step specifies the cumulative rollout progress.
+     * The final step must be 100.
+     *
+     * This can be overridden adhoc by deploying with the `--containers-rollout=immediate` flag,
+     * which will roll out to 100% of instances in one step.
+     *
      * @optional
-     * @default 25
+     * @default [10,100]
      * */
-    rollout_step_percentage?: number;
+    rollout_step_percentage?: number | number[];
     /**
      * How a rollout should be created. It supports the following modes:
      *  - full_auto: The container application will be rolled out fully automatically.
@@ -162,6 +173,7 @@ type ContainerApp = {
      *  - manual: The container application will be rollout fully by manually actioning progress steps.
      * @optional
      * @default "full_auto"
+     * @hidden
      */
     rollout_kind?: "full_auto" | "none" | "full_manual";
     /**
@@ -770,9 +782,18 @@ interface EnvironmentNonInheritable {
     services: {
         /** The binding name used to refer to the bound service. */
         binding: string;
-        /** The name of the service. */
+        /**
+         * The name of the service.
+         * To bind to a worker in a specific environment,
+         * you should use the format `<worker_name>-<environment_name>`.
+         */
         service: string;
-        /** The environment of the service (e.g. production, staging, etc). */
+        /**
+         * @hidden
+         * @deprecated you should use `service: <worker_name>-<environment_name>` instead.
+         * This refers to the deprecated concept of 'service environments'.
+         * The environment of the service (e.g. production, staging, etc).
+         */
         environment?: string;
         /** Optionally, the entrypoint (named export) of the service to bind to. */
         entrypoint?: string;
@@ -1811,26 +1832,6 @@ declare const unstable_pages: {
  */
 type ComplianceConfig = Partial<Pick<Config, "compliance_region">>;
 
-type WorkerRegistry = Record<string, WorkerDefinition>;
-type WorkerEntrypointsDefinition = Record<"default" | string, {
-    host: string;
-    port: number;
-} | undefined>;
-type WorkerDefinition = {
-    port: number | undefined;
-    protocol: "http" | "https" | undefined;
-    host: string | undefined;
-    mode: "local" | "remote";
-    headers?: Record<string, string>;
-    entrypointAddresses?: WorkerEntrypointsDefinition;
-    durableObjects: {
-        name: string;
-        className: string;
-    }[];
-    durableObjectsHost?: string;
-    durableObjectsPort?: number;
-};
-
 type _Params<ParamsArray extends [unknown?]> = ParamsArray extends [infer P] ? P : undefined;
 type _EventMethods = keyof Protocol.Events;
 type DevToolsEvent<Method extends _EventMethods> = Method extends unknown ? {
@@ -1948,6 +1949,7 @@ declare class ConfigController extends Controller<ConfigControllerEventMap> {
     latestConfig?: StartDevWorkerOptions;
     set(input: StartDevWorkerInput, throwErrors?: boolean): Promise<StartDevWorkerOptions | undefined>;
     patch(input: Partial<StartDevWorkerInput>): Promise<StartDevWorkerOptions | undefined>;
+    onDevRegistryUpdate(event: DevRegistryUpdateEvent): void;
     teardown(): Promise<void>;
     emitConfigUpdateEvent(config: StartDevWorkerOptions): void;
 }
@@ -2073,8 +2075,6 @@ interface StartDevWorkerInput {
         outboundService?: ServiceFetch;
         /** An undici MockAgent to declaratively mock fetch calls to particular resources. */
         mockFetch?: undici.MockAgent;
-        /** Describes the registry of other Workers running locally */
-        registry?: WorkerRegistry | null;
         testScheduled?: boolean;
         /** Whether to use Vectorize as a remote binding -- the worker is run locally but accesses to Vectorize are made remotely */
         bindVectorizeToProd?: boolean;
@@ -2087,6 +2087,8 @@ interface StartDevWorkerInput {
         containerBuildId?: string;
         /** Whether to build and connect to containers during local dev. Requires Docker daemon to be running. Defaults to true. */
         enableContainers?: boolean;
+        /** Path to the dev registry directory */
+        registry?: string;
         /** Path to the docker executable. Defaults to 'docker' */
         dockerPath?: string;
         /** Options for the container engine */
@@ -2262,6 +2264,10 @@ type ReloadCompleteEvent = {
     bundle: Bundle;
     proxyData: ProxyData;
 };
+type DevRegistryUpdateEvent = {
+    type: "devRegistryUpdate";
+    registry: WorkerRegistry;
+};
 type PreviewTokenExpiredEvent = {
     type: "previewTokenExpired";
     proxyData: ProxyData;
@@ -2324,8 +2330,6 @@ type ProxyData = {
     headers: Record<string, string>;
     liveReload?: boolean;
     proxyLogsToController?: boolean;
-    internalDurableObjects?: CfDurableObject[];
-    entrypointAddresses: WorkerEntrypointsDefinition | undefined;
 };
 
 interface TypedEventEmitter<EventMap extends Record<string | symbol, unknown[]>> extends EventEmitter {
@@ -2354,6 +2358,7 @@ declare abstract class Controller<EventMap extends ControllerEventMap = Controll
 type RuntimeControllerEventMap = ControllerEventMap & {
     reloadStart: [ReloadStartEvent];
     reloadComplete: [ReloadCompleteEvent];
+    devRegistryUpdate: [DevRegistryUpdateEvent];
 };
 declare abstract class RuntimeController extends Controller<RuntimeControllerEventMap> {
     abstract onBundleStart(_: BundleStartEvent): void;