wrangler 4.115.0 → 4.117.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wrangler",
-  "version": "4.115.0",
+  "version": "4.117.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.20260722.1",
+    "workerd": "1.20260730.1",
     "@cloudflare/kv-asset-handler": "0.5.0",
     "@cloudflare/unenv-preset": "2.16.1",
-    "miniflare": "4.20260722.1"
+    "miniflare": "5.20260730.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.20260722.1",
+    "@cloudflare/workers-types": "^5.20260730.1",
     "@cspotcode/source-map-support": "0.8.1",
     "@netlify/build-info": "^10.5.1",
     "@sentry/node": "^7.86.0",
@@ -156,23 +156,25 @@
     "yaml": "^2.8.1",
     "yargs": "^17.7.2",
     "zod": "4.4.3",
-    "@cloudflare/autoconfig": "0.2.1",
-    "@cloudflare/cli-shared-helpers": "0.1.17",
+    "@cloudflare/autoconfig": "0.2.3",
+    "@cloudflare/build-output-utils": "0.1.0",
+    "@cloudflare/cli-shared-helpers": "0.1.19",
     "@cloudflare/codemod": "1.1.0",
-    "@cloudflare/config": "0.3.0",
+    "@cloudflare/config": "0.4.0",
     "@cloudflare/containers-shared": "0.16.0",
-    "@cloudflare/deploy-helpers": "0.6.2",
-    "@cloudflare/pages-shared": "^0.13.161",
-    "@cloudflare/remote-bindings": "0.0.3",
-    "@cloudflare/runtime-types": "0.0.6",
-    "@cloudflare/workers-auth": "0.5.3",
+    "@cloudflare/deploy-helpers": "0.6.4",
+    "@cloudflare/pages-functions": "0.1.0",
+    "@cloudflare/pages-shared": "^0.13.163",
+    "@cloudflare/remote-bindings": "0.0.5",
+    "@cloudflare/runtime-types": "0.0.8",
+    "@cloudflare/workers-auth": "0.5.5",
     "@cloudflare/workers-shared": "0.19.9",
     "@cloudflare/workers-tsconfig": "0.0.0",
