vercel 56.2.0 → 56.3.0

package/dist/chunks/{chunk-AVLGVZJ5.js → chunk-I2IICWBW.js}

@@ -6,32 +6,32 @@ const __filename = __fileURLToPath(import.meta.url);
 const __dirname = __dirname_(__filename);
 import {
   vcrCommand
-} from "./chunk-5OT26JZN.js";
+} from "./chunk-3VS4DTAU.js";
 import {
   metricsCommand
-} from "./chunk-JJWESW5Y.js";
+} from "./chunk-4G6QZSBL.js";
 import {
   routesCommand
-} from "./chunk-DREO3DFB.js";
+} from "./chunk-VZSZBD4V.js";
 import {
   activityCommand
-} from "./chunk-5AJNUXWP.js";
+} from "./chunk-3PKFXNJZ.js";
 import {
   alertsCommand
-} from "./chunk-7S3QUMIG.js";
+} from "./chunk-YS6EDZHB.js";
 import {
   devCommand
-} from "./chunk-IDMKFYEA.js";
+} from "./chunk-OGG6UBXK.js";
 import {
   listCommand
-} from "./chunk-HA7C7SDO.js";
+} from "./chunk-LHFNIZ2P.js";
 import {
   buildCommand,
   pullCommand
-} from "./chunk-K2THP63Z.js";
+} from "./chunk-EYNXG3FO.js";
 import {
   envCommand
-} from "./chunk-YGSTSVXS.js";
+} from "./chunk-2MXGTALG.js";
 import {
   confirmOption,
   deploymentOption,
@@ -40,13 +40,11 @@ import {
   jsonOption,
   limitOption,
   nextOption,
+  packageName,
   projectOption,
   protectionBypassOption,
   yesOption
-} from "./chunk-EHTPDXTS.js";
-import {
-  packageName
-} from "./chunk-P6AK7SVK.js";
+} from "./chunk-KSSNLCL4.js";
 import {
   output_manager_default
 } from "./chunk-OX7KI3LF.js";
