wrangler 4.139.0 → 4.141.0

package/config-schema.json

@@ -17,6 +17,9 @@
           "markdownDescription": "The `env` section defines overrides for the configuration for different environments.\n\nAll environment fields can be specified at the top level of the config indicating the default environment settings.\n\n- Some fields are inherited and overridable in each environment.\n- But some are not inherited and must be explicitly specified in every environment, if they are specified at the top level.\n\nFor more information, see the documentation at https://developers.cloudflare.com/workers/cli-wrangler/configuration#environments",
           "default": {}
         },
+        "durable_objects": {
+          "$ref": "#/definitions/RawDurableObjectsConfig"
+        },
         "name": {
           "type": "string",
           "description": "The name of your Worker. Alphanumeric + dashes only.",
@@ -428,23 +431,6 @@
           "description": "Secrets configuration.\n\nNOTE: This field is not automatically inherited from the top level environment, and so must be specified in every named environment.\n\nFor reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#secrets-configuration-property",
           "markdownDescription": "Secrets configuration.\n\nNOTE: This field is not automatically inherited from the top level environment,\nand so must be specified in every named environment.\n\nFor reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#secrets-configuration-property"
         },
-        "durable_objects": {
-          "type": "object",
-          "properties": {
-            "bindings": {
-              "$ref": "#/definitions/DurableObjectBindings"
-            }
-          },
-          "required": [
-            "bindings"
-          ],
-          "additionalProperties": false,
-          "description": "A list of durable objects that your Worker should be bound to.\n\nFor more information about Durable Objects, see the documentation at https://developers.cloudflare.com/workers/learning/using-durable-objects\n\nNOTE: This field is not automatically inherited from the top level environment, and so must be specified in every named environment.\n\nFor reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#durable-objects",
-          "markdownDescription": "A list of durable objects that your Worker should be bound to.\n\nFor more information about Durable Objects, see the documentation at\nhttps://developers.cloudflare.com/workers/learning/using-durable-objects\n\nNOTE: This field is not automatically inherited from the top level environment,\nand so must be specified in every named environment.\n\nFor reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#durable-objects",
-          "default": {
-            "bindings": []
-          }
-        },
         "workflows": {
           "type": "array",
           "items": {
@@ -1828,7 +1814,11 @@
     },
     "RawEnvironment": {
       "type": "object",
+      "additionalProperties": false,
       "properties": {
+        "durable_objects": {
+          "$ref": "#/definitions/RawDurableObjectsConfig"
+        },
         "name": {
           "type": "string",
           "description": "The name of your Worker. Alphanumeric + dashes only.",
@@ -2240,23 +2230,6 @@
           "description": "Secrets configuration.\n\nNOTE: This field is not automatically inherited from the top level environment, and so must be specified in every named environment.\n\nFor reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#secrets-configuration-property",
           "markdownDescription": "Secrets configuration.\n\nNOTE: This field is not automatically inherited from the top level environment,\nand so must be specified in every named environment.\n\nFor reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#secrets-configuration-property"
         },
-        "durable_objects": {
-          "type": "object",
-          "properties": {
-            "bindings": {
-              "$ref": "#/definitions/DurableObjectBindings"
-            }
-          },
-          "required": [
-            "bindings"
-          ],
-          "additionalProperties": false,
-          "description": "A list of durable objects that your Worker should be bound to.\n\nFor more information about Durable Objects, see the documentation at https://developers.cloudflare.com/workers/learning/using-durable-objects\n\nNOTE: This field is not automatically inherited from the top level environment, and so must be specified in every named environment.\n\nFor reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#durable-objects",
-          "markdownDescription": "A list of durable objects that your Worker should be bound to.\n\nFor more information about Durable Objects, see the documentation at\nhttps://developers.cloudflare.com/workers/learning/using-durable-objects\n\nNOTE: This field is not automatically inherited from the top level environment,\nand so must be specified in every named environment.\n\nFor reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#durable-objects",
-          "default": {
-            "bindings": []
-          }
-        },
         "workflows": {
           "type": "array",
           "items": {
@@ -3512,10 +3485,81 @@
           "default": []
         }
       },
-      "additionalProperties": false,
       "description": "The raw environment configuration that we read from the config file.\n\nAll the properties are optional, and will be replaced with defaults in the configuration that is used in the rest of the codebase.",
       "markdownDescription": "The raw environment configuration that we read from the config file.\n\nAll the properties are optional, and will be replaced with defaults in the configuration that\nis used in the rest of the codebase."
     },
+    "RawDurableObjectsConfig": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "bindings": {
+          "$ref": "#/definitions/DurableObjectBindings"
+        },
+        "code_update_strategy": {
+          "$ref": "#/definitions/DurableObjectCodeUpdateStrategy"
+        }
+      }
+    },
+    "DurableObjectBindings": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "The name of the binding used to refer to the Durable Object",
+            "markdownDescription": "The name of the binding used to refer to the Durable Object"
+          },
+          "class_name": {
+            "type": "string",
+            "description": "The exported class name of the Durable Object",
+            "markdownDescription": "The exported class name of the Durable Object"
+          },
+          "script_name": {
+            "type": "string",
+            "description": "The script where the Durable Object is defined (if it's external to this Worker)",
+            "markdownDescription": "The script where the Durable Object is defined (if it's external to this Worker)"
+          },
+          "environment": {
+            "type": "string",
+            "description": "The service environment of the script_name to bind to",
+            "markdownDescription": "The service environment of the script_name to bind to"
+          }
+        },
+        "required": [
+          "name",
+          "class_name"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "DurableObjectCodeUpdateStrategy": {
+      "type": "object",
+      "properties": {
+        "mode": {
+          "type": "string",
+          "enum": [
+            "immediate",
+            "deferred"
+          ],
+          "description": "How Durable Object code updates should be applied.",
+          "markdownDescription": "How Durable Object code updates should be applied."
+        },
+        "max_delay": {
+          "type": "number",
+          "description": "Maximum time, in seconds, to wait for Durable Objects to hibernate. Defaults to 300 (5 minutes) and cannot exceed 86400 (24 hours).",
+          "markdownDescription": "Maximum time, in seconds, to wait for Durable Objects to hibernate.\nDefaults to 300 (5 minutes) and cannot exceed 86400 (24 hours).",
+          "minimum": 0,
+          "maximum": 86400,
+          "multipleOf": 0.001,
+          "default": 300
+        }
+      },
+      "required": [
+        "mode"
+      ],
+      "additionalProperties": false
+    },
     "Route": {
       "anyOf": [
         {
@@ -4256,22 +4300,21 @@
     },
     "PreviewsConfig": {
       "type": "object",
-      "additionalProperties": false,
       "properties": {
         "logpush": {
-          "$ref": "#/definitions/interface-769040647-14860-25222-769040647-0-597452004818536"
+          "$ref": "#/definitions/interface-769040647-14860-25222-769040647-0-605262004818536"
         },
         "observability": {
-          "$ref": "#/definitions/interface-769040647-14860-25222-769040647-0-597452004818536"
+          "$ref": "#/definitions/interface-769040647-14860-25222-769040647-0-605262004818536"
         },
         "limits": {
-          "$ref": "#/definitions/interface-769040647-14860-25222-769040647-0-597452004818536"
+          "$ref": "#/definitions/interface-769040647-14860-25222-769040647-0-605262004818536"
         },
         "placement": {
-          "$ref": "#/definitions/interface-769040647-14860-25222-769040647-0-597452004818536"
+          "$ref": "#/definitions/interface-769040647-14860-25222-769040647-0-605262004818536"
         },
         "cache": {
-          "$ref": "#/definitions/interface-769040647-14860-25222-769040647-0-597452004818536"
+          "$ref": "#/definitions/interface-769040647-14860-25222-769040647-0-605262004818536"
         },
         "define": {
           "type": "object",
@@ -4314,23 +4357,6 @@
           "description": "Secrets configuration.\n\nNOTE: This field is not automatically inherited from the top level environment, and so must be specified in every named environment.\n\nFor reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#secrets-configuration-property",
           "markdownDescription": "Secrets configuration.\n\nNOTE: This field is not automatically inherited from the top level environment,\nand so must be specified in every named environment.\n\nFor reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#secrets-configuration-property"
         },
-        "durable_objects": {
-          "type": "object",
-          "properties": {
-            "bindings": {
-              "$ref": "#/definitions/DurableObjectBindings"
-            }
-          },
-          "required": [
-            "bindings"
-          ],
-          "additionalProperties": false,
-          "description": "A list of durable objects that your Worker should be bound to.\n\nFor more information about Durable Objects, see the documentation at https://developers.cloudflare.com/workers/learning/using-durable-objects\n\nNOTE: This field is not automatically inherited from the top level environment, and so must be specified in every named environment.\n\nFor reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#durable-objects",
-          "markdownDescription": "A list of durable objects that your Worker should be bound to.\n\nFor more information about Durable Objects, see the documentation at\nhttps://developers.cloudflare.com/workers/learning/using-durable-objects\n\nNOTE: This field is not automatically inherited from the top level environment,\nand so must be specified in every named environment.\n\nFor reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#durable-objects",
-          "default": {
-            "bindings": []
-          }
-        },
         "workflows": {
           "type": "array",
           "items": {
@@ -5584,12 +5610,25 @@
           "description": "Specifies VPC networks 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.",
           "markdownDescription": "Specifies VPC networks that are bound to this Worker environment.\n\nNOTE: This field is not automatically inherited from the top level environment,\nand so must be specified in every named environment.",
           "default": []
+        },
+        "durable_objects": {
+          "type": "object",
+          "properties": {
+            "bindings": {
+              "$ref": "#/definitions/DurableObjectBindings"
+            }
+          },
+          "required": [
+            "bindings"
+          ],
+          "additionalProperties": false
         }
       },
+      "additionalProperties": false,
       "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`, `placement`, `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`, `placement`, `cache`"
     },
-    "interface-769040647-14860-25222-769040647-0-597452004818536": {
+    "interface-769040647-14860-25222-769040647-0-605262004818536": {
       "type": "object",
       "properties": {
         "name": {
@@ -6007,39 +6046,6 @@
         }
       ]
     },
-    "DurableObjectBindings": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "properties": {
-          "name": {
-            "type": "string",
-            "description": "The name of the binding used to refer to the Durable Object",
-            "markdownDescription": "The name of the binding used to refer to the Durable Object"
-          },
-          "class_name": {
-            "type": "string",
-            "description": "The exported class name of the Durable Object",
-            "markdownDescription": "The exported class name of the Durable Object"
-          },
-          "script_name": {
-            "type": "string",
-            "description": "The script where the Durable Object is defined (if it's external to this Worker)",
-            "markdownDescription": "The script where the Durable Object is defined (if it's external to this Worker)"
-          },
-          "environment": {
-            "type": "string",
-            "description": "The service environment of the script_name to bind to",
-            "markdownDescription": "The service environment of the script_name to bind to"
-          }
-        },
-        "required": [
-          "name",
-          "class_name"
-        ],
-        "additionalProperties": false
-      }
-    },
     "WorkflowBinding": {
       "type": "object",
       "properties": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wrangler",
-  "version": "4.139.0",
+  "version": "4.141.0",
   "description": "Command-line interface for all things Cloudflare Workers",
   "keywords": [
     "assembly",
@@ -71,17 +71,17 @@
     "esbuild": "0.28.1",
     "path-to-regexp": "6.3.0",
     "unenv": "2.0.0-rc.24",
-    "workerd": "1.20260923.1",
+    "workerd": "1.20260925.1",
     "@cloudflare/unenv-preset": "2.16.2",
     "@cloudflare/kv-asset-handler": "0.5.0",
-    "miniflare": "5.20260923.0-alpha"
+    "miniflare": "5.20260925.0-alpha"
   },
   "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.20260923.1",
+    "@cloudflare/workers-types": "^5.20260925.1",
     "@cspotcode/source-map-support": "0.8.1",
     "@netlify/build-info": "10.5.1",
     "@sentry/node": "^7.86.0",
@@ -161,25 +161,25 @@
     "yaml": "^2.8.1",
     "yargs": "^17.7.2",
     "zod": "4.4.3",
-    "@cloudflare/autoconfig": "0.6.4",
-    "@cloudflare/build-output-utils": "0.8.0",
-    "@cloudflare/cli-shared-helpers": "0.1.38",
-    "@cloudflare/config": "0.18.0",
-    "@cloudflare/containers-shared": "0.20.0",
+    "@cloudflare/autoconfig": "0.6.6",
+    "@cloudflare/build-output-utils": "0.8.1",
+    "@cloudflare/cli-shared-helpers": "0.2.0",
+    "@cloudflare/config": "0.19.0",
+    "@cloudflare/containers-shared": "0.20.2",
+    "@cloudflare/deploy-helpers": "0.18.0",
+    "@cloudflare/pages-shared": "^0.13.189",
+    "@cloudflare/remote-bindings": "0.0.36",
     "@cloudflare/pages-functions": "0.1.0",
-    "@cloudflare/deploy-helpers": "0.16.0",
-    "@cloudflare/pages-shared": "^0.13.188",
-    "@cloudflare/remote-bindings": "0.0.34",
-    "@cloudflare/runtime-types": "0.1.2",
-    "@cloudflare/shared-ast-primitives": "1.1.0",
+    "@cloudflare/runtime-types": "0.1.3",
+    "@cloudflare/workers-auth": "0.9.4",
     "@cloudflare/workers-shared": "0.20.0",
-    "@cloudflare/workers-auth": "0.9.2",
-    "@cloudflare/workers-utils": "0.42.0",
+    "@cloudflare/shared-ast-primitives": "1.1.0",
+    "@cloudflare/workers-utils": "0.44.0",
     "@cloudflare/workers-tsconfig": "0.0.0",
     "@cloudflare/workflows-shared": "0.14.0"
   },
   "peerDependencies": {
-    "@cloudflare/workers-types": "^5.20260923.1"
+    "@cloudflare/workers-types": "^5.20260925.1"
   },
   "peerDependenciesMeta": {
     "@cloudflare/workers-types": {

package/wrangler-dist/cli.d.ts

@@ -2018,6 +2018,26 @@ type DurableObjectBindings = {
     /** The service environment of the script_name to bind to */
     environment?: string;
 }[];
+type DurableObjectCodeUpdateStrategy = {
+    /** How Durable Object code updates should be applied. */
+    mode: "immediate" | "deferred";
+    /**
+     * Maximum time, in seconds, to wait for Durable Objects to hibernate.
+     * Defaults to 300 (5 minutes) and cannot exceed 86400 (24 hours).
+     * @minimum 0
+     * @maximum 86400
+     * @multipleOf 0.001
+     * @default 300
+     */
+    max_delay?: number;
+};
+type DurableObjectsConfig = {
+    bindings: DurableObjectBindings;
+    code_update_strategy?: DurableObjectCodeUpdateStrategy;
+};
+type RawDurableObjectsConfig = Omit<DurableObjectsConfig, "bindings"> & {
+    bindings?: DurableObjectBindings;
+};
 declare const ARTIFACTS_EVENT_TYPES: readonly ["cf.artifacts.repo.created", "cf.artifacts.repo.deleted", "cf.artifacts.repo.forked", "cf.artifacts.repo.imported", "cf.artifacts.repo.pushed", "cf.artifacts.repo.cloned", "cf.artifacts.repo.fetched", "cf.artifacts.repo.token.created", "cf.artifacts.repo.token.revoked"];
 type ArtifactsEventType = (typeof ARTIFACTS_EVENT_TYPES)[number];
 type ArtifactsEventTrigger = {
@@ -2131,7 +2151,7 @@ interface EnvironmentNonInheritable {
         required?: string[];
     };
     /**
-     * A list of durable objects that your Worker should be bound to.
+     * Durable Object bindings and code update strategy for your Worker.
      *
      * For more information about Durable Objects, see the documentation at
      * https://developers.cloudflare.com/workers/learning/using-durable-objects
@@ -2144,9 +2164,7 @@ interface EnvironmentNonInheritable {
      * @default {bindings:[]}
      * @nonInheritable
      */
-    durable_objects: {
-        bindings: DurableObjectBindings;
-    };
+    durable_objects: DurableObjectsConfig;
     /**
      * A list of workflows that your Worker should be bound to.
      *
@@ -2853,7 +2871,9 @@ interface EnvironmentNonInheritable {
  * All the properties are optional, and will be replaced with defaults in the configuration that
  * is used in the rest of the codebase.
  */
-type RawEnvironment = Partial<Environment>;
+type RawEnvironment = Partial<Omit<Environment, "durable_objects">> & {
+    durable_objects?: RawDurableObjectsConfig;
+};
 /**
  * A bundling resolver rule, defining the modules type for paths that match the specified globs.
  */
@@ -2996,7 +3016,10 @@ type ContainerEngine = {
  *
  * @inheritable
  */
-interface PreviewsConfig extends Partial<EnvironmentNonInheritable>, Partial<Pick<EnvironmentInheritable, "logpush" | "observability" | "limits" | "placement" | "cache">> {
+interface PreviewsConfig extends Partial<Omit<EnvironmentNonInheritable, "durable_objects">>, Partial<Pick<EnvironmentInheritable, "logpush" | "observability" | "limits" | "placement" | "cache">> {
+    durable_objects?: {
+        bindings: DurableObjectBindings;
+    };
 }
 
 /**