wrangler 4.61.1 → 4.62.0

package/README.md

@@ -39,12 +39,15 @@ To read more about Workers in general:
 
 ## Configuration
 
-Wrangler is configured via a `wrangler.toml` or `wrangler.json` file in the project root. An example configuration generated by `npx wrangler init` or `npx create cloudflare` is as follows:
-
-```toml
-name = "my-worker"
-main = "./src/index.ts"
-compatibility_date = "YYYY-MM-DD"
+Wrangler is configured via a `wrangler.jsonc` (recommended), `wrangler.json` or `wrangler.toml` file in the project root. An example configuration generated by `npx wrangler init` or `npx create cloudflare` is as follows:
+
+```jsonc
+{
+	"$schema": "node_modules/wrangler/config-schema.json",
+	"name": "my-worker",
+	"main": "./src/index.ts",
+	"compatibility_date": "YYYY-MM-DD",
+}
 ```
 
 For more detailed information about configuration, refer to the [documentation](https://developers.cloudflare.com/workers/wrangler/configuration/).

package/config-schema.json

@@ -2561,11 +2561,12 @@
         "cpu_ms": {
           "type": "number",
           "description": "Maximum allowed CPU time for a Worker's invocation in milliseconds"
+        },
+        "subrequests": {
+          "type": "number",
+          "description": "Maximum allowed number of fetch requests that a Worker's invocation can execute"
         }
       },
-      "required": [
-        "cpu_ms"
-      ],
       "additionalProperties": false
     },
     "Rule": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wrangler",
-  "version": "4.61.1",
+  "version": "4.62.0",
   "description": "Command-line interface for all things Cloudflare Workers",
   "keywords": [
     "wrangler",
@@ -54,16 +54,16 @@
     "esbuild": "0.27.0",
     "path-to-regexp": "6.3.0",
     "unenv": "2.0.0-rc.24",
-    "workerd": "1.20260128.0",
+    "workerd": "1.20260131.0",
     "@cloudflare/kv-asset-handler": "0.4.2",
-    "@cloudflare/unenv-preset": "2.12.0",
-    "miniflare": "4.20260128.0"
+    "miniflare": "4.20260131.0",
+    "@cloudflare/unenv-preset": "2.12.0"
   },
   "devDependencies": {
     "@aws-sdk/client-s3": "^3.721.0",
     "@bomb.sh/tab": "^0.0.12",
     "@cloudflare/types": "6.18.4",
-    "@cloudflare/workers-types": "^4.20260128.0",
+    "@cloudflare/workers-types": "^4.20260131.0",
     "@cspotcode/source-map-support": "0.8.1",
     "@netlify/build-info": "^10.2.0",
     "@sentry/node": "^7.86.0",
@@ -150,15 +150,15 @@
     "yargs": "^17.7.2",
     "@cloudflare/cli": "1.2.1",
     "@cloudflare/containers-shared": "0.8.0",
-    "@cloudflare/eslint-config-shared": "1.2.0",
-    "@cloudflare/pages-shared": "^0.13.103",
+    "@cloudflare/eslint-config-shared": "1.2.1",
+    "@cloudflare/pages-shared": "^0.13.104",
     "@cloudflare/workers-shared": "0.18.10",
     "@cloudflare/workers-tsconfig": "0.0.0",
-    "@cloudflare/workers-utils": "0.8.1",
+    "@cloudflare/workers-utils": "0.9.0",
     "@cloudflare/workflows-shared": "0.4.0"
   },
   "peerDependencies": {
-    "@cloudflare/workers-types": "^4.20260128.0"
+    "@cloudflare/workers-types": "^4.20260131.0"
   },
   "peerDependenciesMeta": {
     "@cloudflare/workers-types": {
@@ -180,7 +180,7 @@
   "scripts": {
     "assert-git-version": "node -r esbuild-register scripts/assert-git-version.ts",
     "build": "pnpm run clean && pnpm tsup && pnpm run generate-json-schema",
-    "check:lint": "eslint . --max-warnings=0",
+    "check:lint": "eslint . --max-warnings=0 --cache",
     "check:type": "tsc -p ./tsconfig.json && tsc -p ./templates/tsconfig.json",
     "clean": "rimraf wrangler-dist miniflare-dist emitted-types",
     "dev": "pnpm run clean && concurrently -c black,blue --kill-others-on-fail false \"pnpm tsup --watch src --watch ../containers-shared/src --watch ../cli\" \"pnpm run check:type --watch --preserveWatchOutput\"",

package/wrangler-dist/cli.d.ts

@@ -2121,7 +2121,9 @@ interface DispatchNamespaceOutbound {
 }
 interface UserLimits {
     /** Maximum allowed CPU time for a Worker's invocation in milliseconds */
-    cpu_ms: number;
+    cpu_ms?: number;
+    /** Maximum allowed number of fetch requests that a Worker's invocation can execute */
+    subrequests?: number;
 }
 type Assets = {
     /** Absolute path to assets directory */
@@ -2463,6 +2465,11 @@ interface EnvironmentMap {
  */
 declare function getVarsForDev(configPath: string | undefined, envFiles: string[] | undefined, vars: Config$1["vars"], env: string | undefined, silent?: boolean): Config$1["vars"];
 
+type FrameworkInfo = {
+    id: string;
+    name: string;
+};
+
 type ConfigurationOptions = {
     outputDir: string;
     projectPath: string;
@@ -2475,13 +2482,17 @@ type PackageJsonScriptsOverrides = {
     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;
     packageJsonScriptsOverrides?: PackageJsonScriptsOverrides;
-    buildCommand?: string;
+    buildCommandOverride?: string;
+    deployCommandOverride?: string;
+    versionCommandOverride?: string;
 };
 declare abstract class Framework {
-    name: string;
-    constructor(name?: string);
+    readonly id: string;
+    readonly name: string;
+    constructor(frameworkInfo: FrameworkInfo);
     isConfigured(_projectPath: string): boolean;
     abstract configure(options: ConfigurationOptions): Promise<ConfigurationResults> | ConfigurationResults;
     configurationDescription?: string;
@@ -2530,6 +2541,10 @@ type AutoConfigSummary = {
     wranglerConfig: RawConfig$1;
     frameworkConfiguration?: string;
     outputDir: string;
+    frameworkId?: string;
+    buildCommand?: string;
+    deployCommand?: string;
+    versionCommand?: string;
 };
 
 /**
@@ -2923,6 +2938,11 @@ type CommandDefinition<NamedArgDefs extends NamedArgDefinitions = NamedArgDefini
          * @default true
          */
         printBanner?: boolean | ((args: HandlerArgs<NamedArgDefs>) => boolean);
+        /**
+         * Opt-in to printing a metrics banner for this command.
+         * @default false
+         */
+        printMetricsBanner?: boolean;
         /**
          * By default, wrangler will print warnings about the Wrangler configuration file.
          * Set this value to `false` to skip printing these warnings.
@@ -2952,6 +2972,11 @@ type CommandDefinition<NamedArgDefs extends NamedArgDefinitions = NamedArgDefini
          * using the `-e|--env` cli flag, show a warning suggesting that one should instead be specified.
          */
         warnIfMultipleEnvsConfiguredButNoneSpecified?: boolean;
+        /**
+         * Opt out of sending metrics for this command
+         * @default true
+         */
+        sendMetrics?: boolean;
     };
     /**
      * A plain key-value object describing the CLI args for this command.
@@ -3039,15 +3064,26 @@ declare class CommandRegistry {
      * See https://github.com/cloudflare/workers-sdk/pull/7357#discussion_r1862138470 for more details.
      */
     registerNamespace(namespace: string): void;
+    /**
+     * Get a set of all top-level command names.
+     *
+     * Includes both registry-defined commands & legacy commands.
+     */
+    get topLevelCommands(): Set<string>;
     /**
      * Returns the map of categories to command segments, ordered according to
      * the category order. Commands within each category are sorted alphabetically.
      * Used for grouping commands in the help output.
      */
     get orderedCategories(): CategoryMap;
+    /**
+     * Registers a legacy command that doesn't use the `CommandRegistry` class.
+     * This is used for hidden commands like `cloudchamber` that use the old yargs pattern.
+     */
+    registerLegacyCommand(command: string): void;
     /**
      * Registers a category for a legacy command that doesn't use the CommandRegistry.
-     * This is used for commands like `containers`, `pubsub`, etc, that use the old yargs pattern.
+     * This is used for commands like `containers`, etc, that use the old yargs pattern.
      */
     registerLegacyCommandCategory(command: string, category: MetadataCategory): void;
 }