wrangler 4.123.0 → 4.125.0

package/bin/cf-wrangler.js

@@ -61,9 +61,8 @@ function runCfWranglerDevFromArgs(parsedArgs) {
 
 function createDevOptions(parsedArgs) {
 	// Build wrangler dev's full (yargs-derived) options object. Every field
-	// must be present; we set the four accepted flags plus `wrangler dev`'s
-	// defaults and leave everything else `undefined`, which makes wrangler's
-	// ConfigController resolve those exactly as `wrangler dev` would.
+	// must be present; we set the four accepted flags, force cf's new config
+	// format, and otherwise use `wrangler dev`'s defaults.
 	return {
 		_: [],
 		$0: "",
@@ -77,6 +76,7 @@ function createDevOptions(parsedArgs) {
 		testScheduled: false,
 		processEntrypoint: false,
 		experimentalAutoCreate: false,
+		experimentalNewConfig: true,
 		types: false,
 		disableDevRegistry: false,
 		config: undefined,

package/config-schema.json

@@ -1,6 +1,5 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$ref": "#/definitions/RawConfig",
   "definitions": {
     "RawConfig": {
       "type": "object",
@@ -660,6 +659,38 @@
             "producers": []
           }
         },
+        "connect": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "protocol": {
+                "type": "string",
+                "const": "tcp",
+                "description": "The transport protocol to listen for.",
+                "markdownDescription": "The transport protocol to listen for."
+              },
+              "port": {
+                "type": "number",
+                "description": "The port to listen on.",
+                "markdownDescription": "The port to listen on."
+              },
+              "address": {
+                "type": "string",
+                "description": "The address to bind to. Defaults to `127.0.0.1`.",
+                "markdownDescription": "The address to bind to. Defaults to `127.0.0.1`."
+              }
+            },
+            "required": [
+              "protocol",
+              "port"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Specifies raw sockets that this Worker should listen on. Each entry opens a listening socket on the given port that delivers incoming connections directly to the Worker's `connect(socket, env, ctx)` handler.\n\nNOTE: This field is not automatically inherited from the top level environment, and so must be specified in every named environment.",
+          "markdownDescription": "Specifies raw sockets that this Worker should listen on.\nEach entry opens a listening socket on the\ngiven port that delivers incoming connections directly to the Worker's\n`connect(socket, env, ctx)` handler.\n\nNOTE: This field is not automatically inherited from the top level environment,\nand so must be specified in every named environment.",
+          "default": []
+        },
         "r2_buckets": {
           "type": "array",
           "items": {
@@ -2426,6 +2457,38 @@
             "producers": []
           }
         },
+        "connect": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "protocol": {
+                "type": "string",
+                "const": "tcp",
+                "description": "The transport protocol to listen for.",
+                "markdownDescription": "The transport protocol to listen for."
+              },
+              "port": {
+                "type": "number",
+                "description": "The port to listen on.",
+                "markdownDescription": "The port to listen on."
+              },
+              "address": {
+                "type": "string",
+                "description": "The address to bind to. Defaults to `127.0.0.1`.",
+                "markdownDescription": "The address to bind to. Defaults to `127.0.0.1`."
+              }
+            },
+            "required": [
+              "protocol",
+              "port"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Specifies raw sockets that this Worker should listen on. Each entry opens a listening socket on the given port that delivers incoming connections directly to the Worker's `connect(socket, env, ctx)` handler.\n\nNOTE: This field is not automatically inherited from the top level environment, and so must be specified in every named environment.",
+          "markdownDescription": "Specifies raw sockets that this Worker should listen on.\nEach entry opens a listening socket on the\ngiven port that delivers incoming connections directly to the Worker's\n`connect(socket, env, ctx)` handler.\n\nNOTE: This field is not automatically inherited from the top level environment,\nand so must be specified in every named environment.",
+          "default": []
+        },
         "r2_buckets": {
           "type": "array",
           "items": {
@@ -3595,6 +3658,11 @@
             },
             "storage": {
               "$ref": "#/definitions/DurableObjectExportStorage"
+            },
+            "container": {
+              "type": "string",
+              "description": "Attach a container to this Durable Object. Must match the `name` of an entry in the top-level `containers` array, and requires `storage: \"sqlite\"`.",
+              "markdownDescription": "Attach a container to this Durable Object. Must match the `name` of an\nentry in the top-level `containers` array, and requires\n`storage: \"sqlite\"`."
             }
           },
           "required": [
@@ -3681,6 +3749,11 @@
             },
             "transfer_from": {
               "type": "string"
+            },
+            "container": {
+              "type": "string",
+              "description": "Attach a container to this Durable Object. Must match the `name` of an entry in the top-level `containers` array, and requires `storage: \"sqlite\"`.",
+              "markdownDescription": "Attach a container to this Durable Object. Must match the `name` of an\nentry in the top-level `containers` array, and requires\n`storage: \"sqlite\"`."
             }
           },
           "required": [
@@ -3692,8 +3765,8 @@
           "additionalProperties": false
         }
       ],
