wrangler 4.101.0 → 4.103.0

package/bin/cf-wrangler.js

@@ -1,30 +1,44 @@
 #!/usr/bin/env node
-// `cf-wrangler` delegate binary. Runs wrangler's bundled dev server
-// in-process; the parent tool owns the Node runtime (version, flags).
+// `cf-wrangler` delegate binary. Runs wrangler delegate verbs in-process;
+// the parent tool owns the Node runtime (version, flags).
 //
-// Dispatches on the leading verb. Only `dev` exists today; an unknown
-// or missing verb exits 2, which the parent uses to feature-detect
-// support.
+// Dispatches on the leading verb. An unknown or missing verb exits 2, which
+// the parent uses to feature-detect support.
 const {
 	ArgParseError,
+	parseCfWranglerBuildArgs,
 	parseCfWranglerArgs,
+	runCfWranglerBuild,
 	runCfWranglerDev,
 } = require("../wrangler-dist/cli.js");
 
 const argv = process.argv.slice(2);
 const verb = argv[0];
 
-if (verb !== "dev") {
+const verbHandlers = {
+	dev: {
+		parse: parseCfWranglerArgs,
+		run: runCfWranglerDevFromArgs,
+	},
+	build: {
+		parse: parseCfWranglerBuildArgs,
+		run: runCfWranglerBuild,
+	},
+};
+
+const verbHandler = verbHandlers[verb];
+
+if (!verbHandler) {
 	process.stderr.write(
 		`Error: unknown subcommand "${verb ?? ""}".\n` +
-			`Usage: cf-wrangler dev [args]\n`
+			`Usage: cf-wrangler <${Object.keys(verbHandlers).join("|")}> [args]\n`
 	);
 	process.exit(2);
 }
 
 let parsed;
 try {
-	parsed = parseCfWranglerArgs(argv.slice(1));
+	parsed = verbHandler.parse(argv.slice(1));
 } catch (err) {
 	if (err instanceof ArgParseError) {
 		process.stderr.write(`Error: ${err.message}\n`);
@@ -33,83 +47,86 @@ try {
 	throw err;
 }
 
-// Build wrangler dev's full (yargs-derived) options object. Every field
-// must be present; we set the four accepted flags plus `wrangler dev`'s
-// defaults and leave everything else `undefined`, which makes wrangler's
-// ConfigController resolve those exactly as `wrangler dev` would (config
-// discovery, containers, inspector port, interactive hotkeys, ...).
-// `--local` forces local execution; left unset it preserves per-resource
-// `remote = true` bindings. There is no whole-worker remote dev (no
-// `--remote`).
-const options = {
-	_: [],
-	$0: "",
-	env: parsed.mode,
-	port: parsed.port,
-	host: parsed.host,
-	local: parsed.local,
-	remote: false,
-	latest: true,
-	noBundle: false,
-	testScheduled: false,
-	processEntrypoint: false,
-	experimentalAutoCreate: false,
-	types: false,
-	disableDevRegistry: false,
-	config: undefined,
-	script: undefined,
-	name: undefined,
-	accountId: undefined,
-	forceLocal: undefined,
-	compatibilityDate: undefined,
-	compatibilityFlags: undefined,
-	ip: undefined,
-	inspectorPort: undefined,
-	inspectorIp: undefined,
-	v: undefined,
-	cwd: undefined,
-	localProtocol: undefined,
-	httpsKeyPath: undefined,
-	httpsCertPath: undefined,
-	assets: undefined,
-	site: undefined,
-	siteInclude: undefined,
-	siteExclude: undefined,
-	persist: undefined,
-	persistTo: undefined,
-	routes: undefined,
-	localUpstream: undefined,
-	upstreamProtocol: undefined,
-	var: undefined,
-	define: undefined,
-	alias: undefined,
-	jsxFactory: undefined,
-	jsxFragment: undefined,
-	tsconfig: undefined,
-	minify: undefined,
-	legacyEnv: undefined,
-	logLevel: undefined,
-	showInteractiveDevSession: undefined,
-	liveReload: undefined,
-	bundle: undefined,
-	additionalModules: undefined,
-	enablePagesAssetsServiceBinding: undefined,
-	d1Databases: undefined,
-	experimentalProvision: undefined,
-	enableIpc: undefined,
-	nodeCompat: undefined,
-	enableContainers: undefined,
-	dockerPath: undefined,
-	containerEngine: undefined,
-	tunnel: undefined,
-	tunnelName: undefined,
-	envFile: undefined,
-	onReady: undefined,
-};
-
-runCfWranglerDev(options)
+verbHandler
+	.run(parsed)
 	.then((code) => process.exit(code))
 	.catch((err) => {
 		process.stderr.write(`${(err && err.stack) || err}\n`);
 		process.exit(1);
 	});
+
+function runCfWranglerDevFromArgs(parsedArgs) {
+	return runCfWranglerDev(createDevOptions(parsedArgs));
+}
+
+function createDevOptions(parsedArgs) {
+	// Build wrangler dev's full (yargs-derived) options object. Every field
+	// must be present; we set the four accepted flags plus `wrangler dev`'s
+	// defaults and leave everything else `undefined`, which makes wrangler's
+	// ConfigController resolve those exactly as `wrangler dev` would.
+	return {
+		_: [],
+		$0: "",
+		env: parsedArgs.mode,
+		port: parsedArgs.port,
+		host: parsedArgs.host,
+		local: parsedArgs.local,
+		remote: false,
+		latest: true,
+		noBundle: false,
+		testScheduled: false,
+		processEntrypoint: false,
+		experimentalAutoCreate: false,
+		types: false,
+		disableDevRegistry: false,
+		config: undefined,
+		script: undefined,
+		name: undefined,
+		accountId: undefined,
+		forceLocal: undefined,
+		compatibilityDate: undefined,
+		compatibilityFlags: undefined,
+		ip: undefined,
+		inspectorPort: undefined,
+		inspectorIp: undefined,
+		v: undefined,
+		cwd: undefined,
+		localProtocol: undefined,
+		httpsKeyPath: undefined,
+		httpsCertPath: undefined,
+		assets: undefined,
+		site: undefined,
+		siteInclude: undefined,
+		siteExclude: undefined,
+		persist: undefined,
+		persistTo: undefined,
+		routes: undefined,
+		localUpstream: undefined,
+		upstreamProtocol: undefined,
+		var: undefined,
+		define: undefined,
+		alias: undefined,
+		jsxFactory: undefined,
+		jsxFragment: undefined,
+		tsconfig: undefined,
+		minify: undefined,
+		legacyEnv: undefined,
+		logLevel: undefined,
+		showInteractiveDevSession: undefined,
+		liveReload: undefined,
+		bundle: undefined,
+		additionalModules: undefined,
+		enablePagesAssetsServiceBinding: undefined,
+		d1Databases: undefined,
+		experimentalProvision: undefined,
+		enableIpc: undefined,
+		nodeCompat: undefined,
+		enableContainers: undefined,
+		dockerPath: undefined,
+		containerEngine: undefined,
+		tunnel: undefined,
+		tunnelName: undefined,
+		envFile: undefined,
+		onReady: undefined,
+	};
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wrangler",
-  "version": "4.101.0",
+  "version": "4.103.0",
   "description": "Command-line interface for all things Cloudflare Workers",
   "keywords": [
     "assembly",
@@ -63,19 +63,19 @@
   },
   "dependencies": {
     "blake3-wasm": "2.1.5",
-    "esbuild": "0.27.3",
+    "esbuild": "0.28.1",
     "path-to-regexp": "6.3.0",
     "unenv": "2.0.0-rc.24",
-    "workerd": "1.20260616.1",
-    "@cloudflare/unenv-preset": "2.16.1",
+    "workerd": "1.20260617.1",
     "@cloudflare/kv-asset-handler": "0.5.0",
-    "miniflare": "4.20260616.0"
+    "@cloudflare/unenv-preset": "2.16.1",
+    "miniflare": "4.20260617.1"
   },
   "devDependencies": {
     "@aws-sdk/client-s3": "^3.721.0",
     "@bomb.sh/tab": "^0.0.12",
     "@cloudflare/types": "6.18.4",
-    "@cloudflare/workers-types": "^4.20260616.1",
+    "@cloudflare/workers-types": "^4.20260617.1",
     "@cspotcode/source-map-support": "0.8.1",
     "@netlify/build-info": "^10.5.1",
     "@sentry/node": "^7.86.0",
@@ -148,28 +148,29 @@
     "tsdown": "0.16.3",
     "tsup": "8.3.0",
     "typescript": "5.8.3",
-    "undici": "7.24.8",
+    "undici": "7.28.0",
     "vitest": "4.1.0",
     "vitest-websocket-mock": "^0.4.0",
-    "ws": "8.20.1",
+    "ws": "8.21.0",
     "xxhash-wasm": "^1.0.1",
     "yaml": "^2.8.1",
     "yargs": "^17.7.2",
     "zod": "^4.4.3",
-    "@cloudflare/cli-shared-helpers": "0.1.8",
+    "@cloudflare/autoconfig": "0.1.0",
+    "@cloudflare/cli-shared-helpers": "0.1.10",
     "@cloudflare/codemod": "1.1.0",
     "@cloudflare/config": "0.0.0",
-    "@cloudflare/deploy-helpers": "0.2.0",
     "@cloudflare/containers-shared": "0.15.1",
-    "@cloudflare/pages-shared": "^0.13.146",
+    "@cloudflare/deploy-helpers": "0.2.2",
+    "@cloudflare/workers-auth": "0.3.2",
+    "@cloudflare/pages-shared": "^0.13.148",
+    "@cloudflare/workers-shared": "0.19.7",
     "@cloudflare/workers-tsconfig": "0.0.0",
-    "@cloudflare/workers-auth": "0.3.0",
-    "@cloudflare/workers-shared": "0.19.6",
-    "@cloudflare/workers-utils": "0.23.1",
-    "@cloudflare/workflows-shared": "0.11.1"
+    "@cloudflare/workers-utils": "0.24.0",
+    "@cloudflare/workflows-shared": "0.11.2"
   },
   "peerDependencies": {
-    "@cloudflare/workers-types": "^4.20260616.1"
+    "@cloudflare/workers-types": "^4.20260617.1"
   },
   "peerDependenciesMeta": {
     "@cloudflare/workers-types": {

package/wrangler-dist/InspectorProxyWorker.js

@@ -71,6 +71,7 @@ var InspectorProxyWorker = class {
   constructor(_state, env) {
     this.env = env;
   }
+  env;
   websockets = {
     runtimeDeferred: createDeferred()
   };

package/wrangler-dist/ProxyWorker.js

@@ -37,6 +37,8 @@ var ProxyWorker = class {
     this.state = state;
     this.env = env;
   }
+  state;
+  env;
   proxyData;
   requestQueue = /* @__PURE__ */ new Map();
   requestRetryQueue = /* @__PURE__ */ new Map();

package/wrangler-dist/cli.d.ts

@@ -1,4 +1,4 @@
-import { Rule as Rule$1, CfModule, Environment as Environment$1, Entry, CfModuleType, StartDevWorkerInput, NodeJSCompatMode, CfScriptFormat, Config as Config$1, AsyncHook, CfAccount as CfAccount$1, AssetsOptions as AssetsOptions$1, Binding, ConfigBindingFieldName, RawConfig as RawConfig$1, NormalizeAndValidateConfigArgs, ResolveConfigPathOptions, PackageJSON, ApiCredentials, ParseError, LoggerLevel, ComplianceConfig, UserError, FatalError } from '@cloudflare/workers-utils';
+import { Rule as Rule$1, CfModule, Environment as Environment$1, Entry, CfModuleType, StartDevWorkerInput, NodeJSCompatMode, CfScriptFormat, Config as Config$1, 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 * as undici from 'undici';
@@ -2848,164 +2848,6 @@ type VarBinding = Extract<Binding, {
  */
 declare function getVarsForDev(configPath: string | undefined, envFiles: string[] | undefined, vars: Config$1["vars"], env: string | undefined, silent?: boolean, secrets?: Config$1["secrets"]): Record<string, VarBinding>;
 
-interface PackageManager {
-    type: "npm" | "yarn" | "pnpm" | "bun";
-    npx: string;
-    dlx: string[];
-    lockFiles: string[];
-}
-
-/** Makes a subset of properties in a type optional
- *
- * @example
- * 	- type A = { s: string, b: boolean, n: number }
- *  - Optional<A, 'b'|'n'> = { s: string, b?: boolean, n?: number }
- */
-type Optional<T, K extends keyof T> = Omit<T, K> & Pick<Partial<T>, K>;
-
-type FrameworkInfo = {
-    id: string;
-    name: string;
-} & ({
-    supported: false;
-} | {
-    supported: true;
-    class: typeof Framework;
-    frameworkPackageInfo: AutoConfigFrameworkPackageInfo;
-});
-/**
- * AutoConfig information for a package that defines a framework.
- */
-type AutoConfigFrameworkPackageInfo = {
-    /** The package name (e.g. "astro" for the Astro framework and "@solidjs/start" for the SolidStart framework) */
-    name: string;
-    /** The minimum version (if any) of the package/framework that autoconfig supports */
-    minimumVersion: string;
-    /** The latest major version of the package/framework that autoconfig supports  */
-    maximumKnownMajorVersion: string;
-};
-
-declare abstract class Framework {
-    #private;
-    readonly id: FrameworkInfo["id"];
-    readonly name: FrameworkInfo["name"];
-    get frameworkVersion(): string;
-    constructor(frameworkInfo: Pick<FrameworkInfo, "id" | "name">);
-    isConfigured(_projectPath: string): boolean;
-    abstract configure(options: ConfigurationOptions): Promise<ConfigurationResults> | ConfigurationResults;
-    configurationDescription?: string;
-    /**
-     * Validates the installed framework version against the supported range and
-     * stores it for later access via the `frameworkVersion` getter.
-     * Warns via `logger` if the version exceeds `maximumKnownMajorVersion`.
-     *
-     * @param projectPath - Path to the project root used to resolve the installed version.
-     * @param frameworkPackageInfo - Package metadata including name and version bounds.
-     * @throws {AssertionError} If the installed version cannot be determined.
-     * @throws {AutoConfigFrameworkConfigurationError} If the version is below `minimumVersion`.
-     */
-    validateFrameworkVersion(projectPath: string, frameworkPackageInfo: AutoConfigFrameworkPackageInfo): void;
-}
-type ConfigurationOptions = {
-    outputDir: string;
-    projectPath: string;
-    workerName: string;
-    dryRun: boolean;
-    packageManager: PackageManager;
-    isWorkspaceRoot: boolean;
-};
-type PackageJsonScriptsOverrides = {
-    preview?: string;
-    deploy?: string;
-    typegen?: string;
-};
-type ConfigurationResults = {
-    /** The wrangler configuration that the framework's `configure()` hook should generate. `null` if autoconfig should not create the wrangler file (in case an external tool already does that) */
-    wranglerConfig: RawConfig$1 | null;
-    packageJsonScriptsOverrides?: PackageJsonScriptsOverrides;
-    buildCommandOverride?: string;
-    deployCommandOverride?: string;
-    versionCommandOverride?: string;
-};
-
-type AutoConfigDetailsBase = {
-    /** The name of the worker */
-    workerName: string;
-    /** The path to the project (defaults to cwd) */
-    projectPath: string;
-    /** The content of the project's package.json file (if any) */
-    packageJson?: PackageJSON;
-    /** Whether the project is already configured (no autoconfig required) */
-    configured: boolean;
-    /** Details about the detected framework. It can be a JS framework or 'Static' if no actual JS framework is used. */
-    framework: Framework;
-    /** The build command used to build the project (if any) */
-    buildCommand?: string;
-    /** The output directory (if no framework is used, points to the raw asset files) */
-    outputDir: string;
-    /** The detected package manager for the project */
-    packageManager: PackageManager;
-    /** Whether the current path is at the root of a workspace */
-    isWorkspaceRoot?: boolean;
-};
-type AutoConfigDetailsForConfiguredProject = Optional<AutoConfigDetailsBase, "framework" | "outputDir"> & {
-    configured: true;
-};
-type AutoConfigDetailsForNonConfiguredProject = AutoConfigDetailsBase & {
-    configured: false;
-};
-type AutoConfigDetails = AutoConfigDetailsForConfiguredProject | AutoConfigDetailsForNonConfiguredProject;
-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;
-    /**
-     * Whether to install Wrangler during autoconfig
-     */
-    enableWranglerInstallation?: boolean;
-};
-type AutoConfigSummary = {
-    scripts: Record<string, string>;
-    wranglerInstall: boolean;
-    wranglerConfig?: RawConfig$1;
-    frameworkConfiguration?: string;
-    outputDir: string;
-    frameworkId?: string;
-    buildCommand?: string;
-    deployCommand?: string;
-    versionCommand?: string;
-};
-
-/**
- * Derives a valid worker name from a project directory.
- *
- * The name is determined by (in order of precedence):
- * 1. The WRANGLER_CI_OVERRIDE_NAME environment variable (for CI environments)
- * 2. The `name` field from package.json in the project directory
- * 3. The directory basename
- *
- * The resulting name is sanitized to be a valid worker name.
- *
- * @param projectPath The path to the project directory
- * @returns A valid worker name
- */
-declare function getWorkerNameFromProject(projectPath: string): string;
-declare function getDetailsForAutoConfig({ projectPath, wranglerConfig, }?: {
-    projectPath?: string;
-    wranglerConfig?: Config$1;
-}): Promise<AutoConfigDetails>;
-
 /**
  * @deprecated Use today's date as the compatibility date instead.
  */
@@ -3233,35 +3075,39 @@ declare function resolveNamedTunnel(name: string, origin: URL, options: {
     token: string;
 }>;
 
-/**
- * Run the dev server until it tears down (a hotkey quit in a TTY, or a
- * signal from a non-interactive parent). Mirrors `wrangler dev`'s command
- * handler and installs no signal handlers of its own, so signal handling
- * and exit codes match `wrangler dev` exactly.
- *
- * @param options Fully-built `StartDevOptions` (built in `bin/cf-wrangler.js`).
- * @returns `0` on a clean teardown.
- */
-declare function runCfWranglerDev(options: StartDevOptions): Promise<number>;
-
 interface DevArgs {
     mode?: string;
     port?: number;
     host?: string;
     local?: boolean;
 }
+interface BuildArgs {
+    mode?: string;
+}
 declare class ArgParseError extends Error {
     constructor(message: string);
 }
 declare function parseArgs(argv: string[]): DevArgs;
+declare function parseBuildArgs(argv: string[]): BuildArgs;
+
+declare function runCfWranglerBuild(args: BuildArgs): Promise<number>;
+
+/**
+ * Run the dev server until it tears down (a hotkey quit in a TTY, or a
+ * signal from a non-interactive parent). Mirrors `wrangler dev`'s command
+ * handler and installs no signal handlers of its own, so signal handling
+ * and exit codes match `wrangler dev` exactly.
+ *
+ * @param options Fully-built `StartDevOptions` (built in `bin/cf-wrangler.js`).
+ * @returns `0` on a clean teardown.
+ */
+declare function runCfWranglerDev(options: StartDevOptions): Promise<number>;
 
 /**
  * Split an SQLQuery into an array of statements
  */
 declare function splitSqlQuery(sql: string): string[];
 
-declare function runAutoConfig(autoConfigDetails: AutoConfigDetails, autoConfigOptions?: AutoConfigOptions): Promise<AutoConfigSummary>;
-
 /**
  * The implementation for fetching a kv value from the cloudflare API.
  * We special-case this one call, because it's the only API call that
@@ -3719,4 +3565,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, Framework as experimental_AutoConfigFramework, generateTypes as experimental_generateTypes, getDetailsForAutoConfig as experimental_getDetailsForAutoConfig, experimental_getWranglerCommands, runAutoConfig as experimental_runAutoConfig, getPlatformProxy, maybeStartOrUpdateRemoteProxySession, parseArgs as parseCfWranglerArgs, 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, getWorkerNameFromProject as unstable_getWorkerNameFromProject, 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 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 };