@sanity/cli 5.5.0-next.9 → 5.5.0

package/lib/_chunks-cjs/cli.js

@@ -18,7 +18,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: !0 }) : target,
   mod
 ));
-var os = require("node:os"), chalk = require("chalk"), loadEnv = require("./loadEnv.js"), require$$0$5 = require("path"), require$$1$2 = require("module"), require$$0$4 = require("fs"), semver = require("semver"), telemetry = require("@sanity/telemetry"), childProcess = require("node:child_process"), fs$1 = require("node:fs"), path$3 = require("node:path"), fs = require("node:fs/promises"), util$3 = require("node:util"), require$$0$6 = require("os"), getLatestVersion = require("get-latest-version"), pkgDir = require("pkg-dir"), client$1 = require("@sanity/client"), require$$0$7 = require("constants"), require$$0$8 = require("stream"), require$$0$9 = require("util"), require$$0$a = require("assert"), require$$0$b = require("events"), require$$3$1 = require("crypto"), require$$1$3 = require("child_process"), getCliConfig = require("./getCliConfig.js"), require$$0$c = require("fs/promises"), require$$0$d = require("buffer"), journeyConfig = require("./journeyConfig.js"), Stream = require("node:stream"), promises$1 = require("node:stream/promises"), templateValidator = require("@sanity/template-validator"), require$$2$1 = require("string_decoder"), require$$0$e = require("zlib"), require$$7$1 = require("process"), http = require("node:http"), jsoncParser = require("jsonc-parser"), traverse = require("@babel/traverse"), node_url = require("node:url"), node_events = require("node:events"), node_string_decoder = require("node:string_decoder"), process$2 = require("node:process"), require$$2$2 = require("readline"), require$$0$f = require("tty");
+var os = require("node:os"), chalk = require("chalk"), loadEnv = require("./loadEnv.js"), require$$0$5 = require("path"), require$$1$2 = require("module"), require$$0$4 = require("fs"), semver = require("semver"), telemetry = require("@sanity/telemetry"), runtimeCli = require("@sanity/runtime-cli"), utils$3 = require("@sanity/runtime-cli/utils"), childProcess = require("node:child_process"), fs$1 = require("node:fs"), path$3 = require("node:path"), fs = require("node:fs/promises"), util$3 = require("node:util"), require$$0$6 = require("os"), getLatestVersion = require("get-latest-version"), pkgDir = require("pkg-dir"), client$1 = require("@sanity/client"), require$$0$7 = require("constants"), require$$0$8 = require("stream"), require$$0$9 = require("util"), require$$0$a = require("assert"), require$$0$b = require("events"), require$$3$1 = require("crypto"), require$$1$3 = require("child_process"), getCliConfig = require("./getCliConfig.js"), require$$0$c = require("fs/promises"), require$$0$d = require("buffer"), journeyConfig = require("./journeyConfig.js"), Stream = require("node:stream"), promises$1 = require("node:stream/promises"), templateValidator = require("@sanity/template-validator"), require$$2$1 = require("string_decoder"), require$$0$e = require("zlib"), require$$7$1 = require("process"), http = require("node:http"), jsoncParser = require("jsonc-parser"), traverse = require("@babel/traverse"), node_url = require("node:url"), node_events = require("node:events"), node_string_decoder = require("node:string_decoder"), process$2 = require("node:process"), require$$2$2 = require("readline"), require$$0$f = require("tty");
 function _interopDefaultCompat(e) {
   return e && typeof e == "object" && "default" in e ? e : { default: e };
 }
@@ -1575,55 +1575,64 @@ var sortBy = baseRest(function(collection, iteratees) {
   var length = iteratees.length;
   return length > 1 && isIterateeCall(collection, iteratees[0], iteratees[1]) ? iteratees = [] : length > 2 && isIterateeCall(iteratees[0], iteratees[1], iteratees[2]) && (iteratees = [iteratees[0]]), baseOrderBy(collection, baseFlatten(iteratees), []);
 });
