wrangler 4.111.0 → 4.112.0

package/config-schema.json

@@ -1741,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.111.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.20260710.1",
-    "@cloudflare/kv-asset-handler": "0.5.0",
+    "workerd": "1.20260714.1",
     "@cloudflare/unenv-preset": "2.16.1",
-    "miniflare": "4.20260710.0"
+    "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.20260710.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.5",
+    "zod": "4.4.3",
+    "@cloudflare/autoconfig": "0.1.6",
     "@cloudflare/codemod": "1.1.0",
-    "@cloudflare/cli-shared-helpers": "0.1.14",
-    "@cloudflare/config": "0.2.0",
-    "@cloudflare/deploy-helpers": "0.5.0",
-    "@cloudflare/pages-shared": "^0.13.157",
+    "@cloudflare/config": "0.2.1",
     "@cloudflare/containers-shared": "0.16.0",
-    "@cloudflare/runtime-types": "0.0.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.8",
+    "@cloudflare/workers-shared": "0.19.9",
     "@cloudflare/workers-tsconfig": "0.0.0",
     "@cloudflare/workers-utils": "0.27.0",
-    "@cloudflare/workflows-shared": "0.12.0"
+    "@cloudflare/workflows-shared": "0.12.1"
   },
   "peerDependencies": {
-    "@cloudflare/workers-types": "^5.20260710.1"
+    "@cloudflare/workers-types": "^5.20260714.1"
   },
   "peerDependenciesMeta": {
     "@cloudflare/workers-types": {

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: {
@@ -869,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.
      */
@@ -2887,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 {
     /**