wrangler 4.47.0 → 4.49.0

package/config-schema.json

@@ -915,6 +915,14 @@
           "description": "Specifies a list of Tail Workers 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.",
           "default": []
         },
+        "streaming_tail_consumers": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/StreamingTailConsumer"
+          },
+          "description": "Specifies a list of Streaming Tail Workers 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.",
+          "default": []
+        },
         "dispatch_namespaces": {
           "type": "array",
           "items": {
@@ -2102,6 +2110,14 @@
           "description": "Specifies a list of Tail Workers 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.",
           "default": []
         },
+        "streaming_tail_consumers": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/StreamingTailConsumer"
+          },
+          "description": "Specifies a list of Streaming Tail Workers 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.",
+          "default": []
+        },
         "dispatch_namespaces": {
           "type": "array",
           "items": {
@@ -2861,6 +2877,19 @@
       ],
       "additionalProperties": false
     },
+    "StreamingTailConsumer": {
+      "type": "object",
+      "properties": {
+        "service": {
+          "type": "string",
+          "description": "The name of the service streaming tail events will be forwarded to."
+        }
+      },
+      "required": [
+        "service"
+      ],
+      "additionalProperties": false
+    },
     "DispatchNamespaceOutbound": {
       "type": "object",
       "properties": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wrangler",
-  "version": "4.47.0",
+  "version": "4.49.0",
   "description": "Command-line interface for all things Cloudflare Workers",
   "keywords": [
     "wrangler",
@@ -54,17 +54,16 @@
     "esbuild": "0.25.4",
     "path-to-regexp": "6.3.0",
     "unenv": "2.0.0-rc.24",
-    "workerd": "1.20251109.0",
+    "workerd": "1.20251113.0",
     "@cloudflare/kv-asset-handler": "0.4.0",
     "@cloudflare/unenv-preset": "2.7.10",
-    "miniflare": "4.20251109.0"
+    "miniflare": "4.20251113.0"
   },
   "devDependencies": {
     "@aws-sdk/client-s3": "^3.721.0",
     "@cloudflare/types": "6.18.4",
-    "@cloudflare/workers-types": "^4.20251109.0",
+    "@cloudflare/workers-types": "^4.20251113.0",
     "@cspotcode/source-map-support": "0.8.1",
-    "@iarna/toml": "^3.0.0",
     "@netlify/build-info": "^10.0.9",
     "@sentry/node": "^7.86.0",
     "@sentry/types": "^7.86.0",
@@ -119,7 +118,7 @@
     "msw": "2.4.3",
     "node-forge": "^1.3.1",
     "open": "^8.4.0",
-    "p-queue": "^7.2.0",
+    "p-queue": "^9.0.0",
     "patch-console": "^1.0.0",
     "pretty-bytes": "^6.0.0",
     "prompts": "^2.4.2",
@@ -129,6 +128,7 @@
     "semiver": "^1.1.0",
     "shell-quote": "^1.8.1",
     "signal-exit": "^3.0.7",
+    "smol-toml": "^1.5.2",
     "source-map": "^0.6.1",
     "strip-ansi": "^7.1.0",
     "supports-color": "^9.2.2",
@@ -146,17 +146,17 @@
     "xxhash-wasm": "^1.0.1",
     "yaml": "^2.8.1",
     "yargs": "^17.7.2",
-    "@cloudflare/cli": "1.1.3",
     "@cloudflare/containers-shared": "0.3.0",
+    "@cloudflare/cli": "1.1.3",
     "@cloudflare/eslint-config-shared": "1.1.0",
-    "@cloudflare/pages-shared": "^0.13.84",
-    "@cloudflare/workers-utils": "0.0.2",
-    "@cloudflare/workers-tsconfig": "0.0.0",
+    "@cloudflare/pages-shared": "^0.13.86",
     "@cloudflare/workers-shared": "0.18.8",
+    "@cloudflare/workers-utils": "0.1.1",
+    "@cloudflare/workers-tsconfig": "0.0.0",
     "@cloudflare/workflows-shared": "0.3.8"
   },
   "peerDependencies": {
-    "@cloudflare/workers-types": "^4.20251109.0"
+    "@cloudflare/workers-types": "^4.20251113.0"
   },
   "peerDependenciesMeta": {
     "@cloudflare/workers-types": {
@@ -167,7 +167,7 @@
     "fsevents": "~2.3.2"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   },
   "volta": {
     "extends": "../../package.json"

package/templates/startDevWorker/ProxyWorker.ts

@@ -151,11 +151,12 @@ export class ProxyWorker implements DurableObject {
 
 			// explicitly NOT await-ing this promise, we are in a loop and want to process the whole queue quickly + synchronously
 			void fetch(userWorkerUrl, new Request(request, { headers }))
-				.then((res) => {
+				.then(async (res) => {
 					res = new Response(res.body, res);
 					rewriteUrlRelatedHeaders(res.headers, innerUrl, outerUrl);
 
 					if (isHtmlResponse(res)) {
+						await checkForPreviewTokenError(res, this.env, proxyData);
 						res = insertLiveReloadScript(request, res, this.env, proxyData);
 					}
 
@@ -242,6 +243,28 @@ function sendMessageToProxyController(
 	});
 }
 
+async function checkForPreviewTokenError(
+	response: Response,
+	env: Env,
+	proxyData: ProxyData
+) {
+	if (response.status !== 400) {
+		return;
+	}
+
+	// At this point HTMLRewriter tries to parse the compressed stream,
+	// so we clone and read the text instead.
+	const clone = response.clone();
+	const text = await clone.text();
+	// Naive string match should be good enough when combined with status code check
+	if (text.includes("Invalid Workers Preview configuration")) {
+		void sendMessageToProxyController(env, {
+			type: "previewTokenExpired",
+			proxyData,
+		});
+	}
+}
+
 function insertLiveReloadScript(
 	request: Request,
 	response: Response,
@@ -250,26 +273,8 @@ function insertLiveReloadScript(
 ) {
 	const htmlRewriter = new HTMLRewriter();
 
-	// if preview-token-expired response, errorDetails will contain "Invalid Workers Preview configuration"
-	let errorDetails = "";
-	htmlRewriter.on("#cf-error-details", {
-		text(element) {
-			errorDetails += element.text;
-		},
-	});
-
 	htmlRewriter.onDocument({
 		end(end) {
-			if (
-				response.status === 400 &&
-				errorDetails.includes("Invalid Workers Preview configuration")
-			) {
-				void sendMessageToProxyController(env, {
-					type: "previewTokenExpired",
-					proxyData,
-				});
-			}
-
 			// if liveReload enabled, append a script tag
 			// TODO: compare to existing nodejs implementation
 			if (proxyData.liveReload) {

package/wrangler-dist/ProxyWorker.js

@@ -110,10 +110,11 @@ var ProxyWorker = class {
           headers.set(key, value);
         }
       }
-      void fetch(userWorkerUrl, new Request(request, { headers })).then((res) => {
+      void fetch(userWorkerUrl, new Request(request, { headers })).then(async (res) => {
         res = new Response(res.body, res);
         rewriteUrlRelatedHeaders(res.headers, innerUrl, outerUrl);
         if (isHtmlResponse(res)) {
+          await checkForPreviewTokenError(res, this.env, proxyData);
           res = insertLiveReloadScript(request, res, this.env, proxyData);
         }
         deferredResponse.resolve(res);
@@ -164,22 +165,23 @@ function sendMessageToProxyController(env, message) {
     body: JSON.stringify(message)
   });
 }
+async function checkForPreviewTokenError(response, env, proxyData) {
+  if (response.status !== 400) {
+    return;
+  }
+  const clone = response.clone();
+  const text = await clone.text();
+  if (text.includes("Invalid Workers Preview configuration")) {
+    void sendMessageToProxyController(env, {
+      type: "previewTokenExpired",
+      proxyData
+    });
+  }
+}
 function insertLiveReloadScript(request, response, env, proxyData) {
   const htmlRewriter = new HTMLRewriter();
-  let errorDetails = "";
-  htmlRewriter.on("#cf-error-details", {
-    text(element) {
-      errorDetails += element.text;
-    }
-  });
   htmlRewriter.onDocument({
     end(end) {
-      if (response.status === 400 && errorDetails.includes("Invalid Workers Preview configuration")) {
-        void sendMessageToProxyController(env, {
-          type: "previewTokenExpired",
-          proxyData
-        });
-      }
       if (proxyData.liveReload) {
         const websocketUrl = new URL(request.url);
         websocketUrl.protocol = websocketUrl.protocol === "http:" ? "ws:" : "wss:";

package/wrangler-dist/cli.d.ts

@@ -5,8 +5,8 @@ import * as undici from 'undici';
 import { RequestInfo, RequestInit, Response, FormData } from 'undici';
 import { RouterConfig, AssetConfig } from '@cloudflare/workers-shared';
 import { Metafile } from 'esbuild';
-import { EventEmitter } from 'node:events';
 import Protocol from 'devtools-protocol/types/protocol-mapping';
+import { EventEmitter } from 'node:events';
 import { ContainerNormalizedConfig } from '@cloudflare/containers-shared';
 import { IncomingRequestCfProperties } from '@cloudflare/workers-types/experimental';
 import { URLSearchParams } from 'node:url';
@@ -328,10 +328,7 @@ interface CfAccount {
     accountId: string;
 }
 
-type ConfigControllerEventMap = ControllerEventMap & {
-    configUpdate: [ConfigUpdateEvent];
-};
-declare class ConfigController extends Controller<ConfigControllerEventMap> {
+declare class ConfigController extends Controller {
     #private;
     latestInput?: StartDevWorkerInput;
     latestConfig?: StartDevWorkerOptions;
@@ -392,6 +389,7 @@ interface StartDevWorkerInput {
     /** The triggers which will cause the worker's exported default handlers to be called. */
     triggers?: Trigger[];
     tailConsumers?: CfTailConsumer[];
+    streamingTailConsumers?: CfTailConsumer[];
     /**
      * Whether Wrangler should send usage metrics to Cloudflare for this project.
      *
@@ -734,49 +732,27 @@ type ProxyData = {
     proxyLogsToController?: boolean;
 };
 
-interface TypedEventEmitter<EventMap extends Record<string | symbol, unknown[]>> extends EventEmitter {
-    addListener<Name extends keyof EventMap>(eventName: Name, listener: (...args: EventMap[Name]) => void): this;
-    on<Name extends keyof EventMap>(eventName: Name, listener: (...args: EventMap[Name]) => void): this;
-    once<Name extends keyof EventMap>(eventName: Name, listener: (...args: EventMap[Name]) => void): this;
-    removeListener<Name extends keyof EventMap>(eventName: Name, listener: (...args: EventMap[Name]) => void): this;
-    off<Name extends keyof EventMap>(eventName: Name, listener: (...args: EventMap[Name]) => void): this;
-    removeAllListeners(event?: keyof EventMap): this;
-    listeners<Name extends keyof EventMap>(eventName: Name): ((...args: EventMap[Name]) => void)[];
-    rawListeners<Name extends keyof EventMap>(eventName: Name): ((...args: EventMap[Name]) => void)[];
-    emit<Name extends keyof EventMap>(eventName: Name, ...args: EventMap[Name]): boolean;
-    listenerCount<Name extends keyof EventMap>(eventName: Name, listener?: (...args: EventMap[Name]) => void): number;
-    prependListener<Name extends keyof EventMap>(eventName: Name, listener: (...args: EventMap[Name]) => void): this;
-    prependOnceListener<Name extends keyof EventMap>(eventName: Name, listener: (...args: EventMap[Name]) => void): this;
+type ControllerEvent = ErrorEvent | ConfigUpdateEvent | BundleStartEvent | BundleCompleteEvent | ReloadStartEvent | ReloadCompleteEvent | DevRegistryUpdateEvent | PreviewTokenExpiredEvent;
+interface ControllerBus {
+    dispatch(event: ControllerEvent): void;
 }
-declare const TypedEventEmitterImpl: {
-    new <EventMap extends Record<string | symbol, unknown[]>>(): TypedEventEmitter<EventMap>;
-};
-type ControllerEventMap = {
-    error: [ErrorEvent];
-};
-declare abstract class Controller<EventMap extends ControllerEventMap = ControllerEventMap> extends TypedEventEmitterImpl<EventMap> {
+declare abstract class Controller {
     #private;
+    protected bus: ControllerBus;
+    constructor(bus: ControllerBus);
     teardown(): Promise<void>;
-    emitErrorEvent(event: ErrorEvent): void;
+    protected emitErrorEvent(event: ErrorEvent): void;
 }
-type RuntimeControllerEventMap = ControllerEventMap & {
-    reloadStart: [ReloadStartEvent];
-    reloadComplete: [ReloadCompleteEvent];
-    devRegistryUpdate: [DevRegistryUpdateEvent];
-};
-declare abstract class RuntimeController extends Controller<RuntimeControllerEventMap> {
+declare abstract class RuntimeController extends Controller {
     abstract onBundleStart(_: BundleStartEvent): void;
     abstract onBundleComplete(_: BundleCompleteEvent): void;
     abstract onPreviewTokenExpired(_: PreviewTokenExpiredEvent): void;
-    abstract emitReloadStartEvent(data: ReloadStartEvent): void;
-    abstract emitReloadCompleteEvent(data: ReloadCompleteEvent): void;
+    protected emitReloadStartEvent(data: ReloadStartEvent): void;
+    protected emitReloadCompleteEvent(data: ReloadCompleteEvent): void;
+    protected emitDevRegistryUpdateEvent(data: DevRegistryUpdateEvent): void;
 }
 
-type BundlerControllerEventMap = ControllerEventMap & {
-    bundleStart: [BundleStartEvent];
-    bundleComplete: [BundleCompleteEvent];
-};
-declare class BundlerController extends Controller<BundlerControllerEventMap> {
+declare class BundlerController extends Controller {
     #private;
     onConfigUpdate(event: ConfigUpdateEvent): void;
     teardown(): Promise<void>;
@@ -792,11 +768,7 @@ type DeferredPromise<T> = {
 };
 declare function convertConfigBindingsToStartWorkerBindings(configBindings: ConfigBindingOptions): StartDevWorkerOptions["bindings"];
 
-type ProxyControllerEventMap = ControllerEventMap & {
-    ready: [ReadyEvent];
-    previewTokenExpired: [PreviewTokenExpiredEvent];
-};
-declare class ProxyController extends Controller<ProxyControllerEventMap> {
+declare class ProxyController extends Controller {
     ready: DeferredPromise<ReadyEvent>;
     localServerReady: DeferredPromise<void>;
     proxyWorker?: Miniflare;
@@ -826,20 +798,36 @@ declare class ProxyController extends Controller<ProxyControllerEventMap> {
     emitErrorEvent(reason: string, cause?: Error | SerializedError): void;
 }
 
-declare class DevEnv extends EventEmitter {
+type ControllerFactory<C extends Controller> = (devEnv: DevEnv) => C;
+declare class DevEnv extends EventEmitter implements ControllerBus {
     config: ConfigController;
     bundler: BundlerController;
     runtimes: RuntimeController[];
     proxy: ProxyController;
     startWorker(options: StartDevWorkerInput): Promise<Worker>;
-    constructor({ config, bundler, runtimes, proxy, }?: {
-        config?: ConfigController | undefined;
-        bundler?: BundlerController | undefined;
-        runtimes?: RuntimeController[] | undefined;
-        proxy?: ProxyController | undefined;
+    constructor({ configFactory, bundlerFactory, runtimeFactories, proxyFactory, }?: {
+        configFactory?: ControllerFactory<ConfigController>;
+        bundlerFactory?: ControllerFactory<BundlerController>;
+        runtimeFactories?: ControllerFactory<RuntimeController>[];
+        proxyFactory?: ControllerFactory<ProxyController>;
     });
+    /**
+     * Central message bus dispatch method.
+     * All events from controllers flow through here, making the event routing explicit and traceable.
+     *
+     * Event flow:
+     * - ConfigController emits configUpdate → BundlerController, ProxyController
+     * - BundlerController emits bundleStart → ProxyController, RuntimeControllers
+     * - BundlerController emits bundleComplete → RuntimeControllers
+     * - RuntimeController emits reloadStart → ProxyController
+     * - RuntimeController emits reloadComplete → ProxyController
+     * - RuntimeController emits devRegistryUpdate → ConfigController
+     * - ProxyController emits previewTokenExpired → RuntimeControllers
+     * - Any controller emits error → DevEnv error handler
+     */
+    dispatch(event: ControllerEvent): void;
+    private handleErrorEvent;
     teardown(): Promise<void>;
-    emitErrorEvent(ev: ErrorEvent): void;
 }
 
 declare function startWorker(options: StartDevWorkerInput): Promise<Worker>;
@@ -857,6 +845,8 @@ type ReadConfigOptions = ResolveConfigPathOptions & {
  */
 declare function readConfig(args: ReadConfigCommandArgs, options?: ReadConfigOptions): Config;
 
+declare function getDurableObjectClassNameToUseSQLiteMap(migrations: Config["migrations"] | undefined): Map<string, boolean>;
+
 /**
  * Note about this file:
  *
@@ -1138,11 +1128,21 @@ declare class Logger {
  */
 declare function splitSqlQuery(sql: string): string[];
 
+type ConfigurationOptions = {
+    outputDir: string;
+    projectPath: string;
+    workerName: string;
+    dryRun: boolean;
+};
 declare abstract class Framework {
     abstract name: string;
+    preview?: string;
+    deploy?: string;
+    typegen?: string;
     /** Some frameworks (i.e. Nuxt) don't need additional configuration */
     get configured(): boolean;
-    abstract configure(outputDir: string): Promise<RawConfig> | RawConfig;
+    abstract configure(options: ConfigurationOptions): Promise<RawConfig> | RawConfig;
+    configurationDescription?: string;
 }
 
 type AutoConfigDetails = {
@@ -1161,13 +1161,29 @@ type AutoConfigDetails = {
     /** The output directory (if no framework is used, points to the raw asset files) */
     outputDir?: string;
 };
+type AutoConfigOptions = {
+    /** Whether to run autoconfig without actually applying any filesystem modification (default: false) */
+    dryRun?: boolean;
+    /**
+     * Whether the build command should be run (default: true)
+     *
+     * Note: When `dryRun` is `true` the build command is never run.
+     */
+    runBuild?: boolean;
+    /**
+     * Whether the confirmation prompts should be skipped (default: false)
+     *
+     * Note: When `dryRun` is `true` the the confirmation prompts are always skipped.
+     */
+    skipConfirmations?: boolean;
+};
 
 declare function getDetailsForAutoConfig({ projectPath, wranglerConfig, }?: {
     projectPath?: string;
     wranglerConfig?: Config;
 }): Promise<AutoConfigDetails>;
 
-declare function runAutoConfig(autoConfigDetails: AutoConfigDetails): Promise<void>;
+declare function runAutoConfig(autoConfigDetails: AutoConfigDetails, autoConfigOptions?: AutoConfigOptions): Promise<void>;
 
 /**
  * Make a fetch request, and extract the `result` from the JSON response.
@@ -1487,4 +1503,4 @@ interface Unstable_ASSETSBindingsOptions {
 }
 declare const generateASSETSBinding: (opts: Unstable_ASSETSBindingsOptions) => (request: Request) => Promise<Response$1>;
 
-export { type Binding, type GetPlatformProxyOptions, type PlatformProxy, type RemoteProxySession, type SourcelessWorkerOptions, type StartRemoteProxySessionOptions, type Unstable_ASSETSBindingsOptions, type Unstable_DevOptions, type Unstable_DevWorker, type Unstable_MiniflareWorkerOptions, Framework as experimental_AutoConfigFramework, getDetailsForAutoConfig as experimental_getDetailsForAutoConfig, experimental_getWranglerCommands, runAutoConfig as experimental_runAutoConfig, getPlatformProxy, maybeStartOrUpdateRemoteProxySession, startRemoteProxySession, DevEnv as unstable_DevEnv, convertConfigBindingsToStartWorkerBindings as unstable_convertConfigBindingsToStartWorkerBindings, unstable_dev, generateASSETSBinding as unstable_generateASSETSBinding, unstable_getMiniflareWorkerOptions, getVarsForDev as unstable_getVarsForDev, unstable_pages, readConfig as unstable_readConfig, splitSqlQuery as unstable_splitSqlQuery, startWorker as unstable_startWorker };
+export { type Binding, type GetPlatformProxyOptions, type PlatformProxy, type RemoteProxySession, type SourcelessWorkerOptions, type StartRemoteProxySessionOptions, type Unstable_ASSETSBindingsOptions, type Unstable_DevOptions, type Unstable_DevWorker, type Unstable_MiniflareWorkerOptions, Framework as experimental_AutoConfigFramework, getDetailsForAutoConfig as experimental_getDetailsForAutoConfig, experimental_getWranglerCommands, runAutoConfig as experimental_runAutoConfig, getPlatformProxy, maybeStartOrUpdateRemoteProxySession, startRemoteProxySession, DevEnv as unstable_DevEnv, convertConfigBindingsToStartWorkerBindings as unstable_convertConfigBindingsToStartWorkerBindings, unstable_dev, generateASSETSBinding as unstable_generateASSETSBinding, getDurableObjectClassNameToUseSQLiteMap as unstable_getDurableObjectClassNameToUseSQLiteMap, unstable_getMiniflareWorkerOptions, getVarsForDev as unstable_getVarsForDev, unstable_pages, readConfig as unstable_readConfig, splitSqlQuery as unstable_splitSqlQuery, startWorker as unstable_startWorker };