+const ANSI_REGEX = /\x1b\[[0-9;]*m/g, OCLIF_HEADERS = [
+  "ARGUMENTS",
+  "FLAGS",
+  "GLOBAL FLAGS",
+  "FLAG DESCRIPTIONS",
+  "DESCRIPTION",
+  "EXAMPLES",
+  "ALIASES",
+  "COMMANDS",
+  "TOPICS",
+  "CONFIGURATION VARIABLES"
+];
+function stripAnsi$4(str2) {
+  return str2.replace(ANSI_REGEX, "");
+}
+function transformHelpLine(line3) {
+  const cleanLine = stripAnsi$4(line3);
+  return OCLIF_HEADERS.includes(cleanLine) ? `${cleanLine.toLowerCase()}:` : cleanLine;
+}
+function transformHelpText(command2, bin, commandId) {
+  const lines2 = command2.getHelpText(bin, commandId).split(`
+`), usagePrefix = `  $ ${bin} ${commandId} `;
+  let usageStartIndex = -1, usageEndIndex = -1;
+  const signatureParts = [];
+  for (let i = 0; i < lines2.length; i++) {
+    const cleanLine = stripAnsi$4(lines2[i]);
+    if (cleanLine === "USAGE") {
+      usageStartIndex = i;
+      continue;
+    }
+    usageStartIndex !== -1 && usageEndIndex === -1 && (cleanLine.startsWith(usagePrefix) ? signatureParts.push(cleanLine.slice(usagePrefix.length).trim()) : signatureParts.length > 0 && cleanLine.startsWith("    ") ? signatureParts.push(cleanLine.trim()) : (cleanLine === "" || /^[A-Z]+$/.test(cleanLine)) && (usageEndIndex = i));
+  }
+  const signature = signatureParts.join(" "), helpTextLines = [];
+  for (let i = 0; i < lines2.length; i++)
+    usageStartIndex !== -1 && i >= usageStartIndex && i < usageEndIndex || i === usageEndIndex && stripAnsi$4(lines2[i]) === "" || helpTextLines.push(transformHelpLine(lines2[i]));
+  return {
+    helpText: helpTextLines.join(`
+`),
+    signature,
+    description: command2.summary
+  };
+}
+function createErrorLogger(output) {
+  return (message, options2 = {}) => {
+    output.error(message), options2.exit && process.exit(options2.code ?? 1);
+  };
+}
 const BlueprintsAddExampleUsed = telemetry.defineEvent({
   version: 1,
   name: "Blueprints Add Example Used",
   description: "User used --example flag with blueprints add command"
-}), helpText$t = `
-Arguments
-  <type>  Type of Resource to add (currently only 'function' is supported)
-
-Options
-  --name, -n <name>              Name of the Resource
-  --fn-type <type>               Type of Function to add. Available options: "document-create", "document-delete", "document-update", "document-publish". Default: "document-publish"
-  --fn-language, --lang <ts|js>  Language of the Function. Default: "ts"
-  --js, --javascript             Shortcut for --fn-language=js
-  --fn-helpers, --helpers        Add helpers to the Function
-  --no-fn-helpers                Do not add helpers to the Function
-  --fn-installer,                Package manager to use for Function helpers
-    --installer <npm|pnpm|yarn>    sets --fn-helpers to true
-  --install, -i                  Shortcut for --fn-installer=npm
-
-Examples:
-  # Add a Function (TypeScript by default)
-  sanity blueprints add function
-
-  # Add a Function with a specific name and install helpers with npm
-  sanity blueprints add function --name my-function -i --helpers
-
-  # Add a Function with a specific type
-  sanity blueprints add function --fn-type document-create
-
-  # Add a Function using an example
-  sanity blueprints add function --example example-name
-
-  # Add a JavaScript Function
-  sanity blueprints add function --js
-
-  # Add a Function without helpers
-  sanity blueprints add function --no-fn-helpers
-
-  # Add a document-publish .js Function with helpers and install with npm
-  sanity blueprints add function -n roboto --fn-type document-publish --js -i
-`, defaultFlags$e = {
+}), defaultFlags$e = {
   "fn-language": "ts"
   // 'fn-helpers': true, // ask, for now
 }, addBlueprintsCommand = {
   name: "add",
   group: "blueprints",
-  helpText: helpText$t,
-  signature: "<type> [--name <name>] [--fn-type <document-create|document-delete|document-update|document-publish>] [--fn-lang <ts|js>] [--javascript]",
-  description: "Add a Resource to a Blueprint",
+  ...transformHelpText(runtimeCli.BlueprintsAddCommand, "sanity", "blueprints add"),
   async action(args, context) {
     const { output, apiClient, telemetry: telemetry2 } = context, { extOptions } = args, [resourceType] = args.argsWithoutOptions;
     if (extOptions.example) {
@@ -1632,6 +1641,7 @@ Examples:
         "n",
         "fn-type",
         "fn-language",
+        "language",
         "lang",
         "javascript",
         "js",
@@ -1658,7 +1668,7 @@ Examples:
     }
     const { initBlueprintConfig } = await import("@sanity/runtime-cli/cores"), { functionAddCore } = await import("@sanity/runtime-cli/cores/functions"), cmdConfig = await initBlueprintConfig({
       bin: "sanity",
-      log: (message) => output.print(message),
+      log: utils$3.logger.Logger(output.print),
       token: token2
     });
     if (!cmdConfig.ok) throw new Error(cmdConfig.error);
@@ -1670,7 +1680,7 @@ Examples:
         example: flags.example,
         name: flags.n ?? flags.name,
         type: flags["fn-type"],
-        language: flags.lang ?? flags["fn-language"],
+        language: flags.lang ?? flags.language ?? flags["fn-language"],
         javascript: flags.js || flags.javascript,
         helpers: userWantsFnHelpers,
         installer: flags.installer ?? flags["fn-installer"],
@@ -1684,27 +1694,12 @@ Examples:
   signature: "[COMMAND]",
   isGroupRoot: !0,
   description: "Deploy and manage Sanity Blueprints and Stacks (IaC)"
-}, helpText$s = `
-Options
-  --edit, -e           Modify the configuration interactively, or directly when combined with ID flags.
-  --project-id <id>    Directly set the Project ID in the configuration. Requires --edit flag
-  --stack-id <id>      Directly set the Stack ID in the configuration. Requires --edit flag
-  --verbose            Output verbose logs
-
-Examples:
-  # View current configuration
-  sanity blueprints config
-
-  # Edit configuration
-  sanity blueprints config --edit
-`, defaultFlags$d = {
+}, defaultFlags$d = {
   //
 }, configBlueprintsCommand = {
   name: "config",
   group: "blueprints",
-  helpText: helpText$s,
-  signature: "[--edit] [--project-id <id>] [--stack-id <id>] [--verbose]",
-  description: "View or edit local Blueprints configuration",
+  ...transformHelpText(runtimeCli.BlueprintsConfigCommand, "sanity", "blueprints config"),
   async action(args, context) {
     const { apiClient, output } = context, flags = { ...defaultFlags$d, ...args.extOptions }, client2 = apiClient({
       requireUser: !0,
@@ -1713,7 +1708,7 @@ Examples:
     if (!token2) throw new Error("No API token found. Please run `sanity login`.");
     const { initBlueprintConfig } = await import("@sanity/runtime-cli/cores"), { blueprintConfigCore } = await import("@sanity/runtime-cli/cores/blueprints"), cmdConfig = await initBlueprintConfig({
       bin: "sanity",
-      log: (message) => output.print(message),
+      log: utils$3.logger.Logger(output.print, { verbose: flags.verbose }),
       token: token2
     });
     if (!cmdConfig.ok) throw new Error(cmdConfig.error);
@@ -1729,24 +1724,12 @@ Examples:
     });
     if (!success) throw new Error(error2);
   }
-}, helpText$r = `
-Options
-  --no-wait    Do not wait for Stack deployment to complete
-
-Examples:
-  # Deploy the current blueprint
-  sanity blueprints deploy
-
-  # Deploy the current blueprint without waiting for completion
-  sanity blueprints deploy --no-wait
-`, defaultFlags$c = {
+}, defaultFlags$c = {
   //
 }, deployBlueprintsCommand = {
   name: "deploy",
   group: "blueprints",
-  helpText: helpText$r,
-  signature: "[--no-wait]",
-  description: "Deploy a Blueprint",
+  ...transformHelpText(runtimeCli.BlueprintsDeployCommand, "sanity", "blueprints deploy"),
   async action(args, context) {
     const { apiClient, output } = context, flags = { ...defaultFlags$c, ...args.extOptions }, client2 = apiClient({
       requireUser: !0,
@@ -1755,7 +1738,7 @@ Examples:
     if (!token2) throw new Error("No API token found. Please run `sanity login`.");
     const { initDeployedBlueprintConfig } = await import("@sanity/runtime-cli/cores"), { blueprintDeployCore } = await import("@sanity/runtime-cli/cores/blueprints"), cmdConfig = await initDeployedBlueprintConfig({
       bin: "sanity",
-      log: (message) => output.print(message),
+      log: utils$3.logger.Logger(output.print),
       token: token2
     });
     if (!cmdConfig.ok) throw new Error(cmdConfig.error);
@@ -1767,30 +1750,12 @@ Examples:
     });
     if (!success) throw new Error(error2);
   }
-}, helpText$q = `
-Options
-  --project-id   Project associated with the Stack
-  --stack-id     Stack ID to destroy (defaults to current Stack)
-  --force, -f    Force destroy without confirmation
-  --no-wait      Do not wait for destroy to complete
-
-Examples:
-  # Destroy the current deployment
-  sanity blueprints destroy
-
-  # Force destroy without confirmation
-  sanity blueprints destroy --force
-
-  # Destroy without waiting for completion
-  sanity blueprints destroy --no-wait
-`, defaultFlags$b = {
+}, defaultFlags$b = {
   //
 }, destroyBlueprintsCommand = {
   name: "destroy",
   group: "blueprints",
-  helpText: helpText$q,
-  signature: "[--project-id <value> --stack-id <value> --force] [--no-wait]",
-  description: "Destroy a Blueprint Stack deployment and its resources (will not delete local files)",
+  ...transformHelpText(runtimeCli.BlueprintsDestroyCommand, "sanity", "blueprints destroy"),
   async action(args, context) {
     const { apiClient, output } = context, flags = { ...defaultFlags$b, ...args.extOptions }, client2 = apiClient({
       requireUser: !0,
@@ -1799,7 +1764,7 @@ Examples:
     if (!token2) throw new Error("No API token found. Please run `sanity login`.");
     const { initBlueprintConfig } = await import("@sanity/runtime-cli/cores"), { blueprintDestroyCore } = await import("@sanity/runtime-cli/cores/blueprints"), cmdConfig = await initBlueprintConfig({
       bin: "sanity",
-      log: (message) => output.print(message),
+      log: utils$3.logger.Logger(output.print),
       token: token2
     });
     if (!cmdConfig.ok) throw new Error(cmdConfig.error);
@@ -1814,27 +1779,14 @@ Examples:
     });
     if (!success) throw new Error(error2);
   }
-}, helpText$p = `
-Options
-  --verbose  Provide detailed information about issues
-  --fix      Interactively update the Blueprint configuration to fix issues
-
-Examples:
-  # Check the health of the current Blueprint project
-  sanity blueprints doctor --verbose
-
-  # Fix issues in the current Blueprint project
-  sanity blueprints doctor --fix
-`, defaultFlags$a = {
-  // path: undefined,
+}, defaultFlags$a = {
   fix: !1,
+  json: !1,
   verbose: !1
 }, doctorBlueprintsCommand = {
   name: "doctor",
   group: "blueprints",
-  helpText: helpText$p,
-  signature: "[--verbose] [--fix]",
-  description: "Diagnose potential issues with Blueprint configuration",
+  ...transformHelpText(runtimeCli.BlueprintsDoctorCommand, "sanity", "blueprints doctor"),
   async action(args, context) {
     const { apiClient, output } = context, flags = { ...defaultFlags$a, ...args.extOptions }, client2 = apiClient({
       requireUser: !0,
@@ -1843,24 +1795,18 @@ Examples:
     if (!token2) throw new Error("No API token found. Please run `sanity login`.");
     const { blueprintDoctorCore } = await import("@sanity/runtime-cli/cores/blueprints"), { success, error: error2 } = await blueprintDoctorCore({
       bin: "sanity",
-      log: (message) => output.print(message),
+      log: utils$3.logger.Logger(output.print, { verbose: flags.verbose }),
       token: token2,
       flags
     });
     if (!success) throw new Error(error2);
   }
-}, helpText$o = `
-Examples:
-  # Retrieve information about the current Stack
-  sanity blueprints info
-`, defaultFlags$9 = {
+}, defaultFlags$9 = {
   //
 }, infoBlueprintsCommand = {
   name: "info",
   group: "blueprints",
-  helpText: helpText$o,
-  signature: "",
-  description: "Show information about a Blueprint Stack deployment",
+  ...transformHelpText(runtimeCli.BlueprintsInfoCommand, "sanity", "blueprints info"),
   async action(args, context) {
     const { apiClient, output } = context, flags = { ...defaultFlags$9, ...args.extOptions }, client2 = apiClient({
       requireUser: !0,
@@ -1869,7 +1815,7 @@ Examples:
     if (!token2) throw new Error("No API token found. Please run `sanity login`.");
     const { initDeployedBlueprintConfig } = await import("@sanity/runtime-cli/cores"), { blueprintInfoCore } = await import("@sanity/runtime-cli/cores/blueprints"), cmdConfig = await initDeployedBlueprintConfig({
       bin: "sanity",
-      log: (message) => output.print(message),
+      log: utils$3.logger.Logger(output.print),
       token: token2
     });
     if (!cmdConfig.ok) throw new Error(cmdConfig.error);
@@ -1879,34 +1825,12 @@ Examples:
     });
     if (!success) throw new Error(error2);
   }
-}, helpText$n = `
-Arguments
-  [dir]  Path to initialize the Blueprint in
-
-Options
-  --blueprint-type, --type <json>    Blueprint manifest type to use for the Blueprint (json|js|ts)
-  --project-id <id>                  Sanity Project ID to use for the Blueprint
-  --stack-id <id>                    Existing Stack ID to use for the Blueprint
-  --stack-name <id>                  Name to use for a NEW Stack
-  --verbose                          Verbose output
-
-Examples:
-  # Create a new Blueprint project in the current directory
-  sanity blueprints init
-
-  # Create a new Blueprint project in a specific directory
-  sanity blueprints init my-sanity-project --type json
-
-  # Create a new Blueprint project in a specific directory with an example
-  sanity blueprints init --example example-name
-`, defaultFlags$8 = {
+}, defaultFlags$8 = {
   //
 }, initBlueprintsCommand = {
   name: "init",
   group: "blueprints",
-  helpText: helpText$n,
-  signature: "[dir] [--blueprint-type <type>] [--project-id <id>]",
-  description: "Initialize a new Blueprint",
+  ...transformHelpText(runtimeCli.BlueprintsInitCommand, "sanity", "blueprints init"),
   async action(args, context) {
     const { apiClient, output } = context, flags = { ...defaultFlags$8, ...args.extOptions }, [dir] = args.argsWithoutOptions, client2 = apiClient({
       requireUser: !0,
@@ -1929,7 +1853,7 @@ Examples:
     }
     const { success, error: error2 } = await blueprintInitCore({
       bin: "sanity",
-      log: (message) => output.print(message),
+      log: utils$3.logger.Logger(output.print, { verbose: flags.verbose }),
       token: token2,
       args: {
         dir: dir ?? flags.dir
@@ -1945,24 +1869,12 @@ Examples:
     });
     if (!success) throw new Error(error2);
   }
-}, helpText$m = `
-Options
-  --watch, -w    Watch for new Stack logs (streaming mode)
-
-Examples:
-  # Show logs for the current Stack
-  sanity blueprints logs
-
-  # Watch for new logs (streaming mode)
-  sanity blueprints logs --watch
-`, defaultFlags$7 = {
+}, defaultFlags$7 = {
   //
 }, logsBlueprintsCommand = {
   name: "logs",
   group: "blueprints",
-  helpText: helpText$m,
-  signature: "[--watch] [-w]",
-  description: "Display logs for a Blueprint Stack deployment",
+  ...transformHelpText(runtimeCli.BlueprintsLogsCommand, "sanity", "blueprints logs"),
   async action(args, context) {
     const { apiClient, output } = context, flags = { ...defaultFlags$7, ...args.extOptions }, client2 = apiClient({
       requireUser: !0,
@@ -1971,7 +1883,7 @@ Examples:
     if (!token2) throw new Error("No API token found. Please run `sanity login`.");
     const { initDeployedBlueprintConfig } = await import("@sanity/runtime-cli/cores"), { blueprintLogsCore } = await import("@sanity/runtime-cli/cores/blueprints"), cmdConfig = await initDeployedBlueprintConfig({
       bin: "sanity",
-      log: (message) => output.print(message),
+      log: utils$3.logger.Logger(output.print),
       token: token2
     });
     if (!cmdConfig.ok) throw new Error(cmdConfig.error);
@@ -1983,23 +1895,12 @@ Examples:
     });
     if (streaming && await streaming, !success) throw new Error(error2);
   }
-}, helpText$l = `
-Safe to run at any time. Will not modify any Resources.
-
-Options
-  --version Verbose output
-
-Examples:
-  # Show deployment plan for the current Blueprint
-  sanity blueprints plan
-`, defaultFlags$6 = {
+}, defaultFlags$6 = {
   //
 }, planBlueprintsCommand = {
   name: "plan",
   group: "blueprints",
-  helpText: helpText$l,
-  signature: "",
-  description: "Enumerate resources to be deployed - will not modify any resources",
+  ...transformHelpText(runtimeCli.BlueprintsPlanCommand, "sanity", "blueprints plan"),
   async action(args, context) {
     const { apiClient, output } = context, flags = { ...defaultFlags$6, ...args.extOptions }, client2 = apiClient({
       requireUser: !0,
@@ -2008,7 +1909,7 @@ Examples:
     if (!token2) throw new Error("No API token found. Please run `sanity login`.");
     const { initBlueprintConfig } = await import("@sanity/runtime-cli/cores"), { blueprintPlanCore } = await import("@sanity/runtime-cli/cores/blueprints"), cmdConfig = await initBlueprintConfig({
       bin: "sanity",
-      log: (message) => output.print(message),
+      log: utils$3.logger.Logger(output.print, { verbose: flags.verbose }),
       token: token2
     });
     if (!cmdConfig.ok) throw new Error(cmdConfig.error);
@@ -2020,24 +1921,12 @@ Examples:
     });
     if (!success) throw new Error(error2);
   }
-}, helpText$k = `
-Options
-  --project-id <id>       Project ID to use
-
-Examples:
-  # List all Stacks for the current Project
-  sanity blueprints stacks
-
-  # List Stacks for a specific project
-  sanity blueprints stacks --project-id abc123
-`, defaultFlags$5 = {
+}, defaultFlags$5 = {
   //
 }, stacksBlueprintsCommand = {
   name: "stacks",
   group: "blueprints",
-  helpText: helpText$k,
-  signature: "[--project-id <value>]",
-  description: "List all Blueprint Stacks",
+  ...transformHelpText(runtimeCli.BlueprintsStacksCommand, "sanity", "blueprints stacks"),
   hideFromHelp: !1,
   async action(args, context) {
     const { apiClient, output } = context, flags = { ...defaultFlags$5, ...args.extOptions }, client2 = apiClient({
@@ -2047,7 +1936,7 @@ Examples:
     if (!token2) throw new Error("No API token found. Please run `sanity login`.");
     const { initBlueprintConfig } = await import("@sanity/runtime-cli/cores"), { blueprintStacksCore } = await import("@sanity/runtime-cli/cores/blueprints"), cmdConfig = await initBlueprintConfig({
       bin: "sanity",
-      log: (message) => output.print(message),
+      log: utils$3.logger.Logger(output.print, { verbose: flags.verbose }),
       token: token2
     });
     if (!cmdConfig.ok) throw new Error(cmdConfig.error);
@@ -2204,7 +2093,7 @@ function ensureNpx() {
     );
   }
 }
-const helpText$j = `
+const helpText$g = `
 Runs a given code modification script on the current studio folder.
 Running the command without a specified codemod name will list available transformations.
 
@@ -2226,7 +2115,7 @@ Examples
   name: "codemod",
   signature: "[CODEMOD_NAME]",
   description: "Updates Sanity Studio codebase with a code modification script",
-  helpText: helpText$j,
+  helpText: helpText$g,
   action: codemodAction
 };
 var lodash_isplainobject, hasRequiredLodash_isplainobject;
@@ -3919,7 +3808,7 @@ function normalizePath(input2) {
   const sanityDocsPrefix = "https://www.sanity.io";
   return input2.startsWith(sanityDocsPrefix) ? input2.replace(sanityDocsPrefix, "") : input2;
 }
-const helpText$i = `
+const helpText$f = `
 Arguments
   <path> Path or URL to article, found in search results and docs content as links
 
@@ -3937,13 +3826,13 @@ Examples
 `, readCommand = {
   name: "read",
   group: "docs",
-  helpText: helpText$i,
+  helpText: helpText$f,
   signature: "<path|url> [-w, --web]",
   description: "Read an article in terminal",
   async action(args, context) {
     const { output } = context, flags = args.extOptions, input2 = args.argsWithoutOptions[0];
     if (!input2 || typeof input2 != "string") {
-      output.error("Please provide an article path or URL"), output.print(""), output.print(helpText$i), process.exit(1);
+      output.error("Please provide an article path or URL"), output.print(""), output.print(helpText$f), process.exit(1);
       return;
     }
     const path2 = normalizePath(input2);
@@ -3973,7 +3862,7 @@ async function searchDocs(options2, context) {
   const results = await response.json();
   return Array.isArray(results) ? results.slice(0, limit) : [];
 }
-const isInteractive$1 = process.stdout.isTTY && process.env.TERM !== "dumb" && !("CI" in process.env), helpText$h = `
+const isInteractive$1 = process.stdout.isTTY && process.env.TERM !== "dumb" && !("CI" in process.env), helpText$e = `
 Arguments
   <query> Search query for documentation
 
@@ -3994,7 +3883,7 @@ Examples
 }, searchCommand = {
   name: "search",
   group: "docs",
-  helpText: helpText$h,
+  helpText: helpText$e,
   signature: "<query> [--limit <limit>]",
   description: "Search Sanity docs",
   async action(args, context) {
@@ -4048,53 +3937,35 @@ Found ${results.length} result(s):
       }
     }
   }
-}, helpText$g = `
-Options
-  --port <port> Port to start emulator on
-  --open Open dev server in a new browser tab
-
-Examples
-  # Start dev server on default port
-  sanity functions dev
-
-  # Start dev server on specific host
-  sanity functions dev --host 0.0.0.0
-
-  # Start dev server on specific port
-  sanity functions dev --port 3333
-
-  # Start dev server and open a new browser tab
-  sanity functions dev --open
-`, defaultFlags$3 = {
+}, defaultFlags$3 = {
   open: !1,
   host: "localhost",
   port: 8080
 }, devFunctionsCommand = {
   name: "dev",
   group: "functions",
-  helpText: helpText$g,
-  signature: "[--host <host> --port <port> --open]",
-  description: "Start the Sanity Function emulator",
+  ...transformHelpText(runtimeCli.FunctionsDevCommand, "sanity", "functions dev"),
   async action(args, context) {
     const { apiClient, output } = context, flags = { ...defaultFlags$3, ...args.extOptions }, { open: shouldOpen } = flags, client2 = apiClient({ requireUser: !0, requireProject: !1 }), { token: token2 } = client2.config();
     if (!token2) throw new Error("No API token found. Please run `sanity login`.");
     const { initBlueprintConfig } = await import("@sanity/runtime-cli/cores"), { functionDevCore } = await import("@sanity/runtime-cli/cores/functions"), cmdConfig = await initBlueprintConfig({
       bin: "sanity",
-      log: (message) => output.print(message),
+      log: utils$3.logger.Logger(output.print),
       token: token2
     });
     if (!cmdConfig.ok) throw new Error(cmdConfig.error);
-    const { success, error: error2 } = await functionDevCore({
+    const resolvedHost = flags.h ?? flags.host, resolvedPort = flags.p ?? flags.port, { success, error: error2 } = await functionDevCore({
       ...cmdConfig.value,
       flags: {
-        host: flags.host,
-        port: flags.port
+        host: resolvedHost,
+        port: resolvedPort,
+        timeout: flags.t ?? flags.timeout
       }
     });
     if (!success) throw new Error(error2);
-    shouldOpen && await open(`http://${flags.host}:${flags.port}`);
+    shouldOpen && await open(`http://${resolvedHost}:${resolvedPort}`);
   }
-}, helpText$f = `
+}, helpText$d = `
 Commands
   add    Add or update an environment variable
   list   List the environment variables
@@ -4117,7 +3988,7 @@ Examples
 `, envFunctionsCommand = {
   name: "env",
   group: "functions",
-  helpText: helpText$f,
+  helpText: helpText$d,
   signature: "<add|list|remove> <name> [key] [value]",
   description: "Add or remove an environment variable or list environment variables for a Sanity function",
   async action(args, context) {
@@ -4138,7 +4009,7 @@ Examples
     if (!token2) throw new Error("No API token found. Please run `sanity login`.");
     const { initDeployedBlueprintConfig } = await import("@sanity/runtime-cli/cores"), { functionEnvAddCore, functionEnvListCore, functionEnvRemoveCore } = await import("@sanity/runtime-cli/cores/functions"), cmdConfig = await initDeployedBlueprintConfig({
       bin: "sanity",
-      log: (message) => output.print(message),
+      log: utils$3.logger.Logger(output.print),
       token: token2
     });
     if (!cmdConfig.ok) throw new Error(cmdConfig.error);
@@ -4173,46 +4044,17 @@ Examples
   signature: "[COMMAND]",
   isGroupRoot: !0,
   description: "Manage, test, and observe Sanity Functions"
-}, helpText$e = `
-Arguments
-  <name> The name of the Function to retrieve logs for
-
-Options
-  --limit <limit> The number of log entries to retrieve [default 50]
-  --json          If set return json
-  --utc           Use UTC dates in logs
-  --delete        Delete all logs for the Function
-  --force         Force delete all logs for the Function
-  --watch         Watch for new logs (streaming mode)
-
-Examples
-  # Retrieve logs for Sanity Function
-  sanity functions logs echo
-
-  # Retrieve the last two log entries for Sanity Function
-  sanity functions logs echo --limit 2
-
-  # Retrieve logs for Sanity Function in json format
-  sanity functions logs echo --json
-
-  # Delete all logs for Sanity Function
-  sanity functions logs echo --delete
-
-  # Watch for new logs (streaming mode)
-  sanity functions logs echo --watch
-`, defaultFlags$2 = {
+}, defaultFlags$2 = {
   limit: 50,
   json: !1,
   utc: !1,
   delete: !1,
   force: !1,
   watch: !1
-}, logsFunctionsCommand = {
+}, transformedHelp$1 = transformHelpText(runtimeCli.FunctionsLogsCommand, "sanity", "functions logs"), logsFunctionsCommand = {
   name: "logs",
   group: "functions",
-  helpText: helpText$e,
-  signature: "<name> [--limit <number>] [--json] [--utc] [--delete [--force]] [--watch]",
-  description: "Retrieve or delete logs for a Sanity Function",
+  ...transformedHelp$1,
   async action(args, context) {
     const { apiClient, output } = context, [name] = args.argsWithoutOptions, flags = { ...defaultFlags$2, ...args.extOptions }, client2 = apiClient({
       requireUser: !0,
@@ -4224,113 +4066,89 @@ Examples
     if (!token2) throw new Error("No API token found. Please run `sanity login`.");
     const { initDeployedBlueprintConfig } = await import("@sanity/runtime-cli/cores"), { functionLogsCore } = await import("@sanity/runtime-cli/cores/functions"), cmdConfig = await initDeployedBlueprintConfig({
       bin: "sanity",
-      log: (message) => output.print(message),
+      log: utils$3.logger.Logger(output.print),
       token: token2
     });
     if (!cmdConfig.ok) throw new Error(cmdConfig.error);
     const { success, error: error2 } = await functionLogsCore({
       ...cmdConfig.value,
+      helpText: transformedHelp$1.helpText,
+      error: createErrorLogger(output),
       args: { name },
-      flags
+      flags: {
+        limit: flags.l ?? flags.limit,
+        json: flags.j ?? flags.json,
+        utc: flags.u ?? flags.utc,
+        delete: flags.d ?? flags.delete,
+        force: flags.f ?? flags.force,
+        watch: flags.w ?? flags.watch
+      }
     });
     if (!success) throw new Error(error2);
   }
-}, helpText$d = `
-Arguments
-  <name> The name of the Sanity Function
-
-Options
-  --event <create|update|delete> The type of event to simulate (default: 'create')
-  --data <data> Data to send to the function
-  --data-before <data> Data to send to the function when event is update
-  --data-after <data> Data to send to the function when event is update
-  --file <file> Read data from file and send to the function
-  --file-before <file> Read data from file and send to the function when event is update
-  --file-after <file> Read data from file and send to the function when event is update
-  --document-id <id> Document to fetch and send to function
-  --document-id-before <id> Document to fetch and send to function when event is update
-  --document-id-after <id> Document to fetch and send to function when event is update
-  --timeout <timeout> Execution timeout value in seconds
-  --api <version> Sanity API Version to use
-  --dataset <dataset> The Sanity dataset to use
-  --project-id <id> Sanity Project ID to use
-  --with-user-token Prime access token from CLI config into context.clientOptions
-  --media-library-id <id> Sanity Media Library ID to use
-
-
-Examples
-  # Test function passing event data on command line
-  sanity functions test echo --data '{ "id": 1 }'
-
-  # Test function passing event data via a file
-  sanity functions test echo --file 'payload.json'
-
-  # Test function passing event data on command line and cap execution time to 60 seconds
-  sanity functions test echo --data '{ "id": 1 }' --timeout 60
-
-  # Test function simulating an update event
-  sanity functions test echo --event update --data-before '{ "title": "before" }' --data-after '{ "title": "after" }'
-`, defaultFlags$1 = {
+}, defaultFlags$1 = {
   timeout: 10,
   // seconds
   "with-user-token": !1
-}, testFunctionsCommand = {
+}, transformedHelp = transformHelpText(runtimeCli.FunctionsTestCommand, "sanity", "functions test");
+function validateUpdateEventFlags(flags) {
+  if (flags.event !== "update" && flags.e !== "update") return;
+  const hasDataPair = flags["data-before"] && flags["data-after"], hasFilePair = flags["file-before"] && flags["file-after"], hasDocPair = flags["document-id-before"] && flags["document-id-after"];
+  if (!(hasDataPair || hasFilePair || hasDocPair))
+    throw new Error(
+      `When using --event=update, you must provide one of the following flag pairs:
+  --data-before and --data-after
+  --file-before and --file-after
+  --document-id-before and --document-id-after`
+    );
+}
+const testFunctionsCommand = {
   name: "test",
   group: "functions",
-  helpText: helpText$d,
-  signature: "<name> [--event create|update|delete] [--data <json>] [--data-before <json>] [--data-after <json>] [--file <filename>] [--file-before <filename>] [--file-after <filename>] [--document-id <id>] [--document-id-before <id>] [--document-id-before <id>] [--timeout <seconds>] [--api <version>] [--dataset <name>] [--project-id <id>] [--media-library-id <id>] [--with-user-token]",
-  description: "Invoke a local Sanity Function",
+  ...transformedHelp,
   async action(args, context) {
     const { apiClient, output, chalk: chalk2 } = context, [name] = args.argsWithoutOptions, flags = { ...defaultFlags$1, ...args.extOptions }, client2 = apiClient({
       requireUser: !0,
       requireProject: !1
     }), { dataset, projectId, token: token2 } = client2.config(), actualDataset = dataset === "~dummy-placeholder-dataset-" ? void 0 : dataset;
     if (!token2) throw new Error("No API token found. Please run `sanity login`.");
-    if (!name)
-      throw new Error("You must provide a function name as the first argument");
-    const { initBlueprintConfig } = await import("@sanity/runtime-cli/cores"), { functionTestCore } = await import("@sanity/runtime-cli/cores/functions"), { blueprint } = await import("@sanity/runtime-cli/actions/blueprints"), { projectId: bpProjectId } = await blueprint.readLocalBlueprint();
-    if (projectId && projectId !== bpProjectId && (output.print(
+    if (!name) throw new Error("You must provide a function name as the first argument");
+    const { initBlueprintConfig } = await import("@sanity/runtime-cli/cores"), { functionTestCore } = await import("@sanity/runtime-cli/cores/functions"), { blueprint } = await import("@sanity/runtime-cli/actions/blueprints"), log = utils$3.logger.Logger(output.print), { projectId: bpProjectId } = await blueprint.readLocalBlueprint(log);
+    projectId && projectId !== bpProjectId && (output.print(
       chalk2.yellow("WARNING"),
       `Project ID ${chalk2.cyan(projectId)} in ${chalk2.green("sanity.cli.ts")} does not match Project ID ${chalk2.cyan(bpProjectId)} in ${chalk2.green("./sanity/blueprint.config.json")}.`
     ), output.print(
       `Defaulting to Project ID ${chalk2.cyan(bpProjectId)}. To override use the ${chalk2.green("--project-id")} flag.
 `
-    )), flags.event === "update") {
-      const hasDataPair = flags["data-before"] && flags["data-after"], hasFilePair = flags["file-before"] && flags["file-after"], hasDocPair = flags["document-id-before"] && flags["document-id-after"];
-      if (!(hasDataPair || hasFilePair || hasDocPair))
-        throw new Error(
-          `When using --event=update, you must provide one of the following flag pairs:
-  --data-before and --data-after
-  --file-before and --file-after
-  --document-id-before and --document-id-after`
-        );
-    }
+    )), validateUpdateEventFlags(flags);
     const cmdConfig = await initBlueprintConfig({
       bin: "sanity",
-      log: (message) => output.print(message),
+      log,
       token: token2
     });
     if (!cmdConfig.ok) throw new Error(cmdConfig.error);
     const { success, error: error2 } = await functionTestCore({
       ...cmdConfig.value,
       args: { name },
+      helpText: transformedHelp.helpText,
+      error: createErrorLogger(output),
       flags: {
-        data: flags.data,
-        "data-before": flags["data-before"],
+        api: flags.a ?? flags.api,
         "data-after": flags["data-after"],
-        file: flags.file,
-        "file-before": flags["file-before"],
-        "file-after": flags["file-after"],
-        "document-id": flags["document-id"],
-        "document-id-before": flags["document-id-before"],
-        "document-id-after": flags["document-id-after"],
-        event: flags.event,
-        timeout: flags.timeout,
-        api: flags.api,
+        "data-before": flags["data-before"],
+        data: flags.d ?? flags.data,
         dataset: flags.dataset || actualDataset,
+        "document-id-after": flags["document-id-after"],
+        "document-id-before": flags["document-id-before"],
+        "document-id": flags["document-id"],
+        event: flags.e ?? flags.event,
+        "file-after": flags["file-after"],
+        "file-before": flags["file-before"],
+        file: flags.f ?? flags.file,
+        "media-library-id": flags["media-library-id"],
         "project-id": flags["project-id"] || bpProjectId,
-        "with-user-token": flags["with-user-token"],
-        "media-library-id": flags["media-library-id"]
+        timeout: flags.t ?? flags.timeout,
+        "with-user-token": flags["with-user-token"]
       }
     });
     if (!success) throw new Error(error2);