-      "description": "A single declarative Durable Object export entry in the `exports` config map. `type` is reserved for the export kind. `state` carries the Durable Object lifecycle and defaults to `\"created\"` (live) when omitted.\n\nMutually exclusive with  {@link  DurableObjectMigration }  at the config- validation boundary.\n\n - `created` (default, live): `storage` is required.  - `deleted` (tombstone): retire a provisioned namespace whose class has    been removed from code.  - `renamed` (tombstone): rewrite a provisioned namespace's class name to    `renamed_to`. The target name must also appear as a live (state    `\"created\"`) `durable-object` entry in the same map.  - `transferred` (tombstone): hand ownership of the namespace to another    script in the same account (`transferred_to`). Two-phase commit;    the target must first deploy an `expecting-transfer` entry naming this    script via `transfer_from`.  - `expecting-transfer` (live): receiving side of a two-phase transfer;    `storage` and `transfer_from` are both required.",
-      "markdownDescription": "A single declarative Durable Object export entry in the `exports` config\nmap. `type` is reserved for the export kind. `state` carries the Durable\nObject lifecycle and defaults to `\"created\"` (live) when omitted.\n\nMutually exclusive with  {@link  DurableObjectMigration }  at the config-\nvalidation boundary.\n\n - `created` (default, live): `storage` is required.\n - `deleted` (tombstone): retire a provisioned namespace whose class has\n   been removed from code.\n - `renamed` (tombstone): rewrite a provisioned namespace's class name to\n   `renamed_to`. The target name must also appear as a live (state\n   `\"created\"`) `durable-object` entry in the same map.\n - `transferred` (tombstone): hand ownership of the namespace to another\n   script in the same account (`transferred_to`). Two-phase commit;\n   the target must first deploy an `expecting-transfer` entry naming this\n   script via `transfer_from`.\n - `expecting-transfer` (live): receiving side of a two-phase transfer;\n   `storage` and `transfer_from` are both required."
+      "description": "A single declarative Durable Object export entry in the `exports` config map. `type` is reserved for the export kind. `state` carries the Durable Object lifecycle and defaults to `\"created\"` (live) when omitted.\n\nMutually exclusive with  {@link  DurableObjectMigration }  at the config- validation boundary.\n\n - `created` (default, live): `storage` is required.  - `deleted` (tombstone): retire a provisioned namespace whose class has    been removed from code.  - `renamed` (tombstone): rewrite a provisioned namespace's class name to    `renamed_to`. The target name must also appear as a live (state    `\"created\"`) `durable-object` entry in the same map.  - `transferred` (tombstone): hand ownership of the namespace to another    script in the same account (`transferred_to`). Two-phase commit;    the target must first deploy an `expecting-transfer` entry naming this    script via `transfer_from`.  - `expecting-transfer` (live): receiving side of a two-phase transfer;    `storage` and `transfer_from` are both required.\n\nThe live states may additionally attach a container via `container`, which names an entry in the top-level `containers` array. Tombstones cannot.",
+      "markdownDescription": "A single declarative Durable Object export entry in the `exports` config\nmap. `type` is reserved for the export kind. `state` carries the Durable\nObject lifecycle and defaults to `\"created\"` (live) when omitted.\n\nMutually exclusive with  {@link  DurableObjectMigration }  at the config-\nvalidation boundary.\n\n - `created` (default, live): `storage` is required.\n - `deleted` (tombstone): retire a provisioned namespace whose class has\n   been removed from code.\n - `renamed` (tombstone): rewrite a provisioned namespace's class name to\n   `renamed_to`. The target name must also appear as a live (state\n   `\"created\"`) `durable-object` entry in the same map.\n - `transferred` (tombstone): hand ownership of the namespace to another\n   script in the same account (`transferred_to`). Two-phase commit;\n   the target must first deploy an `expecting-transfer` entry naming this\n   script via `transfer_from`.\n - `expecting-transfer` (live): receiving side of a two-phase transfer;\n   `storage` and `transfer_from` are both required.\n\nThe live states may additionally attach a container via `container`, which\nnames an entry in the top-level `containers` array. Tombstones cannot."
     },
     "DurableObjectExportStorage": {
       "type": "string",
@@ -4027,16 +4100,16 @@
       "additionalProperties": false,
       "properties": {
         "logpush": {
-          "$ref": "#/definitions/interface-769040647-10754-21116-769040647-0-543362004818536"
+          "$ref": "#/definitions/interface-769040647-11843-22205-769040647-0-559642004818536"
         },
         "observability": {
-          "$ref": "#/definitions/interface-769040647-10754-21116-769040647-0-543362004818536"
+          "$ref": "#/definitions/interface-769040647-11843-22205-769040647-0-559642004818536"
         },
         "limits": {
-          "$ref": "#/definitions/interface-769040647-10754-21116-769040647-0-543362004818536"
+          "$ref": "#/definitions/interface-769040647-11843-22205-769040647-0-559642004818536"
         },
         "cache": {
-          "$ref": "#/definitions/interface-769040647-10754-21116-769040647-0-543362004818536"
+          "$ref": "#/definitions/interface-769040647-11843-22205-769040647-0-559642004818536"
         },
         "define": {
           "type": "object",
@@ -4310,6 +4383,38 @@
             "producers": []
           }
         },
+        "connect": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "protocol": {
+                "type": "string",
+                "const": "tcp",
+                "description": "The transport protocol to listen for.",
+                "markdownDescription": "The transport protocol to listen for."
+              },
+              "port": {
+                "type": "number",
+                "description": "The port to listen on.",
+                "markdownDescription": "The port to listen on."
+              },
+              "address": {
+                "type": "string",
+                "description": "The address to bind to. Defaults to `127.0.0.1`.",
+                "markdownDescription": "The address to bind to. Defaults to `127.0.0.1`."
+              }
+            },
+            "required": [
+              "protocol",
+              "port"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Specifies raw sockets that this Worker should listen on. Each entry opens a listening socket on the given port that delivers incoming connections directly to the Worker's `connect(socket, env, ctx)` handler.\n\nNOTE: This field is not automatically inherited from the top level environment, and so must be specified in every named environment.",
+          "markdownDescription": "Specifies raw sockets that this Worker should listen on.\nEach entry opens a listening socket on the\ngiven port that delivers incoming connections directly to the Worker's\n`connect(socket, env, ctx)` handler.\n\nNOTE: This field is not automatically inherited from the top level environment,\nand so must be specified in every named environment.",
+          "default": []
+        },
         "r2_buckets": {
           "type": "array",
           "items": {
@@ -5308,7 +5413,7 @@
       "description": "Configuration for Worker Previews.\n\nThis defines the settings used when creating Preview deployments. Previews are branches of your Worker's main instance used to test features during feature development outside of production.\n\nThe `previews` block contains any intentionally divergent configuration intended solely for Previews, including:\n- All non-inheritable properties (environment variables and bindings like KV, D1, R2, etc.)\n- Select inheritable properties: `logpush`, `observability`, `limits`, `cache`",
       "markdownDescription": "Configuration for Worker Previews.\n\nThis defines the settings used when creating Preview deployments.\nPreviews are branches of your Worker's main instance used to test features\nduring feature development outside of production.\n\nThe `previews` block contains any intentionally divergent configuration intended solely for Previews, including:\n- All non-inheritable properties (environment variables and bindings like KV, D1, R2, etc.)\n- Select inheritable properties: `logpush`, `observability`, `limits`, `cache`"
     },
-    "interface-769040647-10754-21116-769040647-0-543362004818536": {
+    "interface-769040647-11843-22205-769040647-0-559642004818536": {
       "type": "object",
       "properties": {
         "name": {
@@ -5782,11 +5887,6 @@
           "description": "The script where the Workflow is defined (if it's external to this Worker)",
           "markdownDescription": "The script where the Workflow is defined (if it's external to this Worker)"
         },
-        "remote": {
-          "type": "boolean",
-          "description": "Whether the Workflow should be remote or not in local development",
-          "markdownDescription": "Whether the Workflow should be remote or not in local development"
-        },
         "limits": {
           "type": "object",
           "properties": {
@@ -5864,8 +5964,8 @@
       "properties": {
         "name": {
           "type": "string",
-          "description": "Name of the application",
-          "markdownDescription": "Name of the application"
+          "description": "Name of the application.\n\nThis is also the identifier used to reference the container from a Durable Object's `exports` entry via its `container` field.",
+          "markdownDescription": "Name of the application.\n\nThis is also the identifier used to reference the container from a Durable\nObject's `exports` entry via its `container` field."
         },
         "max_instances": {
           "type": "number",
@@ -6084,8 +6184,7 @@
         }
       },
       "required": [
-        "image",
-        "class_name"
+        "image"
       ],
       "additionalProperties": false,
       "description": "Configuration for a container application",
@@ -6280,5 +6379,10 @@
       "additionalProperties": false
     }
   },
-  "allowTrailingCommas": true
+  "allowTrailingCommas": true,
+  "allOf": [
+    {
+      "$ref": "#/definitions/RawConfig"
+    }
+  ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wrangler",
-  "version": "4.123.0",
+  "version": "4.125.0",
   "description": "Command-line interface for all things Cloudflare Workers",
   "keywords": [
     "assembly",
@@ -66,17 +66,17 @@
     "esbuild": "0.28.1",
     "path-to-regexp": "6.3.0",
     "unenv": "2.0.0-rc.24",
-    "workerd": "1.20260811.1",
+    "workerd": "1.20260820.1",
     "@cloudflare/kv-asset-handler": "0.5.0",
-    "@cloudflare/unenv-preset": "2.16.1",
-    "miniflare": "5.20260811.1-alpha"
+    "miniflare": "5.20260820.0-alpha",
+    "@cloudflare/unenv-preset": "2.16.1"
   },
   "devDependencies": {
     "@aws-sdk/client-s3": "^3.721.0",
     "@aws-sdk/s3-request-presigner": "^3.721.0",
     "@bomb.sh/tab": "^0.0.12",
     "@cloudflare/types": "6.18.4",
-    "@cloudflare/workers-types": "^5.20260811.1",
+    "@cloudflare/workers-types": "^5.20260820.1",
     "@cspotcode/source-map-support": "0.8.1",
     "@netlify/build-info": "^10.5.1",
     "@sentry/node": "^7.86.0",
@@ -125,7 +125,7 @@
     "mime": "^3.0.0",
     "minimatch": "^5.1.0",
     "mock-socket": "^9.3.1",
-    "msw": "2.12.4",
+    "msw": "2.14.6",
     "node-forge": "^1.3.2",
     "open": "11.0.0",
     "p-queue": "^9.0.0",
@@ -156,25 +156,25 @@
     "yaml": "^2.8.1",
     "yargs": "^17.7.2",
     "zod": "4.4.3",
-    "@cloudflare/autoconfig": "0.2.7",
-    "@cloudflare/build-output-utils": "0.1.1",
-    "@cloudflare/cli-shared-helpers": "0.1.23",
-    "@cloudflare/codemod": "1.1.0",
-    "@cloudflare/config": "0.5.0",
+    "@cloudflare/autoconfig": "0.2.9",
+    "@cloudflare/build-output-utils": "0.1.3",
+    "@cloudflare/cli-shared-helpers": "0.1.25",
     "@cloudflare/containers-shared": "0.16.0",
-    "@cloudflare/deploy-helpers": "0.7.0",
+    "@cloudflare/config": "0.7.0",
+    "@cloudflare/deploy-helpers": "0.8.0",
     "@cloudflare/pages-functions": "0.1.0",
-    "@cloudflare/pages-shared": "^0.13.169",
-    "@cloudflare/remote-bindings": "0.0.12",
-    "@cloudflare/runtime-types": "0.0.14",
-    "@cloudflare/workers-auth": "0.6.3",
+    "@cloudflare/pages-shared": "^0.13.171",
+    "@cloudflare/remote-bindings": "0.0.14",
+    "@cloudflare/runtime-types": "0.0.16",
+    "@cloudflare/shared-ast-primitives": "1.1.0",
+    "@cloudflare/workers-auth": "0.6.5",
     "@cloudflare/workers-shared": "0.19.9",
-    "@cloudflare/workflows-shared": "0.12.2",
     "@cloudflare/workers-tsconfig": "0.0.0",
-    "@cloudflare/workers-utils": "0.33.0"
+    "@cloudflare/workers-utils": "0.34.0",
+    "@cloudflare/workflows-shared": "0.13.0"
   },
   "peerDependencies": {
-    "@cloudflare/workers-types": "^5.20260811.1"
+    "@cloudflare/workers-types": "^5.20260820.1"
   },
   "peerDependenciesMeta": {
     "@cloudflare/workers-types": {

package/wrangler-dist/cli.d.ts

@@ -1,6 +1,6 @@
 import { Rule as Rule$1, CfModule, Environment as Environment$1, Entry, CfModuleType, Config as Config$1, StartDevWorkerInput, NodeJSCompatMode, CfScriptFormat, AsyncHook, CfAccount, AssetsOptions as AssetsOptions$1, Binding, ConfigBindingFieldName, RawConfig as RawConfig$1, NormalizeAndValidateConfigArgs, ResolveConfigPathOptions, ParseError, LoggerLevel, ComplianceConfig, ApiCredentials, UserError, FatalError } from '@cloudflare/workers-utils';
 export { Binding, experimental_patchConfig, experimental_readRawConfig, defaultWranglerConfig as unstable_defaultWranglerConfig } from '@cloudflare/workers-utils';
-import { Json as Json$1, WorkerdStructuredLog, DispatchFetch, Miniflare, WorkerRegistry, V4MiniflareOptions, Mutex, Response as Response$1, DurableObjectStorageOptions, DurableObjectStorageHandle, RemoteProxyConnectionString, V4WorkerOptions, V4ModuleRule, Request } from 'miniflare';
+import { Json as Json$1, WorkerdStructuredLog, DispatchFetch, Miniflare, WorkerRegistry, V4MiniflareOptions, Mutex, Response as Response$1, DurableObjectStorageOptions, DurableObjectStorageHandle, V4WorkerOptions, V4ModuleRule, RemoteProxyConnectionString, Request } from 'miniflare';
 import * as undici from 'undici';
 import { RequestInfo, RequestInit, Response, FormData } from 'undici';
 import { Metafile } from 'esbuild';
@@ -1298,8 +1298,14 @@ type UnsafeBinding = {
  */
 type ContainerApp = {
     /**
-     * Name of the application
-     * @optional Defaults to `worker_name-class_name` if not specified.
+     * Name of the application.
+     *
+     * This is also the identifier used to reference the container from a Durable
+     * Object's `exports` entry via its `container` field.
+     *
+     * @optional Defaults to `worker_name-class_name` if not specified. A name is
+     * required when `class_name` is not set, since there is no class name to
+     * derive the default from.
      */
     name?: string;
     /**
@@ -1330,8 +1336,12 @@ type ContainerApp = {
     image_vars?: Record<string, string>;
     /**
      * The class name of the Durable Object the container is connected to.
+     *
+     * @optional Instead of naming the Durable Object here, you can reference this
+     * container from the Durable Object's `exports` entry via its `container`
+     * field. Exactly one of the two directions must be configured.
      */
-    class_name: string;
+    class_name?: string;
     /**
      * The scheduling policy of the application
      * @optional
@@ -1543,11 +1553,22 @@ type DurableObjectExportStorage = "sqlite" | "legacy-kv";
  *    script via `transfer_from`.
  *  - `expecting-transfer` (live): receiving side of a two-phase transfer;
  *    `storage` and `transfer_from` are both required.
+ *
+ * The live states may additionally attach a container via `container`, which
+ * names an entry in the top-level `containers` array. Tombstones cannot.
  */
 type DurableObjectExport = {
     type: "durable-object";
     state?: "created";
     storage: DurableObjectExportStorage;
+    /**
+     * Attach a container to this Durable Object. Must match the `name` of an
+     * entry in the top-level `containers` array, and requires
+     * `storage: "sqlite"`.
+     *
+     * @optional
+     */
+    container?: string;
 } | {
     type: "durable-object";
     state: "deleted";
@@ -1564,6 +1585,14 @@ type DurableObjectExport = {
     state: "expecting-transfer";
     storage: DurableObjectExportStorage;
     transfer_from: string;
+    /**
+     * Attach a container to this Durable Object. Must match the `name` of an
+     * entry in the top-level `containers` array, and requires
+     * `storage: "sqlite"`.
+     *
+     * @optional
+     */
+    container?: string;
 };
 interface WorkerEntrypointExport {
     type: "worker";
@@ -1957,8 +1986,6 @@ type WorkflowBinding = {
     class_name: string;
     /** The script where the Workflow is defined (if it's external to this Worker) */
     script_name?: string;
-    /** Whether the Workflow should be remote or not in local development */
-    remote?: boolean;
     /** Optional limits for the Workflow */
     limits?: {
         /** Maximum number of steps a Workflow instance can execute */
@@ -2156,6 +2183,26 @@ interface EnvironmentNonInheritable {
             retry_delay?: number;
         }[];
     };
+    /**
+     * Specifies raw sockets that this Worker should listen on.
+     * Each entry opens a listening socket on the
+     * given port that delivers incoming connections directly to the Worker's
+     * `connect(socket, env, ctx)` handler.
+     *
+     * NOTE: This field is not automatically inherited from the top level environment,
+     * and so must be specified in every named environment.
+     *
+     * @default []
+     * @nonInheritable
+     */
+    connect: {
+        /** The transport protocol to listen for. */
+        protocol: "tcp";
+        /** The port to listen on. */
+        port: number;
+        /** The address to bind to. Defaults to `127.0.0.1`. */
+        address?: string;
+    }[];
     /**
      * Specifies R2 buckets that are bound to this Worker environment.
      *
@@ -3201,7 +3248,7 @@ type VarBinding = Extract<Binding, {
 declare function getVarsForDev(configPath: string | undefined, envFiles: string[] | undefined, vars: Config$1["vars"], env: string | undefined, silent?: boolean, secrets?: Config$1["secrets"]): Record<string, VarBinding>;
 
 /**
- * @deprecated Use today's date as the compatibility date instead.
+ * @deprecated Set a compatibility date explicitly instead.
  */
 declare function unstable_getDevCompatibilityDate(): `${number}${number}${number}${number}-${number}${number}-${number}${number}`;