@redocly/cli 2.39.0 → 2.41.0

package/lib/index.js

@@ -2,9 +2,9 @@
 import { createRequire as __createRequire } from 'node:module';
 const require = __createRequire(import.meta.url);
 import {
-  j,
+  E,
   ulid
-} from "./chunks/ICAVAH7N.js";
+} from "./chunks/ICPYP2LP.js";
 import {
   capitalize,
   cleanColors,
@@ -28,11 +28,16 @@ import {
   saveBundle,
   sortTopLevelKeys,
   writeToFileByExtension
-} from "./chunks/OYZMAAZV.js";
+} from "./chunks/XDNYWH7V.js";
+import {
+  OPENAPI3_COMPONENT_NAMES,
+  OPENAPI3_METHOD_NAMES,
+  Spinner
+} from "./chunks/LCWGF7G6.js";
 import {
   AbortFlowError,
   exitWithError
-} from "./chunks/U4V3W7MN.js";
+} from "./chunks/DT4UM7U4.js";
 import {
   RedoclyOAuthClient,
   ReuniteApi,
@@ -42,7 +47,7 @@ import {
   getProxyUrl,
   getReuniteUrl,
   shouldBypassProxy
-} from "./chunks/BA5AZJUM.js";
+} from "./chunks/Q3KTKRJH.js";
 import {
   ANONYMOUS_ID_CACHE_FILE,
   DEFAULT_FETCH_TIMEOUT,
@@ -53,7 +58,7 @@ import {
   engines,
   name,
   version
-} from "./chunks/2LEVMD2A.js";
+} from "./chunks/Z5H4OEIW.js";
 import {
   require_undici
 } from "./chunks/XB6C62FW.js";
