vercel 56.2.0 → 56.2.1

package/dist/chunks/{chunk-LXF3AXHM.js → chunk-DWU7JOO6.js}

@@ -11,7 +11,7 @@ import {
   getTeamById,
   getUser,
   getVercelDirectory
-} from "./chunk-YGSTSVXS.js";
+} from "./chunk-DDEPCAGE.js";
 import {
   TeamDeleted
 } from "./chunk-P6AK7SVK.js";

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

@@ -28,10 +28,10 @@ import {
 import {
   buildCommand,
   pullCommand
-} from "./chunk-K2THP63Z.js";
+} from "./chunk-YKJA5TVC.js";
 import {
   envCommand
-} from "./chunk-YGSTSVXS.js";
+} from "./chunk-DDEPCAGE.js";
 import {
   confirmOption,
   deploymentOption,
@@ -4467,6 +4467,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"],
@@ -5691,6 +5816,7 @@ var flagsCommand = {
   subcommands: [
     listSubcommand11,
     inspectSubcommand3,
+    versionsSubcommand,
     createSubcommand4,
     openSubcommand2,
     updateSubcommand3,
@@ -6981,7 +7107,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 +7128,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 +7184,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 +7219,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 +7237,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 +7254,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`
     },
     {
@@ -10316,6 +10450,9 @@ export {
   formatFlagConditionComparator,
   listSubcommand11,
   inspectSubcommand3,
+  versionsListSubcommand,
+  versionsDiffSubcommand,
+  versionsSubcommand,
   createSubcommand4,
   openSubcommand2,
   updateSubcommand3,

package/dist/chunks/{chunk-7PZWVZN6.js → chunk-G75NFPIT.js}

@@ -6,7 +6,7 @@ const __filename = __fileURLToPath(import.meta.url);
 const __dirname = __dirname_(__filename);
 import {
   require_isexe
-} from "./chunk-24FCBXI4.js";
+} from "./chunk-R6IGDGX3.js";
 import {
   __commonJS,
   __require

package/dist/chunks/{chunk-EKIKD7RS.js → chunk-GPVU6JRS.js}

@@ -6,7 +6,7 @@ const __filename = __fileURLToPath(import.meta.url);
 const __dirname = __dirname_(__filename);
 import {
   writeProjectSettings
-} from "./chunk-SRJTYE5U.js";
+} from "./chunk-JF7LPEBD.js";
 import {
   autoInstallVercelPlugin
 } from "./chunk-NJUPUGOE.js";
@@ -15,10 +15,10 @@ import {
 } from "./chunk-64IF634X.js";
 import {
   ensureLink
-} from "./chunk-WOA4Z45Z.js";
+} from "./chunk-HIO4M75R.js";
 import {
   pullCommand
-} from "./chunk-K2THP63Z.js";
+} from "./chunk-YKJA5TVC.js";
 import {
   help
 } from "./chunk-QY63UKTP.js";
@@ -28,7 +28,7 @@ import {
   envPullCommandLogic,
   humanizePath,
   parseTarget
-} from "./chunk-YGSTSVXS.js";
+} from "./chunk-DDEPCAGE.js";
 import {
   TelemetryClient
 } from "./chunk-ECCWJHC6.js";

package/dist/chunks/{chunk-WOA4Z45Z.js → chunk-HIO4M75R.js}

@@ -5,14 +5,19 @@ const require = __createRequire(import.meta.url);
 const __filename = __fileURLToPath(import.meta.url);
 const __dirname = __dirname_(__filename);
 import {
-  printProjectNotFoundError,
   setupAndLink
-} from "./chunk-XFMTSTYT.js";
+} from "./chunk-PASZMRTZ.js";
+import {
+  printProjectNotFoundError
+} from "./chunk-IMUF5MGV.js";
+import {
+  detectExplicitScope
+} from "./chunk-DWU7JOO6.js";
 import {
   getLinkedProject,
   param,
   resolveProjectCwd
-} from "./chunk-YGSTSVXS.js";
+} from "./chunk-DDEPCAGE.js";
 import {
   buildCommandWithYes,
   outputActionRequired
@@ -28,25 +33,30 @@ import {
 // src/util/link/ensure-link.ts
 async function ensureLink(commandName, client, cwd, opts = {}) {
   cwd = await resolveProjectCwd(cwd);
-  let { link } = opts;
+  let link = opts.link;
   const nonInteractive = opts.nonInteractive ?? client.nonInteractive ?? false;
   opts.nonInteractive = nonInteractive;
   if (!link) {
     if (opts.forceDelete) {
       link = { status: "not_linked", org: null, project: null };
     } else {
-      link = await getLinkedProject(
-        client,
+      link = await getLinkedProject(client, {
         cwd,
-        opts.projectName,
-        opts.failIfNotFound
-      );
+        projectName: opts.projectName,
+        projectNameIsExplicit: Boolean(opts.projectName && opts.failIfNotFound),
+        scopeIsExplicit: detectExplicitScope(client)
+      });
     }
     opts.link = link;
   }
   if (link.status === "linked" && opts.forceDelete || link.status === "not_linked") {
     if (link.status === "not_linked" && opts.failIfNotFound && opts.projectName) {
-      await printProjectNotFoundError(client, opts.projectName, commandName);
+      await printProjectNotFoundError(
+        client,
+        opts.projectName,
+        commandName,
+        link.orgId
+      );
       return 1;
     }
     if (link.status === "not_linked" && opts.requireExistingLink) {

package/dist/chunks/chunk-IMUF5MGV.js

@@ -0,0 +1,81 @@
+import { createRequire as __createRequire } from 'node:module';
+import { fileURLToPath as __fileURLToPath } from 'node:url';
+import { dirname as __dirname_ } from 'node:path';
+const require = __createRequire(import.meta.url);
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __dirname_(__filename);
+import {
+  AGENT_REASON,
+  AGENT_STATUS
+} from "./chunk-IC4YEIGW.js";
+import {
+  getScope
+} from "./chunk-DWU7JOO6.js";
+import {
+  getOrgById
+} from "./chunk-DDEPCAGE.js";
+import {
+  buildCommandWithGlobalFlags,
+  outputAgentError,
+  shouldEmitNonInteractiveCommandError
+} from "./chunk-CB3I3QIT.js";
+import {
+  output_manager_default
+} from "./chunk-OX7KI3LF.js";
+
+// src/util/projects/project-not-found-error.ts
+async function printProjectNotFoundError(client, projectNameOrId, commandName, orgId) {
+  let contextName;
+  try {
+    if (orgId) {
+      const org = await getOrgById(client, orgId);
+      contextName = org?.slug ?? orgId;
+    } else {
+      const scope = await getScope(client);
+      contextName = scope.contextName;
+    }
+  } catch (err) {
+    contextName = orgId;
+    output_manager_default.debug(`Scope lookup failed during error reporting: ${err}`);
+  }
+  const scopeClause = contextName ? ` (${contextName})` : "";
+  const headline = `Project "${projectNameOrId}" was not found in the current scope${scopeClause}.`;
+  output_manager_default.error(
+    `${headline}
+
+If it lives in a different team or account:
+  \u2022 Retry with \`--scope <team-slug|your-username>\`, or
+  \u2022 Run \`vercel switch <team-slug|your-username>\` to change scope.
+
+List accessible teams with \`vercel teams ls\`.`
+  );
+  if (!shouldEmitNonInteractiveCommandError(client)) {
+    return;
+  }
+  const retryWithScope = buildCommandWithGlobalFlags(
+    client.argv,
+    `${commandName} --project ${projectNameOrId} --scope <team-slug>`
+  );
+  outputAgentError(
+    client,
+    {
+      status: AGENT_STATUS.ERROR,
+      reason: AGENT_REASON.PROJECT_NOT_FOUND,
+      message: `${headline} If it lives in a different team or account, retry with --scope <team-slug|your-username> or run \`vercel switch <team-slug|your-username>\` to change scope.`,
+      ...contextName ? { scope: contextName } : {},
+      next: [
+        { command: "vercel teams ls", when: "list accessible teams" },
+        { command: retryWithScope, when: "retry with a specific team" },
+        {
+          command: "vercel switch <team-slug>",
+          when: "change the default scope"
+        }
+      ]
+    },
+    1
+  );
+}
+
+export {
+  printProjectNotFoundError
+};

package/dist/chunks/{chunk-SRJTYE5U.js → chunk-JF7LPEBD.js}

@@ -8,7 +8,7 @@ import {
   VERCEL_DIR,
   VERCEL_DIR_PROJECT,
   require_lib
-} from "./chunk-YGSTSVXS.js";
+} from "./chunk-DDEPCAGE.js";
 import {
   require_dist
 } from "./chunk-OX7KI3LF.js";

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