-    "@cloudflare/workers-utils": "0.29.0",
+    "@cloudflare/workers-utils": "0.31.0",
     "@cloudflare/workflows-shared": "0.12.2"
   },
   "peerDependencies": {
-    "@cloudflare/workers-types": "^5.20260722.1"
+    "@cloudflare/workers-types": "^5.20260730.1"
   },
   "peerDependenciesMeta": {
     "@cloudflare/workers-types": {

package/templates/new-worker-scheduled.js

@@ -2,7 +2,7 @@
  * Welcome to Cloudflare Workers! This is your first scheduled worker.
  *
  * - Run `wrangler dev` in your terminal to start a development server
- * - Run `curl "http://localhost:8787/cdn-cgi/handler/scheduled"` to trigger the scheduled event
+ * - Run `curl "http://localhost:8787/cdn-cgi/local/scheduled"` to trigger the scheduled event
  * - Go back to the console to see what your worker has logged
  * - Update the Cron trigger in wrangler.toml (see https://developers.cloudflare.com/workers/configuration/cron-triggers/)
  * - Run `wrangler publish --name my-worker` to publish your worker

package/templates/new-worker-scheduled.ts

@@ -2,7 +2,7 @@
  * Welcome to Cloudflare Workers! This is your first scheduled worker.
  *
  * - Run `wrangler dev` in your terminal to start a development server
- * - Run `curl "http://localhost:8787/cdn-cgi/handler/scheduled"` to trigger the scheduled event
+ * - Run `curl "http://localhost:8787/cdn-cgi/local/scheduled"` to trigger the scheduled event
  * - Go back to the console to see what your worker has logged
  * - Update the Cron trigger in wrangler.toml (see https://developers.cloudflare.com/workers/configuration/cron-triggers/)
  * - Run `wrangler deploy --name my-worker` to deploy your worker

package/templates/pages-template-worker.ts

@@ -1,3 +1,5 @@
+// This file is a copy of packages/pages-functions/src/templates/pages-template-worker.ts.
+// Changes here should be reflected there and vice-versa.
 import { match } from "path-to-regexp";
 
 //note: this explicitly does not include the * character, as pages requires this

package/templates/startDevWorker/ProxyWorker.ts

@@ -132,6 +132,13 @@ export class ProxyWorker implements DurableObject {
 				request.url
 			);
 
+			// rewrite requests to old miniflare paths
+			// because wrangler cannot have a breaking change
+			userWorkerUrl.pathname = rewriteLegacyMiniflarePath(
+				userWorkerUrl.pathname
+			);
+			innerUrl.pathname = rewriteLegacyMiniflarePath(innerUrl.pathname);
+
 			// Preserve client `Accept-Encoding`, rather than using Worker's default
 			// of `Accept-Encoding: br, gzip`
 			const encoding = request.cf?.clientAcceptEncoding;
@@ -238,6 +245,26 @@ export class ProxyWorker implements DurableObject {
 function isRequestFromProxyController(req: Request, env: Env): boolean {
 	return req.headers.get("Authorization") === env.PROXY_CONTROLLER_AUTH_SECRET;
 }
+
+// Miniflare v5 moved its internal endpoints under `/cdn-cgi/local/` (and
+// `/__cf_local/` for endpoints that must remain reachable over tunnels). These
+// map the pre-v5 paths onto their current equivalents.
+const LEGACY_PATH_REWRITES: readonly [string, string][] = [
+	["/cdn-cgi/handler", "/cdn-cgi/local"],
+	["/cdn-cgi/mf/scheduled", "/cdn-cgi/local/scheduled"],
+	["/cdn-cgi/mf/stream", "/__cf_local/stream"],
+	["/cdn-cgi/mf/imagedelivery", "/__cf_local/imagedelivery"],
+	["/cdn-cgi/explorer", "/cdn-cgi/local/explorer"],
+];
+
+function rewriteLegacyMiniflarePath(pathname: string): string {
+	for (const [oldPrefix, newPrefix] of LEGACY_PATH_REWRITES) {
+		if (pathname === oldPrefix || pathname.startsWith(`${oldPrefix}/`)) {
+			return newPrefix + pathname.slice(oldPrefix.length);
+		}
+	}
+	return pathname;
+}
 function isHtmlResponse(res: Response): boolean {
 	return res.headers.get("content-type")?.startsWith("text/html") ?? false;
 }

package/wrangler-dist/ProxyWorker.js

@@ -122,6 +122,10 @@ var ProxyWorker = class {
         proxyData.userWorkerInnerUrlOverrides ?? {},
         request.url
       );
+      userWorkerUrl.pathname = rewriteLegacyMiniflarePath(
+        userWorkerUrl.pathname
+      );
+      innerUrl.pathname = rewriteLegacyMiniflarePath(innerUrl.pathname);
       const encoding = request.cf?.clientAcceptEncoding;
       if (encoding !== void 0) headers.set("Accept-Encoding", encoding);
       rewriteUrlRelatedHeaders(headers, outerUrl, innerUrl);
@@ -180,6 +184,21 @@ var ProxyWorker = class {
 function isRequestFromProxyController(req, env) {
   return req.headers.get("Authorization") === env.PROXY_CONTROLLER_AUTH_SECRET;
 }
+var LEGACY_PATH_REWRITES = [
+  ["/cdn-cgi/handler", "/cdn-cgi/local"],
+  ["/cdn-cgi/mf/scheduled", "/cdn-cgi/local/scheduled"],
+  ["/cdn-cgi/mf/stream", "/__cf_local/stream"],
+  ["/cdn-cgi/mf/imagedelivery", "/__cf_local/imagedelivery"],
+  ["/cdn-cgi/explorer", "/cdn-cgi/local/explorer"]
+];
+function rewriteLegacyMiniflarePath(pathname) {
+  for (const [oldPrefix, newPrefix] of LEGACY_PATH_REWRITES) {
+    if (pathname === oldPrefix || pathname.startsWith(`${oldPrefix}/`)) {
+      return newPrefix + pathname.slice(oldPrefix.length);
+    }
+  }
+  return pathname;
+}
 function isHtmlResponse(res) {
   return res.headers.get("content-type")?.startsWith("text/html") ?? false;
 }

package/wrangler-dist/cli.d.ts

@@ -197,13 +197,13 @@ declare function deploy({ directory, accountId, projectName, branch, skipCaching
             };
         };
         latest_stage: {
-            status: "skipped" | "active" | "canceled" | "success" | "idle" | "failure";
+            status: "success" | "skipped" | "active" | "canceled" | "idle" | "failure";
             name: "queued" | "build" | "deploy" | "initialize" | "clone_repo";
             started_on: string | null;
             ended_on: string | null;
         };
         stages: {
-            status: "skipped" | "active" | "canceled" | "success" | "idle" | "failure";
+            status: "success" | "skipped" | "active" | "canceled" | "idle" | "failure";
             name: "queued" | "build" | "deploy" | "initialize" | "clone_repo";
             started_on: string | null;
             ended_on: string | null;
@@ -816,6 +816,33 @@ type DurableObjectIdentifier = {
     id: string;
     name?: never;
 };
+type FetcherEmailOptions = {
+    from: string;
+    to: string;
+    raw: string | ReadableStream<Uint8Array>;
+};
+type FetcherEmailResult = {
+    outcome: "ok" | "exception";
+    rejectReason?: string;
+    forwards: Array<{
+        messageId: string;
+        recipient: string;
+        headers: [string, string][];
+    }>;
+    replies: Array<{
+        messageId: string;
+        sender: string;
+        raw: string;
+    }>;
+    events: Array<{
+        type: "forward" | "reply";
+        timestamp: string;
+        messageId: string;
+    } | {
+        type: "reject";
+        timestamp: string;
+    }>;
+};
 type WorkerDefaultExport = (new (...args: any[]) => Rpc.WorkerEntrypointBranded) | Rpc.WorkerEntrypointBranded | AnyExportedHandler;
 type WorkerModule = {
     default: WorkerDefaultExport;
@@ -838,6 +865,19 @@ type WorkerHandle<Env = AnyEnv, Module extends WorkerModule = {
      * ```
      */
     fetch: DispatchFetch;
+    /**
+     * Dispatches an email event directly to this Worker.
+     *
+     * @example
+     * ```ts
+     * const result = await worker.email({
+     *   from: "sender@example.com",
+     *   to: "recipient@example.com",
+     *   raw: "From: sender@example.com\\r\\n...",
+     * });
+     * ```
+     */
+    email(options: FetcherEmailOptions): Promise<FetcherEmailResult>;
     /**
      * Dispatches a scheduled event directly to this Worker.
      *