wrangler 4.112.0 → 4.113.0

package/config-schema.json

@@ -570,8 +570,7 @@
                   }
                 },
                 "required": [
-                  "binding",
-                  "queue"
+                  "binding"
                 ],
                 "additionalProperties": false
               },
@@ -1305,8 +1304,7 @@
               }
             },
             "required": [
-              "binding",
-              "namespace"
+              "binding"
             ],
             "additionalProperties": false
           },
@@ -1460,8 +1458,7 @@
               }
             },
             "required": [
-              "binding",
-              "app_id"
+              "binding"
             ],
             "additionalProperties": false
           },
@@ -1650,6 +1647,14 @@
               "type": "boolean",
               "description": "Whether dependency instrumentation is enabled. Defaults to `true`.",
               "markdownDescription": "Whether dependency instrumentation is enabled. Defaults to `true`."
+            },
+            "exclude_packages": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "An optional list of package name patterns to exclude from the collected dependency metadata.\n\nEach entry can be an exact package name (e.g. `\"lodash\"`) or a glob pattern using `*` as a wildcard (e.g. `\"@internal/*\"` to exclude all packages under the `@internal` scope).",
+              "markdownDescription": "An optional list of package name patterns to exclude from the\ncollected dependency metadata.\n\nEach entry can be an exact package name (e.g. `\"lodash\"`) or a glob\npattern using `*` as a wildcard (e.g. `\"@internal/*\"` to exclude all\npackages under the `@internal` scope)."
             }
           },
           "required": [
@@ -2307,8 +2312,7 @@
                   }
                 },
                 "required": [
-                  "binding",
-                  "queue"
+                  "binding"
                 ],
                 "additionalProperties": false
               },
@@ -3042,8 +3046,7 @@
               }
             },
             "required": [
-              "binding",
-              "namespace"
+              "binding"
             ],
             "additionalProperties": false
           },
@@ -3197,8 +3200,7 @@
               }
             },
             "required": [
-              "binding",
-              "app_id"
+              "binding"
             ],
             "additionalProperties": false
           },
@@ -3890,16 +3892,16 @@
       "additionalProperties": false,
       "properties": {
         "logpush": {
-          "$ref": "#/definitions/interface-769040647-10589-20711-769040647-0-526752004818536"
+          "$ref": "#/definitions/interface-769040647-10591-20713-769040647-0-526802004818536"
         },
         "observability": {
-          "$ref": "#/definitions/interface-769040647-10589-20711-769040647-0-526752004818536"
+          "$ref": "#/definitions/interface-769040647-10591-20713-769040647-0-526802004818536"
         },
         "limits": {
-          "$ref": "#/definitions/interface-769040647-10589-20711-769040647-0-526752004818536"
+          "$ref": "#/definitions/interface-769040647-10591-20713-769040647-0-526802004818536"
         },
         "cache": {
-          "$ref": "#/definitions/interface-769040647-10589-20711-769040647-0-526752004818536"
+          "$ref": "#/definitions/interface-769040647-10591-20713-769040647-0-526802004818536"
         },
         "define": {
           "type": "object",
@@ -4094,8 +4096,7 @@
                   }
                 },
                 "required": [
-                  "binding",
-                  "queue"
+                  "binding"
                 ],
                 "additionalProperties": false
               },
@@ -4829,8 +4830,7 @@
               }
             },
             "required": [
-              "binding",
-              "namespace"
+              "binding"
             ],
             "additionalProperties": false
           },
@@ -4984,8 +4984,7 @@
               }
             },
             "required": [
-              "binding",
-              "app_id"
+              "binding"
             ],
             "additionalProperties": false
           },
@@ -5161,7 +5160,7 @@
       "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`, `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`, `cache`"
     },
