@redocly/cli 0.0.0-snapshot.1784554531 → 0.0.0-snapshot.1784806880

package/THIRD_PARTY_NOTICES

@@ -649,14 +649,14 @@ Packages:
   @redocly/ajv@8.18.3 — Copyright (c) 2015-2021 Evgeny Poberezkin
   @redocly/cli-otel@0.3.4 — Copyright 2025 Redocly Inc, all rights reserved.
   @redocly/config@0.22.0 — Copyright 2024 Redocly Inc.
-  @redocly/config@0.51.0 — Copyright 2024 Redocly Inc.
-  @redocly/openapi-core@1.34.16
+  @redocly/config@0.52.0 — Copyright 2024 Redocly Inc.
+  @redocly/openapi-core@1.34.17
   agent-base@7.1.4 — Copyright (c) 2013 Nathan Rajlich <nathan@tootallnate.net>
   ajv-formats@3.0.1 — Copyright (c) 2020 Evgeny Poberezkin
   ajv@8.20.0 — Copyright (c) 2015-2021 Evgeny Poberezkin
   ansi-styles@4.3.0
   balanced-match@1.0.2 — Copyright (c) 2013 Julian Gruber &lt;julian@juliangruber.com&gt;
-  brace-expansion@2.1.1 — Copyright (c) 2013 Julian Gruber <julian@juliangruber.com>
+  brace-expansion@2.1.2 — Copyright (c) 2013 Julian Gruber <julian@juliangruber.com>
   call-me-maybe@1.0.2 — Copyright (c) 2015 Eric McCarthy
   chalk@4.1.2
   classnames@2.5.1 — Copyright (c) 2018 Jed Watson
@@ -679,6 +679,7 @@ Packages:
   js-levenshtein@1.1.6 — Copyright (c) 2017 Gustaf Andersson
   js-tokens@4.0.0 — Copyright (c) 2014, 2015, 2016, 2017, 2018 Simon Lydell
   js-yaml@4.2.0 — Copyright (C) 2011-2015 by Vitaly Puzrin
+  js-yaml@5.2.1 — Copyright (C) 2011-2015 by Vitaly Puzrin
   json-pointer@0.6.2 — Copyright (c) 2016 Manuel Stofer
   json-schema-traverse@1.0.0 — Copyright (c) 2017 Evgeny Poberezkin
   jsonpointer@5.0.1 — Copyright (c) 2011-2015 Jan Lehnardt <jan@apache.org> & Marc Bachmann <https://github.com/marcbachmann>

package/lib/chunks/3NHVLYJH.js

