vercel 56.3.2 → 56.4.1

package/dist/chunks/{ls-FQIWFI4K.js → ls-P7ZLBWW2.js}

@@ -15,7 +15,7 @@ import {
   handleVcrApiError,
   resolveVcrScope,
   validateVcrJsonOutput
-} from "./chunk-GB3QQGZU.js";
+} from "./chunk-NLRIKNPX.js";
 import {
   outputError,
   validateOptionalIntegerRange
@@ -29,7 +29,7 @@ import "./chunk-FYQPTH5C.js";
 import {
   table
 } from "./chunk-NZRWTCRM.js";
-import "./chunk-HZAINEXG.js";
+import "./chunk-GLAHGVBS.js";
 import {
   AGENT_REASON,
   outputAgentError

package/dist/chunks/{ls-PQPRURTJ.js → ls-YDUYTLXW.js}

@@ -19,7 +19,7 @@ import {
   resolveVcrScope,
   validateVcrChoice,
   validateVcrJsonOutput
-} from "./chunk-GB3QQGZU.js";
+} from "./chunk-NLRIKNPX.js";
 import {
   outputError,
   validateOptionalIntegerRange
@@ -33,7 +33,7 @@ import {
 import {
   table
 } from "./chunk-NZRWTCRM.js";
-import "./chunk-HZAINEXG.js";
+import "./chunk-GLAHGVBS.js";
 import {
   AGENT_REASON,
   outputAgentError

package/dist/chunks/{publish-LWCEDLGX.js → publish-RXFUYSW3.js}

@@ -17,7 +17,7 @@ import {
   printDiffSummary,
   requireProjectContext,
   withGlobalFlags
-} from "./chunk-5POUHPEH.js";
+} from "./chunk-GKVAAY2A.js";
 import {
   publishSubcommand
 } from "./chunk-VZSZBD4V.js";
@@ -25,7 +25,7 @@ import {
   stamp_default
 } from "./chunk-64IF634X.js";
 import "./chunk-VXYGCOKL.js";
-import "./chunk-HZAINEXG.js";
+import "./chunk-GLAHGVBS.js";
 import {
   outputAgentError
 } from "./chunk-UDWRZXIT.js";

package/dist/chunks/query-ILJJL3BZ.js

@@ -0,0 +1,391 @@
+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 {
+  fetchMetricDetailOrExit,
+  getDefaultAggregation
+} from "./chunk-6RTK6BWX.js";
+import {
+  computeGranularity,
+  formatText
+} from "./chunk-F5OMERHI.js";
+import {
+  formatErrorJson,
+  formatQueryJson,
+  getRollupColumnName,
+  handleApiError
+} from "./chunk-Z7NPYIZ6.js";
+import {
+  resolveTimeRange,
+  validateAllProjectMutualExclusivity
+} from "./chunk-BUZRVER7.js";
+import {
+  validateJsonOutput
+} from "./chunk-XPKWKPWA.js";
+import {
+  metricsCommand
+} from "./chunk-4G6QZSBL.js";
+import "./chunk-VXYGCOKL.js";
+import "./chunk-NZRWTCRM.js";
+import {
+  getLinkedProject,
+  getProjectByNameOrId,
+  getScope
+} from "./chunk-GLAHGVBS.js";
+import "./chunk-UDWRZXIT.js";
+import "./chunk-ECCWJHC6.js";
+import {
+  parseArguments,
+  printError
+} from "./chunk-SZXT3PDQ.js";
+import {
+  ProjectNotFound,
+  getFlagsSpecification,
+  isAPIError
+} from "./chunk-KSSNLCL4.js";
+import "./chunk-P4QNYOFB.js";
+import "./chunk-52QYYTM5.js";
+import {
+  output_manager_default
+} from "./chunk-OX7KI3LF.js";
+import "./chunk-GGP5R3FU.js";
+import "./chunk-S7KYDPEM.js";
+import "./chunk-TZ2YI2VH.js";
+
+// src/commands/metrics/validation.ts
+function validateMutualExclusivity(all, project) {
+  return validateAllProjectMutualExclusivity(all, project);
+}
+function validateRequiredMetric(metric) {
+  if (metric) {
+    return { valid: true, value: metric };
+  }
+  return {
+    valid: false,
+    code: "MISSING_METRIC",
+    message: "Missing required metric. Specify the metric to query.\n\nRun 'vercel metrics schema' to see available metrics."
+  };
+}
+function validateOrderDirection(orderDirection) {
+  if (orderDirection === void 0) {
+    return { valid: true, value: void 0 };
+  }
+  if (orderDirection === "asc" || orderDirection === "desc") {
+    return { valid: true, value: orderDirection };
+  }
+  return {
+    valid: false,
+    code: "INVALID_ORDER",
+    message: `Invalid order "${orderDirection}". Use "asc" or "desc".`,
+    allowedValues: ["asc", "desc"]
+  };
+}
+function validateOrderBy(orderBy) {
+  if (orderBy === void 0) {
+    return { valid: true, value: void 0 };
+  }
+  if (orderBy === "value" || orderBy === "count") {
+    return { valid: true, value: orderBy };
+  }
+  return {
+    valid: false,
+    code: "INVALID_ORDER_BY",
+    message: `Invalid order-by "${orderBy}". Use "value" or "count".`,
+    allowedValues: ["value", "count"]
+  };
+}
+
+// src/commands/metrics/query.ts
+function handleValidationError(result, jsonOutput, client) {
+  if (jsonOutput) {
+    client.stdout.write(
+      formatErrorJson(result.code, result.message, result.allowedValues)
+    );
+  } else {
+    output_manager_default.error(result.message);
+    if (result.allowedValues && result.allowedValues.length > 0) {
+      output_manager_default.print(`
+Available values: ${result.allowedValues.join(", ")}
+`);
+    }
+  }
+  return 1;
+}
+var PRODUCTION_ENVIRONMENT_FILTER = "environment eq 'production'";
+function combineFilters(filters, prod) {
+  const nonEmptyFilters = [
+    ...filters?.filter((filter) => filter.length > 0) ?? [],
+    ...prod ? [PRODUCTION_ENVIRONMENT_FILTER] : []
+  ];
+  if (nonEmptyFilters.length === 0) {
+    return void 0;
+  }
+  if (nonEmptyFilters.length === 1) {
+    return nonEmptyFilters[0];
+  }
+  return nonEmptyFilters.map((filter) => `(${filter})`).join(" and ");
+}
+function getRequestOrderBy(metric, aggregation, orderBy) {
+  return orderBy === "value" ? getRollupColumnName(metric, aggregation) : void 0;
+}
+async function resolveQueryScope(client, opts) {
+  if (opts.project || opts.all) {
+    const { team } = await getScope(client);
+    if (!team) {
+      const errMsg = "No team context found. Run `vercel switch` to select a team, or use `vercel link` in a project directory.";
+      if (opts.jsonOutput) {
+        client.stdout.write(formatErrorJson("NO_TEAM", errMsg));
+      } else {
+        output_manager_default.error(errMsg);
+      }
+      return 1;
+    }
+    if (opts.all) {
+      return {
+        scope: { type: "owner", ownerId: team.id },
+        accountId: team.id,
+        teamName: team.slug
+      };
+    }
+    const project = await getProjectByNameOrId(client, opts.project, team.id);
+    if (project instanceof ProjectNotFound) {
+      const errMsg = `Project "${opts.project}" was not found in team "${team.slug}".`;
+      if (opts.jsonOutput) {
+        client.stdout.write(formatErrorJson("PROJECT_NOT_FOUND", errMsg));
+      } else {
+        output_manager_default.error(errMsg);
+      }
+      return 1;
+    }
+    return {
+      scope: {
+        type: "project",
+        ownerId: team.id,
+        projectIds: [project.id]
+      },
+      accountId: team.id,
+      teamName: team.slug,
+      projectName: project.name
+    };
+  }
+  const linkedProject = await getLinkedProject(client);
+  if (linkedProject.status === "error") {
+    return linkedProject.exitCode;
+  }
+  if (linkedProject.status === "not_linked") {
+    const errMsg = "No linked project found. Run `vercel link` to link a project, or use --project <name-or-id> or --all.";
+    if (opts.jsonOutput) {
+      client.stdout.write(formatErrorJson("NOT_LINKED", errMsg));
+    } else {
+      output_manager_default.error(errMsg);
+    }
+    return 1;
+  }
+  return {
+    scope: {
+      type: "project",
+      ownerId: linkedProject.org.id,
+      projectIds: [linkedProject.project.id]
+    },
+    accountId: linkedProject.org.id,
+    teamName: linkedProject.org.slug,
+    projectName: linkedProject.project.name
+  };
+}
+async function query(client, telemetry) {
+  let parsedArgs;
+  const flagsSpecification = getFlagsSpecification(metricsCommand.options);
+  try {
+    parsedArgs = parseArguments(client.argv.slice(2), flagsSpecification);
+  } catch (err) {
+    printError(err);
+    return 1;
+  }
+  const flags = parsedArgs.flags;
+  const positionalArgs = parsedArgs.args.slice(1);
+  const positionalMetric = positionalArgs[0] === "query" ? positionalArgs[1] : positionalArgs[0];
+  const formatResult = validateJsonOutput(flags);
+  if (!formatResult.valid) {
+    output_manager_default.error(formatResult.error);
+    return 1;
+  }
+  const jsonOutput = formatResult.jsonOutput;
+  const metricFlag = positionalMetric;
+  const aggregationFlag = flags["--aggregation"];
+  const groupBy = flags["--group-by"] ?? [];
+  const limit = flags["--limit"];
+  const orderByInput = typeof flags["--order-by"] === "string" ? flags["--order-by"].trim().toLowerCase() : void 0;
+  const orderInput = typeof flags["--order"] === "string" ? flags["--order"].trim().toLowerCase() : void 0;
+  const filters = flags["--filter"];
+  const prod = flags["--prod"];
+  const filter = combineFilters(filters, prod);
+  const since = flags["--since"];
+  const until = flags["--until"];
+  const granularity = flags["--granularity"];
+  const bucketTimezone = flags["--bucket-timezone"]?.trim();
+  const project = flags["--project"];
+  const all = flags["--all"];
+  telemetry.trackCliArgumentMetricId(metricFlag);
+  telemetry.trackCliOptionAggregation(aggregationFlag);
+  telemetry.trackCliOptionGroupBy(groupBy.length > 0 ? groupBy : void 0);
+  telemetry.trackCliOptionLimit(limit);
+  telemetry.trackCliOptionOrderBy(orderByInput);
+  telemetry.trackCliOptionOrder(orderInput);
+  telemetry.trackCliOptionFilter(filters);
+  telemetry.trackCliFlagProd(prod);
+  telemetry.trackCliOptionSince(since);
+  telemetry.trackCliOptionUntil(until);
+  telemetry.trackCliOptionGranularity(granularity);
+  telemetry.trackCliOptionBucketTimezone(bucketTimezone);
+  telemetry.trackCliOptionProject(project);
+  telemetry.trackCliFlagAll(all);
+  telemetry.trackCliOptionFormat(flags["--format"]);
+  const orderByResult = validateOrderBy(orderByInput);
+  if (!orderByResult.valid) {
+    return handleValidationError(orderByResult, jsonOutput, client);
+  }
+  const orderByMode = orderByResult.value;
+  const requiredMetric = validateRequiredMetric(metricFlag);
+  if (!requiredMetric.valid) {
+    return handleValidationError(requiredMetric, jsonOutput, client);
+  }
+  const metric = requiredMetric.value;
+  const mutualResult = validateMutualExclusivity(all, project);
+  if (!mutualResult.valid) {
+    return handleValidationError(mutualResult, jsonOutput, client);
+  }
+  const orderDirectionResult = validateOrderDirection(orderInput);
+  if (!orderDirectionResult.valid) {
+    return handleValidationError(orderDirectionResult, jsonOutput, client);
+  }
+  const orderDirection = orderDirectionResult.value;
+  const scopeResult = await resolveQueryScope(client, {
+    project,
+    all,
+    jsonOutput
+  });
+  if (typeof scopeResult === "number") {
+    return scopeResult;
+  }
+  const { scope, accountId, teamName, projectName } = scopeResult;
+  const detailOrExitCode = await fetchMetricDetailOrExit(
+    client,
+    accountId,
+    metric,
+    jsonOutput
+  );
+  if (typeof detailOrExitCode === "number") {
+    return detailOrExitCode;
+  }
+  const aggregationInput = aggregationFlag ?? getDefaultAggregation(detailOrExitCode, metric) ?? "sum";
+  const aggregation = aggregationInput;
+  const orderBy = getRequestOrderBy(metric, aggregation, orderByMode);
+  let startTime;
+  let endTime;
+  try {
+    ({ startTime, endTime } = resolveTimeRange(since, until));
+  } catch (err) {
+    const errMsg = err instanceof Error ? err.message : String(err);
+    if (jsonOutput) {
+      client.stdout.write(formatErrorJson("INVALID_TIME", errMsg));
+    } else {
+      output_manager_default.error(errMsg);
+    }
+    return 1;
+  }
+  const rangeMs = endTime.getTime() - startTime.getTime();
+  const granResult = computeGranularity(rangeMs, granularity);
+  if (!jsonOutput && granResult.adjusted && granResult.notice) {
+    output_manager_default.log(`Notice: ${granResult.notice}`);
+  }
+  const body = {
+    scope,
+    metric,
+    aggregation,
+    startTime: startTime.toISOString(),
+    endTime: endTime.toISOString(),
+    granularity: granResult.duration,
+    ...bucketTimezone ? { bucketTimezone } : {},
+    ...groupBy.length > 0 ? { groupBy } : {},
+    ...filter ? { filter } : {},
+    limit: limit ?? 10,
+    ...orderBy ? { orderBy } : {},
+    ...orderDirection ? { orderDirection } : {}
+  };
+  if (!jsonOutput) {
+    output_manager_default.spinner("Querying metrics...");
+  }
+  let response;
+  try {
+    response = await client.fetch(
+      "/v2/observability/query",
+      {
+        method: "POST",
+        body: JSON.stringify(body),
+        headers: { "Content-Type": "application/json" },
+        accountId,
+        bailOn429: true
+      }
+    );
+  } catch (err) {
+    if (isAPIError(err)) {
+      return handleApiError(err, jsonOutput, client);
+    }
+    const errMsg = err instanceof Error ? err.message : String(err);
+    if (jsonOutput) {
+      client.stdout.write(formatErrorJson("NETWORK_ERROR", errMsg));
+    } else {
+      output_manager_default.error(errMsg);
+    }
+    return 1;
+  } finally {
+    if (!jsonOutput) {
+      output_manager_default.stopSpinner();
+    }
+  }
+  if (jsonOutput) {
+    client.stdout.write(
+      formatQueryJson(
+        {
+          metric,
+          aggregation,
+          groupBy,
+          filter,
+          startTime: startTime.toISOString(),
+          endTime: endTime.toISOString(),
+          granularity: granResult.duration,
+          ...bucketTimezone ? { bucketTimezone } : {},
+          ...orderByMode ? { orderBy: orderByMode } : {},
+          ...orderDirection ? { orderDirection } : {}
+        },
+        response
+      )
+    );
+  } else {
+    client.stdout.write(
+      formatText(response, {
+        metric,
+        metricUnit: detailOrExitCode.find((item) => item.id === metric)?.unit ?? "count",
+        aggregation,
+        groupBy,
+        filter,
+        scope,
+        projectName,
+        teamName,
+        periodStart: startTime.toISOString(),
+        periodEnd: endTime.toISOString(),
+        granularity: granResult.duration,
+        bucketTimezone,
+        orderBy: orderByMode,
+        orderDirection
+      })
+    );
+  }
+  return 0;
+}
+export {
+  query as default
+};

package/dist/chunks/{reorder-J6OONT76.js → reorder-GBCOPZT4.js}

@@ -16,7 +16,7 @@ import {
   resolveRoute,
   shellQuoteRouteIdentifierForSuggestion,
   withGlobalFlags
-} from "./chunk-5POUHPEH.js";
+} from "./chunk-GKVAAY2A.js";
 import {
   reorderSubcommand
 } from "./chunk-VZSZBD4V.js";
@@ -24,7 +24,7 @@ import {
   stamp_default
 } from "./chunk-64IF634X.js";
 import "./chunk-VXYGCOKL.js";
-import "./chunk-HZAINEXG.js";
+import "./chunk-GLAHGVBS.js";
 import {
   outputAgentError
 } from "./chunk-UDWRZXIT.js";

package/dist/chunks/{restore-3ME4ZHFW.js → restore-YK5DGGRX.js}

@@ -19,7 +19,7 @@ import {
   requireProjectContext,
   validateRequiredArguments,
   withGlobalFlags
-} from "./chunk-5POUHPEH.js";
+} from "./chunk-GKVAAY2A.js";
 import {
   restoreSubcommand
 } from "./chunk-VZSZBD4V.js";
@@ -27,7 +27,7 @@ import {
   stamp_default
 } from "./chunk-64IF634X.js";
 import "./chunk-VXYGCOKL.js";
-import "./chunk-HZAINEXG.js";
+import "./chunk-GLAHGVBS.js";
 import {
   outputAgentError
 } from "./chunk-UDWRZXIT.js";

package/dist/chunks/{rm-XOUHC6CU.js → rm-FRZMXB2W.js}

@@ -9,8 +9,8 @@ import {
   handleRulesApiError,
   parseRulesFlagsAndScope,
   rulesItemPath
-} from "./chunk-AVJRWFTM.js";
-import "./chunk-OK6EYKRX.js";
+} from "./chunk-A4XB42AB.js";
+import "./chunk-XFGY3JAX.js";
 import "./chunk-BUZRVER7.js";
 import {
   validateJsonOutput
@@ -18,7 +18,7 @@ import {
 import {
   rulesRmSubcommand
 } from "./chunk-STJJ3DFO.js";
-import "./chunk-HZAINEXG.js";
+import "./chunk-GLAHGVBS.js";
 import {
   AGENT_REASON,
   buildCommandWithGlobalFlags,

package/dist/chunks/{rm-63AGQFIQ.js → rm-LK6P7XTA.js}

@@ -13,7 +13,7 @@ import {
   requireVcrRepository,
   resolveVcrScope,
   validateVcrJsonOutput
-} from "./chunk-GB3QQGZU.js";
+} from "./chunk-NLRIKNPX.js";
 import "./chunk-BUZRVER7.js";
 import "./chunk-XPKWKPWA.js";
 import {
@@ -21,7 +21,7 @@ import {
 } from "./chunk-3VS4DTAU.js";
 import "./chunk-GIL3VAUR.js";
 import "./chunk-FYQPTH5C.js";
-import "./chunk-HZAINEXG.js";
+import "./chunk-GLAHGVBS.js";
 import {
   AGENT_REASON,
   buildCommandWithYes,

package/dist/chunks/{rm-EHEJRXQJ.js → rm-O474MI5C.js}

@@ -13,13 +13,13 @@ import {
   requireVcrRepositoryAndImageId,
   resolveVcrScope,
   validateVcrJsonOutput
-} from "./chunk-GB3QQGZU.js";
+} from "./chunk-NLRIKNPX.js";
 import "./chunk-BUZRVER7.js";
 import "./chunk-XPKWKPWA.js";
 import {
   imageRmSubcommand
 } from "./chunk-FYQPTH5C.js";
-import "./chunk-HZAINEXG.js";
+import "./chunk-GLAHGVBS.js";
 import {
   AGENT_REASON,
   buildCommandWithYes,

package/dist/chunks/{rule-inspect-3PRCEXIB.js → rule-inspect-YEZGYINZ.js}

@@ -9,8 +9,8 @@ import {
   handleRulesApiError,
   parseRulesFlagsAndScope,
   rulesItemPath
-} from "./chunk-AVJRWFTM.js";
-import "./chunk-OK6EYKRX.js";
+} from "./chunk-A4XB42AB.js";
+import "./chunk-XFGY3JAX.js";
 import "./chunk-BUZRVER7.js";
 import {
   validateJsonOutput
@@ -18,7 +18,7 @@ import {
 import {
   rulesInspectSubcommand
 } from "./chunk-STJJ3DFO.js";
-import "./chunk-HZAINEXG.js";
+import "./chunk-GLAHGVBS.js";
 import {
   AGENT_REASON,
   buildCommandWithGlobalFlags,

package/dist/chunks/{rules-UBSIW5ZQ.js → rules-MZ2MP6KJ.js}

@@ -30,7 +30,7 @@ var RULES_CONFIG = {
 };
 async function rules(client, argv) {
   if (argv.length === 0 || argv[0].startsWith("-")) {
-    const lsFn = (await import("./ls-J4HHGSFU.js")).default;
+    const lsFn = (await import("./ls-MB74DIQV.js")).default;
     return lsFn(client, argv);
   }
   const { subcommand, args, subcommandOriginal } = getSubcommand(
@@ -63,15 +63,15 @@ async function rules(client, argv) {
   }
   switch (subcommand) {
     case "ls":
-      return (await import("./ls-J4HHGSFU.js")).default(client, args);
+      return (await import("./ls-MB74DIQV.js")).default(client, args);
     case "add":
-      return (await import("./add-2ITAPI7M.js")).default(client, args);
+      return (await import("./add-L3Z6PL54.js")).default(client, args);
     case "inspect":
-      return (await import("./rule-inspect-3PRCEXIB.js")).default(client, args);
+      return (await import("./rule-inspect-YEZGYINZ.js")).default(client, args);
     case "rm":
-      return (await import("./rm-XOUHC6CU.js")).default(client, args);
+      return (await import("./rm-FRZMXB2W.js")).default(client, args);
     case "update":
-      return (await import("./update-RRMAOQDP.js")).default(client, args);
+      return (await import("./update-W3CWQB2F.js")).default(client, args);
     default:
       output_manager_default.error(`Unhandled rules subcommand: ${String(subcommandOriginal)}`);
       return 1;

package/dist/chunks/{schema-I4SXEWLS.js → schema-FR6CCQIZ.js}

@@ -6,12 +6,12 @@ const __filename = __fileURLToPath(import.meta.url);
 const __dirname = __dirname_(__filename);
 import {
   fetchMetricDetailOrExit,
-  fetchMetricListOrExit,
-  formatErrorJson
-} from "./chunk-4Z5LC2CI.js";
+  fetchMetricListOrExit
+} from "./chunk-6RTK6BWX.js";
 import {
+  formatErrorJson,
   indent_default
-} from "./chunk-A3NYPUKZ.js";
+} from "./chunk-Z7NPYIZ6.js";
 import {
   formatTable
 } from "./chunk-ZVLPUREX.js";
@@ -25,7 +25,7 @@ import "./chunk-NZRWTCRM.js";
 import {
   getScope,
   require_pluralize
-} from "./chunk-HZAINEXG.js";
+} from "./chunk-GLAHGVBS.js";
 import "./chunk-UDWRZXIT.js";
 import "./chunk-ECCWJHC6.js";
 import {

package/dist/chunks/{tags-HF2YOQ4V.js → tags-AKRTKFRV.js}

@@ -52,9 +52,9 @@ async function tags(client, argv, telemetry) {
   }
   switch (subcommand) {
     case "ls":
-      return (await import("./ls-PQPRURTJ.js")).default(client, args, telemetry);
+      return (await import("./ls-YDUYTLXW.js")).default(client, args, telemetry);
     case "inspect":
-      return (await import("./inspect-652QJ33O.js")).default(client, args, telemetry);
+      return (await import("./inspect-4JD2QN67.js")).default(client, args, telemetry);
     default:
       output_manager_default.error(`Unhandled tags subcommand: ${subcommand}`);
       return 1;

package/dist/chunks/{update-RRMAOQDP.js → update-W3CWQB2F.js}

@@ -9,8 +9,8 @@ import {
   handleRulesApiError,
   parseRulesFlagsAndScope,
   rulesItemPath
-} from "./chunk-AVJRWFTM.js";
-import "./chunk-OK6EYKRX.js";
+} from "./chunk-A4XB42AB.js";
+import "./chunk-XFGY3JAX.js";
 import "./chunk-BUZRVER7.js";
 import {
   validateJsonOutput
@@ -18,7 +18,7 @@ import {
 import {
   rulesUpdateSubcommand
 } from "./chunk-STJJ3DFO.js";
-import "./chunk-HZAINEXG.js";
+import "./chunk-GLAHGVBS.js";
 import {
   AGENT_REASON,
   buildCommandWithGlobalFlags,