@@ -3416,6 +3414,7 @@ var overviewSubcommand = {
   description: "Show a summary of your project's firewall configuration, including active rules, IP blocks, bypasses, and any unpublished draft changes",
   arguments: [],
   options: [
+    projectOption,
     {
       name: "json",
       shorthand: null,
@@ -3437,6 +3436,7 @@ var diffSubcommand = {
   description: "Show draft changes that have been made but are not yet published to production",
   arguments: [],
   options: [
+    projectOption,
     {
       name: "json",
       shorthand: null,
@@ -3457,7 +3457,7 @@ var publishSubcommand = {
   aliases: [],
   description: "Publish all draft firewall changes to production, making them live immediately",
   arguments: [],
-  options: [yesOption],
+  options: [projectOption, yesOption],
   examples: [
     {
       name: "Publish draft changes",
@@ -3474,7 +3474,7 @@ var discardSubcommand = {
   aliases: [],
   description: "Permanently discard all unpublished draft changes, reverting to the current production configuration",
   arguments: [],
-  options: [yesOption],
+  options: [projectOption, yesOption],
   examples: [
     {
       name: "Discard draft changes",
@@ -3492,6 +3492,7 @@ var systemBypassListSubcommand = {
   description: "List all system bypass rules that allow specific IPs to skip firewall checks",
   arguments: [],
   options: [
+    projectOption,
     {
       name: "json",
       shorthand: null,
@@ -3513,6 +3514,7 @@ var systemBypassAddSubcommand = {
   description: "Add a system bypass rule to allow a specific IP address to skip firewall checks. Takes effect immediately (no publish required)",
   arguments: [{ name: "ip", required: true }],
   options: [
+    projectOption,
     {
       name: "domain",
       shorthand: null,
@@ -3546,6 +3548,7 @@ var systemBypassRemoveSubcommand = {
   description: "Remove a system bypass rule so the IP is no longer exempt from firewall checks. Takes effect immediately (no publish required)",
   arguments: [{ name: "ip", required: true }],
   options: [
+    projectOption,
     {
       name: "domain",
       shorthand: null,
@@ -3594,6 +3597,7 @@ var ipBlocksListSubcommand = {
   description: "List all IP blocking rules, including any unpublished draft changes",
   arguments: [],
   options: [
+    projectOption,
     {
       name: "json",
       shorthand: null,
@@ -3615,6 +3619,7 @@ var ipBlocksBlockSubcommand = {
   description: "Block an IP address or CIDR range from accessing your project. Stages a draft change \u2014 run `publish` to make it live",
   arguments: [{ name: "ip", required: true }],
   options: [
+    projectOption,
     {
       name: "hostname",
       shorthand: null,
@@ -3652,6 +3657,7 @@ var ipBlocksUnblockSubcommand = {
   description: "Remove an IP blocking rule to allow the address to access your project again. Stages a draft change \u2014 run `publish` to make it live",
   arguments: [{ name: "id-or-ip", required: true }],
   options: [
+    projectOption,
     {
       name: "hostname",
       shorthand: null,
@@ -3708,6 +3714,7 @@ var rulesListSubcommand2 = {
   description: "List all custom firewall rules, including any unpublished draft changes",
   arguments: [],
   options: [
+    projectOption,
     {
       name: "expand",
       shorthand: "e",
@@ -3740,6 +3747,7 @@ var rulesInspectSubcommand = {
   description: "Show the full configuration of a custom firewall rule, including conditions, action, and rate limit settings",
   arguments: [{ name: "name-or-id", required: true }],
   options: [
+    projectOption,
     {
       name: "json",
       shorthand: null,
@@ -3765,6 +3773,7 @@ var rulesAddSubcommand2 = {
   description: "Create a new custom firewall rule using AI, an interactive builder, JSON, or command-line flags. Stages a draft change \u2014 run `publish` to make it live",
   arguments: [{ name: "name", required: false }],
   options: [
+    projectOption,
     {
       name: "ai",
       shorthand: null,
@@ -3901,6 +3910,7 @@ var rulesEditSubcommand2 = {
   description: "Edit an existing custom firewall rule using AI, an interactive editor, JSON, or command-line flags. Stages a draft change \u2014 run `publish` to make it live",
   arguments: [{ name: "name-or-id", required: true }],
   options: [
+    projectOption,
     {
       name: "ai",
       shorthand: null,
@@ -4050,7 +4060,7 @@ var rulesEnableSubcommand = {
   aliases: [],
   description: "Enable a disabled custom firewall rule. Stages a draft change \u2014 run `publish` to make it live",
   arguments: [{ name: "name-or-id", required: true }],
-  options: [yesOption],
+  options: [projectOption, yesOption],
   examples: [
     {
       name: "Enable a rule",
@@ -4063,7 +4073,7 @@ var rulesDisableSubcommand = {
   aliases: [],
   description: "Disable a custom firewall rule without removing it. Stages a draft change \u2014 run `publish` to make it live",
   arguments: [{ name: "name-or-id", required: true }],
-  options: [yesOption],
+  options: [projectOption, yesOption],
   examples: [
     {
       name: "Disable a rule",
@@ -4076,7 +4086,7 @@ var rulesRemoveSubcommand2 = {
   aliases: ["rm", "delete"],
   description: "Remove a custom firewall rule. Stages a draft change \u2014 run `publish` to make it live",
   arguments: [{ name: "name-or-id", required: true }],
-  options: [yesOption],
+  options: [projectOption, yesOption],
   examples: [
     {
       name: "Remove a rule",
@@ -4090,6 +4100,7 @@ var rulesReorderSubcommand = {
   description: "Change the priority order of a custom firewall rule. Stages a draft change \u2014 run `publish` to make it live",
   arguments: [{ name: "name-or-id", required: true }],
   options: [
+    projectOption,
     {
       name: "position",
       shorthand: null,
@@ -4165,6 +4176,7 @@ var attackModeEnableSubcommand = {
   description: "Enable attack mode \u2014 all visitors will be shown a verification challenge before accessing your site. Takes effect immediately (no publish required)",
   arguments: [],
   options: [
+    projectOption,
     {
       name: "duration",
       shorthand: null,
@@ -4190,7 +4202,7 @@ var attackModeDisableSubcommand = {
   aliases: [],
   description: "Disable attack mode \u2014 visitors will no longer be challenged. Takes effect immediately (no publish required)",
   arguments: [],
-  options: [yesOption],
+  options: [projectOption, yesOption],
   examples: [
     {
       name: "Disable attack mode",
@@ -4221,7 +4233,7 @@ var systemMitigationsPauseSubcommand = {
   aliases: [],
   description: "Pause automatic DDoS protection and system-level traffic filtering for 24 hours. Takes effect immediately (no publish required)",
   arguments: [],
-  options: [yesOption],
+  options: [projectOption, yesOption],
   examples: [
     {
       name: "Pause system mitigations",
@@ -4234,7 +4246,7 @@ var systemMitigationsResumeSubcommand = {
   aliases: [],
   description: "Resume automatic DDoS protection and system-level traffic filtering. Takes effect immediately (no publish required)",
   arguments: [],
-  options: [yesOption],
+  options: [projectOption, yesOption],
   examples: [
     {
       name: "Resume system mitigations",
@@ -4467,6 +4479,131 @@ var inspectSubcommand3 = {
     }
   ]
 };
+var versionsListSubcommand = {
+  name: "list",
+  aliases: ["ls"],
+  default: true,
+  description: "List version history for a feature flag",
+  arguments: [
+    {
+      name: "flag",
+      required: true
+    }
+  ],
+  options: [
+    projectOption,
+    {
+      name: "environment",
+      shorthand: "e",
+      type: String,
+      deprecated: false,
+      description: "Filter versions by changed environment",
+      argument: "ENV"
+    },
+    {
+      name: "limit",
+      shorthand: null,
+      type: Number,
+      deprecated: false,
+      description: "Return at most NUMBER versions (1-100)",
+      argument: "NUMBER"
+    },
+    {
+      name: "cursor",
+      shorthand: null,
+      type: String,
+      deprecated: false,
+      description: "Pagination cursor from a previous versions response",
+      argument: "CURSOR"
+    },
+    {
+      name: "json",
+      shorthand: null,
+      type: Boolean,
+      deprecated: false,
+      description: "Output in JSON format"
+    }
+  ],
+  examples: [
+    {
+      name: "List version history for a feature flag",
+      value: `${packageName} flags versions my-feature-flag`
+    },
+    {
+      name: "List version history using the explicit list subcommand",
+      value: `${packageName} flags versions list my-feature-flag`
+    },
+    {
+      name: "List production version history",
+      value: `${packageName} flags versions my-feature-flag --environment production`
+    },
+    {
+      name: "List the next page of version history",
+      value: `${packageName} flags versions my-feature-flag --limit 10 --cursor <cursor>`
+    },
+    {
+      name: "List version history as JSON",
+      value: `${packageName} flags versions my-feature-flag --json`
+    }
+  ]
+};
+var versionsDiffSubcommand = {
+  name: "diff",
+  aliases: [],
+  description: "Show changes introduced by a feature flag version",
+  arguments: [
+    {
+      name: "flag",
+      required: true
+    }
+  ],
+  options: [
+    projectOption,
+    {
+      name: "revision",
+      shorthand: null,
+      type: Number,
+      deprecated: false,
+      description: "Revision number to compare with the previous revision",
+      argument: "NUMBER"
+    },
+    {
+      name: "json",
+      shorthand: null,
+      type: Boolean,
+      deprecated: false,
+      description: "Output the diff in JSON format"
+    }
+  ],
+  examples: [
+    {
+      name: "Show what changed in a revision",
+      value: `${packageName} flags versions diff my-feature-flag --revision 4`
+    },
+    {
+      name: "Show the revision diff as JSON",
+      value: `${packageName} flags versions diff my-feature-flag --revision 4 --json`
+    }
+  ]
+};
+var versionsSubcommand = {
+  name: "versions",
+  aliases: [],
+  description: "List and compare version history for a feature flag",
+  arguments: [],
+  subcommands: [versionsListSubcommand, versionsDiffSubcommand],
+  options: [],
+  examples: [
+    {
+      name: "List version history for a feature flag",
+      value: `${packageName} flags versions my-feature-flag`
+    },
+    {
+      name: "Show what changed in a revision",
+      value: `${packageName} flags versions diff my-feature-flag --revision 4`
+    }
+  ]
+};
 var createSubcommand4 = {
   name: "create",
   aliases: ["add"],
@@ -4903,6 +5040,7 @@ var rulesListSubcommand3 = {
     }
   ],
   options: [
+    projectOption,
     {
       name: "environment",
       shorthand: "e",
@@ -4941,6 +5079,7 @@ var rulesAddSubcommand3 = {
     }
   ],
   options: [
+    projectOption,
     {
       name: "environment",
       shorthand: "e",
@@ -4998,6 +5137,7 @@ var rulesUpdateSubcommand = {
     }
   ],
   options: [
+    projectOption,
     {
       name: "environment",
       shorthand: "e",
@@ -5043,6 +5183,7 @@ var rulesRemoveSubcommand3 = {
     }
   ],
   options: [
+    projectOption,
     {
       name: "environment",
       shorthand: "e",
@@ -5075,6 +5216,7 @@ var rulesMoveSubcommand = {
     }
   ],
   options: [
+    projectOption,
     {
       name: "environment",
       shorthand: "e",
@@ -5691,6 +5833,7 @@ var flagsCommand = {
   subcommands: [
     listSubcommand11,
     inspectSubcommand3,
+    versionsSubcommand,
     createSubcommand4,
     openSubcommand2,
     updateSubcommand3,
@@ -5722,7 +5865,7 @@ var connectSubcommand = {
       required: false
     }
   ],
-  options: [yesOption, confirmOption],
+  options: [projectOption, yesOption, confirmOption],
   examples: [
     {
       name: "Connect your Vercel Project to your Git repository defined in your local `.git` config",
@@ -5739,7 +5882,7 @@ var disconnectSubcommand = {
   aliases: [],
   description: "Disconnect the Git repository from your Vercel Project",
   arguments: [],
-  options: [yesOption, confirmOption],
+  options: [projectOption, yesOption, confirmOption],
   examples: [
     {
       name: "Disconnect the Git repository",
@@ -6981,7 +7124,7 @@ var CommandTimeout = "5 minutes";
 var logsCommand = {
   name: "logs",
   aliases: ["log"],
-  description: "Display request logs for a project.\n\nSource types: \u03BB = serverless, \u03B5 = edge/middleware, \u25C7 = static/external",
+  description: "Display request logs for a project.\n\nWith --follow, stream live runtime logs from a deployment. When no deployment is specified, resolves in order: latest deployment on the current git branch, then your latest deployment, then the latest production deployment. Use --environment production to always stream the latest production deployment.\n\nSource types: \u03BB = serverless, \u03B5 = edge/middleware, \u25C7 = static/external",
   arguments: [
     {
       name: "url|deploymentId",
@@ -7002,7 +7145,7 @@ var logsCommand = {
       shorthand: null,
       type: String,
       deprecated: false,
-      description: "Filter by environment: production or preview"
+      description: "Filter by environment: production or preview. With --follow, selects which environment to stream (production always streams the latest production deployment)"
     },
     {
       name: "level",
@@ -7058,7 +7201,7 @@ var logsCommand = {
       shorthand: "f",
       type: Boolean,
       deprecated: false,
-      description: "Stream live runtime logs for a deployment"
+      description: "Stream live runtime logs. Without a deployment, follows the latest deployment on the current git branch, then your latest deployment, then the latest production deployment"
     },
     {
       name: "no-follow",
@@ -7093,7 +7236,7 @@ var logsCommand = {
       shorthand: "x",
       type: Boolean,
       deprecated: false,
-      description: "Show full log message below each request line"
+      description: "Show full log message below each request line (default when output is not a TTY)"
     },
     {
       name: "branch",
@@ -7111,6 +7254,14 @@ var logsCommand = {
     }
   ],
   examples: [
+    {
+      name: "Stream live logs for your most recent deployment",
+      value: `${packageName} logs --follow`
+    },
+    {
+      name: "Stream live logs for the latest production deployment",
+      value: `${packageName} logs --follow --environment production`
+    },
     {
       name: "Stream live logs for a deployment URL",
       value: `${packageName} logs https://my-app-xxxxx.vercel.app --follow`
@@ -7120,7 +7271,7 @@ var logsCommand = {
       value: `${packageName} logs dpl_xxxxx --follow`
     },
     {
-      name: "Stream logs for the latest production deployment of a project",
+      name: "Stream logs for a specific project",
       value: `${packageName} logs --project my-app --follow`
     },
     {
@@ -8183,6 +8334,7 @@ var listSubcommand14 = {
   description: "List all redirects for the current project. These redirects apply to all deployments and environments. There may also be redirects defined in a deployment that are not listed here.",
   arguments: [],
   options: [
+    projectOption,
     {
       name: "search",
       description: "Search for redirects by source or destination",
@@ -8247,7 +8399,7 @@ var listVersionsSubcommand = {
   aliases: ["ls-versions"],
   description: "List all versions of redirects",
   arguments: [],
-  options: [],
+  options: [projectOption],
   examples: [
     {
       name: "List all redirect versions",
@@ -8270,6 +8422,7 @@ var addSubcommand9 = {
     }
   ],
   options: [
+    projectOption,
     {
       name: "status",
       description: "HTTP status code (301, 302, 307, or 308)",
@@ -8335,6 +8488,7 @@ var uploadSubcommand = {
     }
   ],
   options: [
+    projectOption,
     {
       ...yesOption,
       description: "Skip confirmation prompt"
@@ -8377,6 +8531,7 @@ var removeSubcommand12 = {
     }
   ],
   options: [
+    projectOption,
     {
       ...yesOption,
       description: "Skip the confirmation prompt when removing a redirect"
@@ -8400,6 +8555,7 @@ var promoteSubcommand = {
     }
   ],
   options: [
+    projectOption,
     {
       ...yesOption,
       description: "Skip the confirmation prompt when promoting"
@@ -8423,6 +8579,7 @@ var restoreSubcommand = {
     }
   ],
   options: [
+    projectOption,
     {
       ...yesOption,
       description: "Skip the confirmation prompt when restoring"
@@ -8838,6 +8995,7 @@ var listSubcommand15 = {
   arguments: [],
   options: [
     formatOption,
+    projectOption,
     {
       ...yesOption,
       description: "Skip confirmation when linking is required (e.g. in non-interactive mode)"
@@ -10316,6 +10474,9 @@ export {
   formatFlagConditionComparator,
   listSubcommand11,
   inspectSubcommand3,
+  versionsListSubcommand,
+  versionsDiffSubcommand,
+  versionsSubcommand,
   createSubcommand4,
   openSubcommand2,
   updateSubcommand3,

package/dist/chunks/{chunk-E3Y4SDXF.js → chunk-ICSIFPXG.js}

@@ -6,19 +6,17 @@ const __filename = __fileURLToPath(import.meta.url);
 const __dirname = __dirname_(__filename);
 import {
   resolveAlertsScope
-} from "./chunk-HMMPJ3VD.js";
+} from "./chunk-2C2JJTAM.js";
 import {
   handleValidationError,
   outputError,
   validateAllProjectMutualExclusivity
 } from "./chunk-BUZRVER7.js";
 import {
-  AGENT_REASON
-} from "./chunk-IC4YEIGW.js";
-import {
+  AGENT_REASON,
   buildCommandWithGlobalFlags,
   outputAgentError
-} from "./chunk-CB3I3QIT.js";
+} from "./chunk-UDWRZXIT.js";
 
 // src/commands/alerts/rules/parse-scope.ts
 async function parseRulesFlagsAndScope(client, flags, jsonOutput) {