@@ -6,7 +6,7 @@ const __filename = __fileURLToPath(import.meta.url);
 const __dirname = __dirname_(__filename);
 import {
   resolveAlertsScope
-} from "./chunk-HMMPJ3VD.js";
+} from "./chunk-7OJJKCSW.js";
 import {
   handleValidationError,
   outputError,

package/dist/chunks/{chunk-SHT5IY3Q.js → chunk-MYD7N6MH.js}

@@ -9,7 +9,7 @@ import {
 } from "./chunk-IB5L4LKZ.js";
 import {
   require_execa
-} from "./chunk-24FCBXI4.js";
+} from "./chunk-R6IGDGX3.js";
 import {
   VERCEL_CONFIG_EXTENSIONS,
   VERCEL_DIR,
@@ -19,7 +19,7 @@ import {
   require_lib,
   require_minimatch,
   require_pluralize
-} from "./chunk-YGSTSVXS.js";
+} from "./chunk-DDEPCAGE.js";
 import {
   CantParseJSONFile,
   cmd,

package/dist/chunks/{chunk-HR6VI6UV.js → chunk-NULWLKT7.js}

@@ -11,7 +11,7 @@ import {
   PromptBackError,
   PromptCanceledError,
   getLocalPathConfig
-} from "./chunk-EI555LUJ.js";
+} from "./chunk-UESEGACQ.js";
 import {
   DEFAULT_VERCEL_CONFIG_FILENAME,
   VERCEL_CONFIG_EXTENSIONS,
@@ -38,7 +38,7 @@ import {
   useKeypress,
   usePrefix,
   useState
-} from "./chunk-YGSTSVXS.js";
+} from "./chunk-DDEPCAGE.js";
 import {
   require_load_json_file
 } from "./chunk-ECCWJHC6.js";