@@ -61,7 +66,7 @@ import {
   RESET_ESCAPE_CODE,
   calculateTotals,
   conditionallyMaskSecrets
-} from "./chunks/OVY6O6WL.js";
+} from "./chunks/6ABF7ZRJ.js";
 import "./chunks/VXIQEZPR.js";
 import "./chunks/UUU33DK3.js";
 import {
@@ -114,7 +119,7 @@ import {
   white,
   xmlEscape,
   yellow
-} from "./chunks/KYZEVOA2.js";
+} from "./chunks/YK6T7IHG.js";
 import "./chunks/Z2I5YXYN.js";
 import {
   __commonJS,
@@ -3437,11 +3442,11 @@ var YargsParser = class {
       } else if (arg.match(/^-[^-]+/) && !arg.match(negative)) {
         letters = arg.slice(1, -1).split("");
         broken = false;
-        for (let j2 = 0; j2 < letters.length; j2++) {
-          next = arg.slice(j2 + 2);
-          if (letters[j2 + 1] && letters[j2 + 1] === "=") {
-            value = arg.slice(j2 + 3);
-            key = letters[j2];
+        for (let j = 0; j < letters.length; j++) {
+          next = arg.slice(j + 2);
+          if (letters[j + 1] && letters[j + 1] === "=") {
+            value = arg.slice(j + 3);
+            key = letters[j];
             if (checkAllAliases(key, flags.arrays)) {
               i = eatArray(i, key, args, value);
             } else if (checkAllAliases(key, flags.nargs) !== false) {
@@ -3453,20 +3458,20 @@ var YargsParser = class {
             break;
           }
           if (next === "-") {
-            setArg(letters[j2], next);
+            setArg(letters[j], next);
             continue;
           }
-          if (/[A-Za-z]/.test(letters[j2]) && /^-?\d+(\.\d*)?(e-?\d+)?$/.test(next) && checkAllAliases(next, flags.bools) === false) {
-            setArg(letters[j2], next);
+          if (/[A-Za-z]/.test(letters[j]) && /^-?\d+(\.\d*)?(e-?\d+)?$/.test(next) && checkAllAliases(next, flags.bools) === false) {
+            setArg(letters[j], next);
             broken = true;
             break;
           }
-          if (letters[j2 + 1] && letters[j2 + 1].match(/\W/)) {
-            setArg(letters[j2], next);
+          if (letters[j + 1] && letters[j + 1].match(/\W/)) {
+            setArg(letters[j], next);
             broken = true;
             break;
           } else {
-            setArg(letters[j2], defaultValue(letters[j2]));
+            setArg(letters[j], defaultValue(letters[j]));
           }
         }
         key = arg.slice(-1)[0];
@@ -3928,13 +3933,13 @@ var YargsParser = class {
       let hasAllFlags = true;
       let next;
       const letters = arg.slice(1).split("");
-      for (let j2 = 0; j2 < letters.length; j2++) {
-        next = arg.slice(j2 + 2);
-        if (!hasAnyFlag(letters[j2])) {
+      for (let j = 0; j < letters.length; j++) {
+        next = arg.slice(j + 2);
+        if (!hasAnyFlag(letters[j])) {
           hasAllFlags = false;
           break;
         }
-        if (letters[j2 + 1] && letters[j2 + 1] === "=" || next === "-" || /[A-Za-z]/.test(letters[j2]) && /^-?\d+(\.\d*)?(e-?\d+)?$/.test(next) || letters[j2 + 1] && letters[j2 + 1].match(/\W/)) {
+        if (letters[j + 1] && letters[j + 1] === "=" || next === "-" || /[A-Za-z]/.test(letters[j]) && /^-?\d+(\.\d*)?(e-?\d+)?$/.test(next) || letters[j + 1] && letters[j + 1].match(/\W/)) {
           break;
         }
       }
@@ -5710,16 +5715,16 @@ function levenshtein(a, b) {
   for (i = 0; i <= b.length; i++) {
     matrix[i] = [i];
   }
-  let j2;
-  for (j2 = 0; j2 <= a.length; j2++) {
-    matrix[0][j2] = j2;
+  let j;
+  for (j = 0; j <= a.length; j++) {
+    matrix[0][j] = j;
   }
   for (i = 1; i <= b.length; i++) {
-    for (j2 = 1; j2 <= a.length; j2++) {
-      if (b.charAt(i - 1) === a.charAt(j2 - 1)) {
-        matrix[i][j2] = matrix[i - 1][j2 - 1];
+    for (j = 1; j <= a.length; j++) {
+      if (b.charAt(i - 1) === a.charAt(j - 1)) {
+        matrix[i][j] = matrix[i - 1][j - 1];
       } else {
-        matrix[i][j2] = Math.min(matrix[i - 1][j2 - 1] + 1, Math.min(matrix[i][j2 - 1] + 1, matrix[i - 1][j2] + 1));
+        matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, Math.min(matrix[i][j - 1] + 1, matrix[i - 1][j] + 1));
       }
     }
   }
@@ -7709,7 +7714,7 @@ async function handleGenerateArazzo({
     config: config3
   };
   try {
-    const { generate } = await import("./chunks/W5R2GYDZ.js");
+    const { generate } = await import("./chunks/VMHXZFTB.js");
     logger.info(gray("\n  Generating Arazzo description... \n"));
     const generatedArazzo = await generate(options);
     writeFileSync2(outputFile, stringifyYaml(generatedArazzo));
@@ -8026,30 +8031,6 @@ function collectExternalDocs({
   }
 }
 
-// src/commands/split/oas/constants.ts
-var OPENAPI3_METHOD_NAMES = [
-  "get",
-  "put",
-  "post",
-  "delete",
-  "options",
-  "head",
-  "patch",
-  "trace",
-  "query"
-];
-var OPENAPI3_COMPONENT_NAMES = [
-  "schemas",
-  "responses",
-  "parameters",
-  "examples",
-  "headers",
-  "requestBodies",
-  "links",
-  "callbacks",
-  "securitySchemes"
-];
-
 // src/commands/join/utils/collect-paths.ts
 function collectPaths({
   joinedDef,
@@ -8092,7 +8073,7 @@ function collectPaths({
         if (field === "parameters") {
           collectPathParameters(pathItem, path28);
         }
-        if (typeof pathItem[field] === "string") {
+        if (typeof pathItem[field] === "string" || field.startsWith("x-")) {
           collectPathStringFields(pathItem, path28, field);
         }
       }
@@ -8100,7 +8081,7 @@ function collectPaths({
   }
   function collectPathStringFields(pathItem, path28, field) {
     const fieldValue = pathItem[field];
-    if (joinedDef.paths[path28].hasOwnProperty(field) && joinedDef.paths[path28][field] !== fieldValue) {
+    if (joinedDef.paths[path28].hasOwnProperty(field) && !dequal(joinedDef.paths[path28][field], fieldValue)) {
       logger.warn(`warning: different ${field} values in ${path28}
 `);
       return;
@@ -9185,7 +9166,7 @@ async function handleRespect({
   let mtlsCerts;
   let harLogs;
   try {
-    const { run, conditionallyMaskSecrets: conditionallyMaskSecrets2 } = await import("./chunks/W5R2GYDZ.js");
+    const { run, conditionallyMaskSecrets: conditionallyMaskSecrets2 } = await import("./chunks/VMHXZFTB.js");
     const workingDir = config3.configPath ? dirname4(config3.configPath) : process.cwd();
     if (argv.mtls) {
       mtlsCerts = resolveMtlsCertificates(argv.mtls, workingDir);
@@ -10064,9 +10045,9 @@ function computeDependencyDepths(operations) {
     if (ops.size < 2) continue;
     const opArray = Array.from(ops);
     for (let i = 0; i < opArray.length; i++) {
-      for (let j2 = i + 1; j2 < opArray.length; j2++) {
-        adjacency.get(opArray[i]).add(opArray[j2]);
-        adjacency.get(opArray[j2]).add(opArray[i]);
+      for (let j = i + 1; j < opArray.length; j++) {
+        adjacency.get(opArray[i]).add(opArray[j]);
+        adjacency.get(opArray[j]).add(opArray[i]);
       }
     }
   }
@@ -12070,50 +12051,6 @@ Launching translate using NPX.
   });
 };
 
-// src/utils/spinner.ts
-import * as process4 from "node:process";
-var SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
-var Spinner = class {
-  frames;
-  currentFrame;
-  intervalId;
-  message;
-  constructor() {
-    this.frames = SPINNER_FRAMES;
-    this.currentFrame = 0;
-    this.intervalId = null;
-    this.message = "";
-  }
-  showFrame() {
-    logger.info("\r" + this.frames[this.currentFrame] + " " + this.message);
-    this.currentFrame = (this.currentFrame + 1) % this.frames.length;
-  }
-  start(message) {
-    if (this.message === message) {
-      return;
-    }
-    this.message = message;
-    if (!process4.stderr.isTTY) {
-      logger.info(`${message}...
-`);
-      return;
-    }
-    if (this.intervalId === null) {
-      this.intervalId = setInterval(() => {
-        this.showFrame();
-      }, 100);
-    }
-  }
-  stop() {
-    if (this.intervalId !== null) {
-      clearInterval(this.intervalId);
-      this.intervalId = null;
-      logger.info("\r");
-    }
-    this.message = "";
-  }
-};
-
 // src/reunite/utils.ts
 var DeploymentError = class extends Error {
 };
@@ -12555,11 +12492,11 @@ var import_semver = __toESM(require_semver2(), 1);
 import { existsSync as existsSync7, writeFileSync as writeFileSync5, readFileSync as readFileSync7, statSync as statSync5 } from "node:fs";
 import { tmpdir } from "node:os";
 import { join as join13 } from "node:path";
-import * as process5 from "node:process";
+import * as process4 from "node:process";
 var VERSION_CACHE_FILE = "redocly-cli-version";
 var SPACE_TO_BORDER = 4;
 var INTERVAL_TO_CHECK = 1e3 * 60 * 60 * 12;
-var SHOULD_NOT_NOTIFY = process5.env.NODE_ENV === "test" || process5.env.CI || !!process5.env.LAMBDA_TASK_ROOT || process5.env.REDOCLY_SUPPRESS_UPDATE_NOTICE === "true";
+var SHOULD_NOT_NOTIFY = process4.env.NODE_ENV === "test" || process4.env.CI || !!process4.env.LAMBDA_TASK_ROOT || process4.env.REDOCLY_SUPPRESS_UPDATE_NOTICE === "true";
 var notifyUpdateCliVersion = () => {
   if (SHOULD_NOT_NOTIFY) {
     return;
@@ -12705,7 +12642,7 @@ async function sendTelemetry({
       $0: _,
       ...args
     } = argv;
-    const { RedoclyOAuthClient: RedoclyOAuthClient2 } = await import("./chunks/V6CVT3XE.js");
+    const { RedoclyOAuthClient: RedoclyOAuthClient2 } = await import("./chunks/SZLWDHZK.js");
     const oauthClient = new RedoclyOAuthClient2();
     const reuniteUrl = getReuniteUrl(config3, args.residency);
     const logged_in = await oauthClient.isAuthorized(reuniteUrl);
@@ -12717,11 +12654,11 @@ async function sendTelemetry({
     const majorSpecVersion = getMajorSpecVersion(spec_version);
     const eventData = [
       {
-        id: "cli-command-run",
+        id: command2,
         object: "command",
-        uri: "urn:redocly:cli",
+        uri: `urn:redocly:cli:command:${command2}`,
         logged_in: logged_in ? "yes" : "no",
-        command: `${command2}`,
+        command: command2,
         ...cleanArgs(args, process.argv.slice(2)),
         node_version: process.version,
         npm_version: execSync("npm -v").toString().replace("\n", ""),
@@ -12740,9 +12677,9 @@ async function sendTelemetry({
         respect_criterion_object_types: majorSpecVersion === "arazzo1" && respect_criterion_object_types?.length ? JSON.stringify(respect_criterion_object_types) : void 0
       }
     ];
-    const cloudEvent = j.mapToCloudEvent({
+    const cloudEvent = E.mapToCloudEvent({
       type: "com.redocly.command.ran",
-      source: "com.redocly.cli",
+      source: "urn:redocly:cli",
       origin: "redocly-cli",
       osPlatform: os.platform(),
       actor: {
@@ -12753,7 +12690,7 @@ async function sendTelemetry({
       category: "product",
       data: eventData
     });
-    const { otelTelemetry } = await import("./chunks/C3PXBQU5.js");
+    const { otelTelemetry } = await import("./chunks/5YSNZVUA.js");
     otelTelemetry.send(cloudEvent);
   } catch (err) {
   }
@@ -13583,7 +13520,7 @@ yargs_default(hideBin(process.argv)).version("version", "Show version number.",
     return true;
   }),
   async (argv) => {
-    const { handlerBuildCommand } = await import("./chunks/V74PIVJZ.js");
+    const { handlerBuildCommand } = await import("./chunks/7H6CC6CT.js");
     commandWrapper(handlerBuildCommand)(argv);
   }
 ).command(
@@ -13744,6 +13681,69 @@ yargs_default(hideBin(process.argv)).version("version", "Show version number.",
   async (argv) => {
     commandWrapper(handleGenerateArazzo)(argv);
   }
+).command(
+  "generate-spec <traffic>",
+  "Infer an OpenAPI description from recorded HTTP traffic, optionally refined with AI [experimental].",
+  (yargs) => yargs.env("REDOCLY_CLI_GENERATE_SPEC").positional("traffic", {
+    describe: "Path to a traffic log file or folder (HAR, Kong, Nginx/Apache JSON, NDJSON).",
+    type: "string"
+  }).option({
+    type: {
+      describe: "Target API description type.",
+      choices: ["openapi"],
+      default: "openapi"
+    },
+    "traffic-format": {
+      describe: "Traffic input format.",
+      choices: [
+        "auto",
+        "har",
+        "kong",
+        "nginx-json",
+        "apache-json",
+        "ndjson"
+      ],
+      default: "auto"
+    },
+    server: {
+      describe: "Server URL the traffic was captured against: only requests under it are considered, the rest of their URL becomes the API path, and it becomes the servers URL of the generated description.",
+      type: "string"
+    },
+    title: {
+      describe: "Title for the generated API description.",
+      type: "string"
+    },
+    "with-ai": {
+      describe: "Refine the inferred description with an AI provider to narrow the hypothesis.",
+      type: "boolean",
+      default: false
+    },
+    "ai-provider": {
+      describe: 'AI provider used with --with-ai; runs the "claude", "codex", or "cursor" CLI in non-interactive mode.',
+      choices: ["claude", "codex", "cursor"],
+      default: "claude"
+    },
+    "ai-model": {
+      describe: "Model passed to the selected AI provider (provider-specific default applies).",
+      type: "string"
+    },
+    "ai-concurrency": {
+      describe: "Number of operations refined in parallel with --with-ai.",
+      type: "number",
+      default: 4,
+      coerce: validatePositiveNumber("ai-concurrency", true)
+    },
+    output: {
+      alias: "o",
+      describe: "Write the generated description to this file instead of stdout.",
+      type: "string"
+    },
+    config: { describe: "Path to the config file.", type: "string" }
+  }),
+  async (argv) => {
+    const { handleGenerateSpec } = await import("./chunks/PFPGSTSG.js");
+    commandWrapper(handleGenerateSpec)(argv);
+  }
 ).command(
   "scorecard-classic [api]",
   "Run quality scorecards with multiple rule levels to validate and maintain API description standards.",
@@ -13821,6 +13821,10 @@ yargs_default(hideBin(process.argv)).version("version", "Show version number.",
       type: "boolean",
       default: false
     },
+    "ignore-headers": {
+      describe: 'Comma-separated header names to skip in undocumented-header checks. A trailing "*" matches by prefix, e.g. "x-consumer-*".',
+      type: "string"
+    },
     "max-findings": {
       describe: "Maximum findings shown in pretty output.",
       type: "number",
@@ -13852,7 +13856,7 @@ yargs_default(hideBin(process.argv)).version("version", "Show version number.",
     }
   }),
   async (argv) => {
-    const { handleDrift } = await import("./chunks/C5HID4LT.js");
+    const { handleDrift } = await import("./chunks/HQDT5XFP.js");
     commandWrapper(handleDrift)(argv);
   }
 ).command(
@@ -13899,6 +13903,10 @@ yargs_default(hideBin(process.argv)).version("version", "Show version number.",
       type: "boolean",
       default: false
     },
+    "ignore-headers": {
+      describe: 'Comma-separated header names to skip in undocumented-header checks. A trailing "*" matches by prefix, e.g. "x-consumer-*".',
+      type: "string"
+    },
     "max-findings": {
       describe: "Maximum findings shown in pretty output.",
       type: "number",
@@ -13916,7 +13924,7 @@ yargs_default(hideBin(process.argv)).version("version", "Show version number.",
     }
   }),
   async (argv) => {
-    const { handleProxy } = await import("./chunks/BNHQNMUG.js");
+    const { handleProxy } = await import("./chunks/GOFLD5MJ.js");
     commandWrapper(handleProxy)(argv);
   }
 ).completion("completion", "Generate autocomplete script for `redocly` command.").demandCommand(1).middleware([notifyUpdateCliVersion]).strict().argv;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@redocly/cli",
-  "version": "2.39.0",
+  "version": "2.41.0",
   "description": "",
   "license": "MIT",
   "type": "module",