-    "interface-769040647-10589-20711-769040647-0-526752004818536": {
+    "interface-769040647-10591-20713-769040647-0-526802004818536": {
       "type": "object",
       "properties": {
         "name": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wrangler",
-  "version": "4.112.0",
+  "version": "4.113.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.20260714.1",
+    "workerd": "1.20260721.1",
     "@cloudflare/unenv-preset": "2.16.1",
-    "miniflare": "4.20260714.0",
-    "@cloudflare/kv-asset-handler": "0.5.0"
+    "@cloudflare/kv-asset-handler": "0.5.0",
+    "miniflare": "4.20260721.0"
   },
   "devDependencies": {
     "@aws-sdk/client-s3": "^3.721.0",
     "@bomb.sh/tab": "^0.0.12",
     "@cloudflare/types": "6.18.4",
-    "@cloudflare/workers-types": "^5.20260714.1",
+    "@cloudflare/workers-types": "^5.20260721.1",
     "@cspotcode/source-map-support": "0.8.1",
     "@netlify/build-info": "^10.5.1",
     "@sentry/node": "^7.86.0",
@@ -155,22 +155,23 @@
     "yaml": "^2.8.1",
     "yargs": "^17.7.2",
     "zod": "4.4.3",
-    "@cloudflare/autoconfig": "0.1.6",
+    "@cloudflare/autoconfig": "0.2.0",
+    "@cloudflare/cli-shared-helpers": "0.1.16",
     "@cloudflare/codemod": "1.1.0",
-    "@cloudflare/config": "0.2.1",
+    "@cloudflare/config": "0.3.0",
     "@cloudflare/containers-shared": "0.16.0",
-    "@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/deploy-helpers": "0.6.0",
+    "@cloudflare/runtime-types": "0.0.4",
+    "@cloudflare/pages-shared": "^0.13.159",
+    "@cloudflare/remote-bindings": "0.0.1",
+    "@cloudflare/workers-auth": "0.5.1",
     "@cloudflare/workers-shared": "0.19.9",
+    "@cloudflare/workers-utils": "0.28.0",
     "@cloudflare/workers-tsconfig": "0.0.0",
-    "@cloudflare/workers-utils": "0.27.0",
     "@cloudflare/workflows-shared": "0.12.1"
   },
   "peerDependencies": {
-    "@cloudflare/workers-types": "^5.20260714.1"
+    "@cloudflare/workers-types": "^5.20260721.1"
   },
   "peerDependenciesMeta": {
     "@cloudflare/workers-types": {

package/templates/middleware/middleware-miniflare3-json-error.ts

@@ -22,10 +22,20 @@ const jsonError: Middleware = async (request, env, _ctx, middlewareCtx) => {
 		return await middlewareCtx.next(request, env);
 	} catch (e: any) {
 		const error = reduceError(e);
-		return Response.json(error, {
-			status: 500,
-			headers: { "MF-Experimental-Error-Stack": "true" },
-		});
+		const body = JSON.stringify(error);
+		const headers: Record<string, string> = {
+			"Content-Type": "application/json",
+			"MF-Experimental-Error-Stack": "true",
+		};
+		// `workerd` drops response bodies for `HEAD` requests, so also carry the
+		// serialised error in a header. Past roughly 16KB of encoded header the
+		// runtime drops the whole response, so stay well under that; the body
+		// remains the primary channel for every method that keeps one.
+		const encoded = encodeURIComponent(body);
+		if (encoded.length <= 8192) {
+			headers["MF-Experimental-Error-Stack-Payload"] = encoded;
+		}
+		return new Response(body, { status: 500, headers });
 	}
 };
 

package/templates/startDevWorker/ProxyWorker.ts

@@ -1,6 +1,6 @@
 import {
 	createDeferred,
-	DeferredPromise,
+	type DeferredPromise,
 	rewriteUrlInHeaderValue,
 	urlFromParts,
 } from "../../src/api/startDevWorker/utils";

package/wrangler-dist/cli.d.ts

@@ -1,4 +1,4 @@
-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';
+import { Rule as Rule$1, CfModule, Environment as Environment$1, Entry, CfModuleType, Config as Config$1, StartDevWorkerInput, NodeJSCompatMode, CfScriptFormat, AsyncHook, CfAccount, AssetsOptions as AssetsOptions$1, Binding, ConfigBindingFieldName, RawConfig as RawConfig$1, NormalizeAndValidateConfigArgs, ResolveConfigPathOptions, ParseError, LoggerLevel, ComplianceConfig, ApiCredentials, 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, DurableObjectStorageOptions, DurableObjectStorageHandle, RemoteProxyConnectionString, WorkerOptions, ModuleRule, Request } from 'miniflare';
 import * as undici from 'undici';
@@ -11,6 +11,8 @@ import { ContainerNormalizedConfig } from '@cloudflare/containers-shared';
 import { Rpc, ExportedHandler, DurableObjectNamespace, D1Database, Workflow, Service } from '@cloudflare/workers-types';
 import { FetcherScheduledOptions, FetcherScheduledResult, IncomingRequestCfProperties } from '@cloudflare/workers-types/experimental';
 import { RouterConfig, AssetConfig } from '@cloudflare/workers-shared';
+import { StartRemoteProxySessionOptions as StartRemoteProxySessionOptions$1, RemoteProxySession, WorkerConfigObject, RemoteProxySessionData } from '@cloudflare/remote-bindings';
+export { RemoteProxySession } from '@cloudflare/remote-bindings';
 export { printBindings as unstable_printBindings } from '@cloudflare/deploy-helpers';
 import { URLSearchParams } from 'node:url';
 import { Argv, PositionalOptions, Options, ArgumentsCamelCase, InferredOptionTypes, InferredOptionType } from 'yargs';
@@ -392,7 +394,7 @@ type StartDevWorkerOptions = Omit<StartDevWorkerInput, "assets" | "config" | "co
     };
     dev: StartDevWorkerInput["dev"] & {
         persist: string | false;
-        auth?: AsyncHook<CfAccount$1>;
+        auth?: AsyncHook<CfAccount>;
         /** Handles structured runtime logs. */
         structuredLogsHandler?: (log: WorkerdStructuredLog) => void;
         /** An undici MockAgent to declaratively mock fetch calls to particular resources. */
@@ -736,6 +738,7 @@ type AdditionalDevProps = {
     moduleRoot?: string;
     rules?: Rule$1[];
     showInteractiveDevSession?: boolean;
+    showLocalExplorerAgentHint?: boolean;
 };
 type DevArguments = Omit<(typeof dev)["args"], "installSkills" | "profile">;
 type StartDevOptions = DevArguments & AdditionalDevProps & {
@@ -1151,7 +1154,7 @@ type AssetsOptions = {
 /**
  * Wrangler configuration types. The JSDoc on these fields is also the source
  * of truth for the equivalent fields in `@cloudflare/config`
- * (`packages/config/src/types.ts` — `UserConfig` — and the binding option
+ * (`packages/config/src/types.ts` — `WorkerConfig` — and the binding option
  * interfaces in `packages/config/src/config.ts`). When editing prose here,
  * mirror the changes there.
  */
@@ -2037,7 +2040,7 @@ interface EnvironmentNonInheritable {
             /** The binding name used to refer to the Queue in the Worker. */
             binding: string;
             /** The name of this Queue. */
-            queue: string;
+            queue?: string;
             /** The number of seconds to wait before delivering a message */
             delivery_delay?: number;
             /** Whether the Queue producer should be remote or not in local development */
@@ -2464,7 +2467,7 @@ interface EnvironmentNonInheritable {
         /** The binding name used to refer to the bound service. */
         binding: string;
         /** The namespace to bind to. */
-        namespace: string;
+        namespace?: string;
         /** Details about the outbound Worker which will handle outbound requests from your namespace */
         outbound?: DispatchNamespaceOutbound;
         /** Whether the Dispatch Namespace should be remote or not in local development */
@@ -2555,7 +2558,7 @@ interface EnvironmentNonInheritable {
         /** The binding name used to refer to the bound Flagship service. */
         binding: string;
         /** The Flagship app ID to bind to. */
-        app_id: string;
+        app_id?: string;
         /** Set to `true` to suppress the remote binding warning in local dev. Flagship bindings are always remote. */
         remote?: boolean;
     }[];
@@ -2835,6 +2838,15 @@ interface ConfigFields<Dev extends RawDevConfig> {
     dependencies_instrumentation: {
         /** Whether dependency instrumentation is enabled. Defaults to `true`. */
         enabled: boolean;
+        /**
+         * An optional list of package name patterns to exclude from the
+         * collected dependency metadata.
+         *
+         * Each entry can be an exact package name (e.g. `"lodash"`) or a glob
+         * pattern using `*` as a wildcard (e.g. `"@internal/*"` to exclude all
+         * packages under the `@internal` scope).
+         */
+        exclude_packages?: string[];
     } | undefined;
     /**
      * Options to configure the development server that your worker will use.
@@ -3193,75 +3205,14 @@ declare function unstable_getMiniflareWorkerOptions(config: Config, env?: string
     containerBuildId?: string;
 }): Unstable_MiniflareWorkerOptions;
 
-/**
- * A Cloudflare account.
- */
-interface CfAccount {
-    /**
-     * An API token.
-     *
-     * @link https://api.cloudflare.com/#user-api-tokens-properties
-     */
-    apiToken: ApiCredentials;
-    /**
-     * An account ID.
-     */
-    accountId: string;
-}
-
-type StartRemoteProxySessionOptions = {
-    workerName?: string;
-    auth?: NonNullable<StartDevWorkerInput["dev"]>["auth"];
-    /** If running in a non-public compliance region, set this here. */
-    complianceRegion?: Config$1["compliance_region"];
-};
+type StartRemoteProxySessionOptions = Omit<StartRemoteProxySessionOptions$1, "logger">;
 declare function startRemoteProxySession(bindings: StartDevWorkerInput["bindings"], options?: StartRemoteProxySessionOptions): Promise<RemoteProxySession>;
-type RemoteProxySession = Pick<Worker, "ready" | "dispose"> & {
-    updateBindings: (bindings: StartDevWorkerInput["bindings"]) => Promise<void>;
-    remoteProxyConnectionString: RemoteProxyConnectionString;
-};
 
 type WranglerConfigObject = {
-    /** The path to the wrangler config file */
     path: string;
-    /** The target environment */
     environment?: string;
 };
-type WorkerConfigObject = {
-    /** The name of the worker */
-    name?: string;
-    /** The Worker's bindings */
-    bindings: NonNullable<StartDevWorkerInput["bindings"]>;
-    /** If running in a non-public compliance region, set this here. */
-    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.
- *
- * @param wranglerOrWorkerConfigObject either a file path to a wrangler configuration file or an object containing the name of
- *                                 the target worker alongside its bindings.
- * @param preExistingRemoteProxySessionData the optional data of a pre-existing remote proxy session if there was one, this
- *                                          argument can be omitted or set to null if there is no pre-existing remote proxy session
- * @param auth the authentication information for establishing the remote proxy connection
- * @returns null if no existing remote proxy session was provided and one should not be created (because the worker is not
- *          defining any remote bindings), the data associated to the created/updated remote proxy session otherwise.
- */
-declare function maybeStartOrUpdateRemoteProxySession(wranglerOrWorkerConfigObject: WranglerConfigObject | WorkerConfigObject, preExistingRemoteProxySessionData?: {
-    session: RemoteProxySession;
-    remoteBindings: Record<string, Binding>;
-    auth?: AsyncHook<CfAccount> | undefined;
-} | null, auth?: AsyncHook<CfAccount> | undefined): Promise<{
-    session: RemoteProxySession;
-    remoteBindings: Record<string, Binding>;
-    auth?: AsyncHook<CfAccount> | undefined;
-} | null>;
+declare function maybeStartOrUpdateRemoteProxySession(wranglerOrWorkerConfigObject: WranglerConfigObject | WorkerConfigObject, preExistingRemoteProxySessionData?: RemoteProxySessionData | null, auth?: AsyncHook<CfAccount>): Promise<RemoteProxySessionData | null>;
 
 type TableRow<Keys extends string> = Record<Keys, string>;
 declare class Logger {
@@ -3833,4 +3784,4 @@ interface Unstable_ASSETSBindingsOptions {
 }
 declare const unstable_generateASSETSBinding: (opts: Unstable_ASSETSBindingsOptions) => (request: Request) => Promise<Response$1>;
 
-export { ArgParseError, type Experimental_GenerateTypesOptions, type Experimental_GenerateTypesResult, type GetPlatformProxyOptions, type PlatformProxy, type RemoteProxySession, type SourcelessWorkerOptions, type StartRemoteProxySessionOptions, type TestHarness, type TestHarnessOptions, type Unstable_ASSETSBindingsOptions, type Config as Unstable_Config, type Unstable_DevOptions, type Unstable_DevWorker, type Unstable_MiniflareWorkerOptions, type RawConfig as Unstable_RawConfig, type RawEnvironment as Unstable_RawEnvironment, type WorkerHandle, createTestHarness, generateTypes as experimental_generateTypes, experimental_getWranglerCommands, getPlatformProxy, maybeStartOrUpdateRemoteProxySession, parseArgs as parseCfWranglerArgs, parseBuildArgs as parseCfWranglerBuildArgs, runCfWranglerBuild, runCfWranglerDev, startRemoteProxySession, DevEnv as unstable_DevEnv, convertConfigBindingsToStartWorkerBindings as unstable_convertConfigBindingsToStartWorkerBindings, unstable_dev, unstable_generateASSETSBinding, unstable_getDevCompatibilityDate, getDurableObjectClassNameToUseSQLiteMap as unstable_getDurableObjectClassNameToUseSQLiteMap, unstable_getMiniflareWorkerOptions, getVarsForDev as unstable_getVarsForDev, unstable_pages, readConfig as unstable_readConfig, resolveNamedTunnel as unstable_resolveNamedTunnel, splitSqlQuery as unstable_splitSqlQuery, startWorker as unstable_startWorker };
+export { ArgParseError, type Experimental_GenerateTypesOptions, type Experimental_GenerateTypesResult, type GetPlatformProxyOptions, type PlatformProxy, type SourcelessWorkerOptions, type StartRemoteProxySessionOptions, type TestHarness, type TestHarnessOptions, type Unstable_ASSETSBindingsOptions, type Config as Unstable_Config, type Unstable_DevOptions, type Unstable_DevWorker, type Unstable_MiniflareWorkerOptions, type RawConfig as Unstable_RawConfig, type RawEnvironment as Unstable_RawEnvironment, type WorkerHandle, createTestHarness, generateTypes as experimental_generateTypes, experimental_getWranglerCommands, getPlatformProxy, maybeStartOrUpdateRemoteProxySession, parseArgs as parseCfWranglerArgs, parseBuildArgs as parseCfWranglerBuildArgs, runCfWranglerBuild, runCfWranglerDev, startRemoteProxySession, DevEnv as unstable_DevEnv, convertConfigBindingsToStartWorkerBindings as unstable_convertConfigBindingsToStartWorkerBindings, unstable_dev, unstable_generateASSETSBinding, unstable_getDevCompatibilityDate, getDurableObjectClassNameToUseSQLiteMap as unstable_getDurableObjectClassNameToUseSQLiteMap, unstable_getMiniflareWorkerOptions, getVarsForDev as unstable_getVarsForDev, unstable_pages, readConfig as unstable_readConfig, resolveNamedTunnel as unstable_resolveNamedTunnel, splitSqlQuery as unstable_splitSqlQuery, startWorker as unstable_startWorker };