@@ -56,7 +56,7 @@ import {
 import {
   Headers,
   fetch
-} from "./chunk-2RVK3DDN.js";
+} from "./chunk-52QYYTM5.js";
 import {
   emoji,
   link_default,
@@ -1655,7 +1655,6 @@ var Client = class extends EventEmitter {
       output_manager_default.debug(`Retrying: ${error}
 ${error.stack}`);
     };
-    this.agent = opts.agent;
     this.setArgv(opts.argv);
     this.apiUrl = opts.apiUrl;
     this.authConfig = opts.authConfig;

package/dist/chunks/{chunk-XFMTSTYT.js → chunk-PASZMRTZ.js}

@@ -4,18 +4,11 @@ import { dirname as __dirname_ } from 'node:path';
 const require = __createRequire(import.meta.url);
 const __filename = __fileURLToPath(import.meta.url);
 const __dirname = __dirname_(__filename);
-import {
-  AGENT_REASON,
-  AGENT_STATUS
-} from "./chunk-IC4YEIGW.js";
 import {
   getLocalPathConfig,
   isPromptBackError,
   isPromptCanceledError
-} from "./chunk-EI555LUJ.js";
-import {
-  getScope
-} from "./chunk-LXF3AXHM.js";
+} from "./chunk-UESEGACQ.js";
 import {
   table
 } from "./chunk-QEEGXNFK.js";
@@ -53,12 +46,7 @@ import {
   selectAndParseRemoteUrl,
   selectOrg,
   writeServicesConfig
-} from "./chunk-YGSTSVXS.js";
-import {
-  buildCommandWithGlobalFlags,
-  outputAgentError,
-  shouldEmitNonInteractiveCommandError
-} from "./chunk-CB3I3QIT.js";
+} from "./chunk-DDEPCAGE.js";
 import {
   printError
 } from "./chunk-EHTPDXTS.js";
@@ -167,53 +155,6 @@ async function readConfig(dir) {
   return null;
 }
 
