wrangler 4.57.0 → 4.59.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wrangler",
-  "version": "4.57.0",
+  "version": "4.59.0",
   "description": "Command-line interface for all things Cloudflare Workers",
   "keywords": [
     "wrangler",
@@ -54,15 +54,15 @@
     "esbuild": "0.27.0",
     "path-to-regexp": "6.3.0",
     "unenv": "2.0.0-rc.24",
-    "workerd": "1.20260103.0",
+    "workerd": "1.20260111.0",
     "@cloudflare/kv-asset-handler": "0.4.1",
-    "@cloudflare/unenv-preset": "2.8.0",
-    "miniflare": "4.20260103.0"
+    "miniflare": "4.20260111.0",
+    "@cloudflare/unenv-preset": "2.9.0"
   },
   "devDependencies": {
     "@aws-sdk/client-s3": "^3.721.0",
     "@cloudflare/types": "6.18.4",
-    "@cloudflare/workers-types": "^4.20260103.0",
+    "@cloudflare/workers-types": "^4.20260111.0",
     "@cspotcode/source-map-support": "0.8.1",
     "@netlify/build-info": "^10.2.0",
     "@sentry/node": "^7.86.0",
@@ -88,6 +88,7 @@
     "@types/yargs": "^17.0.22",
     "@vitest/ui": "~3.2.0",
     "@webcontainer/env": "^1.1.0",
+    "am-i-vibing": "^0.1.0",
     "capnweb": "^0.1.0",
     "chalk": "^5.2.0",
     "chokidar": "^4.0.1",
@@ -148,16 +149,16 @@
     "yaml": "^2.8.1",
     "yargs": "^17.7.2",
     "@cloudflare/cli": "1.2.0",
-    "@cloudflare/containers-shared": "0.7.0",
+    "@cloudflare/containers-shared": "0.8.0",
     "@cloudflare/eslint-config-shared": "1.1.0",
     "@cloudflare/workers-shared": "0.18.9",
-    "@cloudflare/pages-shared": "^0.13.96",
-    "@cloudflare/workers-utils": "0.6.0",
     "@cloudflare/workers-tsconfig": "0.0.0",
-    "@cloudflare/workflows-shared": "0.4.0"
+    "@cloudflare/workflows-shared": "0.4.0",
+    "@cloudflare/workers-utils": "0.7.0",
+    "@cloudflare/pages-shared": "^0.13.98"
   },
   "peerDependencies": {
-    "@cloudflare/workers-types": "^4.20260103.0"
+    "@cloudflare/workers-types": "^4.20260111.0"
   },
   "peerDependenciesMeta": {
     "@cloudflare/workers-types": {
@@ -185,8 +186,8 @@
     "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\"",
     "generate-json-schema": "node -r esbuild-register scripts/generate-json-schema.ts",
     "start": "pnpm run build && cross-env NODE_OPTIONS=--enable-source-maps ./bin/wrangler.js",
-    "test": "dotenv -- pnpm run assert-git-version && dotenv -- vitest",
-    "test:ci": "pnpm run test run",
+    "test": "dotenv -- pnpm run assert-git-version && cross-env NODE_OPTIONS=\"$(node scripts/node-options-for-tests.js)\" dotenv -- vitest",
+    "test:ci": "cross-env NODE_OPTIONS=\"$(node scripts/node-options-for-tests.js)\" pnpm run test run",
     "test:debug": "pnpm run test --silent=false --verbose=true",
     "test:e2e": "dotenv -- vitest run -c ./e2e/vitest.config.mts",
     "test:watch": "pnpm run test --testTimeout=50000 --watch",

package/wrangler-dist/cli.d.ts

@@ -1091,7 +1091,11 @@ type ContainerApp = {
     constraints?: {
         regions?: string[];
         cities?: string[];
+        /**
+         * @deprecated Use `tiers` instead
+         */
         tier?: number;
+        tiers?: number[];
     };
     /**
      * Scheduling affinities
@@ -2836,6 +2840,7 @@ type StringKeyOf<T> = Extract<keyof T, string>;
 type DeepFlatten<T> = T extends object ? {
     [K in keyof T]: DeepFlatten<T[K]>;
 } : T;
+type MetadataCategory = "Account" | "Compute & AI" | "Storage & databases" | "Networking & security";
 type Command = `wrangler${string}`;
 type Metadata = {
     description: string;
@@ -2852,6 +2857,12 @@ type Metadata = {
         description: string;
     }[];
     hideGlobalFlags?: string[];
+    /**
+     * Optional category for grouping commands in the help output.
+     * Commands with the same category will be grouped together under a shared heading.
+     * Commands without a category will appear under the default "COMMANDS" group.
+     */
+    category?: MetadataCategory;
 };
 type ArgDefinition = Omit<PositionalOptions, "type"> & Pick<Options, "hidden" | "requiresArg" | "deprecated" | "type">;
 type NamedArgDefinitions = {
@@ -2987,6 +2998,11 @@ type CreateCommandResult<NamedArgDefs extends NamedArgDefinitions> = DeepFlatten
     args: HandlerArgs<NamedArgDefs>;
 }>;
 
+/**
+ * Map of category names to the top-level command segments that belong to them.
+ * Used for grouping commands in the help output.
+ */
+type CategoryMap = Map<MetadataCategory, Array<string>>;
 /**
  * Class responsible for registering and managing commands within a command registry.
  */
@@ -3014,6 +3030,17 @@ declare class CommandRegistry {
      * See https://github.com/cloudflare/workers-sdk/pull/7357#discussion_r1862138470 for more details.
      */
     registerNamespace(namespace: string): void;
+    /**
+     * 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 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.
+     */
+    registerLegacyCommandCategory(command: string, category: MetadataCategory): void;
 }
 /**
  * Type for the function used to register commands.
@@ -3067,6 +3094,7 @@ declare function createCLIParser(argv: string[]): {
             readonly alias: "x-auto-create";
         };
     };
+    showHelpWithCategories: () => Promise<void>;
 };
 
 /**