openapi-typesafe 1.0.0-rc.4 → 1.0.0-rc.6

package/dist/cli/cli-arguments.cjs

@@ -3,70 +3,27 @@
 const scule = require('scule');
 const parser = require('yargs-parser');
 const cliErrors = require('./cli-errors.cjs');
+const cliFlagNames = require('./cli-flag-names.cjs');
+const docsLinks = require('./docs-links.cjs');
 const fixOption = require('./fix-option.cjs');
+const writtenFlags = require('./written-flags.cjs');
 
 function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
 
 const parser__default = /*#__PURE__*/_interopDefaultCompat(parser);
 
-const GENERATOR_FLAGS = [
-  "additionalProperties",
-  "alphabetize",
-  "arrayLength",
-  "binaryAsBlob",
-  "conditionalEnums",
-  "dedupeEnums",
-  "defaultNonNullable",
-  "emptyObjectsUnknown",
-  "enum",
-  "enumValues",
-  "excludeDeprecated",
-  "exportType",
-  "generatePathParams",
-  "immutable",
-  "lint",
-  "makePathsEnum",
-  "pathParamsAsTypes",
-  "propertiesRequiredByDefault",
-  "readWriteMarkers",
-  "rootTypes",
-  "rootTypesKeepCasing",
-  "rootTypesNoSchemaPrefix"
-];
-const CAMEL_CASE_BOOLEAN_FLAGS = [...GENERATOR_FLAGS, "check", "contentNever", "help"];
-const BOOLEAN_FLAGS = [
-  ...CAMEL_CASE_BOOLEAN_FLAGS,
-  ...CAMEL_CASE_BOOLEAN_FLAGS.map((flag) => scule.kebabCase(flag))
-];
-const REMOVED_FLAGS = [
-  ["-ap", `The -ap alias has been deprecated. Use "--additional-properties" instead.`],
-  ["--immutable-types", `The --immutable-types flag has been renamed to "--immutable".`],
-  [
-    "--support-array-length",
-    `The --support-array-length flag has been renamed to "--array-length".`
-  ],
-  ["-it", `The -it alias has been deprecated. Use "--immutable" instead.`],
-  ["--redoc", `The --redoc config flag has been renamed to "--redocly" (or -c as shorthand).`]
-];
-const ROOT_TYPES_FLAGS = ["--root-types-no-schema-prefix", "--root-types-keep-casing"];
-function rejectRemovedFlags(argv) {
-  for (const [flag, message] of REMOVED_FLAGS) {
-    if (argv.includes(flag)) {
-      throw cliErrors.cliError("CLI_FLAG_REMOVED", message);
-    }
-  }
-}
-function ineffectiveFlagNotices(argv) {
-  if (argv.includes("--root-types")) {
+const ROOT_TYPES_FLAGS = ["rootTypesNoSchemaPrefix", "rootTypesKeepCasing"];
+function ineffectiveFlagNotices(flags) {
+  if (flags.rootTypes === true) {
     return [];
   }
-  return ROOT_TYPES_FLAGS.filter((flag) => argv.includes(flag)).map(
-    (flag) => `${flag} has no effect without --root-types flag`
+  return ROOT_TYPES_FLAGS.filter((flag) => flags[flag] === true).map(
+    (flag) => `--${scule.kebabCase(flag)} has no effect without --root-types flag`
   );
 }
 function generatorFlagsOf(parsed) {
   const flags = {};
-  for (const name of GENERATOR_FLAGS) {
+  for (const name of cliFlagNames.GENERATOR_FLAGS) {
     if (typeof parsed[name] === "boolean") {
       flags[name] = parsed[name];
     }
@@ -93,21 +50,8 @@ function refLimitsOf(parsed) {
     ...remoteRefHosts === void 0 ? {} : { remoteRefHosts }
   };
 }
-const STRING_FLAGS = [
-  "output",
-  "redocly",
-  "fix",
-  ...["localRefRoot", "remoteRefHosts"].flatMap((flag) => [flag, scule.kebabCase(flag)])
-];
-const ALIASES = { redocly: ["c"], exportType: ["t"], output: ["o"] };
-const KNOWN_FLAGS = /* @__PURE__ */ new Set([
-  ...BOOLEAN_FLAGS,
-  ...STRING_FLAGS,
-  ...Object.values(ALIASES).flat(),
-  "version"
-]);
 function unknownFlagsOf(parsed, argv) {
-  const names = Object.keys(parsed).filter((key) => key !== "_" && key !== "--" && !KNOWN_FLAGS.has(key)).map((key) => writtenFlagName(key, argv));
+  const names = Object.keys(parsed).filter((key) => key !== "_" && key !== "--" && !cliFlagNames.KNOWN_FLAGS.has(key)).map((key) => writtenFlagName(key, argv));
   return [...new Set(names)];
 }
 function writtenFlagName(key, argv) {
@@ -118,17 +62,31 @@ function writtenFlagName(key, argv) {
   const isNegated = argv.some((arg) => arg === negated || arg.startsWith(`${negated}=`));
   return isNegated ? negated : `--${scule.kebabCase(key)}`;
 }
+function inputOf(positionals) {
+  if (positionals.length > 1) {
+    throw cliErrors.cliError(
+      "CLI_INPUT_EXTRA",
+      `Only one schema argument is allowed, but ${positionals.length} were given: ${positionals.join(" ")}. A shell expands an unquoted *; to generate several schemas, list them under \`apis\` in redocly.yaml. See ${docsLinks.MULTIPLE_SCHEMAS_DOCS_URL}`
+    );
+  }
+  return optionalString(positionals[0]);
+}
 function parseCliArguments(argv) {
-  rejectRemovedFlags(argv);
+  const flags = writtenFlags.writtenFlags(argv);
+  writtenFlags.rejectRemovedFlags(flags);
+  writtenFlags.rejectInvalidBooleans(flags);
+  writtenFlags.rejectNegatedValueFlags(flags);
   const parsed = parser__default([...argv], {
-    boolean: BOOLEAN_FLAGS,
-    string: STRING_FLAGS,
-    alias: ALIASES
+    boolean: [...cliFlagNames.BOOLEAN_FLAGS, ...writtenFlags.unknownFlagNames(flags)],
+    string: cliFlagNames.STRING_FLAGS,
+    alias: cliFlagNames.ALIASES,
+    // A schema path is a file name: `1.10` is not the number 1.1.
+    configuration: { "parse-positional-numbers": false }
   });
   return {
-    input: optionalString(parsed._[0]),
-    output: optionalString(parsed.output),
-    redocly: optionalString(parsed.redocly),
+    input: inputOf(parsed._),
+    output: lastString(parsed.output),
+    redocly: lastString(parsed.redocly),
     isCheck: parsed.check === true,
     isHelp: "help" in parsed,
     isVersion: "version" in parsed,
@@ -139,7 +97,7 @@ function parseCliArguments(argv) {
   };
 }
 
-exports.GENERATOR_FLAGS = GENERATOR_FLAGS;
+exports.GENERATOR_FLAGS = cliFlagNames.GENERATOR_FLAGS;
 exports.hostList = hostList;
 exports.ineffectiveFlagNotices = ineffectiveFlagNotices;
 exports.parseCliArguments = parseCliArguments;

package/dist/cli/cli-arguments.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli-arguments.cjs","sources":["../../src/cli/cli-arguments.ts"],"sourcesContent":["import { kebabCase } from \"scule\";\nimport parser from \"yargs-parser\";\nimport type { OutputFixName } from \"../domain/output-fixes.js\";\nimport { cliError } from \"./cli-errors.js\";\nimport { fixNamesOf } from \"./fix-option.js\";\n\n/** The CLI's arguments, parsed as the original CLI parsed them (yargs-parser). */\n\n/** Boolean flags that become generator options (camelCase; yargs also accepts kebab-case). */\nexport const GENERATOR_FLAGS = [\n  \"additionalProperties\",\n  \"alphabetize\",\n  \"arrayLength\",\n  \"binaryAsBlob\",\n  \"conditionalEnums\",\n  \"dedupeEnums\",\n  \"defaultNonNullable\",\n  \"emptyObjectsUnknown\",\n  \"enum\",\n  \"enumValues\",\n  \"excludeDeprecated\",\n  \"exportType\",\n  \"generatePathParams\",\n  \"immutable\",\n  \"lint\",\n  \"makePathsEnum\",\n  \"pathParamsAsTypes\",\n  \"propertiesRequiredByDefault\",\n  \"readWriteMarkers\",\n  \"rootTypes\",\n  \"rootTypesKeepCasing\",\n  \"rootTypesNoSchemaPrefix\",\n] as const;\n\nexport type GeneratorFlag = (typeof GENERATOR_FLAGS)[number];\n\nexport type GeneratorFlags = Readonly<Partial<Record<GeneratorFlag, boolean>>>;\n\n// `contentNever` was a boolean flag of the original CLI that no code reads; it stays in the list\n// so that `--content-never <input>` keeps parsing as a flag and an input.\nconst CAMEL_CASE_BOOLEAN_FLAGS = [...GENERATOR_FLAGS, \"check\", \"contentNever\", \"help\"];\n\n// yargs-parser matches the `boolean` list by the exact spelling of the flag: with camelCase names\n// only, `--root-types schema.yaml` took the path as the flag's value (upstream #2523). Both\n// spellings are listed.\nconst BOOLEAN_FLAGS = [\n  ...CAMEL_CASE_BOOLEAN_FLAGS,\n  ...CAMEL_CASE_BOOLEAN_FLAGS.map((flag) => kebabCase(flag)),\n];\n\n/** The `$ref` limits as the user wrote them; unset flags are absent. */\nexport interface CliRefLimits {\n  readonly localRefRoot?: string;\n  readonly remoteRefHosts?: readonly string[];\n}\n\nexport interface CliArguments {\n  /** The schema path or URL; none means stdin, or the APIs of the Redocly config. */\n  readonly input: string | undefined;\n  readonly output: string | undefined;\n  readonly redocly: string | undefined;\n  readonly isCheck: boolean;\n  readonly isHelp: boolean;\n  readonly isVersion: boolean;\n  readonly generatorFlags: GeneratorFlags;\n  readonly refLimits: CliRefLimits;\n  /** `--fix`, comma-separated and repeatable (ADR-021); unset when the flag is not given. */\n  readonly fix: readonly OutputFixName[] | undefined;\n  /** Flags the CLI does not know, as written on the command line (`--bogus`, `-x`). */\n  readonly unknownFlags: readonly string[];\n}\n\n/** Flags of older versions that were removed or renamed, with the message for each. */\nconst REMOVED_FLAGS: readonly (readonly [string, string])[] = [\n  [\"-ap\", `The -ap alias has been deprecated. Use \"--additional-properties\" instead.`],\n  [\"--immutable-types\", `The --immutable-types flag has been renamed to \"--immutable\".`],\n  [\n    \"--support-array-length\",\n    `The --support-array-length flag has been renamed to \"--array-length\".`,\n  ],\n  [\"-it\", `The -it alias has been deprecated. Use \"--immutable\" instead.`],\n  [\"--redoc\", `The --redoc config flag has been renamed to \"--redocly\" (or -c as shorthand).`],\n];\n\n/** Flags that only work together with `--root-types`. */\nconst ROOT_TYPES_FLAGS = [\"--root-types-no-schema-prefix\", \"--root-types-keep-casing\"] as const;\n\nfunction rejectRemovedFlags(argv: readonly string[]): void {\n  for (const [flag, message] of REMOVED_FLAGS) {\n    if (argv.includes(flag)) {\n      throw cliError(\"CLI_FLAG_REMOVED\", message);\n    }\n  }\n}\n\n/** Notices for flags that have no effect in this combination, printed before the run. */\nexport function ineffectiveFlagNotices(argv: readonly string[]): string[] {\n  if (argv.includes(\"--root-types\")) {\n    return [];\n  }\n  return ROOT_TYPES_FLAGS.filter((flag) => argv.includes(flag)).map(\n    (flag) => `${flag} has no effect without --root-types flag`,\n  );\n}\n\nfunction generatorFlagsOf(parsed: parser.Arguments): GeneratorFlags {\n  const flags: Partial<Record<GeneratorFlag, boolean>> = {};\n  for (const name of GENERATOR_FLAGS) {\n    if (typeof parsed[name] === \"boolean\") {\n      flags[name] = parsed[name];\n    }\n  }\n  return flags;\n}\n\nfunction optionalString(value: unknown): string | undefined {\n  return value === undefined ? undefined : String(value);\n}\n\n/** The last value of a flag that may be given more than once. */\nfunction lastString(value: unknown): string | undefined {\n  return optionalString(Array.isArray(value) ? value.at(-1) : value);\n}\n\n/**\n * `--remote-ref-hosts a.example,b.example`, repeatable; an empty value allows no host. The\n * `remote-ref-hosts` setting of a `redocly.yaml` API is read the same way.\n */\nexport function hostList(value: unknown): string[] | undefined {\n  if (value === undefined) {\n    return undefined;\n  }\n  return [value]\n    .flat()\n    .flatMap((entry) => String(entry).split(\",\"))\n    .map((host) => host.trim())\n    .filter((host) => host !== \"\");\n}\n\nfunction refLimitsOf(parsed: parser.Arguments): CliRefLimits {\n  const localRefRoot = lastString(parsed.localRefRoot);\n  const remoteRefHosts = hostList(parsed.remoteRefHosts);\n  return {\n    ...(localRefRoot === undefined ? {} : { localRefRoot }),\n    ...(remoteRefHosts === undefined ? {} : { remoteRefHosts }),\n  };\n}\n\n/** String flags, in both spellings, so that a value such as `8080` is not read as a number. */\nconst STRING_FLAGS = [\n  \"output\",\n  \"redocly\",\n  \"fix\",\n  ...[\"localRefRoot\", \"remoteRefHosts\"].flatMap((flag) => [flag, kebabCase(flag)]),\n];\n\nconst ALIASES = { redocly: [\"c\"], exportType: [\"t\"], output: [\"o\"] };\n\n/** Every name yargs-parser can return for a flag this CLI reads. */\nconst KNOWN_FLAGS = new Set<string>([\n  ...BOOLEAN_FLAGS,\n  ...STRING_FLAGS,\n  ...Object.values(ALIASES).flat(),\n  \"version\",\n]);\n\n/**\n * Flags that no code reads. The original CLI ignored them silently, so a typo such as\n * `--alphabetise` gave other output with no hint; they still do not fail the run.\n */\nfunction unknownFlagsOf(parsed: parser.Arguments, argv: readonly string[]): string[] {\n  const names = Object.keys(parsed)\n    .filter((key) => key !== \"_\" && key !== \"--\" && !KNOWN_FLAGS.has(key))\n    .map((key) => writtenFlagName(key, argv));\n  return [...new Set(names)];\n}\n\n/** The flag as the user wrote it: yargs-parser reads `--no-x` as `x: false`. */\nfunction writtenFlagName(key: string, argv: readonly string[]): string {\n  if (key.length === 1) {\n    return `-${key}`;\n  }\n  const negated = `--no-${kebabCase(key)}`;\n  const isNegated = argv.some((arg) => arg === negated || arg.startsWith(`${negated}=`));\n  return isNegated ? negated : `--${kebabCase(key)}`;\n}\n\n/**\n * Parse the arguments after `node cli.js`. Fails with `CLI_FLAG_REMOVED` for an old flag and with\n * `OPTION_FIX_UNKNOWN` for an unknown `--fix` name.\n */\nexport function parseCliArguments(argv: readonly string[]): CliArguments {\n  rejectRemovedFlags(argv);\n  const parsed = parser([...argv], {\n    boolean: BOOLEAN_FLAGS,\n    string: STRING_FLAGS,\n    alias: ALIASES,\n  });\n  return {\n    input: optionalString(parsed._[0]),\n    output: optionalString(parsed.output),\n    redocly: optionalString(parsed.redocly),\n    isCheck: parsed.check === true,\n    isHelp: \"help\" in parsed,\n    isVersion: \"version\" in parsed,\n    generatorFlags: generatorFlagsOf(parsed),\n    refLimits: refLimitsOf(parsed),\n    fix: fixNamesOf(parsed.fix),\n    unknownFlags: unknownFlagsOf(parsed, argv),\n  };\n}\n"],"names":["kebabCase","cliError","parser","fixNamesOf"],"mappings":"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"}
+{"version":3,"file":"cli-arguments.cjs","sources":["../../src/cli/cli-arguments.ts"],"sourcesContent":["import { kebabCase } from \"scule\";\nimport parser from \"yargs-parser\";\nimport type { OutputFixName } from \"../domain/output-fixes.js\";\nimport { cliError } from \"./cli-errors.js\";\nimport {\n  ALIASES,\n  BOOLEAN_FLAGS,\n  GENERATOR_FLAGS,\n  type GeneratorFlag,\n  type GeneratorFlags,\n  KNOWN_FLAGS,\n  STRING_FLAGS,\n} from \"./cli-flag-names.js\";\nimport { MULTIPLE_SCHEMAS_DOCS_URL } from \"./docs-links.js\";\nimport { fixNamesOf } from \"./fix-option.js\";\nimport {\n  rejectInvalidBooleans,\n  rejectNegatedValueFlags,\n  rejectRemovedFlags,\n  unknownFlagNames,\n  writtenFlags,\n} from \"./written-flags.js\";\n\nexport { GENERATOR_FLAGS, type GeneratorFlag, type GeneratorFlags } from \"./cli-flag-names.js\";\n\n/** The CLI's arguments, parsed as the original CLI parsed them (yargs-parser). */\n\n/** The `$ref` limits as the user wrote them; unset flags are absent. */\nexport interface CliRefLimits {\n  readonly localRefRoot?: string;\n  readonly remoteRefHosts?: readonly string[];\n}\n\nexport interface CliArguments {\n  /** The schema path or URL; none means stdin, or the APIs of the Redocly config. */\n  readonly input: string | undefined;\n  readonly output: string | undefined;\n  readonly redocly: string | undefined;\n  readonly isCheck: boolean;\n  readonly isHelp: boolean;\n  readonly isVersion: boolean;\n  readonly generatorFlags: GeneratorFlags;\n  readonly refLimits: CliRefLimits;\n  /** `--fix`, comma-separated and repeatable (ADR-021); unset when the flag is not given. */\n  readonly fix: readonly OutputFixName[] | undefined;\n  /** Flags the CLI does not know, as written on the command line (`--bogus`, `-x`). */\n  readonly unknownFlags: readonly string[];\n}\n\n/** Flags that only work together with `--root-types`. */\nconst ROOT_TYPES_FLAGS = [\"rootTypesNoSchemaPrefix\", \"rootTypesKeepCasing\"] as const;\n\n/** Notices for flags that have no effect in this combination, printed before the run. */\nexport function ineffectiveFlagNotices(flags: GeneratorFlags): string[] {\n  if (flags.rootTypes === true) {\n    return [];\n  }\n  return ROOT_TYPES_FLAGS.filter((flag) => flags[flag] === true).map(\n    (flag) => `--${kebabCase(flag)} has no effect without --root-types flag`,\n  );\n}\n\nfunction generatorFlagsOf(parsed: parser.Arguments): GeneratorFlags {\n  const flags: Partial<Record<GeneratorFlag, boolean>> = {};\n  for (const name of GENERATOR_FLAGS) {\n    if (typeof parsed[name] === \"boolean\") {\n      flags[name] = parsed[name];\n    }\n  }\n  return flags;\n}\n\nfunction optionalString(value: unknown): string | undefined {\n  return value === undefined ? undefined : String(value);\n}\n\n/**\n * The last value of a flag that takes one value: given twice, the last one wins, as for the\n * boolean flags (yargs-parser gives a list of every value).\n */\nfunction lastString(value: unknown): string | undefined {\n  return optionalString(Array.isArray(value) ? value.at(-1) : value);\n}\n\n/**\n * `--remote-ref-hosts a.example,b.example`, repeatable; an empty value allows no host. The\n * `remote-ref-hosts` setting of a `redocly.yaml` API is read the same way.\n */\nexport function hostList(value: unknown): string[] | undefined {\n  if (value === undefined) {\n    return undefined;\n  }\n  return [value]\n    .flat()\n    .flatMap((entry) => String(entry).split(\",\"))\n    .map((host) => host.trim())\n    .filter((host) => host !== \"\");\n}\n\nfunction refLimitsOf(parsed: parser.Arguments): CliRefLimits {\n  const localRefRoot = lastString(parsed.localRefRoot);\n  const remoteRefHosts = hostList(parsed.remoteRefHosts);\n  return {\n    ...(localRefRoot === undefined ? {} : { localRefRoot }),\n    ...(remoteRefHosts === undefined ? {} : { remoteRefHosts }),\n  };\n}\n\n/**\n * Flags that no code reads. The original CLI ignored them silently, so a typo such as\n * `--alphabetise` gave other output with no hint; they still do not fail the run.\n */\nfunction unknownFlagsOf(parsed: parser.Arguments, argv: readonly string[]): string[] {\n  const names = Object.keys(parsed)\n    .filter((key) => key !== \"_\" && key !== \"--\" && !KNOWN_FLAGS.has(key))\n    .map((key) => writtenFlagName(key, argv));\n  return [...new Set(names)];\n}\n\n/** The flag as the user wrote it: yargs-parser reads `--no-x` as `x: false`. */\nfunction writtenFlagName(key: string, argv: readonly string[]): string {\n  if (key.length === 1) {\n    return `-${key}`;\n  }\n  const negated = `--no-${kebabCase(key)}`;\n  const isNegated = argv.some((arg) => arg === negated || arg.startsWith(`${negated}=`));\n  return isNegated ? negated : `--${kebabCase(key)}`;\n}\n\n/**\n * The one schema argument. More than one fails with `CLI_INPUT_EXTRA`: the original CLI read the\n * first and dropped the rest, so a glob the shell expanded (`g/*.yaml`) generated one schema.\n */\nfunction inputOf(positionals: readonly (string | number)[]): string | undefined {\n  if (positionals.length > 1) {\n    throw cliError(\n      \"CLI_INPUT_EXTRA\",\n      `Only one schema argument is allowed, but ${positionals.length} were given: ` +\n        `${positionals.join(\" \")}. A shell expands an unquoted *; to generate several ` +\n        `schemas, list them under \\`apis\\` in redocly.yaml. See ${MULTIPLE_SCHEMAS_DOCS_URL}`,\n    );\n  }\n  return optionalString(positionals[0]);\n}\n\n/**\n * Parse the arguments after `node cli.js`. Fails with `CLI_FLAG_REMOVED` for an old flag, with\n * `CLI_FLAG_INVALID` for a boolean flag with another value than true or false or a `--no-` form\n * of a flag that takes a value, with `CLI_INPUT_EXTRA` for a second schema argument, and with\n * `OPTION_FIX_UNKNOWN` for an unknown `--fix` name.\n */\nexport function parseCliArguments(argv: readonly string[]): CliArguments {\n  const flags = writtenFlags(argv);\n  rejectRemovedFlags(flags);\n  rejectInvalidBooleans(flags);\n  rejectNegatedValueFlags(flags);\n  const parsed = parser([...argv], {\n    boolean: [...BOOLEAN_FLAGS, ...unknownFlagNames(flags)],\n    string: STRING_FLAGS,\n    alias: ALIASES,\n    // A schema path is a file name: `1.10` is not the number 1.1.\n    configuration: { \"parse-positional-numbers\": false },\n  });\n  return {\n    input: inputOf(parsed._),\n    output: lastString(parsed.output),\n    redocly: lastString(parsed.redocly),\n    isCheck: parsed.check === true,\n    isHelp: \"help\" in parsed,\n    isVersion: \"version\" in parsed,\n    generatorFlags: generatorFlagsOf(parsed),\n    refLimits: refLimitsOf(parsed),\n    fix: fixNamesOf(parsed.fix),\n    unknownFlags: unknownFlagsOf(parsed, argv),\n  };\n}\n"],"names":["kebabCase","GENERATOR_FLAGS","KNOWN_FLAGS","cliError","MULTIPLE_SCHEMAS_DOCS_URL","writtenFlags","rejectRemovedFlags","rejectInvalidBooleans","rejectNegatedValueFlags","parser","BOOLEAN_FLAGS","unknownFlagNames","STRING_FLAGS","ALIASES","fixNamesOf"],"mappings":"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"}

package/dist/cli/cli-arguments.mjs

@@ -1,61 +1,18 @@
 import { kebabCase } from 'scule';
 import parser from 'yargs-parser';
 import { cliError } from './cli-errors.mjs';
+import { ALIASES, STRING_FLAGS, BOOLEAN_FLAGS, KNOWN_FLAGS, GENERATOR_FLAGS } from './cli-flag-names.mjs';
+import { MULTIPLE_SCHEMAS_DOCS_URL } from './docs-links.mjs';
 import { fixNamesOf } from './fix-option.mjs';
+import { writtenFlags, rejectRemovedFlags, rejectInvalidBooleans, rejectNegatedValueFlags, unknownFlagNames } from './written-flags.mjs';
 
-const GENERATOR_FLAGS = [
-  "additionalProperties",
-  "alphabetize",
-  "arrayLength",
-  "binaryAsBlob",
-  "conditionalEnums",
-  "dedupeEnums",
-  "defaultNonNullable",
-  "emptyObjectsUnknown",
-  "enum",
-  "enumValues",
-  "excludeDeprecated",
-  "exportType",
-  "generatePathParams",
-  "immutable",
-  "lint",
-  "makePathsEnum",
-  "pathParamsAsTypes",
-  "propertiesRequiredByDefault",
-  "readWriteMarkers",
-  "rootTypes",
-  "rootTypesKeepCasing",
-  "rootTypesNoSchemaPrefix"
-];
-const CAMEL_CASE_BOOLEAN_FLAGS = [...GENERATOR_FLAGS, "check", "contentNever", "help"];
-const BOOLEAN_FLAGS = [
-  ...CAMEL_CASE_BOOLEAN_FLAGS,
-  ...CAMEL_CASE_BOOLEAN_FLAGS.map((flag) => kebabCase(flag))
-];
-const REMOVED_FLAGS = [
-  ["-ap", `The -ap alias has been deprecated. Use "--additional-properties" instead.`],
-  ["--immutable-types", `The --immutable-types flag has been renamed to "--immutable".`],
-  [
-    "--support-array-length",
-    `The --support-array-length flag has been renamed to "--array-length".`
-  ],
-  ["-it", `The -it alias has been deprecated. Use "--immutable" instead.`],
-  ["--redoc", `The --redoc config flag has been renamed to "--redocly" (or -c as shorthand).`]
-];
-const ROOT_TYPES_FLAGS = ["--root-types-no-schema-prefix", "--root-types-keep-casing"];
-function rejectRemovedFlags(argv) {
-  for (const [flag, message] of REMOVED_FLAGS) {
-    if (argv.includes(flag)) {
-      throw cliError("CLI_FLAG_REMOVED", message);
-    }
-  }
-}
-function ineffectiveFlagNotices(argv) {
-  if (argv.includes("--root-types")) {
+const ROOT_TYPES_FLAGS = ["rootTypesNoSchemaPrefix", "rootTypesKeepCasing"];
+function ineffectiveFlagNotices(flags) {
+  if (flags.rootTypes === true) {
     return [];
   }
-  return ROOT_TYPES_FLAGS.filter((flag) => argv.includes(flag)).map(
-    (flag) => `${flag} has no effect without --root-types flag`
+  return ROOT_TYPES_FLAGS.filter((flag) => flags[flag] === true).map(
+    (flag) => `--${kebabCase(flag)} has no effect without --root-types flag`
   );
 }
 function generatorFlagsOf(parsed) {
@@ -87,19 +44,6 @@ function refLimitsOf(parsed) {
     ...remoteRefHosts === void 0 ? {} : { remoteRefHosts }
   };
 }
-const STRING_FLAGS = [
-  "output",
-  "redocly",
-  "fix",
-  ...["localRefRoot", "remoteRefHosts"].flatMap((flag) => [flag, kebabCase(flag)])
-];
-const ALIASES = { redocly: ["c"], exportType: ["t"], output: ["o"] };
-const KNOWN_FLAGS = /* @__PURE__ */ new Set([
-  ...BOOLEAN_FLAGS,
-  ...STRING_FLAGS,
-  ...Object.values(ALIASES).flat(),
-  "version"
-]);
 function unknownFlagsOf(parsed, argv) {
   const names = Object.keys(parsed).filter((key) => key !== "_" && key !== "--" && !KNOWN_FLAGS.has(key)).map((key) => writtenFlagName(key, argv));
   return [...new Set(names)];
@@ -112,17 +56,31 @@ function writtenFlagName(key, argv) {
   const isNegated = argv.some((arg) => arg === negated || arg.startsWith(`${negated}=`));
   return isNegated ? negated : `--${kebabCase(key)}`;
 }
+function inputOf(positionals) {
+  if (positionals.length > 1) {
+    throw cliError(
+      "CLI_INPUT_EXTRA",
+      `Only one schema argument is allowed, but ${positionals.length} were given: ${positionals.join(" ")}. A shell expands an unquoted *; to generate several schemas, list them under \`apis\` in redocly.yaml. See ${MULTIPLE_SCHEMAS_DOCS_URL}`
+    );
+  }
+  return optionalString(positionals[0]);
+}
 function parseCliArguments(argv) {
-  rejectRemovedFlags(argv);
+  const flags = writtenFlags(argv);
+  rejectRemovedFlags(flags);
+  rejectInvalidBooleans(flags);
+  rejectNegatedValueFlags(flags);
   const parsed = parser([...argv], {
-    boolean: BOOLEAN_FLAGS,
+    boolean: [...BOOLEAN_FLAGS, ...unknownFlagNames(flags)],
     string: STRING_FLAGS,
-    alias: ALIASES
+    alias: ALIASES,
+    // A schema path is a file name: `1.10` is not the number 1.1.
+    configuration: { "parse-positional-numbers": false }
   });
   return {
-    input: optionalString(parsed._[0]),
-    output: optionalString(parsed.output),
-    redocly: optionalString(parsed.redocly),
+    input: inputOf(parsed._),
+    output: lastString(parsed.output),
+    redocly: lastString(parsed.redocly),
     isCheck: parsed.check === true,
     isHelp: "help" in parsed,
     isVersion: "version" in parsed,

package/dist/cli/cli-arguments.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli-arguments.mjs","sources":["../../src/cli/cli-arguments.ts"],"sourcesContent":["import { kebabCase } from \"scule\";\nimport parser from \"yargs-parser\";\nimport type { OutputFixName } from \"../domain/output-fixes.js\";\nimport { cliError } from \"./cli-errors.js\";\nimport { fixNamesOf } from \"./fix-option.js\";\n\n/** The CLI's arguments, parsed as the original CLI parsed them (yargs-parser). */\n\n/** Boolean flags that become generator options (camelCase; yargs also accepts kebab-case). */\nexport const GENERATOR_FLAGS = [\n  \"additionalProperties\",\n  \"alphabetize\",\n  \"arrayLength\",\n  \"binaryAsBlob\",\n  \"conditionalEnums\",\n  \"dedupeEnums\",\n  \"defaultNonNullable\",\n  \"emptyObjectsUnknown\",\n  \"enum\",\n  \"enumValues\",\n  \"excludeDeprecated\",\n  \"exportType\",\n  \"generatePathParams\",\n  \"immutable\",\n  \"lint\",\n  \"makePathsEnum\",\n  \"pathParamsAsTypes\",\n  \"propertiesRequiredByDefault\",\n  \"readWriteMarkers\",\n  \"rootTypes\",\n  \"rootTypesKeepCasing\",\n  \"rootTypesNoSchemaPrefix\",\n] as const;\n\nexport type GeneratorFlag = (typeof GENERATOR_FLAGS)[number];\n\nexport type GeneratorFlags = Readonly<Partial<Record<GeneratorFlag, boolean>>>;\n\n// `contentNever` was a boolean flag of the original CLI that no code reads; it stays in the list\n// so that `--content-never <input>` keeps parsing as a flag and an input.\nconst CAMEL_CASE_BOOLEAN_FLAGS = [...GENERATOR_FLAGS, \"check\", \"contentNever\", \"help\"];\n\n// yargs-parser matches the `boolean` list by the exact spelling of the flag: with camelCase names\n// only, `--root-types schema.yaml` took the path as the flag's value (upstream #2523). Both\n// spellings are listed.\nconst BOOLEAN_FLAGS = [\n  ...CAMEL_CASE_BOOLEAN_FLAGS,\n  ...CAMEL_CASE_BOOLEAN_FLAGS.map((flag) => kebabCase(flag)),\n];\n\n/** The `$ref` limits as the user wrote them; unset flags are absent. */\nexport interface CliRefLimits {\n  readonly localRefRoot?: string;\n  readonly remoteRefHosts?: readonly string[];\n}\n\nexport interface CliArguments {\n  /** The schema path or URL; none means stdin, or the APIs of the Redocly config. */\n  readonly input: string | undefined;\n  readonly output: string | undefined;\n  readonly redocly: string | undefined;\n  readonly isCheck: boolean;\n  readonly isHelp: boolean;\n  readonly isVersion: boolean;\n  readonly generatorFlags: GeneratorFlags;\n  readonly refLimits: CliRefLimits;\n  /** `--fix`, comma-separated and repeatable (ADR-021); unset when the flag is not given. */\n  readonly fix: readonly OutputFixName[] | undefined;\n  /** Flags the CLI does not know, as written on the command line (`--bogus`, `-x`). */\n  readonly unknownFlags: readonly string[];\n}\n\n/** Flags of older versions that were removed or renamed, with the message for each. */\nconst REMOVED_FLAGS: readonly (readonly [string, string])[] = [\n  [\"-ap\", `The -ap alias has been deprecated. Use \"--additional-properties\" instead.`],\n  [\"--immutable-types\", `The --immutable-types flag has been renamed to \"--immutable\".`],\n  [\n    \"--support-array-length\",\n    `The --support-array-length flag has been renamed to \"--array-length\".`,\n  ],\n  [\"-it\", `The -it alias has been deprecated. Use \"--immutable\" instead.`],\n  [\"--redoc\", `The --redoc config flag has been renamed to \"--redocly\" (or -c as shorthand).`],\n];\n\n/** Flags that only work together with `--root-types`. */\nconst ROOT_TYPES_FLAGS = [\"--root-types-no-schema-prefix\", \"--root-types-keep-casing\"] as const;\n\nfunction rejectRemovedFlags(argv: readonly string[]): void {\n  for (const [flag, message] of REMOVED_FLAGS) {\n    if (argv.includes(flag)) {\n      throw cliError(\"CLI_FLAG_REMOVED\", message);\n    }\n  }\n}\n\n/** Notices for flags that have no effect in this combination, printed before the run. */\nexport function ineffectiveFlagNotices(argv: readonly string[]): string[] {\n  if (argv.includes(\"--root-types\")) {\n    return [];\n  }\n  return ROOT_TYPES_FLAGS.filter((flag) => argv.includes(flag)).map(\n    (flag) => `${flag} has no effect without --root-types flag`,\n  );\n}\n\nfunction generatorFlagsOf(parsed: parser.Arguments): GeneratorFlags {\n  const flags: Partial<Record<GeneratorFlag, boolean>> = {};\n  for (const name of GENERATOR_FLAGS) {\n    if (typeof parsed[name] === \"boolean\") {\n      flags[name] = parsed[name];\n    }\n  }\n  return flags;\n}\n\nfunction optionalString(value: unknown): string | undefined {\n  return value === undefined ? undefined : String(value);\n}\n\n/** The last value of a flag that may be given more than once. */\nfunction lastString(value: unknown): string | undefined {\n  return optionalString(Array.isArray(value) ? value.at(-1) : value);\n}\n\n/**\n * `--remote-ref-hosts a.example,b.example`, repeatable; an empty value allows no host. The\n * `remote-ref-hosts` setting of a `redocly.yaml` API is read the same way.\n */\nexport function hostList(value: unknown): string[] | undefined {\n  if (value === undefined) {\n    return undefined;\n  }\n  return [value]\n    .flat()\n    .flatMap((entry) => String(entry).split(\",\"))\n    .map((host) => host.trim())\n    .filter((host) => host !== \"\");\n}\n\nfunction refLimitsOf(parsed: parser.Arguments): CliRefLimits {\n  const localRefRoot = lastString(parsed.localRefRoot);\n  const remoteRefHosts = hostList(parsed.remoteRefHosts);\n  return {\n    ...(localRefRoot === undefined ? {} : { localRefRoot }),\n    ...(remoteRefHosts === undefined ? {} : { remoteRefHosts }),\n  };\n}\n\n/** String flags, in both spellings, so that a value such as `8080` is not read as a number. */\nconst STRING_FLAGS = [\n  \"output\",\n  \"redocly\",\n  \"fix\",\n  ...[\"localRefRoot\", \"remoteRefHosts\"].flatMap((flag) => [flag, kebabCase(flag)]),\n];\n\nconst ALIASES = { redocly: [\"c\"], exportType: [\"t\"], output: [\"o\"] };\n\n/** Every name yargs-parser can return for a flag this CLI reads. */\nconst KNOWN_FLAGS = new Set<string>([\n  ...BOOLEAN_FLAGS,\n  ...STRING_FLAGS,\n  ...Object.values(ALIASES).flat(),\n  \"version\",\n]);\n\n/**\n * Flags that no code reads. The original CLI ignored them silently, so a typo such as\n * `--alphabetise` gave other output with no hint; they still do not fail the run.\n */\nfunction unknownFlagsOf(parsed: parser.Arguments, argv: readonly string[]): string[] {\n  const names = Object.keys(parsed)\n    .filter((key) => key !== \"_\" && key !== \"--\" && !KNOWN_FLAGS.has(key))\n    .map((key) => writtenFlagName(key, argv));\n  return [...new Set(names)];\n}\n\n/** The flag as the user wrote it: yargs-parser reads `--no-x` as `x: false`. */\nfunction writtenFlagName(key: string, argv: readonly string[]): string {\n  if (key.length === 1) {\n    return `-${key}`;\n  }\n  const negated = `--no-${kebabCase(key)}`;\n  const isNegated = argv.some((arg) => arg === negated || arg.startsWith(`${negated}=`));\n  return isNegated ? negated : `--${kebabCase(key)}`;\n}\n\n/**\n * Parse the arguments after `node cli.js`. Fails with `CLI_FLAG_REMOVED` for an old flag and with\n * `OPTION_FIX_UNKNOWN` for an unknown `--fix` name.\n */\nexport function parseCliArguments(argv: readonly string[]): CliArguments {\n  rejectRemovedFlags(argv);\n  const parsed = parser([...argv], {\n    boolean: BOOLEAN_FLAGS,\n    string: STRING_FLAGS,\n    alias: ALIASES,\n  });\n  return {\n    input: optionalString(parsed._[0]),\n    output: optionalString(parsed.output),\n    redocly: optionalString(parsed.redocly),\n    isCheck: parsed.check === true,\n    isHelp: \"help\" in parsed,\n    isVersion: \"version\" in parsed,\n    generatorFlags: generatorFlagsOf(parsed),\n    refLimits: refLimitsOf(parsed),\n    fix: fixNamesOf(parsed.fix),\n    unknownFlags: unknownFlagsOf(parsed, argv),\n  };\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli-arguments.mjs","sources":["../../src/cli/cli-arguments.ts"],"sourcesContent":["import { kebabCase } from \"scule\";\nimport parser from \"yargs-parser\";\nimport type { OutputFixName } from \"../domain/output-fixes.js\";\nimport { cliError } from \"./cli-errors.js\";\nimport {\n  ALIASES,\n  BOOLEAN_FLAGS,\n  GENERATOR_FLAGS,\n  type GeneratorFlag,\n  type GeneratorFlags,\n  KNOWN_FLAGS,\n  STRING_FLAGS,\n} from \"./cli-flag-names.js\";\nimport { MULTIPLE_SCHEMAS_DOCS_URL } from \"./docs-links.js\";\nimport { fixNamesOf } from \"./fix-option.js\";\nimport {\n  rejectInvalidBooleans,\n  rejectNegatedValueFlags,\n  rejectRemovedFlags,\n  unknownFlagNames,\n  writtenFlags,\n} from \"./written-flags.js\";\n\nexport { GENERATOR_FLAGS, type GeneratorFlag, type GeneratorFlags } from \"./cli-flag-names.js\";\n\n/** The CLI's arguments, parsed as the original CLI parsed them (yargs-parser). */\n\n/** The `$ref` limits as the user wrote them; unset flags are absent. */\nexport interface CliRefLimits {\n  readonly localRefRoot?: string;\n  readonly remoteRefHosts?: readonly string[];\n}\n\nexport interface CliArguments {\n  /** The schema path or URL; none means stdin, or the APIs of the Redocly config. */\n  readonly input: string | undefined;\n  readonly output: string | undefined;\n  readonly redocly: string | undefined;\n  readonly isCheck: boolean;\n  readonly isHelp: boolean;\n  readonly isVersion: boolean;\n  readonly generatorFlags: GeneratorFlags;\n  readonly refLimits: CliRefLimits;\n  /** `--fix`, comma-separated and repeatable (ADR-021); unset when the flag is not given. */\n  readonly fix: readonly OutputFixName[] | undefined;\n  /** Flags the CLI does not know, as written on the command line (`--bogus`, `-x`). */\n  readonly unknownFlags: readonly string[];\n}\n\n/** Flags that only work together with `--root-types`. */\nconst ROOT_TYPES_FLAGS = [\"rootTypesNoSchemaPrefix\", \"rootTypesKeepCasing\"] as const;\n\n/** Notices for flags that have no effect in this combination, printed before the run. */\nexport function ineffectiveFlagNotices(flags: GeneratorFlags): string[] {\n  if (flags.rootTypes === true) {\n    return [];\n  }\n  return ROOT_TYPES_FLAGS.filter((flag) => flags[flag] === true).map(\n    (flag) => `--${kebabCase(flag)} has no effect without --root-types flag`,\n  );\n}\n\nfunction generatorFlagsOf(parsed: parser.Arguments): GeneratorFlags {\n  const flags: Partial<Record<GeneratorFlag, boolean>> = {};\n  for (const name of GENERATOR_FLAGS) {\n    if (typeof parsed[name] === \"boolean\") {\n      flags[name] = parsed[name];\n    }\n  }\n  return flags;\n}\n\nfunction optionalString(value: unknown): string | undefined {\n  return value === undefined ? undefined : String(value);\n}\n\n/**\n * The last value of a flag that takes one value: given twice, the last one wins, as for the\n * boolean flags (yargs-parser gives a list of every value).\n */\nfunction lastString(value: unknown): string | undefined {\n  return optionalString(Array.isArray(value) ? value.at(-1) : value);\n}\n\n/**\n * `--remote-ref-hosts a.example,b.example`, repeatable; an empty value allows no host. The\n * `remote-ref-hosts` setting of a `redocly.yaml` API is read the same way.\n */\nexport function hostList(value: unknown): string[] | undefined {\n  if (value === undefined) {\n    return undefined;\n  }\n  return [value]\n    .flat()\n    .flatMap((entry) => String(entry).split(\",\"))\n    .map((host) => host.trim())\n    .filter((host) => host !== \"\");\n}\n\nfunction refLimitsOf(parsed: parser.Arguments): CliRefLimits {\n  const localRefRoot = lastString(parsed.localRefRoot);\n  const remoteRefHosts = hostList(parsed.remoteRefHosts);\n  return {\n    ...(localRefRoot === undefined ? {} : { localRefRoot }),\n    ...(remoteRefHosts === undefined ? {} : { remoteRefHosts }),\n  };\n}\n\n/**\n * Flags that no code reads. The original CLI ignored them silently, so a typo such as\n * `--alphabetise` gave other output with no hint; they still do not fail the run.\n */\nfunction unknownFlagsOf(parsed: parser.Arguments, argv: readonly string[]): string[] {\n  const names = Object.keys(parsed)\n    .filter((key) => key !== \"_\" && key !== \"--\" && !KNOWN_FLAGS.has(key))\n    .map((key) => writtenFlagName(key, argv));\n  return [...new Set(names)];\n}\n\n/** The flag as the user wrote it: yargs-parser reads `--no-x` as `x: false`. */\nfunction writtenFlagName(key: string, argv: readonly string[]): string {\n  if (key.length === 1) {\n    return `-${key}`;\n  }\n  const negated = `--no-${kebabCase(key)}`;\n  const isNegated = argv.some((arg) => arg === negated || arg.startsWith(`${negated}=`));\n  return isNegated ? negated : `--${kebabCase(key)}`;\n}\n\n/**\n * The one schema argument. More than one fails with `CLI_INPUT_EXTRA`: the original CLI read the\n * first and dropped the rest, so a glob the shell expanded (`g/*.yaml`) generated one schema.\n */\nfunction inputOf(positionals: readonly (string | number)[]): string | undefined {\n  if (positionals.length > 1) {\n    throw cliError(\n      \"CLI_INPUT_EXTRA\",\n      `Only one schema argument is allowed, but ${positionals.length} were given: ` +\n        `${positionals.join(\" \")}. A shell expands an unquoted *; to generate several ` +\n        `schemas, list them under \\`apis\\` in redocly.yaml. See ${MULTIPLE_SCHEMAS_DOCS_URL}`,\n    );\n  }\n  return optionalString(positionals[0]);\n}\n\n/**\n * Parse the arguments after `node cli.js`. Fails with `CLI_FLAG_REMOVED` for an old flag, with\n * `CLI_FLAG_INVALID` for a boolean flag with another value than true or false or a `--no-` form\n * of a flag that takes a value, with `CLI_INPUT_EXTRA` for a second schema argument, and with\n * `OPTION_FIX_UNKNOWN` for an unknown `--fix` name.\n */\nexport function parseCliArguments(argv: readonly string[]): CliArguments {\n  const flags = writtenFlags(argv);\n  rejectRemovedFlags(flags);\n  rejectInvalidBooleans(flags);\n  rejectNegatedValueFlags(flags);\n  const parsed = parser([...argv], {\n    boolean: [...BOOLEAN_FLAGS, ...unknownFlagNames(flags)],\n    string: STRING_FLAGS,\n    alias: ALIASES,\n    // A schema path is a file name: `1.10` is not the number 1.1.\n    configuration: { \"parse-positional-numbers\": false },\n  });\n  return {\n    input: inputOf(parsed._),\n    output: lastString(parsed.output),\n    redocly: lastString(parsed.redocly),\n    isCheck: parsed.check === true,\n    isHelp: \"help\" in parsed,\n    isVersion: \"version\" in parsed,\n    generatorFlags: generatorFlagsOf(parsed),\n    refLimits: refLimitsOf(parsed),\n    fix: fixNamesOf(parsed.fix),\n    unknownFlags: unknownFlagsOf(parsed, argv),\n  };\n}\n"],"names":[],"mappings":"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"}

package/dist/cli/cli-errors.cjs

@@ -57,14 +57,17 @@ const CLI_ERROR_REPORTS = {
   ENUM_NAME_EMPTY: { exitCode: EXIT_CODES.SCHEMA },
   CALLBACK_RESULT_UNREADABLE: { exitCode: EXIT_CODES.USAGE },
   OPTION_FIX_UNKNOWN: { exitCode: EXIT_CODES.USAGE },
+  OPTION_INVALID: { exitCode: EXIT_CODES.USAGE },
   TYPESCRIPT_NOT_FOUND: { exitCode: EXIT_CODES.USAGE },
   CLI_FLAG_REMOVED: { exitCode: EXIT_CODES.USAGE },
+  CLI_FLAG_INVALID: { exitCode: EXIT_CODES.USAGE },
   CLI_GLOB_UNSUPPORTED: { exitCode: EXIT_CODES.USAGE },
   CLI_CONFIG_NOT_FOUND: { exitCode: EXIT_CODES.USAGE },
   CLI_CONFIG_INVALID: { exitCode: EXIT_CODES.USAGE },
   CLI_CONFIG_OUTPUT_MISSING: { exitCode: EXIT_CODES.USAGE },
   CLI_CHECK_OUTPUT_MISSING: { exitCode: EXIT_CODES.USAGE },
   CLI_INPUT_MISSING: { exitCode: EXIT_CODES.USAGE },
+  CLI_INPUT_EXTRA: { exitCode: EXIT_CODES.USAGE },
   CLI_OUTPUT_IS_INPUT: { exitCode: EXIT_CODES.USAGE },
   CLI_OUTPUT_DUPLICATE: { exitCode: EXIT_CODES.USAGE },
   CLI_OUTPUT_INVALID: { exitCode: EXIT_CODES.USAGE },
@@ -74,6 +77,10 @@ const CLI_ERROR_REPORTS = {
   OUTPUT_WRITE_FAILED: { exitCode: EXIT_CODES.OUTPUT }
 };
 function describeCliFailure(error) {
+  if (error instanceof ApiFailure) {
+    const failure = describeCliFailure(error.cause);
+    return { ...failure, message: `API ${error.apiName}: ${failure.message}` };
+  }
   if (!errors.isOpenAPITypesafeError(error)) {
     const text = error instanceof Error ? error.stack ?? error.message : String(error);
     return { exitCode: EXIT_CODES.INTERNAL, message: `Unexpected error: ${text}` };
@@ -82,10 +89,21 @@ function describeCliFailure(error) {
   const message = report.message?.(error) ?? error.message;
   return { exitCode: report.exitCode, message: `${message} (${error.code})` };
 }
+class ApiFailure extends Error {
+  name = "ApiFailure";
+  cause;
+  apiName;
+  constructor(apiName, cause) {
+    super(`API ${apiName} failed`, { cause });
+    this.apiName = apiName;
+    this.cause = cause;
+  }
+}
 function cliError(code, message, cause) {
   return new errors.OpenAPITypesafeError({ code: errors.ERROR_CODES[code], message, cause });
 }
 
+exports.ApiFailure = ApiFailure;
 exports.EXIT_CODES = EXIT_CODES;
 exports.cliError = cliError;
 exports.describeCliFailure = describeCliFailure;

package/dist/cli/cli-errors.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli-errors.cjs","sources":["../../src/cli/cli-errors.ts"],"sourcesContent":["import {\n  ERROR_CODES,\n  type ErrorCode,\n  isOpenAPITypesafeError,\n  OpenAPITypesafeError,\n} from \"../domain/errors.js\";\n\n/**\n * How the CLI reports a failure (ENGINEERING_PLAN 4.6, ADR-011): each error code maps to a process\n * exit code and the line printed for it. The table is exhaustive, so a new error code does not\n * compile until the CLI handles it.\n */\n\n/** Process exit codes of the CLI, documented in docs/cli.md. */\nexport const EXIT_CODES = {\n  SUCCESS: 0,\n  /** `--check` found output that differs from the generated types (as in the original CLI). */\n  OUTPUT_STALE: 1,\n  /** A flag, the Redocly config, the environment or a callback is wrong. */\n  USAGE: 2,\n  /** The OpenAPI document cannot be read, is invalid, or cannot be converted. */\n  SCHEMA: 3,\n  /** An output file cannot be read or written. */\n  OUTPUT: 4,\n  /** An unexpected failure: a bug in the generator (sysexits `EX_SOFTWARE`). */\n  INTERNAL: 70,\n} as const;\n\nexport type ExitCode = (typeof EXIT_CODES)[keyof typeof EXIT_CODES];\n\ninterface CliErrorReport {\n  readonly exitCode: ExitCode;\n  /** The printed text; the error's own message when absent. */\n  readonly message?: (error: OpenAPITypesafeError) => string;\n}\n\n/** Problems are printed one by one while linting, so the summary only counts them. */\nfunction schemaInvalidMessage(error: OpenAPITypesafeError): string {\n  const count = Array.isArray(error.details.problems) ? error.details.problems.length : 1;\n  return `The OpenAPI document has ${count} ${count === 1 ? \"error\" : \"errors\"} (see above)`;\n}\n\n/**\n * Node's `fetch` fails with only \"fetch failed\"; the network reason (refused, DNS, TLS) is the\n * cause of that error. The Node API keeps the original message, so only the CLI adds it.\n */\nfunction loadFailedMessage(error: OpenAPITypesafeError): string {\n  const reason = error.cause instanceof Error ? error.cause.cause : undefined;\n  if (!(reason instanceof Error)) {\n    return error.message;\n  }\n  // `loadFailedError`, the only source of this code, always sets the source.\n  return `${error.message}: ${reason.message} (${String(error.details.source)})`;\n}\n\n/** The message js-yaml throws at its nesting limit (docs/security/threat-model.md T2). */\nconst YAML_DEPTH_LIMIT_MESSAGE = /nesting exceeded maxDepth \\((\\d+)\\)/;\n\n/** The parser's message says the limit, not how to stay under it. */\nfunction parseFailedMessage(error: OpenAPITypesafeError): string {\n  const limit = YAML_DEPTH_LIMIT_MESSAGE.exec(error.message)?.[1];\n  if (limit === undefined) {\n    return error.message;\n  }\n  return (\n    `${error.message}. The YAML parser reads at most ${limit} nested levels: ` +\n    \"move nested schemas to `components` and reference them with `$ref`\"\n  );\n}\n\n/**\n * Text piped into stdin that is only a YAML string (`echo api.yaml | openapi-typesafe`) gets the\n * CLI's advice, not the Node API's (`openapiTS(pathToFileURL(path))`).\n */\nfunction sourceInvalidMessage(error: OpenAPITypesafeError): string {\n  const { received, text } = error.details;\n  if (received !== \"stream\" || typeof text !== \"string\") {\n    return error.message;\n  }\n  return (\n    `stdin held only the YAML string \"${text}\", not an OpenAPI document. To read a file, pass ` +\n    \"its path or URL as the first argument: openapi-typesafe ./openapi.yaml -o ./schema.ts\"\n  );\n}\n\nconst CLI_ERROR_REPORTS: Readonly<Record<ErrorCode, CliErrorReport>> = {\n  SCHEMA_SOURCE_EMPTY: { exitCode: EXIT_CODES.SCHEMA },\n  SCHEMA_SOURCE_INVALID: { exitCode: EXIT_CODES.SCHEMA, message: sourceInvalidMessage },\n  SCHEMA_LOAD_FAILED: { exitCode: EXIT_CODES.SCHEMA, message: loadFailedMessage },\n  SCHEMA_PARSE_FAILED: { exitCode: EXIT_CODES.SCHEMA, message: parseFailedMessage },\n  SCHEMA_VERSION_UNSUPPORTED: { exitCode: EXIT_CODES.SCHEMA },\n  SCHEMA_INVALID: { exitCode: EXIT_CODES.SCHEMA, message: schemaInvalidMessage },\n  SCHEMA_REF_INVALID: { exitCode: EXIT_CODES.SCHEMA },\n  SCHEMA_REF_FORBIDDEN: { exitCode: EXIT_CODES.SCHEMA },\n  SCHEMA_OBJECT_INVALID: { exitCode: EXIT_CODES.SCHEMA },\n  SCHEMA_PROPERTY_INVALID: { exitCode: EXIT_CODES.SCHEMA },\n  SCHEMA_TOO_DEEP: { exitCode: EXIT_CODES.SCHEMA },\n  SCHEMA_KEY_UNSUPPORTED: { exitCode: EXIT_CODES.SCHEMA },\n  ENUM_NAME_EMPTY: { exitCode: EXIT_CODES.SCHEMA },\n  CALLBACK_RESULT_UNREADABLE: { exitCode: EXIT_CODES.USAGE },\n  OPTION_FIX_UNKNOWN: { exitCode: EXIT_CODES.USAGE },\n  TYPESCRIPT_NOT_FOUND: { exitCode: EXIT_CODES.USAGE },\n  CLI_FLAG_REMOVED: { exitCode: EXIT_CODES.USAGE },\n  CLI_GLOB_UNSUPPORTED: { exitCode: EXIT_CODES.USAGE },\n  CLI_CONFIG_NOT_FOUND: { exitCode: EXIT_CODES.USAGE },\n  CLI_CONFIG_INVALID: { exitCode: EXIT_CODES.USAGE },\n  CLI_CONFIG_OUTPUT_MISSING: { exitCode: EXIT_CODES.USAGE },\n  CLI_CHECK_OUTPUT_MISSING: { exitCode: EXIT_CODES.USAGE },\n  CLI_INPUT_MISSING: { exitCode: EXIT_CODES.USAGE },\n  CLI_OUTPUT_IS_INPUT: { exitCode: EXIT_CODES.USAGE },\n  CLI_OUTPUT_DUPLICATE: { exitCode: EXIT_CODES.USAGE },\n  CLI_OUTPUT_INVALID: { exitCode: EXIT_CODES.USAGE },\n  CLI_LOCATION_INVALID: { exitCode: EXIT_CODES.USAGE },\n  OUTPUT_STALE: { exitCode: EXIT_CODES.OUTPUT_STALE },\n  OUTPUT_READ_FAILED: { exitCode: EXIT_CODES.OUTPUT },\n  OUTPUT_WRITE_FAILED: { exitCode: EXIT_CODES.OUTPUT },\n};\n\n/** What the CLI prints and returns for a thrown value. */\nexport interface CliFailure {\n  readonly exitCode: ExitCode;\n  readonly message: string;\n}\n\n/**\n * Map a thrown value to the CLI's output. A typed error prints one line with its code; anything\n * else is a bug and prints its stack, so it can be reported.\n */\nexport function describeCliFailure(error: unknown): CliFailure {\n  if (!isOpenAPITypesafeError(error)) {\n    const text = error instanceof Error ? (error.stack ?? error.message) : String(error);\n    return { exitCode: EXIT_CODES.INTERNAL, message: `Unexpected error: ${text}` };\n  }\n  const report = CLI_ERROR_REPORTS[error.code];\n  const message = report.message?.(error) ?? error.message;\n  return { exitCode: report.exitCode, message: `${message} (${error.code})` };\n}\n\n/** Errors of the CLI itself; its messages are the original CLI's messages. */\nexport function cliError(\n  code: Extract<ErrorCode, `CLI_${string}` | `OUTPUT_${string}`>,\n  message: string,\n  cause?: unknown,\n): OpenAPITypesafeError {\n  return new OpenAPITypesafeError({ code: ERROR_CODES[code], message, cause });\n}\n"],"names":["isOpenAPITypesafeError","OpenAPITypesafeError","ERROR_CODES"],"mappings":"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"}
+{"version":3,"file":"cli-errors.cjs","sources":["../../src/cli/cli-errors.ts"],"sourcesContent":["import {\n  ERROR_CODES,\n  type ErrorCode,\n  isOpenAPITypesafeError,\n  OpenAPITypesafeError,\n} from \"../domain/errors.js\";\n\n/**\n * How the CLI reports a failure (ENGINEERING_PLAN 4.6, ADR-011): each error code maps to a process\n * exit code and the line printed for it. The table is exhaustive, so a new error code does not\n * compile until the CLI handles it.\n */\n\n/** Process exit codes of the CLI, documented in docs/cli.md. */\nexport const EXIT_CODES = {\n  SUCCESS: 0,\n  /** `--check` found output that differs from the generated types (as in the original CLI). */\n  OUTPUT_STALE: 1,\n  /** A flag, the Redocly config, the environment or a callback is wrong. */\n  USAGE: 2,\n  /** The OpenAPI document cannot be read, is invalid, or cannot be converted. */\n  SCHEMA: 3,\n  /** An output file cannot be read or written. */\n  OUTPUT: 4,\n  /** An unexpected failure: a bug in the generator (sysexits `EX_SOFTWARE`). */\n  INTERNAL: 70,\n} as const;\n\nexport type ExitCode = (typeof EXIT_CODES)[keyof typeof EXIT_CODES];\n\ninterface CliErrorReport {\n  readonly exitCode: ExitCode;\n  /** The printed text; the error's own message when absent. */\n  readonly message?: (error: OpenAPITypesafeError) => string;\n}\n\n/** Problems are printed one by one while linting, so the summary only counts them. */\nfunction schemaInvalidMessage(error: OpenAPITypesafeError): string {\n  const count = Array.isArray(error.details.problems) ? error.details.problems.length : 1;\n  return `The OpenAPI document has ${count} ${count === 1 ? \"error\" : \"errors\"} (see above)`;\n}\n\n/**\n * Node's `fetch` fails with only \"fetch failed\"; the network reason (refused, DNS, TLS) is the\n * cause of that error. The Node API keeps the original message, so only the CLI adds it.\n */\nfunction loadFailedMessage(error: OpenAPITypesafeError): string {\n  const reason = error.cause instanceof Error ? error.cause.cause : undefined;\n  if (!(reason instanceof Error)) {\n    return error.message;\n  }\n  // `loadFailedError`, the only source of this code, always sets the source.\n  return `${error.message}: ${reason.message} (${String(error.details.source)})`;\n}\n\n/** The message js-yaml throws at its nesting limit (docs/security/threat-model.md T2). */\nconst YAML_DEPTH_LIMIT_MESSAGE = /nesting exceeded maxDepth \\((\\d+)\\)/;\n\n/** The parser's message says the limit, not how to stay under it. */\nfunction parseFailedMessage(error: OpenAPITypesafeError): string {\n  const limit = YAML_DEPTH_LIMIT_MESSAGE.exec(error.message)?.[1];\n  if (limit === undefined) {\n    return error.message;\n  }\n  return (\n    `${error.message}. The YAML parser reads at most ${limit} nested levels: ` +\n    \"move nested schemas to `components` and reference them with `$ref`\"\n  );\n}\n\n/**\n * Text piped into stdin that is only a YAML string (`echo api.yaml | openapi-typesafe`) gets the\n * CLI's advice, not the Node API's (`openapiTS(pathToFileURL(path))`).\n */\nfunction sourceInvalidMessage(error: OpenAPITypesafeError): string {\n  const { received, text } = error.details;\n  if (received !== \"stream\" || typeof text !== \"string\") {\n    return error.message;\n  }\n  return (\n    `stdin held only the YAML string \"${text}\", not an OpenAPI document. To read a file, pass ` +\n    \"its path or URL as the first argument: openapi-typesafe ./openapi.yaml -o ./schema.ts\"\n  );\n}\n\nconst CLI_ERROR_REPORTS: Readonly<Record<ErrorCode, CliErrorReport>> = {\n  SCHEMA_SOURCE_EMPTY: { exitCode: EXIT_CODES.SCHEMA },\n  SCHEMA_SOURCE_INVALID: { exitCode: EXIT_CODES.SCHEMA, message: sourceInvalidMessage },\n  SCHEMA_LOAD_FAILED: { exitCode: EXIT_CODES.SCHEMA, message: loadFailedMessage },\n  SCHEMA_PARSE_FAILED: { exitCode: EXIT_CODES.SCHEMA, message: parseFailedMessage },\n  SCHEMA_VERSION_UNSUPPORTED: { exitCode: EXIT_CODES.SCHEMA },\n  SCHEMA_INVALID: { exitCode: EXIT_CODES.SCHEMA, message: schemaInvalidMessage },\n  SCHEMA_REF_INVALID: { exitCode: EXIT_CODES.SCHEMA },\n  SCHEMA_REF_FORBIDDEN: { exitCode: EXIT_CODES.SCHEMA },\n  SCHEMA_OBJECT_INVALID: { exitCode: EXIT_CODES.SCHEMA },\n  SCHEMA_PROPERTY_INVALID: { exitCode: EXIT_CODES.SCHEMA },\n  SCHEMA_TOO_DEEP: { exitCode: EXIT_CODES.SCHEMA },\n  SCHEMA_KEY_UNSUPPORTED: { exitCode: EXIT_CODES.SCHEMA },\n  ENUM_NAME_EMPTY: { exitCode: EXIT_CODES.SCHEMA },\n  CALLBACK_RESULT_UNREADABLE: { exitCode: EXIT_CODES.USAGE },\n  OPTION_FIX_UNKNOWN: { exitCode: EXIT_CODES.USAGE },\n  OPTION_INVALID: { exitCode: EXIT_CODES.USAGE },\n  TYPESCRIPT_NOT_FOUND: { exitCode: EXIT_CODES.USAGE },\n  CLI_FLAG_REMOVED: { exitCode: EXIT_CODES.USAGE },\n  CLI_FLAG_INVALID: { exitCode: EXIT_CODES.USAGE },\n  CLI_GLOB_UNSUPPORTED: { exitCode: EXIT_CODES.USAGE },\n  CLI_CONFIG_NOT_FOUND: { exitCode: EXIT_CODES.USAGE },\n  CLI_CONFIG_INVALID: { exitCode: EXIT_CODES.USAGE },\n  CLI_CONFIG_OUTPUT_MISSING: { exitCode: EXIT_CODES.USAGE },\n  CLI_CHECK_OUTPUT_MISSING: { exitCode: EXIT_CODES.USAGE },\n  CLI_INPUT_MISSING: { exitCode: EXIT_CODES.USAGE },\n  CLI_INPUT_EXTRA: { exitCode: EXIT_CODES.USAGE },\n  CLI_OUTPUT_IS_INPUT: { exitCode: EXIT_CODES.USAGE },\n  CLI_OUTPUT_DUPLICATE: { exitCode: EXIT_CODES.USAGE },\n  CLI_OUTPUT_INVALID: { exitCode: EXIT_CODES.USAGE },\n  CLI_LOCATION_INVALID: { exitCode: EXIT_CODES.USAGE },\n  OUTPUT_STALE: { exitCode: EXIT_CODES.OUTPUT_STALE },\n  OUTPUT_READ_FAILED: { exitCode: EXIT_CODES.OUTPUT },\n  OUTPUT_WRITE_FAILED: { exitCode: EXIT_CODES.OUTPUT },\n};\n\n/** What the CLI prints and returns for a thrown value. */\nexport interface CliFailure {\n  readonly exitCode: ExitCode;\n  readonly message: string;\n}\n\n/**\n * Map a thrown value to the CLI's output. A typed error prints one line with its code; anything\n * else is a bug and prints its stack, so it can be reported.\n */\nexport function describeCliFailure(error: unknown): CliFailure {\n  if (error instanceof ApiFailure) {\n    const failure = describeCliFailure(error.cause);\n    return { ...failure, message: `API ${error.apiName}: ${failure.message}` };\n  }\n  if (!isOpenAPITypesafeError(error)) {\n    const text = error instanceof Error ? (error.stack ?? error.message) : String(error);\n    return { exitCode: EXIT_CODES.INTERNAL, message: `Unexpected error: ${text}` };\n  }\n  const report = CLI_ERROR_REPORTS[error.code];\n  const message = report.message?.(error) ?? error.message;\n  return { exitCode: report.exitCode, message: `${message} (${error.code})` };\n}\n\n/**\n * A failure of one API of a Redocly config. The CLI reports its cause with the API named first,\n * as the config errors of an API are; the cause keeps its code and so its exit code.\n */\nexport class ApiFailure extends Error {\n  override readonly name = \"ApiFailure\";\n  override readonly cause: unknown;\n  readonly apiName: string;\n\n  constructor(apiName: string, cause: unknown) {\n    super(`API ${apiName} failed`, { cause });\n    this.apiName = apiName;\n    this.cause = cause;\n  }\n}\n\n/** Errors of the CLI itself; its messages are the original CLI's messages. */\nexport function cliError(\n  code: Extract<ErrorCode, `CLI_${string}` | `OUTPUT_${string}`>,\n  message: string,\n  cause?: unknown,\n): OpenAPITypesafeError {\n  return new OpenAPITypesafeError({ code: ERROR_CODES[code], message, cause });\n}\n"],"names":["isOpenAPITypesafeError","OpenAPITypesafeError","ERROR_CODES"],"mappings":"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"}

package/dist/cli/cli-errors.mjs

@@ -55,14 +55,17 @@ const CLI_ERROR_REPORTS = {
   ENUM_NAME_EMPTY: { exitCode: EXIT_CODES.SCHEMA },
   CALLBACK_RESULT_UNREADABLE: { exitCode: EXIT_CODES.USAGE },
   OPTION_FIX_UNKNOWN: { exitCode: EXIT_CODES.USAGE },
+  OPTION_INVALID: { exitCode: EXIT_CODES.USAGE },
   TYPESCRIPT_NOT_FOUND: { exitCode: EXIT_CODES.USAGE },
   CLI_FLAG_REMOVED: { exitCode: EXIT_CODES.USAGE },
+  CLI_FLAG_INVALID: { exitCode: EXIT_CODES.USAGE },
   CLI_GLOB_UNSUPPORTED: { exitCode: EXIT_CODES.USAGE },
   CLI_CONFIG_NOT_FOUND: { exitCode: EXIT_CODES.USAGE },
   CLI_CONFIG_INVALID: { exitCode: EXIT_CODES.USAGE },
   CLI_CONFIG_OUTPUT_MISSING: { exitCode: EXIT_CODES.USAGE },
   CLI_CHECK_OUTPUT_MISSING: { exitCode: EXIT_CODES.USAGE },
   CLI_INPUT_MISSING: { exitCode: EXIT_CODES.USAGE },
+  CLI_INPUT_EXTRA: { exitCode: EXIT_CODES.USAGE },
   CLI_OUTPUT_IS_INPUT: { exitCode: EXIT_CODES.USAGE },
   CLI_OUTPUT_DUPLICATE: { exitCode: EXIT_CODES.USAGE },
   CLI_OUTPUT_INVALID: { exitCode: EXIT_CODES.USAGE },
@@ -72,6 +75,10 @@ const CLI_ERROR_REPORTS = {
   OUTPUT_WRITE_FAILED: { exitCode: EXIT_CODES.OUTPUT }
 };
 function describeCliFailure(error) {
+  if (error instanceof ApiFailure) {
+    const failure = describeCliFailure(error.cause);
+    return { ...failure, message: `API ${error.apiName}: ${failure.message}` };
+  }
   if (!isOpenAPITypesafeError(error)) {
     const text = error instanceof Error ? error.stack ?? error.message : String(error);
     return { exitCode: EXIT_CODES.INTERNAL, message: `Unexpected error: ${text}` };
@@ -80,9 +87,19 @@ function describeCliFailure(error) {
   const message = report.message?.(error) ?? error.message;
   return { exitCode: report.exitCode, message: `${message} (${error.code})` };
 }
+class ApiFailure extends Error {
+  name = "ApiFailure";
+  cause;
+  apiName;
+  constructor(apiName, cause) {
+    super(`API ${apiName} failed`, { cause });
+    this.apiName = apiName;
+    this.cause = cause;
+  }
+}
 function cliError(code, message, cause) {
   return new OpenAPITypesafeError({ code: ERROR_CODES[code], message, cause });
 }
 
-export { EXIT_CODES, cliError, describeCliFailure };
+export { ApiFailure, EXIT_CODES, cliError, describeCliFailure };
 //# sourceMappingURL=cli-errors.mjs.map

package/dist/cli/cli-errors.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli-errors.mjs","sources":["../../src/cli/cli-errors.ts"],"sourcesContent":["import {\n  ERROR_CODES,\n  type ErrorCode,\n  isOpenAPITypesafeError,\n  OpenAPITypesafeError,\n} from \"../domain/errors.js\";\n\n/**\n * How the CLI reports a failure (ENGINEERING_PLAN 4.6, ADR-011): each error code maps to a process\n * exit code and the line printed for it. The table is exhaustive, so a new error code does not\n * compile until the CLI handles it.\n */\n\n/** Process exit codes of the CLI, documented in docs/cli.md. */\nexport const EXIT_CODES = {\n  SUCCESS: 0,\n  /** `--check` found output that differs from the generated types (as in the original CLI). */\n  OUTPUT_STALE: 1,\n  /** A flag, the Redocly config, the environment or a callback is wrong. */\n  USAGE: 2,\n  /** The OpenAPI document cannot be read, is invalid, or cannot be converted. */\n  SCHEMA: 3,\n  /** An output file cannot be read or written. */\n  OUTPUT: 4,\n  /** An unexpected failure: a bug in the generator (sysexits `EX_SOFTWARE`). */\n  INTERNAL: 70,\n} as const;\n\nexport type ExitCode = (typeof EXIT_CODES)[keyof typeof EXIT_CODES];\n\ninterface CliErrorReport {\n  readonly exitCode: ExitCode;\n  /** The printed text; the error's own message when absent. */\n  readonly message?: (error: OpenAPITypesafeError) => string;\n}\n\n/** Problems are printed one by one while linting, so the summary only counts them. */\nfunction schemaInvalidMessage(error: OpenAPITypesafeError): string {\n  const count = Array.isArray(error.details.problems) ? error.details.problems.length : 1;\n  return `The OpenAPI document has ${count} ${count === 1 ? \"error\" : \"errors\"} (see above)`;\n}\n\n/**\n * Node's `fetch` fails with only \"fetch failed\"; the network reason (refused, DNS, TLS) is the\n * cause of that error. The Node API keeps the original message, so only the CLI adds it.\n */\nfunction loadFailedMessage(error: OpenAPITypesafeError): string {\n  const reason = error.cause instanceof Error ? error.cause.cause : undefined;\n  if (!(reason instanceof Error)) {\n    return error.message;\n  }\n  // `loadFailedError`, the only source of this code, always sets the source.\n  return `${error.message}: ${reason.message} (${String(error.details.source)})`;\n}\n\n/** The message js-yaml throws at its nesting limit (docs/security/threat-model.md T2). */\nconst YAML_DEPTH_LIMIT_MESSAGE = /nesting exceeded maxDepth \\((\\d+)\\)/;\n\n/** The parser's message says the limit, not how to stay under it. */\nfunction parseFailedMessage(error: OpenAPITypesafeError): string {\n  const limit = YAML_DEPTH_LIMIT_MESSAGE.exec(error.message)?.[1];\n  if (limit === undefined) {\n    return error.message;\n  }\n  return (\n    `${error.message}. The YAML parser reads at most ${limit} nested levels: ` +\n    \"move nested schemas to `components` and reference them with `$ref`\"\n  );\n}\n\n/**\n * Text piped into stdin that is only a YAML string (`echo api.yaml | openapi-typesafe`) gets the\n * CLI's advice, not the Node API's (`openapiTS(pathToFileURL(path))`).\n */\nfunction sourceInvalidMessage(error: OpenAPITypesafeError): string {\n  const { received, text } = error.details;\n  if (received !== \"stream\" || typeof text !== \"string\") {\n    return error.message;\n  }\n  return (\n    `stdin held only the YAML string \"${text}\", not an OpenAPI document. To read a file, pass ` +\n    \"its path or URL as the first argument: openapi-typesafe ./openapi.yaml -o ./schema.ts\"\n  );\n}\n\nconst CLI_ERROR_REPORTS: Readonly<Record<ErrorCode, CliErrorReport>> = {\n  SCHEMA_SOURCE_EMPTY: { exitCode: EXIT_CODES.SCHEMA },\n  SCHEMA_SOURCE_INVALID: { exitCode: EXIT_CODES.SCHEMA, message: sourceInvalidMessage },\n  SCHEMA_LOAD_FAILED: { exitCode: EXIT_CODES.SCHEMA, message: loadFailedMessage },\n  SCHEMA_PARSE_FAILED: { exitCode: EXIT_CODES.SCHEMA, message: parseFailedMessage },\n  SCHEMA_VERSION_UNSUPPORTED: { exitCode: EXIT_CODES.SCHEMA },\n  SCHEMA_INVALID: { exitCode: EXIT_CODES.SCHEMA, message: schemaInvalidMessage },\n  SCHEMA_REF_INVALID: { exitCode: EXIT_CODES.SCHEMA },\n  SCHEMA_REF_FORBIDDEN: { exitCode: EXIT_CODES.SCHEMA },\n  SCHEMA_OBJECT_INVALID: { exitCode: EXIT_CODES.SCHEMA },\n  SCHEMA_PROPERTY_INVALID: { exitCode: EXIT_CODES.SCHEMA },\n  SCHEMA_TOO_DEEP: { exitCode: EXIT_CODES.SCHEMA },\n  SCHEMA_KEY_UNSUPPORTED: { exitCode: EXIT_CODES.SCHEMA },\n  ENUM_NAME_EMPTY: { exitCode: EXIT_CODES.SCHEMA },\n  CALLBACK_RESULT_UNREADABLE: { exitCode: EXIT_CODES.USAGE },\n  OPTION_FIX_UNKNOWN: { exitCode: EXIT_CODES.USAGE },\n  TYPESCRIPT_NOT_FOUND: { exitCode: EXIT_CODES.USAGE },\n  CLI_FLAG_REMOVED: { exitCode: EXIT_CODES.USAGE },\n  CLI_GLOB_UNSUPPORTED: { exitCode: EXIT_CODES.USAGE },\n  CLI_CONFIG_NOT_FOUND: { exitCode: EXIT_CODES.USAGE },\n  CLI_CONFIG_INVALID: { exitCode: EXIT_CODES.USAGE },\n  CLI_CONFIG_OUTPUT_MISSING: { exitCode: EXIT_CODES.USAGE },\n  CLI_CHECK_OUTPUT_MISSING: { exitCode: EXIT_CODES.USAGE },\n  CLI_INPUT_MISSING: { exitCode: EXIT_CODES.USAGE },\n  CLI_OUTPUT_IS_INPUT: { exitCode: EXIT_CODES.USAGE },\n  CLI_OUTPUT_DUPLICATE: { exitCode: EXIT_CODES.USAGE },\n  CLI_OUTPUT_INVALID: { exitCode: EXIT_CODES.USAGE },\n  CLI_LOCATION_INVALID: { exitCode: EXIT_CODES.USAGE },\n  OUTPUT_STALE: { exitCode: EXIT_CODES.OUTPUT_STALE },\n  OUTPUT_READ_FAILED: { exitCode: EXIT_CODES.OUTPUT },\n  OUTPUT_WRITE_FAILED: { exitCode: EXIT_CODES.OUTPUT },\n};\n\n/** What the CLI prints and returns for a thrown value. */\nexport interface CliFailure {\n  readonly exitCode: ExitCode;\n  readonly message: string;\n}\n\n/**\n * Map a thrown value to the CLI's output. A typed error prints one line with its code; anything\n * else is a bug and prints its stack, so it can be reported.\n */\nexport function describeCliFailure(error: unknown): CliFailure {\n  if (!isOpenAPITypesafeError(error)) {\n    const text = error instanceof Error ? (error.stack ?? error.message) : String(error);\n    return { exitCode: EXIT_CODES.INTERNAL, message: `Unexpected error: ${text}` };\n  }\n  const report = CLI_ERROR_REPORTS[error.code];\n  const message = report.message?.(error) ?? error.message;\n  return { exitCode: report.exitCode, message: `${message} (${error.code})` };\n}\n\n/** Errors of the CLI itself; its messages are the original CLI's messages. */\nexport function cliError(\n  code: Extract<ErrorCode, `CLI_${string}` | `OUTPUT_${string}`>,\n  message: string,\n  cause?: unknown,\n): OpenAPITypesafeError {\n  return new OpenAPITypesafeError({ code: ERROR_CODES[code], message, cause });\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli-errors.mjs","sources":["../../src/cli/cli-errors.ts"],"sourcesContent":["import {\n  ERROR_CODES,\n  type ErrorCode,\n  isOpenAPITypesafeError,\n  OpenAPITypesafeError,\n} from \"../domain/errors.js\";\n\n/**\n * How the CLI reports a failure (ENGINEERING_PLAN 4.6, ADR-011): each error code maps to a process\n * exit code and the line printed for it. The table is exhaustive, so a new error code does not\n * compile until the CLI handles it.\n */\n\n/** Process exit codes of the CLI, documented in docs/cli.md. */\nexport const EXIT_CODES = {\n  SUCCESS: 0,\n  /** `--check` found output that differs from the generated types (as in the original CLI). */\n  OUTPUT_STALE: 1,\n  /** A flag, the Redocly config, the environment or a callback is wrong. */\n  USAGE: 2,\n  /** The OpenAPI document cannot be read, is invalid, or cannot be converted. */\n  SCHEMA: 3,\n  /** An output file cannot be read or written. */\n  OUTPUT: 4,\n  /** An unexpected failure: a bug in the generator (sysexits `EX_SOFTWARE`). */\n  INTERNAL: 70,\n} as const;\n\nexport type ExitCode = (typeof EXIT_CODES)[keyof typeof EXIT_CODES];\n\ninterface CliErrorReport {\n  readonly exitCode: ExitCode;\n  /** The printed text; the error's own message when absent. */\n  readonly message?: (error: OpenAPITypesafeError) => string;\n}\n\n/** Problems are printed one by one while linting, so the summary only counts them. */\nfunction schemaInvalidMessage(error: OpenAPITypesafeError): string {\n  const count = Array.isArray(error.details.problems) ? error.details.problems.length : 1;\n  return `The OpenAPI document has ${count} ${count === 1 ? \"error\" : \"errors\"} (see above)`;\n}\n\n/**\n * Node's `fetch` fails with only \"fetch failed\"; the network reason (refused, DNS, TLS) is the\n * cause of that error. The Node API keeps the original message, so only the CLI adds it.\n */\nfunction loadFailedMessage(error: OpenAPITypesafeError): string {\n  const reason = error.cause instanceof Error ? error.cause.cause : undefined;\n  if (!(reason instanceof Error)) {\n    return error.message;\n  }\n  // `loadFailedError`, the only source of this code, always sets the source.\n  return `${error.message}: ${reason.message} (${String(error.details.source)})`;\n}\n\n/** The message js-yaml throws at its nesting limit (docs/security/threat-model.md T2). */\nconst YAML_DEPTH_LIMIT_MESSAGE = /nesting exceeded maxDepth \\((\\d+)\\)/;\n\n/** The parser's message says the limit, not how to stay under it. */\nfunction parseFailedMessage(error: OpenAPITypesafeError): string {\n  const limit = YAML_DEPTH_LIMIT_MESSAGE.exec(error.message)?.[1];\n  if (limit === undefined) {\n    return error.message;\n  }\n  return (\n    `${error.message}. The YAML parser reads at most ${limit} nested levels: ` +\n    \"move nested schemas to `components` and reference them with `$ref`\"\n  );\n}\n\n/**\n * Text piped into stdin that is only a YAML string (`echo api.yaml | openapi-typesafe`) gets the\n * CLI's advice, not the Node API's (`openapiTS(pathToFileURL(path))`).\n */\nfunction sourceInvalidMessage(error: OpenAPITypesafeError): string {\n  const { received, text } = error.details;\n  if (received !== \"stream\" || typeof text !== \"string\") {\n    return error.message;\n  }\n  return (\n    `stdin held only the YAML string \"${text}\", not an OpenAPI document. To read a file, pass ` +\n    \"its path or URL as the first argument: openapi-typesafe ./openapi.yaml -o ./schema.ts\"\n  );\n}\n\nconst CLI_ERROR_REPORTS: Readonly<Record<ErrorCode, CliErrorReport>> = {\n  SCHEMA_SOURCE_EMPTY: { exitCode: EXIT_CODES.SCHEMA },\n  SCHEMA_SOURCE_INVALID: { exitCode: EXIT_CODES.SCHEMA, message: sourceInvalidMessage },\n  SCHEMA_LOAD_FAILED: { exitCode: EXIT_CODES.SCHEMA, message: loadFailedMessage },\n  SCHEMA_PARSE_FAILED: { exitCode: EXIT_CODES.SCHEMA, message: parseFailedMessage },\n  SCHEMA_VERSION_UNSUPPORTED: { exitCode: EXIT_CODES.SCHEMA },\n  SCHEMA_INVALID: { exitCode: EXIT_CODES.SCHEMA, message: schemaInvalidMessage },\n  SCHEMA_REF_INVALID: { exitCode: EXIT_CODES.SCHEMA },\n  SCHEMA_REF_FORBIDDEN: { exitCode: EXIT_CODES.SCHEMA },\n  SCHEMA_OBJECT_INVALID: { exitCode: EXIT_CODES.SCHEMA },\n  SCHEMA_PROPERTY_INVALID: { exitCode: EXIT_CODES.SCHEMA },\n  SCHEMA_TOO_DEEP: { exitCode: EXIT_CODES.SCHEMA },\n  SCHEMA_KEY_UNSUPPORTED: { exitCode: EXIT_CODES.SCHEMA },\n  ENUM_NAME_EMPTY: { exitCode: EXIT_CODES.SCHEMA },\n  CALLBACK_RESULT_UNREADABLE: { exitCode: EXIT_CODES.USAGE },\n  OPTION_FIX_UNKNOWN: { exitCode: EXIT_CODES.USAGE },\n  OPTION_INVALID: { exitCode: EXIT_CODES.USAGE },\n  TYPESCRIPT_NOT_FOUND: { exitCode: EXIT_CODES.USAGE },\n  CLI_FLAG_REMOVED: { exitCode: EXIT_CODES.USAGE },\n  CLI_FLAG_INVALID: { exitCode: EXIT_CODES.USAGE },\n  CLI_GLOB_UNSUPPORTED: { exitCode: EXIT_CODES.USAGE },\n  CLI_CONFIG_NOT_FOUND: { exitCode: EXIT_CODES.USAGE },\n  CLI_CONFIG_INVALID: { exitCode: EXIT_CODES.USAGE },\n  CLI_CONFIG_OUTPUT_MISSING: { exitCode: EXIT_CODES.USAGE },\n  CLI_CHECK_OUTPUT_MISSING: { exitCode: EXIT_CODES.USAGE },\n  CLI_INPUT_MISSING: { exitCode: EXIT_CODES.USAGE },\n  CLI_INPUT_EXTRA: { exitCode: EXIT_CODES.USAGE },\n  CLI_OUTPUT_IS_INPUT: { exitCode: EXIT_CODES.USAGE },\n  CLI_OUTPUT_DUPLICATE: { exitCode: EXIT_CODES.USAGE },\n  CLI_OUTPUT_INVALID: { exitCode: EXIT_CODES.USAGE },\n  CLI_LOCATION_INVALID: { exitCode: EXIT_CODES.USAGE },\n  OUTPUT_STALE: { exitCode: EXIT_CODES.OUTPUT_STALE },\n  OUTPUT_READ_FAILED: { exitCode: EXIT_CODES.OUTPUT },\n  OUTPUT_WRITE_FAILED: { exitCode: EXIT_CODES.OUTPUT },\n};\n\n/** What the CLI prints and returns for a thrown value. */\nexport interface CliFailure {\n  readonly exitCode: ExitCode;\n  readonly message: string;\n}\n\n/**\n * Map a thrown value to the CLI's output. A typed error prints one line with its code; anything\n * else is a bug and prints its stack, so it can be reported.\n */\nexport function describeCliFailure(error: unknown): CliFailure {\n  if (error instanceof ApiFailure) {\n    const failure = describeCliFailure(error.cause);\n    return { ...failure, message: `API ${error.apiName}: ${failure.message}` };\n  }\n  if (!isOpenAPITypesafeError(error)) {\n    const text = error instanceof Error ? (error.stack ?? error.message) : String(error);\n    return { exitCode: EXIT_CODES.INTERNAL, message: `Unexpected error: ${text}` };\n  }\n  const report = CLI_ERROR_REPORTS[error.code];\n  const message = report.message?.(error) ?? error.message;\n  return { exitCode: report.exitCode, message: `${message} (${error.code})` };\n}\n\n/**\n * A failure of one API of a Redocly config. The CLI reports its cause with the API named first,\n * as the config errors of an API are; the cause keeps its code and so its exit code.\n */\nexport class ApiFailure extends Error {\n  override readonly name = \"ApiFailure\";\n  override readonly cause: unknown;\n  readonly apiName: string;\n\n  constructor(apiName: string, cause: unknown) {\n    super(`API ${apiName} failed`, { cause });\n    this.apiName = apiName;\n    this.cause = cause;\n  }\n}\n\n/** Errors of the CLI itself; its messages are the original CLI's messages. */\nexport function cliError(\n  code: Extract<ErrorCode, `CLI_${string}` | `OUTPUT_${string}`>,\n  message: string,\n  cause?: unknown,\n): OpenAPITypesafeError {\n  return new OpenAPITypesafeError({ code: ERROR_CODES[code], message, cause });\n}\n"],"names":[],"mappings":"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"}