@@ -0,0 +1,179 @@
+import { createRequire as __createRequire } from 'node:module';
+import { fileURLToPath as __fileURLToPath } from 'node:url';
+import { dirname as __pathDirname } from 'node:path';
+const require = __createRequire(import.meta.url);
+var __filename = __fileURLToPath(import.meta.url);
+var __dirname = __pathDirname(__filename);
+import {
+  selectTrafficParser
+} from "./KXKCFLYG.js";
+import {
+  ValidationSession,
+  loadOpenApiIndex,
+  parseCsv,
+  renderReport
+} from "./5X37BYJI.js";
+import {
+  listFilesRecursively,
+  normalizeFsPath
+} from "./MOME5JRS.js";
+import {
+  AbortFlowError,
+  exitWithError
+} from "./L4OU3AUH.js";
+import {
+  logger
+} from "./OR4AMQFM.js";
+import "./HRYOF224.js";
+import "./YDPUXTSG.js";
+
+// src/commands/drift/index.ts
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+
+// src/commands/drift/engine/runner.ts
+async function runTrafficValidation(options) {
+  const trafficFiles = await listFilesRecursively(options.trafficPath);
+  if (trafficFiles.length === 0) {
+    throw new Error("No traffic files found in the provided traffic path.");
+  }
+  const session = ValidationSession.create({
+    openApiIndex: options.openApiIndex,
+    matchMode: options.matchMode,
+    ignoreCookies: options.ignoreCookies,
+    ignoreHeaders: options.ignoreHeaders,
+    previewFindingsLimit: options.previewFindingsLimit,
+    activeRules: options.activeRules,
+    server: options.server,
+    minSeverity: options.minSeverity
+  });
+  let supportedTrafficFileCount = 0;
+  let exchangeIndex = 0;
+  for (const trafficFile of trafficFiles) {
+    const parser = await selectTrafficParser(trafficFile, options.format);
+    if (!parser) {
+      logger.warn(`Skipping traffic file with unrecognized format: ${trafficFile}
+`);
+      continue;
+    }
+    supportedTrafficFileCount += 1;
+    for await (const exchange of parser.parse(trafficFile)) {
+      await session.process({ ...exchange, index: exchangeIndex });
+      exchangeIndex += 1;
+    }
+  }
+  if (supportedTrafficFileCount === 0) {
+    throw new Error(
+      "No supported traffic files found. In auto mode, files must match built-in traffic parser signatures."
+    );
+  }
+  if (exchangeIndex === 0) {
+    throw new Error("No HTTP exchanges were parsed from the provided traffic files.");
+  }
+  return session.finalize();
+}
+
+// src/commands/drift/index.ts
+var USE_COLOR = Boolean(process.stdout.isTTY) && process.env.NO_COLOR === void 0;
+function collectSpecServerUrls(openApiIndex) {
+  const urls = /* @__PURE__ */ new Set();
+  for (const operations of openApiIndex.operationsByMethod.values()) {
+    for (const operation of operations) {
+      for (const server of operation.servers) {
+        urls.add(server.rawUrl);
+      }
+    }
+  }
+  return Array.from(urls).sort();
+}
+function warnWhenNothingMatched(summary, openApiIndex, server) {
+  const validatedExchanges = summary.totalExchanges - summary.skippedExchanges;
+  if (validatedExchanges === 0 && summary.skippedExchanges > 0) {
+    logger.warn(
+      `All ${summary.skippedExchanges} exchange(s) were outside the --server "${server}" and were skipped. Check that the server matches the traffic URLs.
+`
+    );
+    return;
+  }
+  if (summary.documentedExchanges > 0 || validatedExchanges === 0) {
+    return;
+  }
+  const serverUrls = collectSpecServerUrls(openApiIndex);
+  const hint = server ? `Check that the --server "${server}" matches the traffic URLs and that the description paths align with the remainder.` : summary.hostCompatibleExchanges === validatedExchanges ? `The traffic hosts are compatible with the description servers (${serverUrls.join(
+    ", "
+  )}), so the endpoints are likely undocumented; if they should be documented, check that the description base paths and paths align with the traffic URLs, or use --server to declare the server the traffic was captured against.` : `Check that the traffic host and base path match the description servers (${serverUrls.join(
+    ", "
+  )}), or use --server to declare the server the traffic was captured against.`;
+  logger.warn(
+    `None of the ${validatedExchanges} validated exchange(s) matched a documented operation. ${hint}
+`
+  );
+}
+async function writeOutput(outputPath, content) {
+  const resolved = normalizeFsPath(outputPath);
+  await mkdir(path.dirname(resolved), { recursive: true });
+  await writeFile(resolved, content, "utf8");
+}
+async function handleDrift({ argv, config }) {
+  const trafficPath = normalizeFsPath(argv.traffic);
+  const trafficFormat = argv["traffic-format"];
+  const activeRules = argv.rules ? parseCsv(argv.rules) : void 0;
+  const ignoreHeaders = argv["ignore-headers"] ? parseCsv(argv["ignore-headers"]) : void 0;
+  const server = argv.server;
+  if (server && argv["match-mode"]) {
+    return exitWithError(
+      "The --server and --match-mode options are mutually exclusive: --match-mode controls how requests are located via the description servers, while --server replaces the description servers with the one the traffic was captured against."
+    );
+  }
+  const matchMode = argv["match-mode"] ?? "strict-host";
+  const specPath = normalizeFsPath(argv.api);
+  const openApiIndex = await loadOpenApiIndex(specPath, config);
+  if (openApiIndex.loadedOperations === 0) {
+    return exitWithError(`No OpenAPI operations were loaded from: ${specPath}`);
+  }
+  const { runId, summary, findings } = await runTrafficValidation({
+    trafficPath,
+    format: trafficFormat,
+    matchMode,
+    ignoreCookies: argv["ignore-cookies"],
+    ignoreHeaders,
+    previewFindingsLimit: argv["max-findings"],
+    activeRules,
+    openApiIndex,
+    server,
+    minSeverity: argv["min-severity"]
+  });
+  warnWhenNothingMatched(summary, openApiIndex, server);
+  const report = renderReport(
+    {
+      runId,
+      summary,
+      findings,
+      meta: {
+        specSource: specPath,
+        trafficPath,
+        format: trafficFormat,
+        matchMode,
+        server
+      }
+    },
+    {
+      format: argv["report-format"],
+      color: USE_COLOR && argv["report-format"] === "pretty" && !argv.output,
+      maxFindings: argv["max-findings"]
+    }
+  );
+  if (argv.output) {
+    await writeOutput(argv.output, report);
+    logger.info(`Drift report written to: ${normalizeFsPath(argv.output)}
+`);
+  } else {
+    logger.output(report);
+  }
+  if (summary.findingsBySeverity.error > 0) {
+    throw new AbortFlowError("Drift detected.");
+  }
+}
+export {
+  handleDrift
+};

package/lib/chunks/{CQW6BTG6.js → 3PBFD5RJ.js}

@@ -6,24 +6,26 @@ var __filename = __fileURLToPath(import.meta.url);
 var __dirname = __pathDirname(__filename);
 import {
   ValidationSession,
-  createNormalizedExchange,
-  isJsonMime,
   loadOpenApiIndex,
-  normalizeFsPath,
   parseCsv,
   renderReport
-} from "./N6FJ5HYR.js";
+} from "./5X37BYJI.js";
+import {
+  createNormalizedExchange,
+  isJsonMime,
+  normalizeFsPath
+} from "./MOME5JRS.js";
 import {
   AbortFlowError,
   exitWithError
-} from "./7COJB2Y6.js";
+} from "./L4OU3AUH.js";
 import {
   require_undici
 } from "./QRC5ADSZ.js";
 import {
   isPlainObject,
   logger
-} from "./KD24SG2E.js";
+} from "./OR4AMQFM.js";
 import "./HRYOF224.js";
 import {
   __toESM

package/lib/chunks/4VYNEZM4.js

@@ -0,0 +1,83 @@
+import { createRequire as __createRequire } from 'node:module';
+import { fileURLToPath as __fileURLToPath } from 'node:url';
+import { dirname as __pathDirname } from 'node:path';
+const require = __createRequire(import.meta.url);
+var __filename = __fileURLToPath(import.meta.url);
+var __dirname = __pathDirname(__filename);
+import {
+  logger
+} from "./OR4AMQFM.js";
+
+// 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/utils/spinner.ts
+import * as process 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 (!process.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 = "";
+  }
+};
+
+export {
+  OPENAPI3_METHOD_NAMES,
+  OPENAPI3_COMPONENT_NAMES,
+  Spinner
+};