wrangler 4.158.0 → 4.160.0

package/bin/cf-wrangler.js

@@ -18,7 +18,7 @@ const verb = argv[0];
 const verbHandlers = {
 	dev: {
 		parse: parseCfWranglerArgs,
-		run: runCfWranglerDevFromArgs,
+		run: runCfWranglerDev,
 	},
 	build: {
 		parse: parseCfWranglerBuildArgs,
@@ -54,79 +54,3 @@ verbHandler
 		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, force cf's new config
-	// format, and otherwise use `wrangler dev`'s defaults.
-	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,
-		experimentalNewConfig: true,
-		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,
-		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,
-		tunnelAllowedMail: undefined,
-		envFile: undefined,
-		onReady: undefined,
-	};
-}

package/bin/wrangler.js

@@ -1,10 +1,27 @@
 #!/usr/bin/env node
 const { spawn } = require("child_process");
+const { constants } = require("node:os");
 const path = require("path");
 
-const MIN_NODE_VERSION = "22.0.0";
+const MIN_NODE_VERSION = "22.12.0";
 let wranglerProcess;
 
+/**
+ * Convert a child's exit result to the status expected by shell callers.
+ *
+ * @param {number | null | undefined} code
+ * @param {string | null} signal
+ * @returns {number}
+ */
+function getExitCode(code, signal) {
+	if (code !== undefined && code !== null) {
+		return code;
+	}
+
+	const signalNumber = signal && constants.signals[signal];
+	return signalNumber ? 128 + signalNumber : 1;
+}
+
 /**
  * Executes ../wrangler-dist/cli.js
  */
@@ -33,9 +50,7 @@ Consider using a Node.js version manager such as https://volta.sh/ or https://gi
 			stdio: ["inherit", "inherit", "inherit", "ipc"],
 		}
 	)