-// src/util/projects/project-not-found-error.ts
-async function printProjectNotFoundError(client, projectNameOrId, commandName) {
-  let contextName;
-  try {
-    const scope = await getScope(client);
-    contextName = scope.contextName;
-  } catch (err) {
-    output_manager_default.debug(`getScope failed during error reporting: ${err}`);
-  }
-  const scopeClause = contextName ? ` (${contextName})` : "";
-  const headline = `Project "${projectNameOrId}" was not found in the current scope${scopeClause}.`;
-  output_manager_default.error(
-    `${headline}
-
-If it lives in a different team or account:
-  \u2022 Retry with \`--scope <team-slug|your-username>\`, or
-  \u2022 Run \`vercel switch <team-slug|your-username>\` to change scope.
-
-List accessible teams with \`vercel teams ls\`.`
-  );
-  if (!shouldEmitNonInteractiveCommandError(client)) {
-    return;
-  }
-  const retryWithScope = buildCommandWithGlobalFlags(
-    client.argv,
-    `${commandName} --project ${projectNameOrId} --scope <team-slug>`
-  );
-  outputAgentError(
-    client,
-    {
-      status: AGENT_STATUS.ERROR,
-      reason: AGENT_REASON.PROJECT_NOT_FOUND,
-      message: `${headline} If it lives in a different team or account, retry with --scope <team-slug|your-username> or run \`vercel switch <team-slug|your-username>\` to change scope.`,
-      ...contextName ? { scope: contextName } : {},
-      next: [
-        { command: "vercel teams ls", when: "list accessible teams" },
-        { command: retryWithScope, when: "retry with a specific team" },
-        {
-          command: "vercel switch <team-slug>",
-          when: "change the default scope"
-        }
-      ]
-    },
-    1
-  );
-}
-
 // src/util/input/display-services.ts
 var import_frameworks = __toESM(require_frameworks(), 1);
 import {
@@ -1190,7 +1131,7 @@ async function setupAndLink(client, path2, {
     return { status: "error", exitCode: 1, reason: "PATH_IS_FILE" };
   }
   if (!link) {
-    link = await getLinkedProject(client, path2);
+    link = await getLinkedProject(client, { cwd: path2 });
   }
   const isTTY = client.stdin.isTTY;
   let rootDirectory = null;
@@ -1200,7 +1141,7 @@ async function setupAndLink(client, path2, {
     return link;
   }
   if (getPlatformEnv("ORG_ID") && getPlatformEnv("PROJECT_ID")) {
-    const envLink = await getLinkedProject(client, path2);
+    const envLink = await getLinkedProject(client, { cwd: path2 });
     if (envLink.status === "error") {
       return envLink;
     }
@@ -1535,6 +1476,5 @@ export {
   validatePaths,
   readConfig,
   displayDetectedServices,
-  setupAndLink,
-  printProjectNotFoundError
+  setupAndLink
 };

package/dist/chunks/{chunk-24FCBXI4.js → chunk-R6IGDGX3.js}

@@ -7,7 +7,7 @@ const __dirname = __dirname_(__filename);
 import {
   require_end_of_stream,
   require_once
-} from "./chunk-2RVK3DDN.js";
+} from "./chunk-52QYYTM5.js";
 import {
   require_signal_exit
 } from "./chunk-OX7KI3LF.js";

package/dist/chunks/{chunk-EI555LUJ.js → chunk-UESEGACQ.js}

@@ -7,7 +7,7 @@ const __dirname = __dirname_(__filename);
 import {
   VERCEL_DIR,
   isVercelTomlEnabled
-} from "./chunk-YGSTSVXS.js";
+} from "./chunk-DDEPCAGE.js";
 import {
   parseArguments
 } from "./chunk-EHTPDXTS.js";

package/dist/chunks/{chunk-W346YNDN.js → chunk-VOBBH2SB.js}

@@ -4,6 +4,18 @@ import { dirname as __dirname_ } from 'node:path';
 const require = __createRequire(import.meta.url);
 const __filename = __fileURLToPath(import.meta.url);
 const __dirname = __dirname_(__filename);
+import {
+  printProjectNotFoundError
+} from "./chunk-IMUF5MGV.js";
+import {
+  detectExplicitScope
+} from "./chunk-DWU7JOO6.js";
+import {
+  getLinkedProject
+} from "./chunk-DDEPCAGE.js";
+import {
+  omitGlobalFlagsFromArgs
+} from "./chunk-CB3I3QIT.js";
 import {
   require_dist
 } from "./chunk-OX7KI3LF.js";
@@ -299,11 +311,48 @@ function ellipsis(str, length) {
   return str.length > length ? `${str.slice(0, length - 1)}\u2026` : str;
 }
 
+// src/util/projects/resolve-project-context.ts
+function getInvokingCommandFromArgv(argv) {
+  const args = omitGlobalFlagsFromArgs(argv.slice(2));
+  const positionals = [];
+  for (const arg of args) {
+    if (arg.startsWith("-")) {
+      break;
+    }
+    positionals.push(arg);
+  }
+  return positionals.join(" ");
+}
+async function resolveProjectContext({
+  client,
+  cwd = client.cwd,
+  projectNameOrId,
+  commandName = ""
+}) {
+  const context = await getLinkedProject(client, {
+    cwd,
+    projectName: projectNameOrId,
+    projectNameIsExplicit: Boolean(projectNameOrId),
+    scopeIsExplicit: detectExplicitScope(client)
+  });
+  if (context.status === "not_linked" && projectNameOrId) {
+    await printProjectNotFoundError(
+      client,
+      projectNameOrId,
+      commandName || getInvokingCommandFromArgv(client.argv),
+      context.orgId
+    );
+    return { status: "error", exitCode: 1, orgId: context.orgId };
+  }
+  return context;
+}
+
 export {
   readStandardInput,
   CHECKBOX_INSTRUCTIONS,
   getCustomEnvironments,
   pickCustomEnvironment,
   ellipsis,
+  resolveProjectContext,
   require_dist2 as require_dist
 };