wrangler 4.110.0 → 4.112.0

package/bin/cf-wrangler.js

@@ -110,7 +110,6 @@ function createDevOptions(parsedArgs) {
 		jsxFragment: undefined,
 		tsconfig: undefined,
 		minify: undefined,
-		legacyEnv: undefined,
 		logLevel: undefined,
 		showInteractiveDevSession: undefined,
 		liveReload: undefined,

package/config-schema.json

@@ -1638,11 +1638,6 @@
           "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.",
           "markdownDescription": "The directory of static assets to serve.\n\nThe presence of this field in a Wrangler configuration file indicates a Pages project,\nand will prompt the handling of the configuration file according to the\nPages-specific validation rules."
         },
-        "legacy_env": {
-          "type": "boolean",
-          "description": "A boolean to enable \"legacy\" style wrangler environments (from Wrangler v1). These have been superseded by Services, but there may be projects that won't (or can't) use them. If you're using a legacy environment, you can set this to `true` to enable it.",
-          "markdownDescription": "A boolean to enable \"legacy\" style wrangler environments (from Wrangler v1).\nThese have been superseded by Services, but there may be projects that won't\n(or can't) use them. If you're using a legacy environment, you can set this\nto `true` to enable it."
-        },
         "send_metrics": {
           "type": "boolean",
           "description": "Whether Wrangler should send usage metrics to Cloudflare for this project.\n\nWhen defined this will override any user settings. Otherwise, Wrangler will use the user's preference.",
@@ -1746,6 +1741,14 @@
           "description": "By default, the Wrangler configuration file is the source of truth for your environment configuration, like a terraform file.\n\nIf you change your vars in the dashboard, wrangler *will* override/delete them on its next deploy.\n\nIf you want to keep your dashboard vars when wrangler deploys, set this field to true.",
           "markdownDescription": "By default, the Wrangler configuration file is the source of truth for your environment configuration, like a terraform file.\n\nIf you change your vars in the dashboard, wrangler *will* override/delete them on its next deploy.\n\nIf you want to keep your dashboard vars when wrangler deploys, set this field to true.",
           "default": false
+        },
+        "addresses": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "The inbound email addresses handled by the Worker being deployed.\n\nEach entry is a literal recipient address (e.g. `\"support@example.com\"`) or a `*@domain` catch-all (e.g. `\"*@example.com\"`). Every entry creates an Email Routing rule whose action routes mail to this Worker.\n\nThis field is top-level only and applies to every environment of the Worker; it cannot be set under `env.*`.",
+          "markdownDescription": "The inbound email addresses handled by the Worker being deployed.\n\nEach entry is a literal recipient address (e.g. `\"support@example.com\"`)\nor a `*@domain` catch-all (e.g. `\"*@example.com\"`). Every entry creates an\nEmail Routing rule whose action routes mail to this Worker.\n\nThis field is top-level only and applies to every environment of the\nWorker; it cannot be set under `env.*`."
         }
       }
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wrangler",
-  "version": "4.110.0",
+  "version": "4.112.0",
   "description": "Command-line interface for all things Cloudflare Workers",
   "keywords": [
     "assembly",
@@ -66,16 +66,16 @@
     "esbuild": "0.28.1",
     "path-to-regexp": "6.3.0",
     "unenv": "2.0.0-rc.24",
-    "workerd": "1.20260708.1",
-    "@cloudflare/kv-asset-handler": "0.5.0",
+    "workerd": "1.20260714.1",
     "@cloudflare/unenv-preset": "2.16.1",
-    "miniflare": "4.20260708.1"
+    "miniflare": "4.20260714.0",
+    "@cloudflare/kv-asset-handler": "0.5.0"
   },
   "devDependencies": {
     "@aws-sdk/client-s3": "^3.721.0",
     "@bomb.sh/tab": "^0.0.12",
     "@cloudflare/types": "6.18.4",
-    "@cloudflare/workers-types": "^5.20260708.1",
+    "@cloudflare/workers-types": "^5.20260714.1",
     "@cspotcode/source-map-support": "0.8.1",
     "@netlify/build-info": "^10.5.1",
     "@sentry/node": "^7.86.0",
@@ -154,23 +154,23 @@
     "xxhash-wasm": "^1.0.1",
     "yaml": "^2.8.1",
     "yargs": "^17.7.2",
-    "zod": "^4.4.3",
-    "@cloudflare/autoconfig": "0.1.4",
-    "@cloudflare/cli-shared-helpers": "0.1.13",
+    "zod": "4.4.3",
+    "@cloudflare/autoconfig": "0.1.6",
     "@cloudflare/codemod": "1.1.0",
+    "@cloudflare/config": "0.2.1",
     "@cloudflare/containers-shared": "0.16.0",
-    "@cloudflare/deploy-helpers": "0.4.0",
-    "@cloudflare/pages-shared": "^0.13.156",
-    "@cloudflare/runtime-types": "0.0.1",
-    "@cloudflare/workers-shared": "0.19.7",
-    "@cloudflare/workers-auth": "0.4.2",
+    "@cloudflare/deploy-helpers": "0.5.1",
+    "@cloudflare/cli-shared-helpers": "0.1.15",
+    "@cloudflare/pages-shared": "^0.13.158",
+    "@cloudflare/runtime-types": "0.0.3",
+    "@cloudflare/workers-auth": "0.5.0",
+    "@cloudflare/workers-shared": "0.19.9",
     "@cloudflare/workers-tsconfig": "0.0.0",
-    "@cloudflare/workers-utils": "0.26.0",
-    "@cloudflare/workflows-shared": "0.12.0",
-    "@cloudflare/config": "0.0.0"
+    "@cloudflare/workers-utils": "0.27.0",
+    "@cloudflare/workflows-shared": "0.12.1"
   },
   "peerDependencies": {
-    "@cloudflare/workers-types": "^5.20260708.1"
+    "@cloudflare/workers-types": "^5.20260714.1"
   },
   "peerDependenciesMeta": {
     "@cloudflare/workers-types": {

package/templates/startDevWorker/ProxyWorker.ts

@@ -1,6 +1,7 @@
 import {
 	createDeferred,
 	DeferredPromise,
+	rewriteUrlInHeaderValue,
 	urlFromParts,
 } from "../../src/api/startDevWorker/utils";
 import type {
@@ -350,10 +351,7 @@ function rewriteUrlRelatedHeaders(headers: Headers, from: URL, to: URL) {
 	headers.delete("Set-Cookie");
 	headers.forEach((value, key) => {
 		if (typeof value === "string" && value.includes(from.host)) {
-			headers.set(
-				key,
-				value.replaceAll(from.origin, to.origin).replaceAll(from.host, to.host)
-			);
+			headers.set(key, rewriteUrlInHeaderValue(value, from, to));
 		}
 	});
 	for (const cookie of setCookie) {

package/wrangler-dist/ProxyWorker.js

@@ -21,6 +21,23 @@ function urlFromParts(parts, base = "http://localhost") {
   Object.assign(url, parts);
   return url;
 }
+function rewriteUrlInHeaderValue(value, from, to) {
+  return value.replace(
+    /(https?:\/\/[^/?#\s,;"']+)([^\s,;"']*)/gi,
+    (match, origin, rest) => {
+      let url;
+      try {
+        url = new URL(origin);
+      } catch {
+        return match;
+      }
+      if (url.host !== from.host) {
+        return match;
+      }
+      return to.origin + rest;
+    }
+  );
+}
 
 // templates/startDevWorker/ProxyWorker.ts
 var LIVE_RELOAD_PROTOCOL = "WRANGLER_PROXYWORKER_LIVE_RELOAD_PROTOCOL";
@@ -231,10 +248,7 @@ function rewriteUrlRelatedHeaders(headers, from, to) {
   headers.delete("Set-Cookie");
   headers.forEach((value, key) => {
     if (typeof value === "string" && value.includes(from.host)) {
-      headers.set(
-        key,
-        value.replaceAll(from.origin, to.origin).replaceAll(from.host, to.host)
-      );
+      headers.set(key, rewriteUrlInHeaderValue(value, from, to));
     }
   });
   for (const cookie of setCookie) {

package/wrangler-dist/cli.d.ts

@@ -1,10 +1,11 @@
-import { Rule as Rule$1, CfModule, Environment as Environment$1, Entry, CfModuleType, StartDevWorkerInput, Config as Config$1, NodeJSCompatMode, CfScriptFormat, AsyncHook, CfAccount as CfAccount$1, AssetsOptions as AssetsOptions$1, Binding, ConfigBindingFieldName, RawConfig as RawConfig$1, NormalizeAndValidateConfigArgs, ResolveConfigPathOptions, ApiCredentials, ParseError, LoggerLevel, ComplianceConfig, UserError, FatalError } from '@cloudflare/workers-utils';
+import { Rule as Rule$1, CfModule, Environment as Environment$1, Entry, CfModuleType, Config as Config$1, StartDevWorkerInput, NodeJSCompatMode, CfScriptFormat, AsyncHook, CfAccount as CfAccount$1, AssetsOptions as AssetsOptions$1, Binding, ConfigBindingFieldName, RawConfig as RawConfig$1, NormalizeAndValidateConfigArgs, ResolveConfigPathOptions, ApiCredentials, ParseError, LoggerLevel, ComplianceConfig, 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, MiniflareOptions, Mutex, Response as Response$1, RemoteProxyConnectionString, WorkerOptions, ModuleRule, Request } from 'miniflare';
+import { Json as Json$1, WorkerdStructuredLog, DispatchFetch, Miniflare, WorkerRegistry, MiniflareOptions, Mutex, Response as Response$1, DurableObjectStorageOptions, DurableObjectStorageHandle, RemoteProxyConnectionString, WorkerOptions, ModuleRule, Request } from 'miniflare';
 import * as undici from 'undici';
 import { RequestInfo, RequestInit, Response, FormData } from 'undici';
 import { Metafile } from 'esbuild';
 import Protocol from 'devtools-protocol/types/protocol-mapping';
+import Protocol$1 from 'devtools-protocol';
 import { EventEmitter } from 'node:events';
 import { ContainerNormalizedConfig } from '@cloudflare/containers-shared';
 import { Rpc, ExportedHandler, DurableObjectNamespace, D1Database, Workflow, Service } from '@cloudflare/workers-types';
@@ -335,17 +336,29 @@ type EsbuildBundle = {
 
 declare class ConfigController extends Controller {
     #private;
-    latestInput?: StartDevWorkerInput;
+    latestInput?: WranglerStartDevWorkerInput;
     latestWranglerConfig?: Config$1;
     latestConfig?: StartDevWorkerOptions;
-    set(input: StartDevWorkerInput, throwErrors?: boolean): Promise<StartDevWorkerOptions | undefined>;
-    patch(input: Partial<StartDevWorkerInput>): Promise<StartDevWorkerOptions | undefined>;
+    set(input: WranglerStartDevWorkerInput, throwErrors?: boolean): Promise<StartDevWorkerOptions | undefined>;
+    patch(input: Partial<WranglerStartDevWorkerInput>): Promise<StartDevWorkerOptions | undefined>;
     onDevRegistryUpdate(event: DevRegistryUpdateEvent): void;
     teardown(): Promise<void>;
     emitConfigUpdateEvent(config: StartDevWorkerOptions): void;
 }
 
 type MiniflareWorker = Awaited<ReturnType<Miniflare["getWorker"]>>;
+/**
+ * Extended StartDevWorkerInput with wrangler-specific fields that depend on miniflare types.
+ * The base StartDevWorkerInput in workers-utils is kept dependency-free.
+ */
+type WranglerStartDevWorkerInput = Omit<StartDevWorkerInput, "dev"> & {
+    dev?: StartDevWorkerInput["dev"] & {
+        /** Handles structured runtime logs. */
+        structuredLogsHandler?: (log: WorkerdStructuredLog) => void;
+        /** An undici MockAgent to declaratively mock fetch calls to particular resources. */
+        mockFetch?: undici.MockAgent;
+    };
+};
 interface Worker {
     ready: Promise<void>;
     url: Promise<URL>;
@@ -435,6 +448,17 @@ type DevRegistryUpdateEvent = {
     type: "devRegistryUpdate";
     registry: WorkerRegistry;
 };
+type RuntimeErrorEvent = {
+    type: "runtimeError";
+    source: "LocalRuntimeController" | "ProxyController";
+    /** The exception summary line. */
+    text: string;
+    /** The source-mapped stack. */
+    stack: string;
+    /** The raw Chrome DevTools Protocol exception details, when the event
+     * came over the inspector. */
+    exceptionDetails?: Protocol$1.Runtime.ExceptionDetails;
+};
 type PreviewTokenExpiredEvent = {
     type: "previewTokenExpired";
     proxyData: ProxyData;
@@ -501,7 +525,7 @@ type ProxyData = {
     proxyLogsToController?: boolean;
 };
 
-type ControllerEvent = ErrorEvent | ConfigUpdateEvent | BundleStartEvent | BundleCompleteEvent | ReloadStartEvent | ReloadCompleteEvent | DevRegistryUpdateEvent | PreviewTokenExpiredEvent;
+type ControllerEvent = ErrorEvent | ConfigUpdateEvent | BundleStartEvent | BundleCompleteEvent | ReloadStartEvent | ReloadCompleteEvent | DevRegistryUpdateEvent | RuntimeErrorEvent | PreviewTokenExpiredEvent;
 interface ControllerBus {
     dispatch(event: ControllerEvent): void;
 }
@@ -573,7 +597,7 @@ declare class DevEnv extends EventEmitter implements ControllerBus {
     bundler: BundlerController;
     runtimes: RuntimeController[];
     proxy: ProxyController;
-    startWorker(options: StartDevWorkerInput): Promise<Worker>;
+    startWorker(options: WranglerStartDevWorkerInput): Promise<Worker>;
     constructor({ configFactory, bundlerFactory, runtimeFactories, proxyFactory, }?: {
         configFactory?: ControllerFactory<ConfigController>;
         bundlerFactory?: ControllerFactory<BundlerController>;
@@ -603,7 +627,7 @@ declare class DevEnv extends EventEmitter implements ControllerBus {
     teardown(): Promise<void>;
 }
 
-declare function startWorker(options: StartDevWorkerInput): Promise<Worker>;
+declare function startWorker(options: WranglerStartDevWorkerInput): Promise<Worker>;
 
 declare const dev: {
     args: {
@@ -651,7 +675,6 @@ declare const dev: {
         nodeCompat: boolean | undefined;
         persistTo: string | undefined;
         liveReload: boolean | undefined;
-        legacyEnv: boolean | undefined;
         testScheduled: boolean;
         logLevel: "debug" | "none" | "error" | "log" | "info" | "warn" | undefined;
         showInteractiveDevSession: boolean | undefined;
@@ -777,16 +800,25 @@ type TestHarnessOptions = {
      */
     workers: WorkerInput[];
 };
+type ExportName<Module, Type> = string extends keyof Module ? string : Extract<{
+    [K in keyof Module]-?: NonNullable<Module[K]> extends Type | (abstract new (...args: any[]) => Type) ? K : never;
+}[keyof Module], string>;
 type BindingName<Env, Type> = string extends keyof Env ? string : Extract<{
     [K in keyof Env]-?: NonNullable<Env[K]> extends Type ? K : never;
 }[keyof Env], string>;
+type DurableObjectIdentifier = {
+    name: string;
+    id?: never;
+} | {
+    id: string;
+    name?: never;
+};
+type WorkerDefaultExport = (new (...args: any[]) => Rpc.WorkerEntrypointBranded) | Rpc.WorkerEntrypointBranded | AnyExportedHandler;
 type WorkerModule = {
-    default: WorkerExport;
-    [key: string]: WorkerExport | undefined;
+    default: WorkerDefaultExport;
 };
 type AnyExportedHandler = ExportedHandler<any, any, any, any>;
 type AnyEnv = Record<string, any>;
-type WorkerExport = (new (...args: any[]) => Rpc.WorkerEntrypointBranded) | Rpc.WorkerEntrypointBranded | AnyExportedHandler;
 type WorkerHandle<Env = AnyEnv, Module extends WorkerModule = {
     default: AnyExportedHandler;
 }> = {
@@ -829,9 +861,27 @@ type WorkerHandle<Env = AnyEnv, Module extends WorkerModule = {
      */
     getEnv(): Promise<Env>;
     /**
-     * Lists the string IDs of Durable Object instances with persisted storage for a binding.
+     * Lists the string IDs of Durable Object instances with persisted storage.
+     * Pass an exported Durable Object class name, or a Durable Object binding name.
+     */
+    listDurableObjectIds(classNameOrBindingName: ExportName<Module, Rpc.DurableObjectBranded> | BindingName<Env, DurableObjectNamespace>): Promise<string[]>;
+    /**
+     * Evicts a currently running Durable Object instance while preserving its durable storage.
+     * In-memory state is reset the next time the object starts.
+     * Pass an exported Durable Object class name, or a Durable Object binding name.
+     * Class names are resolved before binding names.
+     *
+     * @example
+     * ```ts
+     * await worker.evictDurableObject("Counter", {
+     *   name: "user-123",
+     *   webSockets: "hibernate",
+     * });
+     * ```
      */
-    listDurableObjectIds(bindingName: BindingName<Env, DurableObjectNamespace>): Promise<string[]>;
+    evictDurableObject(classNameOrBindingName: ExportName<Module, Rpc.DurableObjectBranded> | BindingName<Env, DurableObjectNamespace>, options: DurableObjectIdentifier & {
+        webSockets?: "close" | "hibernate";
+    }): Promise<void>;
     /**
      * Applies D1 migration files that have not already run to a D1 binding on this Worker.
      *
@@ -843,6 +893,25 @@ type WorkerHandle<Env = AnyEnv, Module extends WorkerModule = {
      * ```
      */
     applyD1Migrations(bindingName: BindingName<Env, D1Database>): Promise<void>;
+    /**
+     * Returns remote storage access for a Durable Object instance.
+     * Pass an exported Durable Object class name, or a Durable Object binding name.
+     * Class names are resolved before binding names.
+     *
+     * Use this to seed state before sending requests to the object, or to inspect
+     * state after awaited requests. Calling `exec()` runs SQL inside the target
+     * Durable Object and returns all rows. It may start the object if it is not
+     * already active.
+     *
+     * @example
+     * ```ts
+     * const sql = await worker.getDurableObjectStorage("COUNTER", {
+     *   name: "user-123"
+     * });
+     * const rows = await sql.exec("SELECT count FROM counters WHERE id = ?", "user-123");
+     * ```
+     */
+    getDurableObjectStorage(classNameOrBindingName: ExportName<Module, Rpc.DurableObjectBranded> | BindingName<Env, DurableObjectNamespace>, options: DurableObjectStorageOptions): Promise<DurableObjectStorageHandle>;
     /**
      * Creates an introspector for a specific Workflow instance.
      */
@@ -2742,13 +2811,6 @@ interface ComputedFields {
     targetEnvironment: string | undefined;
 }
 interface ConfigFields<Dev extends RawDevConfig> {
-    /**
-     * A boolean to enable "legacy" style wrangler environments (from Wrangler v1).
-     * These have been superseded by Services, but there may be projects that won't
-     * (or can't) use them. If you're using a legacy environment, you can set this
-     * to `true` to enable it.
-     */
-    legacy_env: boolean;
     /**
      * Whether Wrangler should send usage metrics to Cloudflare for this project.
      *
@@ -2868,6 +2930,19 @@ interface ConfigFields<Dev extends RawDevConfig> {
      * @nonInheritable
      */
     keep_vars?: boolean;
+    /**
+     * The inbound email addresses handled by the Worker being deployed.
+     *
+     * Each entry is a literal recipient address (e.g. `"support@example.com"`)
+     * or a `*@domain` catch-all (e.g. `"*@example.com"`). Every entry creates an
+     * Email Routing rule whose action routes mail to this Worker.
+     *
+     * This field is top-level only and applies to every environment of the
+     * Worker; it cannot be set under `env.*`.
+     *
+     * @nonInheritable
+     */
+    addresses?: string[];
 }
 interface PagesConfigFields {
     /**
@@ -3161,6 +3236,11 @@ type WorkerConfigObject = {
     complianceRegion?: Config$1["compliance_region"];
     /** Id of the account owning the worker */
     account_id?: Config$1["account_id"];
+    /**
+     * directory used to resolve the auth profile from directory bindings.
+     * Falls back to `process.cwd()` when not provided.
+     */
+    profileDir?: string;
 };
 /**
  * Utility for potentially starting or updating a remote proxy session.
@@ -3633,6 +3713,20 @@ declare class CommandRegistry {
      * Includes both registry-defined commands & legacy commands.
      */
     get topLevelCommands(): Set<string>;
+    /**
+     * Get the set of valid subcommand names at a given command path.
+     *
+     * Walks the definition tree along the given path segments, then returns
+     * the keys of the subtree at that node. Returns `undefined` if the path
+     * does not exist in the tree or has no subcommands.
+     *
+     * @param pathSegments - The command path segments to walk (e.g., `["kv"]`
+     *   returns `namespace`, `key`, `bulk`; `["kv", "namespace"]` returns
+     *   `create`, `list`, `delete`, etc.)
+     * @returns A set of valid subcommand names, or `undefined` if the path is
+     *   invalid or has no subcommands
+     */
+    getSubcommands(pathSegments: string[]): Set<string> | undefined;
     /**
      * Returns the map of categories to command segments, ordered according to
      * the category order. Commands within each category are sorted alphabetically.