-		.on("exit", (code) =>
-			process.exit(code === undefined || code === null ? 0 : code)
-		)
+		.on("exit", (code, signal) => process.exit(getExitCode(code, signal)))
 		.on("message", (message) => {
 			if (process.send) {
 				process.send(message);
@@ -82,10 +97,9 @@ function semiver(a, b, bool) {
 
 if (module === require.main) {
 	wranglerProcess = runWrangler();
-	process.on("SIGINT", () => {
-		wranglerProcess && wranglerProcess.kill();
-	});
-	process.on("SIGTERM", () => {
-		wranglerProcess && wranglerProcess.kill();
-	});
+	for (const signal of ["SIGINT", "SIGTERM"]) {
+		process.on(signal, () => {
+			wranglerProcess && wranglerProcess.kill(signal);
+		});
+	}
 }

package/config-schema.json

@@ -786,6 +786,11 @@
                 "description": "The UUID of this D1 database (not required).",
                 "markdownDescription": "The UUID of this D1 database (not required)."
               },
+              "jurisdiction": {
+                "type": "string",
+                "description": "The jurisdiction where an automatically provisioned D1 database will be created.",
+                "markdownDescription": "The jurisdiction where an automatically provisioned D1 database will be created."
+              },
               "preview_database_id": {
                 "type": "string",
                 "description": "The UUID of this D1 database for Wrangler Dev (if specified).",
@@ -2646,6 +2651,11 @@
                 "description": "The UUID of this D1 database (not required).",
                 "markdownDescription": "The UUID of this D1 database (not required)."
               },
+              "jurisdiction": {
+                "type": "string",
+                "description": "The jurisdiction where an automatically provisioned D1 database will be created.",
+                "markdownDescription": "The jurisdiction where an automatically provisioned D1 database will be created."
+              },
               "preview_database_id": {
                 "type": "string",
                 "description": "The UUID of this D1 database for Wrangler Dev (if specified).",
@@ -4442,19 +4452,19 @@
       "type": "object",
       "properties": {
         "logpush": {
-          "$ref": "#/definitions/interface-769040647-14884-25493-769040647-0-627292004818536"
+          "$ref": "#/definitions/interface-769040647-14884-25493-769040647-0-628442004818536"
         },
         "observability": {
-          "$ref": "#/definitions/interface-769040647-14884-25493-769040647-0-627292004818536"
+          "$ref": "#/definitions/interface-769040647-14884-25493-769040647-0-628442004818536"
         },
         "limits": {
-          "$ref": "#/definitions/interface-769040647-14884-25493-769040647-0-627292004818536"
+          "$ref": "#/definitions/interface-769040647-14884-25493-769040647-0-628442004818536"
         },
         "placement": {
-          "$ref": "#/definitions/interface-769040647-14884-25493-769040647-0-627292004818536"
+          "$ref": "#/definitions/interface-769040647-14884-25493-769040647-0-628442004818536"
         },
         "cache": {
-          "$ref": "#/definitions/interface-769040647-14884-25493-769040647-0-627292004818536"
+          "$ref": "#/definitions/interface-769040647-14884-25493-769040647-0-628442004818536"
         },
         "define": {
           "type": "object",
@@ -4852,6 +4862,11 @@
                 "description": "The UUID of this D1 database (not required).",
                 "markdownDescription": "The UUID of this D1 database (not required)."
               },
+              "jurisdiction": {
+                "type": "string",
+                "description": "The jurisdiction where an automatically provisioned D1 database will be created.",
+                "markdownDescription": "The jurisdiction where an automatically provisioned D1 database will be created."
+              },
               "preview_database_id": {
                 "type": "string",
                 "description": "The UUID of this D1 database for Wrangler Dev (if specified).",
@@ -5829,7 +5844,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`, `placement`, `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`, `placement`, `cache`"
     },
-    "interface-769040647-14884-25493-769040647-0-627292004818536": {
+    "interface-769040647-14884-25493-769040647-0-628442004818536": {
       "type": "object",
       "properties": {
         "name": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wrangler",
-  "version": "4.158.0",
+  "version": "4.160.0",
   "description": "Command-line interface for all things Cloudflare Workers",
   "keywords": [
     "assembly",
@@ -72,17 +72,17 @@
     "esbuild": "0.28.2",
     "path-to-regexp": "6.3.0",
     "unenv": "2.0.0-rc.24",
-    "workerd": "1.20261104.1",
+    "workerd": "1.20261110.1",
     "@cloudflare/kv-asset-handler": "0.5.0",
     "@cloudflare/unenv-preset": "2.16.2",
-    "miniflare": "5.20261104.0-beta"
+    "miniflare": "5.20261110.0-beta"
   },
   "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.20261104.1",
+    "@cloudflare/workers-types": "^5.20261110.1",
     "@netlify/build-info": "10.5.1",
     "@sentry/node": "^7.86.0",
     "@sentry/types": "^7.86.0",
@@ -164,25 +164,25 @@
     "yaml": "^2.8.3",
     "yargs": "^17.7.2",
     "zod": "4.6.6",
-    "@cloudflare/build-output-utils": "0.9.10",
-    "@cloudflare/autoconfig": "0.9.3",
-    "@cloudflare/cli-shared-helpers": "0.3.4",
-    "@cloudflare/config": "0.30.2",
-    "@cloudflare/containers-shared": "0.23.9",
-    "@cloudflare/deploy-helpers": "0.26.0",
-    "@cloudflare/pages-functions": "0.1.6",
-    "@cloudflare/runtime-types": "0.1.23",
-    "@cloudflare/pages-shared": "^0.13.209",
-    "@cloudflare/remote-bindings": "0.0.60",
-    "@cloudflare/workers-auth": "0.16.0",
-    "@cloudflare/workers-shared": "0.20.2",
+    "@cloudflare/autoconfig": "0.11.0",
+    "@cloudflare/build-output-utils": "0.9.12",
+    "@cloudflare/cli-shared-helpers": "0.3.6",
+    "@cloudflare/config": "0.31.1",
+    "@cloudflare/containers-shared": "0.25.0",
+    "@cloudflare/deploy-helpers": "0.26.2",
+    "@cloudflare/pages-functions": "0.1.8",
+    "@cloudflare/pages-shared": "^0.13.211",
+    "@cloudflare/remote-bindings": "0.0.62",
+    "@cloudflare/runtime-types": "0.1.25",
     "@cloudflare/shared-ast-primitives": "1.1.0",
+    "@cloudflare/workers-auth": "0.18.0",
+    "@cloudflare/workers-utils": "0.53.0",
+    "@cloudflare/workflows-shared": "0.15.3",
     "@cloudflare/workers-tsconfig": "0.0.0",
-    "@cloudflare/workers-utils": "0.52.0",
-    "@cloudflare/workflows-shared": "0.15.3"
+    "@cloudflare/workers-shared": "0.20.2"
   },
   "peerDependencies": {
-    "@cloudflare/workers-types": "^5.20261104.1"
+    "@cloudflare/workers-types": "^5.20261110.1"
   },
   "peerDependenciesMeta": {
     "@cloudflare/workers-types": {
@@ -193,7 +193,7 @@
     "fsevents": "2.3.3"
   },
   "engines": {
-    "node": ">=22.0.0"
+    "node": ">=22.12.0"
   },
   "volta": {
     "extends": "../../package.json"

package/wrangler-dist/cli.d.ts

@@ -265,6 +265,11 @@ interface GenerateTypesOptions {
      * Whether to include runtime types in the output.
      */
     includeRuntime?: boolean;
+    /**
+     * Whether to infer `Cloudflare.GlobalProps.mainModule` from the Worker entrypoint.
+     * Defaults to true. Disabling this opts out of module-derived `ctx.exports` types.
+     */
+    includeMainModule?: boolean;
     /**
      * Path to the declaration file for generated types.
      */
@@ -647,50 +652,50 @@ declare const dev: {
         experimentalAutoCreate: boolean;
         installSkills: boolean;
         profile: string | undefined;
-        script: string | undefined;
-        name: string | undefined;
-        compatibilityDate: string | undefined;
-        compatibilityFlags: string[] | undefined;
-        latest: boolean;
-        assets: string | undefined;
-        bundle: boolean | undefined;
-        noBundle: boolean;
-        ip: string | undefined;
-        port: number | undefined;
-        inspectorPort: number | undefined;
-        inspectorIp: string | undefined;
-        routes: string[] | undefined;
-        host: string | undefined;
-        localProtocol: "http" | "https" | undefined;
-        httpsKeyPath: string | undefined;
-        httpsCertPath: string | undefined;
-        localUpstream: string | undefined;
-        inferOriginFromRoutes: boolean | undefined;
-        enableContainers: boolean | undefined;
-        site: string | undefined;
-        siteInclude: string[] | undefined;
-        siteExclude: string[] | undefined;
-        upstreamProtocol: "http" | "https" | undefined;
-        var: string[] | undefined;
-        define: string[] | undefined;
-        alias: string[] | undefined;
-        jsxFactory: string | undefined;
-        jsxFragment: string | undefined;
-        tsconfig: string | undefined;
-        remote: boolean;
-        local: boolean | undefined;
-        minify: boolean | undefined;
-        nodeCompat: boolean | undefined;
-        persistTo: string | undefined;
-        liveReload: boolean | undefined;
-        testScheduled: boolean;
-        logLevel: "debug" | "none" | "error" | "log" | "info" | "warn" | undefined;
-        showInteractiveDevSession: boolean | undefined;
-        types: boolean | undefined;
-        tunnel: boolean | undefined;
-        tunnelName: string | undefined;
-        tunnelAllowedMail: string[] | undefined;
-        experimentalNewConfig: boolean;
+        readonly script: string | undefined;
+        readonly name: string | undefined;
+        readonly compatibilityDate: string | undefined;
+        readonly compatibilityFlags: string[] | undefined;
+        readonly latest: boolean;
+        readonly assets: string | undefined;
+        readonly bundle: boolean | undefined;
+        readonly noBundle: boolean;
+        readonly ip: string | undefined;
+        readonly port: number | undefined;
+        readonly inspectorPort: number | undefined;
+        readonly inspectorIp: string | undefined;
+        readonly routes: string[] | undefined;
+        readonly host: string | undefined;
+        readonly localProtocol: "http" | "https" | undefined;
+        readonly httpsKeyPath: string | undefined;
+        readonly httpsCertPath: string | undefined;
+        readonly localUpstream: string | undefined;
+        readonly inferOriginFromRoutes: boolean | undefined;
+        readonly enableContainers: boolean | undefined;
+        readonly site: string | undefined;
+        readonly siteInclude: string[] | undefined;
+        readonly siteExclude: string[] | undefined;
+        readonly upstreamProtocol: "http" | "https" | undefined;
+        readonly var: string[] | undefined;
+        readonly define: string[] | undefined;
+        readonly alias: string[] | undefined;
+        readonly jsxFactory: string | undefined;
+        readonly jsxFragment: string | undefined;
+        readonly tsconfig: string | undefined;
+        readonly remote: boolean;
+        readonly local: boolean | undefined;
+        readonly minify: boolean | undefined;
+        readonly nodeCompat: boolean | undefined;
+        readonly persistTo: string | undefined;
+        readonly liveReload: boolean | undefined;
+        readonly testScheduled: boolean;
+        readonly logLevel: "debug" | "none" | "error" | "log" | "info" | "warn" | undefined;
+        readonly showInteractiveDevSession: boolean | undefined;
+        readonly types: boolean | undefined;
+        readonly tunnel: boolean | undefined;
+        readonly tunnelName: string | undefined;
+        readonly tunnelAllowedMail: string[] | undefined;
+        readonly experimentalNewConfig: boolean;
         _: (string | number)[];
         $0: string;
     };
@@ -2372,6 +2377,8 @@ interface EnvironmentNonInheritable {
         database_name?: string;
         /** The UUID of this D1 database (not required). */
         database_id?: string;
+        /** The jurisdiction where an automatically provisioned D1 database will be created. */
+        jurisdiction?: string;
         /** The UUID of this D1 database for Wrangler Dev (if specified). */
         preview_database_id?: string;
         /** The name of the migrations table for this D1 database (defaults to 'd1_migrations'). */
@@ -3579,19 +3586,14 @@ declare function resolveNamedTunnel(name: string, origin: URL, options: {
     token: string;
 }>;
 
-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;
+/** Parse forwarded server arguments into options consumed directly by startDev. */
+declare function parseArgs(argv: string[]): StartDevOptions;
 declare function parseBuildArgs(argv: string[]): BuildArgs;
 
 declare function runCfWranglerBuild(args: BuildArgs): Promise<number>;
@@ -3602,7 +3604,7 @@ declare function runCfWranglerBuild(args: BuildArgs): Promise<number>;
  * 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`).
+ * @param options Parsed development server options.
  * @returns `0` on a clean teardown.
  */
 declare function runCfWranglerDev(options: StartDevOptions): Promise<number>;