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

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_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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"}

package/dist/cli/cli-output.cjs

@@ -3,6 +3,8 @@
 const path = require('node:path');
 const node_url = require('node:url');
 const terminalLogger = require('../adapters/terminal-logger/terminal-logger.cjs');
+const locationText = require('../domain/location-text.cjs');
+const terminalText = require('../domain/terminal-text.cjs');
 const urlSecrets = require('../domain/url-secrets.cjs');
 const cliErrors = require('./cli-errors.cjs');
 
@@ -10,9 +12,8 @@ function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'defau
 
 const path__default = /*#__PURE__*/_interopDefaultCompat(path);
 
-const URL_SCHEME = /^[a-z][a-z\d+.-]+:/i;
 function resolveLocationUrl(location, base) {
-  if (URL_SCHEME.test(location)) {
+  if (locationText.hasUrlScheme(location)) {
     const url = URL.parse(location, base.href);
     if (url === null) {
       const shown = urlSecrets.redactUnparsedUrl(location);
@@ -105,14 +106,15 @@ function duplicateOutputError(output, others) {
   );
 }
 function parseLocationUrl(location, base) {
-  if (URL_SCHEME.test(location)) {
+  if (locationText.hasUrlScheme(location)) {
     return URL.parse(location, base.href) ?? void 0;
   }
   return resolveLocationUrl(location, base);
 }
 function printDone(run, output) {
   const { style, now } = run.deps;
-  const target = style.green(`${output.source} \u2192 ${style.bold(output.output)}`);
+  const source = terminalText.terminalSafeText(urlSecrets.redactUrlSecrets(output.source));
+  const target = style.green(`${source} \u2192 ${style.bold(terminalText.terminalSafeText(output.output))}`);
   const duration = style.dim(`[${terminalLogger.formatDuration(now() - run.startedAt)}]`);
   run.deps.console.info(`\u{1F680} ${target} ${duration}`);
 }

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

@@ -1 +1 @@
-{"version":3,"file":"cli-output.cjs","sources":["../../src/cli/cli-output.ts"],"sourcesContent":["import path from \"node:path\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport { formatDuration } from \"../adapters/terminal-logger/terminal-logger.js\";\nimport type { RedoclyConfig } from \"../application/ports/redocly-config-source.js\";\nimport { redactUnparsedUrl } from \"../domain/url-secrets.js\";\nimport type { CliArguments } from \"./cli-arguments.js\";\nimport type { CliDependencies, GeneratedTypes } from \"./cli-dependencies.js\";\nimport { cliError } from \"./cli-errors.js\";\n\n/** Writing one generated file, or checking it with `--check`, and the line printed for it. */\n\n/** One CLI run: its dependencies, its arguments and when it started. */\nexport interface CliRun {\n  readonly deps: CliDependencies;\n  readonly args: CliArguments;\n  readonly startedAt: number;\n}\n\n/** An output as the user wrote it: `source` names the schema, `output` is the path or URL. */\nexport interface NamedOutput {\n  readonly source: string;\n  readonly output: string;\n}\n\n/** A generated file: an output with the location of its local file. */\nexport interface OutputFile extends NamedOutput {\n  readonly file: URL;\n}\n\n/**\n * A scheme of two or more characters (`https:`, `file:`). One letter is a Windows drive (`C:`), so\n * `C:\\\\specs\\\\api.yaml` stays a path.\n */\nconst URL_SCHEME = /^[a-z][a-z\\d+.-]+:/i;\n\n/**\n * The URL of a location the user wrote: a URL, else a file path, absolute or relative to the\n * directory of `base` (a directory or file URL). A relative `file:` URL (`file:api.yaml`) resolves\n * against `base` too, as in openapi-typescript. A path is not parsed as a URL, so `#`, `?` and `%`\n * are part of the file name. A location with a scheme that does not parse as a URL\n * (`http://[::1/x`) fails with `CLI_LOCATION_INVALID`.\n */\nexport function resolveLocationUrl(location: string, base: URL): URL {\n  if (URL_SCHEME.test(location)) {\n    const url = URL.parse(location, base.href);\n    if (url === null) {\n      const shown = redactUnparsedUrl(location);\n      throw cliError(\"CLI_LOCATION_INVALID\", `The location ${shown} is not a valid URL`);\n    }\n    return url;\n  }\n  const baseDirectory = fileURLToPath(new URL(\".\", base));\n  return pathToFileURL(path.resolve(baseDirectory, location));\n}\n\nconst FILE_PROTOCOL = \"file:\";\n\n/** Segments that name a directory: the directory itself and its parent. */\nconst DIRECTORY_SEGMENTS: ReadonlySet<string> = new Set([\".\", \"..\"]);\n\n/**\n * Whether the location names a directory as written, before resolving drops the sign: a trailing\n * `/` (or `\\\\` on Windows), or a last segment `.` or `..` (`-o gen/.`, `-o a/b/..`). For a URL\n * the parsed path tells it too, since the URL parser drops `.`, `..` and their `%2E` forms.\n */\nfunction namesDirectory(location: string, file: URL): boolean {\n  const lastSegment = location\n    .split(path.sep)\n    .flatMap((part) => part.split(\"/\"))\n    .at(-1);\n  return (\n    lastSegment === \"\" || DIRECTORY_SEGMENTS.has(lastSegment ?? \"\") || file.pathname.endsWith(\"/\")\n  );\n}\n\nfunction invalidOutput(output: string, reason: string): Error {\n  return cliError(\"CLI_OUTPUT_INVALID\", `The output ${output} ${reason}`);\n}\n\n/** The URL of the output, if it is a local file that can be written; it may not exist yet. */\nfunction outputUrlOf(run: CliRun, output: string, base: URL): URL {\n  const file = parseLocationUrl(output, base);\n  if (file?.protocol !== FILE_PROTOCOL) {\n    throw invalidOutput(\n      output,\n      \"is not a local file. Write the types to a file path or a file: URL.\",\n    );\n  }\n  if (!isLocalFile(file)) {\n    throw invalidOutput(output, \"names no file on this computer. Use a file path instead.\");\n  }\n  if (namesDirectory(output, file) || run.deps.files.isDirectory(file)) {\n    throw invalidOutput(output, \"is a directory. Name the file to write the types to in it.\");\n  }\n  return file;\n}\n\n/** A `file:` URL with a host, or with an encoded slash, names no path on this platform. */\nfunction isLocalFile(file: URL): boolean {\n  try {\n    fileURLToPath(file);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * The output file of `source`, as the user wrote it in `output`, relative to `base`. Fails with\n * `CLI_OUTPUT_INVALID` before anything is generated when it is not a local file (a URL of\n * another scheme) or is a directory (a trailing separator, a last segment `.` or `..`, or a\n * directory on disk). Without this check, `-o dir/` and `-o dir/.` wrote a file named `dir`.\n */\nexport function outputFileOf(run: CliRun, named: NamedOutput, base: URL): OutputFile {\n  return { ...named, file: outputUrlOf(run, named.output, base) };\n}\n\n/** A file the CLI reads or writes: `name` is how an error names it, `location` where it is. */\nexport interface NamedFile {\n  readonly name: string;\n  readonly location: URL;\n}\n\n/** The `files` that are the local file `output`, also through a link or in another letter case. */\nfunction filesAtOutput(run: CliRun, output: OutputFile, files: readonly NamedFile[]): NamedFile[] {\n  return files.filter(\n    ({ location }) =>\n      location.protocol === FILE_PROTOCOL && run.deps.files.isSameFile(location, output.file),\n  );\n}\n\n/** A location as a path relative to the working directory, as error messages name files. */\nfunction displayPathOf(run: CliRun, location: URL): string {\n  return path.relative(fileURLToPath(run.deps.cwd), fileURLToPath(location)) || \".\";\n}\n\n/** The Redocly config file the run read, if any: no output may replace it. */\nexport function redoclyConfigFiles(run: CliRun, redocly: RedoclyConfig): NamedFile[] {\n  if (!redocly.configFile) {\n    return [];\n  }\n  const location = resolveLocationUrl(redocly.configFile, run.deps.cwd);\n  return [{ name: `Redocly config ${displayPathOf(run, location)}`, location }];\n}\n\n/** The local files that `owner` (a schema or an API) was generated from, `$ref`'d ones too. */\nexport function filesReadBy(run: CliRun, types: GeneratedTypes, owner: string): NamedFile[] {\n  return types.localFiles.map((location) => ({\n    name: `schema ${displayPathOf(run, location)} that ${owner} reads`,\n    location,\n  }));\n}\n\n/**\n * Fail with `CLI_OUTPUT_IS_INPUT` when `output` is one of the `schemas` (or the Redocly config).\n * Writing it would replace that file with the types, which upstream did without a word. The CLI\n * checks the files it knows before generating, so nothing is loaded or written, and the files\n * that `$ref`s loaded after generating, before anything is written.\n */\nexport function ensureOutputIsNotSchema(\n  run: CliRun,\n  output: OutputFile,\n  schemas: readonly NamedFile[],\n): void {\n  const [schema] = filesAtOutput(run, output, schemas);\n  if (schema) {\n    throw cliError(\n      \"CLI_OUTPUT_IS_INPUT\",\n      `The output ${output.output} is the ${schema.name}: writing the types would ` +\n        \"overwrite it. Choose another output file.\",\n    );\n  }\n}\n\n/**\n * Fail with `CLI_OUTPUT_DUPLICATE` when the output of an API is also one of `otherOutputs`.\n * Whichever write came last would win, so every API with that output fails, before anything is\n * generated.\n */\nexport function ensureOutputIsOwn(\n  run: CliRun,\n  output: OutputFile,\n  otherOutputs: readonly NamedFile[],\n): void {\n  const clashes = filesAtOutput(run, output, otherOutputs);\n  if (clashes.length > 0) {\n    throw duplicateOutputError(\n      output,\n      clashes.map(({ name }) => name),\n    );\n  }\n}\n\n/** `CLI_OUTPUT_DUPLICATE` for `output`, which is also the output of the `others` (named). */\nexport function duplicateOutputError(output: NamedOutput, others: readonly string[]): Error {\n  return cliError(\n    \"CLI_OUTPUT_DUPLICATE\",\n    `The output ${output.output} of API ${output.source} is also the output of ` +\n      `${others.join(\", \")}: they would overwrite each other. Give each API its own output file.`,\n  );\n}\n\n/** As `resolveLocationUrl`, but undefined for a URL that does not parse instead of a throw. */\nexport function parseLocationUrl(location: string, base: URL): URL | undefined {\n  if (URL_SCHEME.test(location)) {\n    return URL.parse(location, base.href) ?? undefined;\n  }\n  return resolveLocationUrl(location, base);\n}\n\nfunction printDone(run: CliRun, output: OutputFile): void {\n  const { style, now } = run.deps;\n  const target = style.green(`${output.source} → ${style.bold(output.output)}`);\n  const duration = style.dim(`[${formatDuration(now() - run.startedAt)}]`);\n  run.deps.console.info(`🚀 ${target} ${duration}`);\n}\n\n/**\n * With `--check`, fail with `OUTPUT_STALE` when the file differs from `contents` and leave it\n * alone otherwise. Without it, write the file and print where it went.\n */\nexport function emitOutput(run: CliRun, output: OutputFile, contents: string): void {\n  if (run.args.isCheck) {\n    if (run.deps.files.readText(output.file) !== contents) {\n      // The original message, then the file: with several APIs it tells which one is stale.\n      throw cliError(\n        \"OUTPUT_STALE\",\n        `Generated types are not up-to-date! ${output.output} differs from its schema.`,\n      );\n    }\n    return;\n  }\n  run.deps.files.writeText(output.file, contents);\n  printDone(run, output);\n}\n\n/** Write (or `--check`) the types, unless the output is one of the files the run read. */\nexport function writeOutput(\n  run: CliRun,\n  output: OutputFile,\n  types: GeneratedTypes,\n  readFiles: readonly NamedFile[],\n): void {\n  ensureOutputIsNotSchema(run, output, readFiles);\n  emitOutput(run, output, types.contents);\n}\n"],"names":["redactUnparsedUrl","cliError","fileURLToPath","pathToFileURL","path","formatDuration"],"mappings":"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"}
+{"version":3,"file":"cli-output.cjs","sources":["../../src/cli/cli-output.ts"],"sourcesContent":["import path from \"node:path\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport { formatDuration } from \"../adapters/terminal-logger/terminal-logger.js\";\nimport type { RedoclyConfig } from \"../application/ports/redocly-config-source.js\";\nimport { hasUrlScheme } from \"../domain/location-text.js\";\nimport { terminalSafeText } from \"../domain/terminal-text.js\";\nimport { redactUnparsedUrl, redactUrlSecrets } from \"../domain/url-secrets.js\";\nimport type { CliArguments } from \"./cli-arguments.js\";\nimport type { CliDependencies, GeneratedTypes } from \"./cli-dependencies.js\";\nimport { cliError } from \"./cli-errors.js\";\n\n/** Writing one generated file, or checking it with `--check`, and the line printed for it. */\n\n/** One CLI run: its dependencies, its arguments and when it started. */\nexport interface CliRun {\n  readonly deps: CliDependencies;\n  readonly args: CliArguments;\n  readonly startedAt: number;\n}\n\n/** An output as the user wrote it: `source` names the schema, `output` is the path or URL. */\nexport interface NamedOutput {\n  readonly source: string;\n  readonly output: string;\n}\n\n/** A generated file: an output with the location of its local file. */\nexport interface OutputFile extends NamedOutput {\n  readonly file: URL;\n}\n\n/**\n * The URL of a location the user wrote: a URL, else a file path, absolute or relative to the\n * directory of `base` (a directory or file URL). A relative `file:` URL (`file:api.yaml`) resolves\n * against `base` too, as in openapi-typescript. A path is not parsed as a URL, so `#`, `?` and `%`\n * are part of the file name. A location with a scheme that does not parse as a URL\n * (`http://[::1/x`) fails with `CLI_LOCATION_INVALID`.\n */\nexport function resolveLocationUrl(location: string, base: URL): URL {\n  if (hasUrlScheme(location)) {\n    const url = URL.parse(location, base.href);\n    if (url === null) {\n      const shown = redactUnparsedUrl(location);\n      throw cliError(\"CLI_LOCATION_INVALID\", `The location ${shown} is not a valid URL`);\n    }\n    return url;\n  }\n  const baseDirectory = fileURLToPath(new URL(\".\", base));\n  return pathToFileURL(path.resolve(baseDirectory, location));\n}\n\nconst FILE_PROTOCOL = \"file:\";\n\n/** Segments that name a directory: the directory itself and its parent. */\nconst DIRECTORY_SEGMENTS: ReadonlySet<string> = new Set([\".\", \"..\"]);\n\n/**\n * Whether the location names a directory as written, before resolving drops the sign: a trailing\n * `/` (or `\\\\` on Windows), or a last segment `.` or `..` (`-o gen/.`, `-o a/b/..`). For a URL\n * the parsed path tells it too, since the URL parser drops `.`, `..` and their `%2E` forms.\n */\nfunction namesDirectory(location: string, file: URL): boolean {\n  const lastSegment = location\n    .split(path.sep)\n    .flatMap((part) => part.split(\"/\"))\n    .at(-1);\n  return (\n    lastSegment === \"\" || DIRECTORY_SEGMENTS.has(lastSegment ?? \"\") || file.pathname.endsWith(\"/\")\n  );\n}\n\nfunction invalidOutput(output: string, reason: string): Error {\n  return cliError(\"CLI_OUTPUT_INVALID\", `The output ${output} ${reason}`);\n}\n\n/** The URL of the output, if it is a local file that can be written; it may not exist yet. */\nfunction outputUrlOf(run: CliRun, output: string, base: URL): URL {\n  const file = parseLocationUrl(output, base);\n  if (file?.protocol !== FILE_PROTOCOL) {\n    throw invalidOutput(\n      output,\n      \"is not a local file. Write the types to a file path or a file: URL.\",\n    );\n  }\n  if (!isLocalFile(file)) {\n    throw invalidOutput(output, \"names no file on this computer. Use a file path instead.\");\n  }\n  if (namesDirectory(output, file) || run.deps.files.isDirectory(file)) {\n    throw invalidOutput(output, \"is a directory. Name the file to write the types to in it.\");\n  }\n  return file;\n}\n\n/** A `file:` URL with a host, or with an encoded slash, names no path on this platform. */\nfunction isLocalFile(file: URL): boolean {\n  try {\n    fileURLToPath(file);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * The output file of `source`, as the user wrote it in `output`, relative to `base`. Fails with\n * `CLI_OUTPUT_INVALID` before anything is generated when it is not a local file (a URL of\n * another scheme) or is a directory (a trailing separator, a last segment `.` or `..`, or a\n * directory on disk). Without this check, `-o dir/` and `-o dir/.` wrote a file named `dir`.\n */\nexport function outputFileOf(run: CliRun, named: NamedOutput, base: URL): OutputFile {\n  return { ...named, file: outputUrlOf(run, named.output, base) };\n}\n\n/** A file the CLI reads or writes: `name` is how an error names it, `location` where it is. */\nexport interface NamedFile {\n  readonly name: string;\n  readonly location: URL;\n}\n\n/** The `files` that are the local file `output`, also through a link or in another letter case. */\nfunction filesAtOutput(run: CliRun, output: OutputFile, files: readonly NamedFile[]): NamedFile[] {\n  return files.filter(\n    ({ location }) =>\n      location.protocol === FILE_PROTOCOL && run.deps.files.isSameFile(location, output.file),\n  );\n}\n\n/** A location as a path relative to the working directory, as error messages name files. */\nfunction displayPathOf(run: CliRun, location: URL): string {\n  return path.relative(fileURLToPath(run.deps.cwd), fileURLToPath(location)) || \".\";\n}\n\n/** The Redocly config file the run read, if any: no output may replace it. */\nexport function redoclyConfigFiles(run: CliRun, redocly: RedoclyConfig): NamedFile[] {\n  if (!redocly.configFile) {\n    return [];\n  }\n  const location = resolveLocationUrl(redocly.configFile, run.deps.cwd);\n  return [{ name: `Redocly config ${displayPathOf(run, location)}`, location }];\n}\n\n/** The local files that `owner` (a schema or an API) was generated from, `$ref`'d ones too. */\nexport function filesReadBy(run: CliRun, types: GeneratedTypes, owner: string): NamedFile[] {\n  return types.localFiles.map((location) => ({\n    name: `schema ${displayPathOf(run, location)} that ${owner} reads`,\n    location,\n  }));\n}\n\n/**\n * Fail with `CLI_OUTPUT_IS_INPUT` when `output` is one of the `schemas` (or the Redocly config).\n * Writing it would replace that file with the types, which upstream did without a word. The CLI\n * checks the files it knows before generating, so nothing is loaded or written, and the files\n * that `$ref`s loaded after generating, before anything is written.\n */\nexport function ensureOutputIsNotSchema(\n  run: CliRun,\n  output: OutputFile,\n  schemas: readonly NamedFile[],\n): void {\n  const [schema] = filesAtOutput(run, output, schemas);\n  if (schema) {\n    throw cliError(\n      \"CLI_OUTPUT_IS_INPUT\",\n      `The output ${output.output} is the ${schema.name}: writing the types would ` +\n        \"overwrite it. Choose another output file.\",\n    );\n  }\n}\n\n/**\n * Fail with `CLI_OUTPUT_DUPLICATE` when the output of an API is also one of `otherOutputs`.\n * Whichever write came last would win, so every API with that output fails, before anything is\n * generated.\n */\nexport function ensureOutputIsOwn(\n  run: CliRun,\n  output: OutputFile,\n  otherOutputs: readonly NamedFile[],\n): void {\n  const clashes = filesAtOutput(run, output, otherOutputs);\n  if (clashes.length > 0) {\n    throw duplicateOutputError(\n      output,\n      clashes.map(({ name }) => name),\n    );\n  }\n}\n\n/** `CLI_OUTPUT_DUPLICATE` for `output`, which is also the output of the `others` (named). */\nexport function duplicateOutputError(output: NamedOutput, others: readonly string[]): Error {\n  return cliError(\n    \"CLI_OUTPUT_DUPLICATE\",\n    `The output ${output.output} of API ${output.source} is also the output of ` +\n      `${others.join(\", \")}: they would overwrite each other. Give each API its own output file.`,\n  );\n}\n\n/** As `resolveLocationUrl`, but undefined for a URL that does not parse instead of a throw. */\nexport function parseLocationUrl(location: string, base: URL): URL | undefined {\n  if (hasUrlScheme(location)) {\n    return URL.parse(location, base.href) ?? undefined;\n  }\n  return resolveLocationUrl(location, base);\n}\n\n/**\n * The line for a written file. It goes to the job log, so a source URL shows no secrets, and a\n * line break or escape sequence in a name cannot start a forged line.\n */\nfunction printDone(run: CliRun, output: OutputFile): void {\n  const { style, now } = run.deps;\n  const source = terminalSafeText(redactUrlSecrets(output.source));\n  const target = style.green(`${source} → ${style.bold(terminalSafeText(output.output))}`);\n  const duration = style.dim(`[${formatDuration(now() - run.startedAt)}]`);\n  run.deps.console.info(`🚀 ${target} ${duration}`);\n}\n\n/**\n * With `--check`, fail with `OUTPUT_STALE` when the file differs from `contents` and leave it\n * alone otherwise. Without it, write the file and print where it went.\n */\nexport function emitOutput(run: CliRun, output: OutputFile, contents: string): void {\n  if (run.args.isCheck) {\n    if (run.deps.files.readText(output.file) !== contents) {\n      // The original message, then the file: with several APIs it tells which one is stale.\n      throw cliError(\n        \"OUTPUT_STALE\",\n        `Generated types are not up-to-date! ${output.output} differs from its schema.`,\n      );\n    }\n    return;\n  }\n  run.deps.files.writeText(output.file, contents);\n  printDone(run, output);\n}\n\n/** Write (or `--check`) the types, unless the output is one of the files the run read. */\nexport function writeOutput(\n  run: CliRun,\n  output: OutputFile,\n  types: GeneratedTypes,\n  readFiles: readonly NamedFile[],\n): void {\n  ensureOutputIsNotSchema(run, output, readFiles);\n  emitOutput(run, output, types.contents);\n}\n"],"names":["hasUrlScheme","redactUnparsedUrl","cliError","fileURLToPath","pathToFileURL","path","terminalSafeText","redactUrlSecrets","formatDuration"],"mappings":"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"}

package/dist/cli/cli-output.mjs

@@ -1,12 +1,13 @@
 import path from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 import { formatDuration } from '../adapters/terminal-logger/terminal-logger.mjs';
-import { redactUnparsedUrl } from '../domain/url-secrets.mjs';
+import { hasUrlScheme } from '../domain/location-text.mjs';
+import { terminalSafeText } from '../domain/terminal-text.mjs';
+import { redactUnparsedUrl, redactUrlSecrets } from '../domain/url-secrets.mjs';
 import { cliError } from './cli-errors.mjs';
 
-const URL_SCHEME = /^[a-z][a-z\d+.-]+:/i;
 function resolveLocationUrl(location, base) {
-  if (URL_SCHEME.test(location)) {
+  if (hasUrlScheme(location)) {
     const url = URL.parse(location, base.href);
     if (url === null) {
       const shown = redactUnparsedUrl(location);
@@ -99,14 +100,15 @@ function duplicateOutputError(output, others) {
   );
 }
 function parseLocationUrl(location, base) {
-  if (URL_SCHEME.test(location)) {
+  if (hasUrlScheme(location)) {
     return URL.parse(location, base.href) ?? void 0;
   }
   return resolveLocationUrl(location, base);
 }
 function printDone(run, output) {
   const { style, now } = run.deps;
-  const target = style.green(`${output.source} \u2192 ${style.bold(output.output)}`);
+  const source = terminalSafeText(redactUrlSecrets(output.source));
+  const target = style.green(`${source} \u2192 ${style.bold(terminalSafeText(output.output))}`);
   const duration = style.dim(`[${formatDuration(now() - run.startedAt)}]`);
   run.deps.console.info(`\u{1F680} ${target} ${duration}`);
 }

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

@@ -1 +1 @@
-{"version":3,"file":"cli-output.mjs","sources":["../../src/cli/cli-output.ts"],"sourcesContent":["import path from \"node:path\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport { formatDuration } from \"../adapters/terminal-logger/terminal-logger.js\";\nimport type { RedoclyConfig } from \"../application/ports/redocly-config-source.js\";\nimport { redactUnparsedUrl } from \"../domain/url-secrets.js\";\nimport type { CliArguments } from \"./cli-arguments.js\";\nimport type { CliDependencies, GeneratedTypes } from \"./cli-dependencies.js\";\nimport { cliError } from \"./cli-errors.js\";\n\n/** Writing one generated file, or checking it with `--check`, and the line printed for it. */\n\n/** One CLI run: its dependencies, its arguments and when it started. */\nexport interface CliRun {\n  readonly deps: CliDependencies;\n  readonly args: CliArguments;\n  readonly startedAt: number;\n}\n\n/** An output as the user wrote it: `source` names the schema, `output` is the path or URL. */\nexport interface NamedOutput {\n  readonly source: string;\n  readonly output: string;\n}\n\n/** A generated file: an output with the location of its local file. */\nexport interface OutputFile extends NamedOutput {\n  readonly file: URL;\n}\n\n/**\n * A scheme of two or more characters (`https:`, `file:`). One letter is a Windows drive (`C:`), so\n * `C:\\\\specs\\\\api.yaml` stays a path.\n */\nconst URL_SCHEME = /^[a-z][a-z\\d+.-]+:/i;\n\n/**\n * The URL of a location the user wrote: a URL, else a file path, absolute or relative to the\n * directory of `base` (a directory or file URL). A relative `file:` URL (`file:api.yaml`) resolves\n * against `base` too, as in openapi-typescript. A path is not parsed as a URL, so `#`, `?` and `%`\n * are part of the file name. A location with a scheme that does not parse as a URL\n * (`http://[::1/x`) fails with `CLI_LOCATION_INVALID`.\n */\nexport function resolveLocationUrl(location: string, base: URL): URL {\n  if (URL_SCHEME.test(location)) {\n    const url = URL.parse(location, base.href);\n    if (url === null) {\n      const shown = redactUnparsedUrl(location);\n      throw cliError(\"CLI_LOCATION_INVALID\", `The location ${shown} is not a valid URL`);\n    }\n    return url;\n  }\n  const baseDirectory = fileURLToPath(new URL(\".\", base));\n  return pathToFileURL(path.resolve(baseDirectory, location));\n}\n\nconst FILE_PROTOCOL = \"file:\";\n\n/** Segments that name a directory: the directory itself and its parent. */\nconst DIRECTORY_SEGMENTS: ReadonlySet<string> = new Set([\".\", \"..\"]);\n\n/**\n * Whether the location names a directory as written, before resolving drops the sign: a trailing\n * `/` (or `\\\\` on Windows), or a last segment `.` or `..` (`-o gen/.`, `-o a/b/..`). For a URL\n * the parsed path tells it too, since the URL parser drops `.`, `..` and their `%2E` forms.\n */\nfunction namesDirectory(location: string, file: URL): boolean {\n  const lastSegment = location\n    .split(path.sep)\n    .flatMap((part) => part.split(\"/\"))\n    .at(-1);\n  return (\n    lastSegment === \"\" || DIRECTORY_SEGMENTS.has(lastSegment ?? \"\") || file.pathname.endsWith(\"/\")\n  );\n}\n\nfunction invalidOutput(output: string, reason: string): Error {\n  return cliError(\"CLI_OUTPUT_INVALID\", `The output ${output} ${reason}`);\n}\n\n/** The URL of the output, if it is a local file that can be written; it may not exist yet. */\nfunction outputUrlOf(run: CliRun, output: string, base: URL): URL {\n  const file = parseLocationUrl(output, base);\n  if (file?.protocol !== FILE_PROTOCOL) {\n    throw invalidOutput(\n      output,\n      \"is not a local file. Write the types to a file path or a file: URL.\",\n    );\n  }\n  if (!isLocalFile(file)) {\n    throw invalidOutput(output, \"names no file on this computer. Use a file path instead.\");\n  }\n  if (namesDirectory(output, file) || run.deps.files.isDirectory(file)) {\n    throw invalidOutput(output, \"is a directory. Name the file to write the types to in it.\");\n  }\n  return file;\n}\n\n/** A `file:` URL with a host, or with an encoded slash, names no path on this platform. */\nfunction isLocalFile(file: URL): boolean {\n  try {\n    fileURLToPath(file);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * The output file of `source`, as the user wrote it in `output`, relative to `base`. Fails with\n * `CLI_OUTPUT_INVALID` before anything is generated when it is not a local file (a URL of\n * another scheme) or is a directory (a trailing separator, a last segment `.` or `..`, or a\n * directory on disk). Without this check, `-o dir/` and `-o dir/.` wrote a file named `dir`.\n */\nexport function outputFileOf(run: CliRun, named: NamedOutput, base: URL): OutputFile {\n  return { ...named, file: outputUrlOf(run, named.output, base) };\n}\n\n/** A file the CLI reads or writes: `name` is how an error names it, `location` where it is. */\nexport interface NamedFile {\n  readonly name: string;\n  readonly location: URL;\n}\n\n/** The `files` that are the local file `output`, also through a link or in another letter case. */\nfunction filesAtOutput(run: CliRun, output: OutputFile, files: readonly NamedFile[]): NamedFile[] {\n  return files.filter(\n    ({ location }) =>\n      location.protocol === FILE_PROTOCOL && run.deps.files.isSameFile(location, output.file),\n  );\n}\n\n/** A location as a path relative to the working directory, as error messages name files. */\nfunction displayPathOf(run: CliRun, location: URL): string {\n  return path.relative(fileURLToPath(run.deps.cwd), fileURLToPath(location)) || \".\";\n}\n\n/** The Redocly config file the run read, if any: no output may replace it. */\nexport function redoclyConfigFiles(run: CliRun, redocly: RedoclyConfig): NamedFile[] {\n  if (!redocly.configFile) {\n    return [];\n  }\n  const location = resolveLocationUrl(redocly.configFile, run.deps.cwd);\n  return [{ name: `Redocly config ${displayPathOf(run, location)}`, location }];\n}\n\n/** The local files that `owner` (a schema or an API) was generated from, `$ref`'d ones too. */\nexport function filesReadBy(run: CliRun, types: GeneratedTypes, owner: string): NamedFile[] {\n  return types.localFiles.map((location) => ({\n    name: `schema ${displayPathOf(run, location)} that ${owner} reads`,\n    location,\n  }));\n}\n\n/**\n * Fail with `CLI_OUTPUT_IS_INPUT` when `output` is one of the `schemas` (or the Redocly config).\n * Writing it would replace that file with the types, which upstream did without a word. The CLI\n * checks the files it knows before generating, so nothing is loaded or written, and the files\n * that `$ref`s loaded after generating, before anything is written.\n */\nexport function ensureOutputIsNotSchema(\n  run: CliRun,\n  output: OutputFile,\n  schemas: readonly NamedFile[],\n): void {\n  const [schema] = filesAtOutput(run, output, schemas);\n  if (schema) {\n    throw cliError(\n      \"CLI_OUTPUT_IS_INPUT\",\n      `The output ${output.output} is the ${schema.name}: writing the types would ` +\n        \"overwrite it. Choose another output file.\",\n    );\n  }\n}\n\n/**\n * Fail with `CLI_OUTPUT_DUPLICATE` when the output of an API is also one of `otherOutputs`.\n * Whichever write came last would win, so every API with that output fails, before anything is\n * generated.\n */\nexport function ensureOutputIsOwn(\n  run: CliRun,\n  output: OutputFile,\n  otherOutputs: readonly NamedFile[],\n): void {\n  const clashes = filesAtOutput(run, output, otherOutputs);\n  if (clashes.length > 0) {\n    throw duplicateOutputError(\n      output,\n      clashes.map(({ name }) => name),\n    );\n  }\n}\n\n/** `CLI_OUTPUT_DUPLICATE` for `output`, which is also the output of the `others` (named). */\nexport function duplicateOutputError(output: NamedOutput, others: readonly string[]): Error {\n  return cliError(\n    \"CLI_OUTPUT_DUPLICATE\",\n    `The output ${output.output} of API ${output.source} is also the output of ` +\n      `${others.join(\", \")}: they would overwrite each other. Give each API its own output file.`,\n  );\n}\n\n/** As `resolveLocationUrl`, but undefined for a URL that does not parse instead of a throw. */\nexport function parseLocationUrl(location: string, base: URL): URL | undefined {\n  if (URL_SCHEME.test(location)) {\n    return URL.parse(location, base.href) ?? undefined;\n  }\n  return resolveLocationUrl(location, base);\n}\n\nfunction printDone(run: CliRun, output: OutputFile): void {\n  const { style, now } = run.deps;\n  const target = style.green(`${output.source} → ${style.bold(output.output)}`);\n  const duration = style.dim(`[${formatDuration(now() - run.startedAt)}]`);\n  run.deps.console.info(`🚀 ${target} ${duration}`);\n}\n\n/**\n * With `--check`, fail with `OUTPUT_STALE` when the file differs from `contents` and leave it\n * alone otherwise. Without it, write the file and print where it went.\n */\nexport function emitOutput(run: CliRun, output: OutputFile, contents: string): void {\n  if (run.args.isCheck) {\n    if (run.deps.files.readText(output.file) !== contents) {\n      // The original message, then the file: with several APIs it tells which one is stale.\n      throw cliError(\n        \"OUTPUT_STALE\",\n        `Generated types are not up-to-date! ${output.output} differs from its schema.`,\n      );\n    }\n    return;\n  }\n  run.deps.files.writeText(output.file, contents);\n  printDone(run, output);\n}\n\n/** Write (or `--check`) the types, unless the output is one of the files the run read. */\nexport function writeOutput(\n  run: CliRun,\n  output: OutputFile,\n  types: GeneratedTypes,\n  readFiles: readonly NamedFile[],\n): void {\n  ensureOutputIsNotSchema(run, output, readFiles);\n  emitOutput(run, output, types.contents);\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli-output.mjs","sources":["../../src/cli/cli-output.ts"],"sourcesContent":["import path from \"node:path\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport { formatDuration } from \"../adapters/terminal-logger/terminal-logger.js\";\nimport type { RedoclyConfig } from \"../application/ports/redocly-config-source.js\";\nimport { hasUrlScheme } from \"../domain/location-text.js\";\nimport { terminalSafeText } from \"../domain/terminal-text.js\";\nimport { redactUnparsedUrl, redactUrlSecrets } from \"../domain/url-secrets.js\";\nimport type { CliArguments } from \"./cli-arguments.js\";\nimport type { CliDependencies, GeneratedTypes } from \"./cli-dependencies.js\";\nimport { cliError } from \"./cli-errors.js\";\n\n/** Writing one generated file, or checking it with `--check`, and the line printed for it. */\n\n/** One CLI run: its dependencies, its arguments and when it started. */\nexport interface CliRun {\n  readonly deps: CliDependencies;\n  readonly args: CliArguments;\n  readonly startedAt: number;\n}\n\n/** An output as the user wrote it: `source` names the schema, `output` is the path or URL. */\nexport interface NamedOutput {\n  readonly source: string;\n  readonly output: string;\n}\n\n/** A generated file: an output with the location of its local file. */\nexport interface OutputFile extends NamedOutput {\n  readonly file: URL;\n}\n\n/**\n * The URL of a location the user wrote: a URL, else a file path, absolute or relative to the\n * directory of `base` (a directory or file URL). A relative `file:` URL (`file:api.yaml`) resolves\n * against `base` too, as in openapi-typescript. A path is not parsed as a URL, so `#`, `?` and `%`\n * are part of the file name. A location with a scheme that does not parse as a URL\n * (`http://[::1/x`) fails with `CLI_LOCATION_INVALID`.\n */\nexport function resolveLocationUrl(location: string, base: URL): URL {\n  if (hasUrlScheme(location)) {\n    const url = URL.parse(location, base.href);\n    if (url === null) {\n      const shown = redactUnparsedUrl(location);\n      throw cliError(\"CLI_LOCATION_INVALID\", `The location ${shown} is not a valid URL`);\n    }\n    return url;\n  }\n  const baseDirectory = fileURLToPath(new URL(\".\", base));\n  return pathToFileURL(path.resolve(baseDirectory, location));\n}\n\nconst FILE_PROTOCOL = \"file:\";\n\n/** Segments that name a directory: the directory itself and its parent. */\nconst DIRECTORY_SEGMENTS: ReadonlySet<string> = new Set([\".\", \"..\"]);\n\n/**\n * Whether the location names a directory as written, before resolving drops the sign: a trailing\n * `/` (or `\\\\` on Windows), or a last segment `.` or `..` (`-o gen/.`, `-o a/b/..`). For a URL\n * the parsed path tells it too, since the URL parser drops `.`, `..` and their `%2E` forms.\n */\nfunction namesDirectory(location: string, file: URL): boolean {\n  const lastSegment = location\n    .split(path.sep)\n    .flatMap((part) => part.split(\"/\"))\n    .at(-1);\n  return (\n    lastSegment === \"\" || DIRECTORY_SEGMENTS.has(lastSegment ?? \"\") || file.pathname.endsWith(\"/\")\n  );\n}\n\nfunction invalidOutput(output: string, reason: string): Error {\n  return cliError(\"CLI_OUTPUT_INVALID\", `The output ${output} ${reason}`);\n}\n\n/** The URL of the output, if it is a local file that can be written; it may not exist yet. */\nfunction outputUrlOf(run: CliRun, output: string, base: URL): URL {\n  const file = parseLocationUrl(output, base);\n  if (file?.protocol !== FILE_PROTOCOL) {\n    throw invalidOutput(\n      output,\n      \"is not a local file. Write the types to a file path or a file: URL.\",\n    );\n  }\n  if (!isLocalFile(file)) {\n    throw invalidOutput(output, \"names no file on this computer. Use a file path instead.\");\n  }\n  if (namesDirectory(output, file) || run.deps.files.isDirectory(file)) {\n    throw invalidOutput(output, \"is a directory. Name the file to write the types to in it.\");\n  }\n  return file;\n}\n\n/** A `file:` URL with a host, or with an encoded slash, names no path on this platform. */\nfunction isLocalFile(file: URL): boolean {\n  try {\n    fileURLToPath(file);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * The output file of `source`, as the user wrote it in `output`, relative to `base`. Fails with\n * `CLI_OUTPUT_INVALID` before anything is generated when it is not a local file (a URL of\n * another scheme) or is a directory (a trailing separator, a last segment `.` or `..`, or a\n * directory on disk). Without this check, `-o dir/` and `-o dir/.` wrote a file named `dir`.\n */\nexport function outputFileOf(run: CliRun, named: NamedOutput, base: URL): OutputFile {\n  return { ...named, file: outputUrlOf(run, named.output, base) };\n}\n\n/** A file the CLI reads or writes: `name` is how an error names it, `location` where it is. */\nexport interface NamedFile {\n  readonly name: string;\n  readonly location: URL;\n}\n\n/** The `files` that are the local file `output`, also through a link or in another letter case. */\nfunction filesAtOutput(run: CliRun, output: OutputFile, files: readonly NamedFile[]): NamedFile[] {\n  return files.filter(\n    ({ location }) =>\n      location.protocol === FILE_PROTOCOL && run.deps.files.isSameFile(location, output.file),\n  );\n}\n\n/** A location as a path relative to the working directory, as error messages name files. */\nfunction displayPathOf(run: CliRun, location: URL): string {\n  return path.relative(fileURLToPath(run.deps.cwd), fileURLToPath(location)) || \".\";\n}\n\n/** The Redocly config file the run read, if any: no output may replace it. */\nexport function redoclyConfigFiles(run: CliRun, redocly: RedoclyConfig): NamedFile[] {\n  if (!redocly.configFile) {\n    return [];\n  }\n  const location = resolveLocationUrl(redocly.configFile, run.deps.cwd);\n  return [{ name: `Redocly config ${displayPathOf(run, location)}`, location }];\n}\n\n/** The local files that `owner` (a schema or an API) was generated from, `$ref`'d ones too. */\nexport function filesReadBy(run: CliRun, types: GeneratedTypes, owner: string): NamedFile[] {\n  return types.localFiles.map((location) => ({\n    name: `schema ${displayPathOf(run, location)} that ${owner} reads`,\n    location,\n  }));\n}\n\n/**\n * Fail with `CLI_OUTPUT_IS_INPUT` when `output` is one of the `schemas` (or the Redocly config).\n * Writing it would replace that file with the types, which upstream did without a word. The CLI\n * checks the files it knows before generating, so nothing is loaded or written, and the files\n * that `$ref`s loaded after generating, before anything is written.\n */\nexport function ensureOutputIsNotSchema(\n  run: CliRun,\n  output: OutputFile,\n  schemas: readonly NamedFile[],\n): void {\n  const [schema] = filesAtOutput(run, output, schemas);\n  if (schema) {\n    throw cliError(\n      \"CLI_OUTPUT_IS_INPUT\",\n      `The output ${output.output} is the ${schema.name}: writing the types would ` +\n        \"overwrite it. Choose another output file.\",\n    );\n  }\n}\n\n/**\n * Fail with `CLI_OUTPUT_DUPLICATE` when the output of an API is also one of `otherOutputs`.\n * Whichever write came last would win, so every API with that output fails, before anything is\n * generated.\n */\nexport function ensureOutputIsOwn(\n  run: CliRun,\n  output: OutputFile,\n  otherOutputs: readonly NamedFile[],\n): void {\n  const clashes = filesAtOutput(run, output, otherOutputs);\n  if (clashes.length > 0) {\n    throw duplicateOutputError(\n      output,\n      clashes.map(({ name }) => name),\n    );\n  }\n}\n\n/** `CLI_OUTPUT_DUPLICATE` for `output`, which is also the output of the `others` (named). */\nexport function duplicateOutputError(output: NamedOutput, others: readonly string[]): Error {\n  return cliError(\n    \"CLI_OUTPUT_DUPLICATE\",\n    `The output ${output.output} of API ${output.source} is also the output of ` +\n      `${others.join(\", \")}: they would overwrite each other. Give each API its own output file.`,\n  );\n}\n\n/** As `resolveLocationUrl`, but undefined for a URL that does not parse instead of a throw. */\nexport function parseLocationUrl(location: string, base: URL): URL | undefined {\n  if (hasUrlScheme(location)) {\n    return URL.parse(location, base.href) ?? undefined;\n  }\n  return resolveLocationUrl(location, base);\n}\n\n/**\n * The line for a written file. It goes to the job log, so a source URL shows no secrets, and a\n * line break or escape sequence in a name cannot start a forged line.\n */\nfunction printDone(run: CliRun, output: OutputFile): void {\n  const { style, now } = run.deps;\n  const source = terminalSafeText(redactUrlSecrets(output.source));\n  const target = style.green(`${source} → ${style.bold(terminalSafeText(output.output))}`);\n  const duration = style.dim(`[${formatDuration(now() - run.startedAt)}]`);\n  run.deps.console.info(`🚀 ${target} ${duration}`);\n}\n\n/**\n * With `--check`, fail with `OUTPUT_STALE` when the file differs from `contents` and leave it\n * alone otherwise. Without it, write the file and print where it went.\n */\nexport function emitOutput(run: CliRun, output: OutputFile, contents: string): void {\n  if (run.args.isCheck) {\n    if (run.deps.files.readText(output.file) !== contents) {\n      // The original message, then the file: with several APIs it tells which one is stale.\n      throw cliError(\n        \"OUTPUT_STALE\",\n        `Generated types are not up-to-date! ${output.output} differs from its schema.`,\n      );\n    }\n    return;\n  }\n  run.deps.files.writeText(output.file, contents);\n  printDone(run, output);\n}\n\n/** Write (or `--check`) the types, unless the output is one of the files the run read. */\nexport function writeOutput(\n  run: CliRun,\n  output: OutputFile,\n  types: GeneratedTypes,\n  readFiles: readonly NamedFile[],\n): void {\n  ensureOutputIsNotSchema(run, output, readFiles);\n  emitOutput(run, output, types.contents);\n}\n"],"names":[],"mappings":"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"}

package/dist/cli/main.cjs

@@ -5,11 +5,14 @@ const node_tty = require('node:tty');
 const node_url = require('node:url');
 const colors = require('ansi-colors');
 const nodeFileSystem = require('../adapters/node-file-system/node-file-system.cjs');
+const pipeSafeWriter = require('../adapters/pipe-safe-writer/pipe-safe-writer.cjs');
 const redoclyConfigSource = require('../adapters/redocly-loader/redocly-config-source.cjs');
 const astToString = require('../api/ast-to-string.cjs');
 const commentHeader = require('../api/comment-header.cjs');
 const defaultPorts = require('../api/default-ports.cjs');
 const openapiTs = require('../api/openapi-ts.cjs');
+const terminalText = require('../domain/terminal-text.cjs');
+const apiLogger = require('./api-logger.cjs');
 const runCli = require('./run-cli.cjs');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
@@ -33,8 +36,10 @@ function terminalStyle() {
   };
 }
 const STDIN_DESCRIPTOR = 0;
-const generateTypes = async (source, options) => {
-  const ports = await openapiTs.defaultGeneratorPorts(options);
+const generateTypes = async (source, options, apiName) => {
+  const terminalLogger = defaultPorts.defaultLogger(options.silent ?? false);
+  const logger = apiName === void 0 ? terminalLogger : apiLogger.apiLogger(terminalLogger, apiName);
+  const ports = await openapiTs.defaultGeneratorPorts(options, logger);
   const { declarations, localFiles } = await openapiTs.generateDocument(source, options, ports);
   return { contents: `${commentHeader.COMMENT_HEADER}${astToString.astToString(declarations)}`, localFiles };
 };
@@ -42,8 +47,9 @@ function terminalConsole() {
   return {
     // biome-ignore lint/suspicious/noConsole: the CLI's own output lines
     info: (text) => console.info(text),
+    // A notice names flags and API names as written, so it is shown as one plain line.
     // biome-ignore lint/suspicious/noConsole: the CLI's own notices
-    notice: (text) => console.warn(text)
+    notice: (text) => console.warn(terminalText.terminalSafeText(text))
   };
 }
 function processDependencies() {
@@ -53,7 +59,7 @@ function processDependencies() {
     version: readVersion(),
     logger: defaultPorts.defaultLogger(false),
     console: terminalConsole(),
-    writeStdout: (text) => process.stdout.write(text),
+    writeStdout: pipeSafeWriter.createPipeSafeWriter(process.stdout),
     stdin: () => process.stdin,
     // `isatty` reads the descriptor without opening `process.stdin`, which would keep the
     // process alive.

package/dist/cli/main.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"main.cjs","sources":["../../src/cli/main.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport { isatty } from \"node:tty\";\nimport { pathToFileURL } from \"node:url\";\nimport colors from \"ansi-colors\";\nimport { createNodeFileSystem } from \"../adapters/node-file-system/node-file-system.js\";\nimport { createRedoclyConfigSource } from \"../adapters/redocly-loader/redocly-config-source.js\";\nimport { astToString } from \"../api/ast-to-string.js\";\nimport { COMMENT_HEADER } from \"../api/comment-header.js\";\nimport { defaultLogger, monotonicNow, terminalSupportsColor } from \"../api/default-ports.js\";\nimport { defaultGeneratorPorts, generateDocument } from \"../api/openapi-ts.js\";\nimport type { CliConsole, CliDependencies, GenerateTypes, TextStyle } from \"./cli-dependencies.js\";\nimport { runCli } from \"./run-cli.js\";\n\n/**\n * The CLI's composition root (ENGINEERING_PLAN 4.5, ADR-012): the only CLI module that touches the\n * process. `bin/cli.js` imports the built copy of this module.\n */\n\n/** The same path from `src/cli/` and from the built `dist/cli/`. */\nconst PACKAGE_JSON = new URL(\"../../package.json\", import.meta.url);\n\nfunction readVersion(): string {\n  const packageJson: { version: string } = JSON.parse(fs.readFileSync(PACKAGE_JSON, \"utf8\"));\n  return packageJson.version;\n}\n\nfunction terminalStyle(): TextStyle {\n  const palette = colors.create();\n  palette.enabled = terminalSupportsColor();\n  return {\n    bold: (text) => palette.bold(text),\n    green: (text) => palette.green(text),\n    dim: (text) => palette.dim(text),\n  };\n}\n\nconst STDIN_DESCRIPTOR = 0;\n\nconst generateTypes: GenerateTypes = async (source, options) => {\n  const ports = await defaultGeneratorPorts(options);\n  const { declarations, localFiles } = await generateDocument(source, options, ports);\n  return { contents: `${COMMENT_HEADER}${astToString(declarations)}`, localFiles };\n};\n\nfunction terminalConsole(): CliConsole {\n  return {\n    // biome-ignore lint/suspicious/noConsole: the CLI's own output lines\n    info: (text) => console.info(text),\n    // biome-ignore lint/suspicious/noConsole: the CLI's own notices\n    notice: (text) => console.warn(text),\n  };\n}\n\nfunction processDependencies(): CliDependencies {\n  const cwd = process.cwd();\n  return {\n    cwd: pathToFileURL(`${cwd}/`),\n    version: readVersion(),\n    logger: defaultLogger(false),\n    console: terminalConsole(),\n    writeStdout: (text) => process.stdout.write(text),\n    stdin: () => process.stdin,\n    // `isatty` reads the descriptor without opening `process.stdin`, which would keep the\n    // process alive.\n    isStdinTerminal: () => isatty(STDIN_DESCRIPTOR),\n    files: createNodeFileSystem(),\n    redoclyConfigs: createRedoclyConfigSource(cwd),\n    generate: generateTypes,\n    now: monotonicNow,\n    style: terminalStyle(),\n  };\n}\n\nrunCli(process.argv.slice(2), processDependencies()).then((exitCode) => {\n  process.exitCode = exitCode;\n});\n"],"names":["fs","colors","terminalSupportsColor","defaultGeneratorPorts","generateDocument","COMMENT_HEADER","astToString","pathToFileURL","defaultLogger","isatty","createNodeFileSystem","createRedoclyConfigSource","monotonicNow","runCli"],"mappings":";;;;;;;;;;;;;;;;;;;;AAmBA,MAAM,YAAA,GAAe,IAAI,GAAA,CAAI,oBAAA,EAAsB,8PAAe,CAAA;AAElE,SAAS,WAAA,GAAsB;AAC7B,EAAA,MAAM,cAAmC,IAAA,CAAK,KAAA,CAAMA,YAAG,YAAA,CAAa,YAAA,EAAc,MAAM,CAAC,CAAA;AACzF,EAAA,OAAO,WAAA,CAAY,OAAA;AACrB;AAEA,SAAS,aAAA,GAA2B;AAClC,EAAA,MAAM,OAAA,GAAUC,gBAAO,MAAA,EAAO;AAC9B,EAAA,OAAA,CAAQ,UAAUC,kCAAA,EAAsB;AACxC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,CAAC,IAAA,KAAS,OAAA,CAAQ,KAAK,IAAI,CAAA;AAAA,IACjC,KAAA,EAAO,CAAC,IAAA,KAAS,OAAA,CAAQ,MAAM,IAAI,CAAA;AAAA,IACnC,GAAA,EAAK,CAAC,IAAA,KAAS,OAAA,CAAQ,IAAI,IAAI;AAAA,GACjC;AACF;AAEA,MAAM,gBAAA,GAAmB,CAAA;AAEzB,MAAM,aAAA,GAA+B,OAAO,MAAA,EAAQ,OAAA,KAAY;AAC9D,EAAA,MAAM,KAAA,GAAQ,MAAMC,+BAAA,CAAsB,OAAO,CAAA;AACjD,EAAA,MAAM,EAAE,cAAc,UAAA,EAAW,GAAI,MAAMC,0BAAA,CAAiB,MAAA,EAAQ,SAAS,KAAK,CAAA;AAClF,EAAA,OAAO,EAAE,UAAU,CAAA,EAAGC,4BAAc,GAAGC,uBAAA,CAAY,YAAY,CAAC,CAAA,CAAA,EAAI,UAAA,EAAW;AACjF,CAAA;AAEA,SAAS,eAAA,GAA8B;AACrC,EAAA,OAAO;AAAA;AAAA,IAEL,IAAA,EAAM,CAAC,IAAA,KAAS,OAAA,CAAQ,KAAK,IAAI,CAAA;AAAA;AAAA,IAEjC,MAAA,EAAQ,CAAC,IAAA,KAAS,OAAA,CAAQ,KAAK,IAAI;AAAA,GACrC;AACF;AAEA,SAAS,mBAAA,GAAuC;AAC9C,EAAA,MAAM,GAAA,GAAM,QAAQ,GAAA,EAAI;AACxB,EAAA,OAAO;AAAA,IACL,GAAA,EAAKC,sBAAA,CAAc,CAAA,EAAG,GAAG,CAAA,CAAA,CAAG,CAAA;AAAA,IAC5B,SAAS,WAAA,EAAY;AAAA,IACrB,MAAA,EAAQC,2BAAc,KAAK,CAAA;AAAA,IAC3B,SAAS,eAAA,EAAgB;AAAA,IACzB,aAAa,CAAC,IAAA,KAAS,OAAA,CAAQ,MAAA,CAAO,MAAM,IAAI,CAAA;AAAA,IAChD,KAAA,EAAO,MAAM,OAAA,CAAQ,KAAA;AAAA;AAAA;AAAA,IAGrB,eAAA,EAAiB,MAAMC,eAAA,CAAO,gBAAgB,CAAA;AAAA,IAC9C,OAAOC,mCAAA,EAAqB;AAAA,IAC5B,cAAA,EAAgBC,8CAA0B,GAAG,CAAA;AAAA,IAC7C,QAAA,EAAU,aAAA;AAAA,IACV,GAAA,EAAKC,yBAAA;AAAA,IACL,OAAO,aAAA;AAAc,GACvB;AACF;AAEAC,aAAA,CAAO,OAAA,CAAQ,IAAA,CAAK,KAAA,CAAM,CAAC,CAAA,EAAG,qBAAqB,CAAA,CAAE,IAAA,CAAK,CAAC,QAAA,KAAa;AACtE,EAAA,OAAA,CAAQ,QAAA,GAAW,QAAA;AACrB,CAAC,CAAA"}
+{"version":3,"file":"main.cjs","sources":["../../src/cli/main.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport { isatty } from \"node:tty\";\nimport { pathToFileURL } from \"node:url\";\nimport colors from \"ansi-colors\";\nimport { createNodeFileSystem } from \"../adapters/node-file-system/node-file-system.js\";\nimport { createPipeSafeWriter } from \"../adapters/pipe-safe-writer/pipe-safe-writer.js\";\nimport { createRedoclyConfigSource } from \"../adapters/redocly-loader/redocly-config-source.js\";\nimport { astToString } from \"../api/ast-to-string.js\";\nimport { COMMENT_HEADER } from \"../api/comment-header.js\";\nimport { defaultLogger, monotonicNow, terminalSupportsColor } from \"../api/default-ports.js\";\nimport { defaultGeneratorPorts, generateDocument } from \"../api/openapi-ts.js\";\nimport { terminalSafeText } from \"../domain/terminal-text.js\";\nimport { apiLogger } from \"./api-logger.js\";\nimport type { CliConsole, CliDependencies, GenerateTypes, TextStyle } from \"./cli-dependencies.js\";\nimport { runCli } from \"./run-cli.js\";\n\n/**\n * The CLI's composition root (ENGINEERING_PLAN 4.5, ADR-012): the only CLI module that touches the\n * process. `bin/cli.js` imports the built copy of this module.\n */\n\n/** The same path from `src/cli/` and from the built `dist/cli/`. */\nconst PACKAGE_JSON = new URL(\"../../package.json\", import.meta.url);\n\nfunction readVersion(): string {\n  const packageJson: { version: string } = JSON.parse(fs.readFileSync(PACKAGE_JSON, \"utf8\"));\n  return packageJson.version;\n}\n\nfunction terminalStyle(): TextStyle {\n  const palette = colors.create();\n  palette.enabled = terminalSupportsColor();\n  return {\n    bold: (text) => palette.bold(text),\n    green: (text) => palette.green(text),\n    dim: (text) => palette.dim(text),\n  };\n}\n\nconst STDIN_DESCRIPTOR = 0;\n\nconst generateTypes: GenerateTypes = async (source, options, apiName) => {\n  const terminalLogger = defaultLogger(options.silent ?? false);\n  const logger = apiName === undefined ? terminalLogger : apiLogger(terminalLogger, apiName);\n  const ports = await defaultGeneratorPorts(options, logger);\n  const { declarations, localFiles } = await generateDocument(source, options, ports);\n  return { contents: `${COMMENT_HEADER}${astToString(declarations)}`, localFiles };\n};\n\nfunction terminalConsole(): CliConsole {\n  return {\n    // biome-ignore lint/suspicious/noConsole: the CLI's own output lines\n    info: (text) => console.info(text),\n    // A notice names flags and API names as written, so it is shown as one plain line.\n    // biome-ignore lint/suspicious/noConsole: the CLI's own notices\n    notice: (text) => console.warn(terminalSafeText(text)),\n  };\n}\n\nfunction processDependencies(): CliDependencies {\n  const cwd = process.cwd();\n  return {\n    cwd: pathToFileURL(`${cwd}/`),\n    version: readVersion(),\n    logger: defaultLogger(false),\n    console: terminalConsole(),\n    writeStdout: createPipeSafeWriter(process.stdout),\n    stdin: () => process.stdin,\n    // `isatty` reads the descriptor without opening `process.stdin`, which would keep the\n    // process alive.\n    isStdinTerminal: () => isatty(STDIN_DESCRIPTOR),\n    files: createNodeFileSystem(),\n    redoclyConfigs: createRedoclyConfigSource(cwd),\n    generate: generateTypes,\n    now: monotonicNow,\n    style: terminalStyle(),\n  };\n}\n\nrunCli(process.argv.slice(2), processDependencies()).then((exitCode) => {\n  process.exitCode = exitCode;\n});\n"],"names":["fs","colors","terminalSupportsColor","defaultLogger","apiLogger","defaultGeneratorPorts","generateDocument","COMMENT_HEADER","astToString","terminalSafeText","pathToFileURL","createPipeSafeWriter","isatty","createNodeFileSystem","createRedoclyConfigSource","monotonicNow","runCli"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAsBA,MAAM,YAAA,GAAe,IAAI,GAAA,CAAI,oBAAA,EAAsB,8PAAe,CAAA;AAElE,SAAS,WAAA,GAAsB;AAC7B,EAAA,MAAM,cAAmC,IAAA,CAAK,KAAA,CAAMA,YAAG,YAAA,CAAa,YAAA,EAAc,MAAM,CAAC,CAAA;AACzF,EAAA,OAAO,WAAA,CAAY,OAAA;AACrB;AAEA,SAAS,aAAA,GAA2B;AAClC,EAAA,MAAM,OAAA,GAAUC,gBAAO,MAAA,EAAO;AAC9B,EAAA,OAAA,CAAQ,UAAUC,kCAAA,EAAsB;AACxC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,CAAC,IAAA,KAAS,OAAA,CAAQ,KAAK,IAAI,CAAA;AAAA,IACjC,KAAA,EAAO,CAAC,IAAA,KAAS,OAAA,CAAQ,MAAM,IAAI,CAAA;AAAA,IACnC,GAAA,EAAK,CAAC,IAAA,KAAS,OAAA,CAAQ,IAAI,IAAI;AAAA,GACjC;AACF;AAEA,MAAM,gBAAA,GAAmB,CAAA;AAEzB,MAAM,aAAA,GAA+B,OAAO,MAAA,EAAQ,OAAA,EAAS,OAAA,KAAY;AACvE,EAAA,MAAM,cAAA,GAAiBC,0BAAA,CAAc,OAAA,CAAQ,MAAA,IAAU,KAAK,CAAA;AAC5D,EAAA,MAAM,SAAS,OAAA,KAAY,MAAA,GAAY,cAAA,GAAiBC,mBAAA,CAAU,gBAAgB,OAAO,CAAA;AACzF,EAAA,MAAM,KAAA,GAAQ,MAAMC,+BAAA,CAAsB,OAAA,EAAS,MAAM,CAAA;AACzD,EAAA,MAAM,EAAE,cAAc,UAAA,EAAW,GAAI,MAAMC,0BAAA,CAAiB,MAAA,EAAQ,SAAS,KAAK,CAAA;AAClF,EAAA,OAAO,EAAE,UAAU,CAAA,EAAGC,4BAAc,GAAGC,uBAAA,CAAY,YAAY,CAAC,CAAA,CAAA,EAAI,UAAA,EAAW;AACjF,CAAA;AAEA,SAAS,eAAA,GAA8B;AACrC,EAAA,OAAO;AAAA;AAAA,IAEL,IAAA,EAAM,CAAC,IAAA,KAAS,OAAA,CAAQ,KAAK,IAAI,CAAA;AAAA;AAAA;AAAA,IAGjC,QAAQ,CAAC,IAAA,KAAS,QAAQ,IAAA,CAAKC,6BAAA,CAAiB,IAAI,CAAC;AAAA,GACvD;AACF;AAEA,SAAS,mBAAA,GAAuC;AAC9C,EAAA,MAAM,GAAA,GAAM,QAAQ,GAAA,EAAI;AACxB,EAAA,OAAO;AAAA,IACL,GAAA,EAAKC,sBAAA,CAAc,CAAA,EAAG,GAAG,CAAA,CAAA,CAAG,CAAA;AAAA,IAC5B,SAAS,WAAA,EAAY;AAAA,IACrB,MAAA,EAAQP,2BAAc,KAAK,CAAA;AAAA,IAC3B,SAAS,eAAA,EAAgB;AAAA,IACzB,WAAA,EAAaQ,mCAAA,CAAqB,OAAA,CAAQ,MAAM,CAAA;AAAA,IAChD,KAAA,EAAO,MAAM,OAAA,CAAQ,KAAA;AAAA;AAAA;AAAA,IAGrB,eAAA,EAAiB,MAAMC,eAAA,CAAO,gBAAgB,CAAA;AAAA,IAC9C,OAAOC,mCAAA,EAAqB;AAAA,IAC5B,cAAA,EAAgBC,8CAA0B,GAAG,CAAA;AAAA,IAC7C,QAAA,EAAU,aAAA;AAAA,IACV,GAAA,EAAKC,yBAAA;AAAA,IACL,OAAO,aAAA;AAAc,GACvB;AACF;AAEAC,aAAA,CAAO,OAAA,CAAQ,IAAA,CAAK,KAAA,CAAM,CAAC,CAAA,EAAG,qBAAqB,CAAA,CAAE,IAAA,CAAK,CAAC,QAAA,KAAa;AACtE,EAAA,OAAA,CAAQ,QAAA,GAAW,QAAA;AACrB,CAAC,CAAA"}

package/dist/cli/main.mjs

@@ -3,11 +3,14 @@ import { isatty } from 'node:tty';
 import { pathToFileURL } from 'node:url';
 import colors from 'ansi-colors';
 import { createNodeFileSystem } from '../adapters/node-file-system/node-file-system.mjs';
+import { createPipeSafeWriter } from '../adapters/pipe-safe-writer/pipe-safe-writer.mjs';
 import { createRedoclyConfigSource } from '../adapters/redocly-loader/redocly-config-source.mjs';
 import { astToString } from '../api/ast-to-string.mjs';
 import { COMMENT_HEADER } from '../api/comment-header.mjs';
 import { monotonicNow, defaultLogger, terminalSupportsColor } from '../api/default-ports.mjs';
 import { defaultGeneratorPorts, generateDocument } from '../api/openapi-ts.mjs';
+import { terminalSafeText } from '../domain/terminal-text.mjs';
+import { apiLogger } from './api-logger.mjs';
 import { runCli } from './run-cli.mjs';
 
 const PACKAGE_JSON = new URL("../../package.json", import.meta.url);
@@ -25,8 +28,10 @@ function terminalStyle() {
   };
 }
 const STDIN_DESCRIPTOR = 0;
-const generateTypes = async (source, options) => {
-  const ports = await defaultGeneratorPorts(options);
+const generateTypes = async (source, options, apiName) => {
+  const terminalLogger = defaultLogger(options.silent ?? false);
+  const logger = apiName === void 0 ? terminalLogger : apiLogger(terminalLogger, apiName);
+  const ports = await defaultGeneratorPorts(options, logger);
   const { declarations, localFiles } = await generateDocument(source, options, ports);
   return { contents: `${COMMENT_HEADER}${astToString(declarations)}`, localFiles };
 };
@@ -34,8 +39,9 @@ function terminalConsole() {
   return {
     // biome-ignore lint/suspicious/noConsole: the CLI's own output lines
     info: (text) => console.info(text),
+    // A notice names flags and API names as written, so it is shown as one plain line.
     // biome-ignore lint/suspicious/noConsole: the CLI's own notices
-    notice: (text) => console.warn(text)
+    notice: (text) => console.warn(terminalSafeText(text))
   };
 }
 function processDependencies() {
@@ -45,7 +51,7 @@ function processDependencies() {
     version: readVersion(),
     logger: defaultLogger(false),
     console: terminalConsole(),
-    writeStdout: (text) => process.stdout.write(text),
+    writeStdout: createPipeSafeWriter(process.stdout),
     stdin: () => process.stdin,
     // `isatty` reads the descriptor without opening `process.stdin`, which would keep the
     // process alive.

package/dist/cli/main.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"main.mjs","sources":["../../src/cli/main.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport { isatty } from \"node:tty\";\nimport { pathToFileURL } from \"node:url\";\nimport colors from \"ansi-colors\";\nimport { createNodeFileSystem } from \"../adapters/node-file-system/node-file-system.js\";\nimport { createRedoclyConfigSource } from \"../adapters/redocly-loader/redocly-config-source.js\";\nimport { astToString } from \"../api/ast-to-string.js\";\nimport { COMMENT_HEADER } from \"../api/comment-header.js\";\nimport { defaultLogger, monotonicNow, terminalSupportsColor } from \"../api/default-ports.js\";\nimport { defaultGeneratorPorts, generateDocument } from \"../api/openapi-ts.js\";\nimport type { CliConsole, CliDependencies, GenerateTypes, TextStyle } from \"./cli-dependencies.js\";\nimport { runCli } from \"./run-cli.js\";\n\n/**\n * The CLI's composition root (ENGINEERING_PLAN 4.5, ADR-012): the only CLI module that touches the\n * process. `bin/cli.js` imports the built copy of this module.\n */\n\n/** The same path from `src/cli/` and from the built `dist/cli/`. */\nconst PACKAGE_JSON = new URL(\"../../package.json\", import.meta.url);\n\nfunction readVersion(): string {\n  const packageJson: { version: string } = JSON.parse(fs.readFileSync(PACKAGE_JSON, \"utf8\"));\n  return packageJson.version;\n}\n\nfunction terminalStyle(): TextStyle {\n  const palette = colors.create();\n  palette.enabled = terminalSupportsColor();\n  return {\n    bold: (text) => palette.bold(text),\n    green: (text) => palette.green(text),\n    dim: (text) => palette.dim(text),\n  };\n}\n\nconst STDIN_DESCRIPTOR = 0;\n\nconst generateTypes: GenerateTypes = async (source, options) => {\n  const ports = await defaultGeneratorPorts(options);\n  const { declarations, localFiles } = await generateDocument(source, options, ports);\n  return { contents: `${COMMENT_HEADER}${astToString(declarations)}`, localFiles };\n};\n\nfunction terminalConsole(): CliConsole {\n  return {\n    // biome-ignore lint/suspicious/noConsole: the CLI's own output lines\n    info: (text) => console.info(text),\n    // biome-ignore lint/suspicious/noConsole: the CLI's own notices\n    notice: (text) => console.warn(text),\n  };\n}\n\nfunction processDependencies(): CliDependencies {\n  const cwd = process.cwd();\n  return {\n    cwd: pathToFileURL(`${cwd}/`),\n    version: readVersion(),\n    logger: defaultLogger(false),\n    console: terminalConsole(),\n    writeStdout: (text) => process.stdout.write(text),\n    stdin: () => process.stdin,\n    // `isatty` reads the descriptor without opening `process.stdin`, which would keep the\n    // process alive.\n    isStdinTerminal: () => isatty(STDIN_DESCRIPTOR),\n    files: createNodeFileSystem(),\n    redoclyConfigs: createRedoclyConfigSource(cwd),\n    generate: generateTypes,\n    now: monotonicNow,\n    style: terminalStyle(),\n  };\n}\n\nrunCli(process.argv.slice(2), processDependencies()).then((exitCode) => {\n  process.exitCode = exitCode;\n});\n"],"names":[],"mappings":";;;;;;;;;;;;AAmBA,MAAM,YAAA,GAAe,IAAI,GAAA,CAAI,oBAAA,EAAsB,YAAY,GAAG,CAAA;AAElE,SAAS,WAAA,GAAsB;AAC7B,EAAA,MAAM,cAAmC,IAAA,CAAK,KAAA,CAAM,GAAG,YAAA,CAAa,YAAA,EAAc,MAAM,CAAC,CAAA;AACzF,EAAA,OAAO,WAAA,CAAY,OAAA;AACrB;AAEA,SAAS,aAAA,GAA2B;AAClC,EAAA,MAAM,OAAA,GAAU,OAAO,MAAA,EAAO;AAC9B,EAAA,OAAA,CAAQ,UAAU,qBAAA,EAAsB;AACxC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,CAAC,IAAA,KAAS,OAAA,CAAQ,KAAK,IAAI,CAAA;AAAA,IACjC,KAAA,EAAO,CAAC,IAAA,KAAS,OAAA,CAAQ,MAAM,IAAI,CAAA;AAAA,IACnC,GAAA,EAAK,CAAC,IAAA,KAAS,OAAA,CAAQ,IAAI,IAAI;AAAA,GACjC;AACF;AAEA,MAAM,gBAAA,GAAmB,CAAA;AAEzB,MAAM,aAAA,GAA+B,OAAO,MAAA,EAAQ,OAAA,KAAY;AAC9D,EAAA,MAAM,KAAA,GAAQ,MAAM,qBAAA,CAAsB,OAAO,CAAA;AACjD,EAAA,MAAM,EAAE,cAAc,UAAA,EAAW,GAAI,MAAM,gBAAA,CAAiB,MAAA,EAAQ,SAAS,KAAK,CAAA;AAClF,EAAA,OAAO,EAAE,UAAU,CAAA,EAAG,cAAc,GAAG,WAAA,CAAY,YAAY,CAAC,CAAA,CAAA,EAAI,UAAA,EAAW;AACjF,CAAA;AAEA,SAAS,eAAA,GAA8B;AACrC,EAAA,OAAO;AAAA;AAAA,IAEL,IAAA,EAAM,CAAC,IAAA,KAAS,OAAA,CAAQ,KAAK,IAAI,CAAA;AAAA;AAAA,IAEjC,MAAA,EAAQ,CAAC,IAAA,KAAS,OAAA,CAAQ,KAAK,IAAI;AAAA,GACrC;AACF;AAEA,SAAS,mBAAA,GAAuC;AAC9C,EAAA,MAAM,GAAA,GAAM,QAAQ,GAAA,EAAI;AACxB,EAAA,OAAO;AAAA,IACL,GAAA,EAAK,aAAA,CAAc,CAAA,EAAG,GAAG,CAAA,CAAA,CAAG,CAAA;AAAA,IAC5B,SAAS,WAAA,EAAY;AAAA,IACrB,MAAA,EAAQ,cAAc,KAAK,CAAA;AAAA,IAC3B,SAAS,eAAA,EAAgB;AAAA,IACzB,aAAa,CAAC,IAAA,KAAS,OAAA,CAAQ,MAAA,CAAO,MAAM,IAAI,CAAA;AAAA,IAChD,KAAA,EAAO,MAAM,OAAA,CAAQ,KAAA;AAAA;AAAA;AAAA,IAGrB,eAAA,EAAiB,MAAM,MAAA,CAAO,gBAAgB,CAAA;AAAA,IAC9C,OAAO,oBAAA,EAAqB;AAAA,IAC5B,cAAA,EAAgB,0BAA0B,GAAG,CAAA;AAAA,IAC7C,QAAA,EAAU,aAAA;AAAA,IACV,GAAA,EAAK,YAAA;AAAA,IACL,OAAO,aAAA;AAAc,GACvB;AACF;AAEA,MAAA,CAAO,OAAA,CAAQ,IAAA,CAAK,KAAA,CAAM,CAAC,CAAA,EAAG,qBAAqB,CAAA,CAAE,IAAA,CAAK,CAAC,QAAA,KAAa;AACtE,EAAA,OAAA,CAAQ,QAAA,GAAW,QAAA;AACrB,CAAC,CAAA"}
+{"version":3,"file":"main.mjs","sources":["../../src/cli/main.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport { isatty } from \"node:tty\";\nimport { pathToFileURL } from \"node:url\";\nimport colors from \"ansi-colors\";\nimport { createNodeFileSystem } from \"../adapters/node-file-system/node-file-system.js\";\nimport { createPipeSafeWriter } from \"../adapters/pipe-safe-writer/pipe-safe-writer.js\";\nimport { createRedoclyConfigSource } from \"../adapters/redocly-loader/redocly-config-source.js\";\nimport { astToString } from \"../api/ast-to-string.js\";\nimport { COMMENT_HEADER } from \"../api/comment-header.js\";\nimport { defaultLogger, monotonicNow, terminalSupportsColor } from \"../api/default-ports.js\";\nimport { defaultGeneratorPorts, generateDocument } from \"../api/openapi-ts.js\";\nimport { terminalSafeText } from \"../domain/terminal-text.js\";\nimport { apiLogger } from \"./api-logger.js\";\nimport type { CliConsole, CliDependencies, GenerateTypes, TextStyle } from \"./cli-dependencies.js\";\nimport { runCli } from \"./run-cli.js\";\n\n/**\n * The CLI's composition root (ENGINEERING_PLAN 4.5, ADR-012): the only CLI module that touches the\n * process. `bin/cli.js` imports the built copy of this module.\n */\n\n/** The same path from `src/cli/` and from the built `dist/cli/`. */\nconst PACKAGE_JSON = new URL(\"../../package.json\", import.meta.url);\n\nfunction readVersion(): string {\n  const packageJson: { version: string } = JSON.parse(fs.readFileSync(PACKAGE_JSON, \"utf8\"));\n  return packageJson.version;\n}\n\nfunction terminalStyle(): TextStyle {\n  const palette = colors.create();\n  palette.enabled = terminalSupportsColor();\n  return {\n    bold: (text) => palette.bold(text),\n    green: (text) => palette.green(text),\n    dim: (text) => palette.dim(text),\n  };\n}\n\nconst STDIN_DESCRIPTOR = 0;\n\nconst generateTypes: GenerateTypes = async (source, options, apiName) => {\n  const terminalLogger = defaultLogger(options.silent ?? false);\n  const logger = apiName === undefined ? terminalLogger : apiLogger(terminalLogger, apiName);\n  const ports = await defaultGeneratorPorts(options, logger);\n  const { declarations, localFiles } = await generateDocument(source, options, ports);\n  return { contents: `${COMMENT_HEADER}${astToString(declarations)}`, localFiles };\n};\n\nfunction terminalConsole(): CliConsole {\n  return {\n    // biome-ignore lint/suspicious/noConsole: the CLI's own output lines\n    info: (text) => console.info(text),\n    // A notice names flags and API names as written, so it is shown as one plain line.\n    // biome-ignore lint/suspicious/noConsole: the CLI's own notices\n    notice: (text) => console.warn(terminalSafeText(text)),\n  };\n}\n\nfunction processDependencies(): CliDependencies {\n  const cwd = process.cwd();\n  return {\n    cwd: pathToFileURL(`${cwd}/`),\n    version: readVersion(),\n    logger: defaultLogger(false),\n    console: terminalConsole(),\n    writeStdout: createPipeSafeWriter(process.stdout),\n    stdin: () => process.stdin,\n    // `isatty` reads the descriptor without opening `process.stdin`, which would keep the\n    // process alive.\n    isStdinTerminal: () => isatty(STDIN_DESCRIPTOR),\n    files: createNodeFileSystem(),\n    redoclyConfigs: createRedoclyConfigSource(cwd),\n    generate: generateTypes,\n    now: monotonicNow,\n    style: terminalStyle(),\n  };\n}\n\nrunCli(process.argv.slice(2), processDependencies()).then((exitCode) => {\n  process.exitCode = exitCode;\n});\n"],"names":[],"mappings":";;;;;;;;;;;;;;;AAsBA,MAAM,YAAA,GAAe,IAAI,GAAA,CAAI,oBAAA,EAAsB,YAAY,GAAG,CAAA;AAElE,SAAS,WAAA,GAAsB;AAC7B,EAAA,MAAM,cAAmC,IAAA,CAAK,KAAA,CAAM,GAAG,YAAA,CAAa,YAAA,EAAc,MAAM,CAAC,CAAA;AACzF,EAAA,OAAO,WAAA,CAAY,OAAA;AACrB;AAEA,SAAS,aAAA,GAA2B;AAClC,EAAA,MAAM,OAAA,GAAU,OAAO,MAAA,EAAO;AAC9B,EAAA,OAAA,CAAQ,UAAU,qBAAA,EAAsB;AACxC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,CAAC,IAAA,KAAS,OAAA,CAAQ,KAAK,IAAI,CAAA;AAAA,IACjC,KAAA,EAAO,CAAC,IAAA,KAAS,OAAA,CAAQ,MAAM,IAAI,CAAA;AAAA,IACnC,GAAA,EAAK,CAAC,IAAA,KAAS,OAAA,CAAQ,IAAI,IAAI;AAAA,GACjC;AACF;AAEA,MAAM,gBAAA,GAAmB,CAAA;AAEzB,MAAM,aAAA,GAA+B,OAAO,MAAA,EAAQ,OAAA,EAAS,OAAA,KAAY;AACvE,EAAA,MAAM,cAAA,GAAiB,aAAA,CAAc,OAAA,CAAQ,MAAA,IAAU,KAAK,CAAA;AAC5D,EAAA,MAAM,SAAS,OAAA,KAAY,MAAA,GAAY,cAAA,GAAiB,SAAA,CAAU,gBAAgB,OAAO,CAAA;AACzF,EAAA,MAAM,KAAA,GAAQ,MAAM,qBAAA,CAAsB,OAAA,EAAS,MAAM,CAAA;AACzD,EAAA,MAAM,EAAE,cAAc,UAAA,EAAW,GAAI,MAAM,gBAAA,CAAiB,MAAA,EAAQ,SAAS,KAAK,CAAA;AAClF,EAAA,OAAO,EAAE,UAAU,CAAA,EAAG,cAAc,GAAG,WAAA,CAAY,YAAY,CAAC,CAAA,CAAA,EAAI,UAAA,EAAW;AACjF,CAAA;AAEA,SAAS,eAAA,GAA8B;AACrC,EAAA,OAAO;AAAA;AAAA,IAEL,IAAA,EAAM,CAAC,IAAA,KAAS,OAAA,CAAQ,KAAK,IAAI,CAAA;AAAA;AAAA;AAAA,IAGjC,QAAQ,CAAC,IAAA,KAAS,QAAQ,IAAA,CAAK,gBAAA,CAAiB,IAAI,CAAC;AAAA,GACvD;AACF;AAEA,SAAS,mBAAA,GAAuC;AAC9C,EAAA,MAAM,GAAA,GAAM,QAAQ,GAAA,EAAI;AACxB,EAAA,OAAO;AAAA,IACL,GAAA,EAAK,aAAA,CAAc,CAAA,EAAG,GAAG,CAAA,CAAA,CAAG,CAAA;AAAA,IAC5B,SAAS,WAAA,EAAY;AAAA,IACrB,MAAA,EAAQ,cAAc,KAAK,CAAA;AAAA,IAC3B,SAAS,eAAA,EAAgB;AAAA,IACzB,WAAA,EAAa,oBAAA,CAAqB,OAAA,CAAQ,MAAM,CAAA;AAAA,IAChD,KAAA,EAAO,MAAM,OAAA,CAAQ,KAAA;AAAA;AAAA;AAAA,IAGrB,eAAA,EAAiB,MAAM,MAAA,CAAO,gBAAgB,CAAA;AAAA,IAC9C,OAAO,oBAAA,EAAqB;AAAA,IAC5B,cAAA,EAAgB,0BAA0B,GAAG,CAAA;AAAA,IAC7C,QAAA,EAAU,aAAA;AAAA,IACV,GAAA,EAAK,YAAA;AAAA,IACL,OAAO,aAAA;AAAc,GACvB;AACF;AAEA,MAAA,CAAO,OAAA,CAAQ,IAAA,CAAK,KAAA,CAAM,CAAC,CAAA,EAAG,qBAAqB,CAAA,CAAE,IAAA,CAAK,CAAC,QAAA,KAAa;AACtE,EAAA,OAAA,CAAQ,QAAA,GAAW,QAAA;AACrB,CAAC,CAAA"}

package/dist/cli/redocly-apis.cjs

@@ -2,6 +2,7 @@
 
 const apiSettings = require('./api-settings.cjs');
 const apiWrites = require('./api-writes.cjs');
+const cliArguments = require('./cli-arguments.cjs');
 const cliErrors = require('./cli-errors.cjs');
 const cliOutput = require('./cli-output.cjs');
 const docsLinks = require('./docs-links.cjs');
@@ -43,21 +44,25 @@ function apiTarget(api, configRoot) {
   }
   return { name, root, settings, configRoot };
 }
-function apiOptions(run, redocly, target) {
+function apiOptions(run, apiRun, target) {
   const { name, settings, configRoot } = target;
+  const flags = { ...run.args.generatorFlags, ...apiSettings.apiFlags(name, settings) };
+  for (const notice of cliArguments.ineffectiveFlagNotices(flags)) {
+    run.deps.console.notice(`API ${name}: ${notice}`);
+  }
   return {
-    ...run.args.generatorFlags,
-    ...apiSettings.apiFlags(name, settings),
-    ...refLimits.refLimitOptions(run.args, run.deps.cwd),
+    ...flags,
+    ...apiRun.refLimits,
     ...apiSettings.apiRefLimitOptions(name, settings, configRoot),
     ...fixOption.fixOption(apiSettings.apiFixNames(name, settings) ?? run.args.fix),
-    redocly
+    redocly: apiRun.redocly
   };
 }
 function otherOutputs(files, apiName) {
   return [...files.outputs].filter(([name]) => name !== apiName).map(([name, location]) => ({ name: `API ${name}`, location }));
 }
-async function generateApi(run, redocly, target, files) {
+async function generateApi(run, apiRun, target) {
+  const { files } = apiRun;
   for (const warning of apiSettings.unknownSettingWarnings(target.name, target.settings)) {
     run.deps.logger.warn(warning);
   }
@@ -66,8 +71,13 @@ async function generateApi(run, redocly, target, files) {
   cliOutput.ensureOutputIsNotSchema(run, outputFile, files.schemas);
   cliOutput.ensureOutputIsOwn(run, outputFile, otherOutputs(files, target.name));
   const source = cliOutput.resolveLocationUrl(target.root, target.configRoot);
-  const types = await run.deps.generate(source, apiOptions(run, redocly, target));
-  return { name: target.name, outputFile, types };
+  const options = apiOptions(run, apiRun, target);
+  try {
+    const types = await run.deps.generate(source, options, target.name);
+    return { name: target.name, outputFile, types };
+  } catch (error) {
+    throw new cliErrors.ApiFailure(target.name, error);
+  }
 }
 function configFilesOf(run, redocly, apis) {
   const configRoot = configRootOf(redocly, run.deps.cwd);
@@ -100,9 +110,10 @@ async function settledInTurn(items, task) {
 async function generateRedoclyApis(run, redocly) {
   const apis = redoclyApisOf(redocly);
   const { configRoot, files } = configFilesOf(run, redocly, apis);
+  const apiRun = { redocly, files, refLimits: refLimits.refLimitOptions(run.args, run.deps.cwd) };
   const results = await settledInTurn(
     apis,
-    (api) => generateApi(run, redocly, apiTarget(api, configRoot), files)
+    (api) => generateApi(run, apiRun, apiTarget(api, configRoot))
   );
   const generated = results.flatMap(
     (result) => result.status === "fulfilled" ? [result.value] : []

package/dist/cli/redocly-apis.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"redocly-apis.cjs","sources":["../../src/cli/redocly-apis.ts"],"sourcesContent":["import type { RedoclyConfig } from \"../application/ports/redocly-config-source.js\";\nimport type { GeneratorOptions } from \"../types.js\";\nimport {\n  type ApiSettings,\n  apiFixNames,\n  apiFlags,\n  apiOutputOf,\n  apiRefLimitOptions,\n  OUTPUT_SETTING,\n  unknownSettingWarnings,\n} from \"./api-settings.js\";\nimport { type GeneratedApi, writeGeneratedApis } from \"./api-writes.js\";\nimport { cliError } from \"./cli-errors.js\";\nimport {\n  type CliRun,\n  ensureOutputIsNotSchema,\n  ensureOutputIsOwn,\n  filesReadBy,\n  type NamedFile,\n  outputFileOf,\n  parseLocationUrl,\n  redoclyConfigFiles,\n  resolveLocationUrl,\n} from \"./cli-output.js\";\nimport { MULTIPLE_SCHEMAS_DOCS_URL } from \"./docs-links.js\";\nimport { fixOption } from \"./fix-option.js\";\nimport { refLimitOptions } from \"./ref-limits.js\";\n\n/** The `apis` of a Redocly config: each API is generated into its `x-openapi-ts.output`. */\n\n/** The key of an API's openapi-typesafe settings in `redocly.yaml`. */\nconst REDOCLY_CONFIG_KEY = \"x-openapi-ts\";\n\n/** An API of the config as written: `root` and the settings are not checked yet. */\ninterface RedoclyApi {\n  readonly name: string;\n  readonly root: unknown;\n  readonly settings: unknown;\n}\n\nfunction redoclyApisOf(redocly: RedoclyConfig): RedoclyApi[] {\n  return Object.entries(redocly.apis ?? {}).map(([name, api]) => {\n    const fields = api as Readonly<Record<string, unknown>>;\n    return { name, root: fields.root, settings: fields[REDOCLY_CONFIG_KEY] };\n  });\n}\n\nexport function hasRedoclyApis(redocly: RedoclyConfig): boolean {\n  return Object.keys(redocly.apis ?? {}).length > 0;\n}\n\n/** Paths in the config are relative to the config file; without a file, to the working dir. */\nfunction configRootOf(redocly: RedoclyConfig, cwd: URL): URL {\n  return redocly.configFile ? resolveLocationUrl(redocly.configFile, cwd) : cwd;\n}\n\n/** An API whose root and settings are usable, and the directory its paths are relative to. */\ninterface ApiTarget {\n  readonly name: string;\n  readonly root: string;\n  readonly settings: ApiSettings;\n  readonly configRoot: URL;\n}\n\nfunction isSettingsMap(value: unknown): value is ApiSettings {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/**\n * The API with its settings. Fails with `CLI_CONFIG_OUTPUT_MISSING` when they name no output, and\n * with `CLI_CONFIG_INVALID` when they are no map or `root` is no path or URL; only this API then\n * fails, the others are still generated.\n */\nfunction apiTarget(api: RedoclyApi, configRoot: URL): ApiTarget {\n  const { name, root, settings } = api;\n  if (settings !== undefined && !isSettingsMap(settings)) {\n    throw cliError(\"CLI_CONFIG_INVALID\", `API ${name}: \\`${REDOCLY_CONFIG_KEY}\\` must be a map`);\n  }\n  if (!settings?.[OUTPUT_SETTING]) {\n    throw cliError(\n      \"CLI_CONFIG_OUTPUT_MISSING\",\n      `API ${name} is missing an \\`${REDOCLY_CONFIG_KEY}.output\\` key. ` +\n        `See ${MULTIPLE_SCHEMAS_DOCS_URL}`,\n    );\n  }\n  if (typeof root !== \"string\" || root === \"\") {\n    throw cliError(\n      \"CLI_CONFIG_INVALID\",\n      `API ${name}: \\`root\\` in redocly.yaml must be the path or URL of its schema`,\n    );\n  }\n  return { name, root, settings, configRoot };\n}\n\n/** The generator options of one API: its own settings win over the CLI's flags. */\nfunction apiOptions(run: CliRun, redocly: RedoclyConfig, target: ApiTarget): GeneratorOptions {\n  const { name, settings, configRoot } = target;\n  return {\n    ...run.args.generatorFlags,\n    ...apiFlags(name, settings),\n    ...refLimitOptions(run.args, run.deps.cwd),\n    ...apiRefLimitOptions(name, settings, configRoot),\n    ...fixOption(apiFixNames(name, settings) ?? run.args.fix),\n    redocly,\n  };\n}\n\n/** The schemas and outputs of every API of the config, keyed by API name for the outputs. */\ninterface ConfigFiles {\n  readonly schemas: readonly NamedFile[];\n  readonly outputs: ReadonlyMap<string, URL>;\n}\n\n/** The outputs of the other APIs, as `ensureOutputIsOwn` names them. */\nfunction otherOutputs(files: ConfigFiles, apiName: string): NamedFile[] {\n  return [...files.outputs]\n    .filter(([name]) => name !== apiName)\n    .map(([name, location]) => ({ name: `API ${name}`, location }));\n}\n\n/**\n * Generate the types of one API. Its output must not be a file the run reads before any API is\n * loaded (the root of any API, the Redocly config) nor another API's output.\n */\nasync function generateApi(\n  run: CliRun,\n  redocly: RedoclyConfig,\n  target: ApiTarget,\n  files: ConfigFiles,\n): Promise<GeneratedApi> {\n  for (const warning of unknownSettingWarnings(target.name, target.settings)) {\n    run.deps.logger.warn(warning);\n  }\n  const output = apiOutputOf(target.name, target.settings);\n  const outputFile = outputFileOf(run, { source: target.name, output }, target.configRoot);\n  ensureOutputIsNotSchema(run, outputFile, files.schemas);\n  ensureOutputIsOwn(run, outputFile, otherOutputs(files, target.name));\n  const source = resolveLocationUrl(target.root, target.configRoot);\n  const types = await run.deps.generate(source, apiOptions(run, redocly, target));\n  return { name: target.name, outputFile, types };\n}\n\n/**\n * The schema and the output of every API, and the config file itself. A location that is no\n * text or no valid URL is left out: it is no file that an output could be, and its own API fails\n * on it, not every API.\n */\nfunction configFilesOf(run: CliRun, redocly: RedoclyConfig, apis: readonly RedoclyApi[]) {\n  const configRoot = configRootOf(redocly, run.deps.cwd);\n  const roots = apis.flatMap(({ name, root }) => {\n    const location = typeof root === \"string\" ? parseLocationUrl(root, configRoot) : undefined;\n    return location ? [{ name: `schema ${root} of API ${name}`, location }] : [];\n  });\n  const outputs = new Map<string, URL>();\n  for (const api of apis) {\n    const output = isSettingsMap(api.settings) ? api.settings[OUTPUT_SETTING] : undefined;\n    const location = typeof output === \"string\" ? parseLocationUrl(output, configRoot) : undefined;\n    if (location) {\n      outputs.set(api.name, location);\n    }\n  }\n  const schemas = [...roots, ...redoclyConfigFiles(run, redocly)];\n  return { configRoot, files: { schemas, outputs } satisfies ConfigFiles };\n}\n\n/** What `task` gives for each item, run one after another: the next starts when one settles. */\nasync function settledInTurn<T, R>(\n  items: readonly T[],\n  task: (item: T) => Promise<R>,\n): Promise<PromiseSettledResult<R>[]> {\n  const results: PromiseSettledResult<R>[] = [];\n  for (const item of items) {\n    try {\n      results.push({ status: \"fulfilled\", value: await task(item) });\n    } catch (reason) {\n      results.push({ status: \"rejected\", reason });\n    }\n  }\n  return results;\n}\n\n/**\n * Generate every API of the config, one after another in the order of the config, then write\n * them. One at a time, so a run takes the memory of its largest API, not the sum of all of them,\n * and the work of one API cannot hold up the fetches of another until their timeout ends them.\n * Nothing is written until every API is read and every output is claimed, so no output can\n * replace a file that another API still reads; an output that is a file any API read (a `$ref`'d\n * schema) fails with `CLI_OUTPUT_IS_INPUT`. Every API is generated or checked even when another\n * fails, so `--check` reports a stale output wherever it is; the failures are returned in the\n * order of the config.\n */\nexport async function generateRedoclyApis(run: CliRun, redocly: RedoclyConfig): Promise<unknown[]> {\n  const apis = redoclyApisOf(redocly);\n  const { configRoot, files } = configFilesOf(run, redocly, apis);\n  const results = await settledInTurn(apis, (api) =>\n    generateApi(run, redocly, apiTarget(api, configRoot), files),\n  );\n  const generated = results.flatMap((result) =>\n    result.status === \"fulfilled\" ? [result.value] : [],\n  );\n  const readFiles = generated.flatMap(({ name, types }) => filesReadBy(run, types, `API ${name}`));\n  const writeFailures = writeGeneratedApis(run, generated, readFiles);\n  return results.flatMap((result) =>\n    result.status === \"rejected\" ? [result.reason] : (writeFailures.get(result.value.name) ?? []),\n  );\n}\n"],"names":["resolveLocationUrl","cliError","OUTPUT_SETTING","MULTIPLE_SCHEMAS_DOCS_URL","apiFlags","refLimitOptions","apiRefLimitOptions","fixOption","apiFixNames","unknownSettingWarnings","apiOutputOf","outputFileOf","ensureOutputIsNotSchema","ensureOutputIsOwn","parseLocationUrl","redoclyConfigFiles","filesReadBy","writeGeneratedApis"],"mappings":";;;;;;;;;;AA+BA,MAAM,kBAAA,GAAqB,cAAA;AAS3B,SAAS,cAAc,OAAA,EAAsC;AAC3D,EAAA,OAAO,MAAA,CAAO,OAAA,CAAQ,OAAA,CAAQ,IAAA,IAAQ,EAAE,CAAA,CAAE,GAAA,CAAI,CAAC,CAAC,IAAA,EAAM,GAAG,CAAA,KAAM;AAC7D,IAAA,MAAM,MAAA,GAAS,GAAA;AACf,IAAA,OAAO,EAAE,MAAM,IAAA,EAAM,MAAA,CAAO,MAAM,QAAA,EAAU,MAAA,CAAO,kBAAkB,CAAA,EAAE;AAAA,EACzE,CAAC,CAAA;AACH;AAEO,SAAS,eAAe,OAAA,EAAiC;AAC9D,EAAA,OAAO,OAAO,IAAA,CAAK,OAAA,CAAQ,QAAQ,EAAE,EAAE,MAAA,GAAS,CAAA;AAClD;AAGA,SAAS,YAAA,CAAa,SAAwB,GAAA,EAAe;AAC3D,EAAA,OAAO,QAAQ,UAAA,GAAaA,4BAAA,CAAmB,OAAA,CAAQ,UAAA,EAAY,GAAG,CAAA,GAAI,GAAA;AAC5E;AAUA,SAAS,cAAc,KAAA,EAAsC;AAC3D,EAAA,OAAO,OAAO,UAAU,QAAA,IAAY,KAAA,KAAU,QAAQ,CAAC,KAAA,CAAM,QAAQ,KAAK,CAAA;AAC5E;AAOA,SAAS,SAAA,CAAU,KAAiB,UAAA,EAA4B;AAC9D,EAAA,MAAM,EAAE,IAAA,EAAM,IAAA,EAAM,QAAA,EAAS,GAAI,GAAA;AACjC,EAAA,IAAI,QAAA,KAAa,MAAA,IAAa,CAAC,aAAA,CAAc,QAAQ,CAAA,EAAG;AACtD,IAAA,MAAMC,mBAAS,oBAAA,EAAsB,CAAA,IAAA,EAAO,IAAI,CAAA,IAAA,EAAO,kBAAkB,CAAA,gBAAA,CAAkB,CAAA;AAAA,EAC7F;AACA,EAAA,IAAI,CAAC,QAAA,GAAWC,0BAAc,CAAA,EAAG;AAC/B,IAAA,MAAMD,kBAAA;AAAA,MACJ,2BAAA;AAAA,MACA,CAAA,IAAA,EAAO,IAAI,CAAA,iBAAA,EAAoB,kBAAkB,sBACxCE,mCAAyB,CAAA;AAAA,KACpC;AAAA,EACF;AACA,EAAA,IAAI,OAAO,IAAA,KAAS,QAAA,IAAY,IAAA,KAAS,EAAA,EAAI;AAC3C,IAAA,MAAMF,kBAAA;AAAA,MACJ,oBAAA;AAAA,MACA,OAAO,IAAI,CAAA,gEAAA;AAAA,KACb;AAAA,EACF;AACA,EAAA,OAAO,EAAE,IAAA,EAAM,IAAA,EAAM,QAAA,EAAU,UAAA,EAAW;AAC5C;AAGA,SAAS,UAAA,CAAW,GAAA,EAAa,OAAA,EAAwB,MAAA,EAAqC;AAC5F,EAAA,MAAM,EAAE,IAAA,EAAM,QAAA,EAAU,UAAA,EAAW,GAAI,MAAA;AACvC,EAAA,OAAO;AAAA,IACL,GAAG,IAAI,IAAA,CAAK,cAAA;AAAA,IACZ,GAAGG,oBAAA,CAAS,IAAA,EAAM,QAAQ,CAAA;AAAA,IAC1B,GAAGC,yBAAA,CAAgB,GAAA,CAAI,IAAA,EAAM,GAAA,CAAI,KAAK,GAAG,CAAA;AAAA,IACzC,GAAGC,8BAAA,CAAmB,IAAA,EAAM,QAAA,EAAU,UAAU,CAAA;AAAA,IAChD,GAAGC,oBAAUC,uBAAA,CAAY,IAAA,EAAM,QAAQ,CAAA,IAAK,GAAA,CAAI,KAAK,GAAG,CAAA;AAAA,IACxD;AAAA,GACF;AACF;AASA,SAAS,YAAA,CAAa,OAAoB,OAAA,EAA8B;AACtE,EAAA,OAAO,CAAC,GAAG,KAAA,CAAM,OAAO,CAAA,CACrB,OAAO,CAAC,CAAC,IAAI,CAAA,KAAM,IAAA,KAAS,OAAO,EACnC,GAAA,CAAI,CAAC,CAAC,IAAA,EAAM,QAAQ,CAAA,MAAO,EAAE,IAAA,EAAM,CAAA,IAAA,EAAO,IAAI,CAAA,CAAA,EAAI,QAAA,EAAS,CAAE,CAAA;AAClE;AAMA,eAAe,WAAA,CACb,GAAA,EACA,OAAA,EACA,MAAA,EACA,KAAA,EACuB;AACvB,EAAA,KAAA,MAAW,WAAWC,kCAAA,CAAuB,MAAA,CAAO,IAAA,EAAM,MAAA,CAAO,QAAQ,CAAA,EAAG;AAC1E,IAAA,GAAA,CAAI,IAAA,CAAK,MAAA,CAAO,IAAA,CAAK,OAAO,CAAA;AAAA,EAC9B;AACA,EAAA,MAAM,MAAA,GAASC,uBAAA,CAAY,MAAA,CAAO,IAAA,EAAM,OAAO,QAAQ,CAAA;AACvD,EAAA,MAAM,UAAA,GAAaC,sBAAA,CAAa,GAAA,EAAK,EAAE,MAAA,EAAQ,OAAO,IAAA,EAAM,MAAA,EAAO,EAAG,MAAA,CAAO,UAAU,CAAA;AACvF,EAAAC,iCAAA,CAAwB,GAAA,EAAK,UAAA,EAAY,KAAA,CAAM,OAAO,CAAA;AACtD,EAAAC,2BAAA,CAAkB,KAAK,UAAA,EAAY,YAAA,CAAa,KAAA,EAAO,MAAA,CAAO,IAAI,CAAC,CAAA;AACnE,EAAA,MAAM,MAAA,GAASb,4BAAA,CAAmB,MAAA,CAAO,IAAA,EAAM,OAAO,UAAU,CAAA;AAChE,EAAA,MAAM,KAAA,GAAQ,MAAM,GAAA,CAAI,IAAA,CAAK,QAAA,CAAS,QAAQ,UAAA,CAAW,GAAA,EAAK,OAAA,EAAS,MAAM,CAAC,CAAA;AAC9E,EAAA,OAAO,EAAE,IAAA,EAAM,MAAA,CAAO,IAAA,EAAM,YAAY,KAAA,EAAM;AAChD;AAOA,SAAS,aAAA,CAAc,GAAA,EAAa,OAAA,EAAwB,IAAA,EAA6B;AACvF,EAAA,MAAM,UAAA,GAAa,YAAA,CAAa,OAAA,EAAS,GAAA,CAAI,KAAK,GAAG,CAAA;AACrD,EAAA,MAAM,QAAQ,IAAA,CAAK,OAAA,CAAQ,CAAC,EAAE,IAAA,EAAM,MAAK,KAAM;AAC7C,IAAA,MAAM,WAAW,OAAO,IAAA,KAAS,WAAWc,0BAAA,CAAiB,IAAA,EAAM,UAAU,CAAA,GAAI,MAAA;AACjF,IAAA,OAAO,QAAA,GAAW,CAAC,EAAE,IAAA,EAAM,CAAA,OAAA,EAAU,IAAI,CAAA,QAAA,EAAW,IAAI,CAAA,CAAA,EAAI,QAAA,EAAU,CAAA,GAAI,EAAC;AAAA,EAC7E,CAAC,CAAA;AACD,EAAA,MAAM,OAAA,uBAAc,GAAA,EAAiB;AACrC,EAAA,KAAA,MAAW,OAAO,IAAA,EAAM;AACtB,IAAA,MAAM,MAAA,GAAS,cAAc,GAAA,CAAI,QAAQ,IAAI,GAAA,CAAI,QAAA,CAASZ,0BAAc,CAAA,GAAI,MAAA;AAC5E,IAAA,MAAM,WAAW,OAAO,MAAA,KAAW,WAAWY,0BAAA,CAAiB,MAAA,EAAQ,UAAU,CAAA,GAAI,MAAA;AACrF,IAAA,IAAI,QAAA,EAAU;AACZ,MAAA,OAAA,CAAQ,GAAA,CAAI,GAAA,CAAI,IAAA,EAAM,QAAQ,CAAA;AAAA,IAChC;AAAA,EACF;AACA,EAAA,MAAM,OAAA,GAAU,CAAC,GAAG,KAAA,EAAO,GAAGC,4BAAA,CAAmB,GAAA,EAAK,OAAO,CAAC,CAAA;AAC9D,EAAA,OAAO,EAAE,UAAA,EAAY,KAAA,EAAO,EAAE,OAAA,EAAS,SAAQ,EAAwB;AACzE;AAGA,eAAe,aAAA,CACb,OACA,IAAA,EACoC;AACpC,EAAA,MAAM,UAAqC,EAAC;AAC5C,EAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,IAAA,IAAI;AACF,MAAA,OAAA,CAAQ,IAAA,CAAK,EAAE,MAAA,EAAQ,WAAA,EAAa,OAAO,MAAM,IAAA,CAAK,IAAI,CAAA,EAAG,CAAA;AAAA,IAC/D,SAAS,MAAA,EAAQ;AACf,MAAA,OAAA,CAAQ,IAAA,CAAK,EAAE,MAAA,EAAQ,UAAA,EAAY,QAAQ,CAAA;AAAA,IAC7C;AAAA,EACF;AACA,EAAA,OAAO,OAAA;AACT;AAYA,eAAsB,mBAAA,CAAoB,KAAa,OAAA,EAA4C;AACjG,EAAA,MAAM,IAAA,GAAO,cAAc,OAAO,CAAA;AAClC,EAAA,MAAM,EAAE,UAAA,EAAY,KAAA,KAAU,aAAA,CAAc,GAAA,EAAK,SAAS,IAAI,CAAA;AAC9D,EAAA,MAAM,UAAU,MAAM,aAAA;AAAA,IAAc,IAAA;AAAA,IAAM,CAAC,QACzC,WAAA,CAAY,GAAA,EAAK,SAAS,SAAA,CAAU,GAAA,EAAK,UAAU,CAAA,EAAG,KAAK;AAAA,GAC7D;AACA,EAAA,MAAM,YAAY,OAAA,CAAQ,OAAA;AAAA,IAAQ,CAAC,WACjC,MAAA,CAAO,MAAA,KAAW,cAAc,CAAC,MAAA,CAAO,KAAK,CAAA,GAAI;AAAC,GACpD;AACA,EAAA,MAAM,SAAA,GAAY,SAAA,CAAU,OAAA,CAAQ,CAAC,EAAE,IAAA,EAAM,KAAA,EAAM,KAAMC,qBAAA,CAAY,GAAA,EAAK,KAAA,EAAO,CAAA,IAAA,EAAO,IAAI,EAAE,CAAC,CAAA;AAC/F,EAAA,MAAM,aAAA,GAAgBC,4BAAA,CAAmB,GAAA,EAAK,SAAA,EAAW,SAAS,CAAA;AAClE,EAAA,OAAO,OAAA,CAAQ,OAAA;AAAA,IAAQ,CAAC,MAAA,KACtB,MAAA,CAAO,MAAA,KAAW,aAAa,CAAC,MAAA,CAAO,MAAM,CAAA,GAAK,cAAc,GAAA,CAAI,MAAA,CAAO,KAAA,CAAM,IAAI,KAAK;AAAC,GAC7F;AACF;;;"}
+{"version":3,"file":"redocly-apis.cjs","sources":["../../src/cli/redocly-apis.ts"],"sourcesContent":["import type { RedoclyConfig } from \"../application/ports/redocly-config-source.js\";\nimport type { GeneratorOptions } from \"../types.js\";\nimport {\n  type ApiSettings,\n  apiFixNames,\n  apiFlags,\n  apiOutputOf,\n  apiRefLimitOptions,\n  OUTPUT_SETTING,\n  unknownSettingWarnings,\n} from \"./api-settings.js\";\nimport { type GeneratedApi, writeGeneratedApis } from \"./api-writes.js\";\nimport { ineffectiveFlagNotices } from \"./cli-arguments.js\";\nimport { ApiFailure, cliError } from \"./cli-errors.js\";\nimport {\n  type CliRun,\n  ensureOutputIsNotSchema,\n  ensureOutputIsOwn,\n  filesReadBy,\n  type NamedFile,\n  outputFileOf,\n  parseLocationUrl,\n  redoclyConfigFiles,\n  resolveLocationUrl,\n} from \"./cli-output.js\";\nimport { MULTIPLE_SCHEMAS_DOCS_URL } from \"./docs-links.js\";\nimport { fixOption } from \"./fix-option.js\";\nimport { type RefLimitOptions, refLimitOptions } from \"./ref-limits.js\";\n\n/** The `apis` of a Redocly config: each API is generated into its `x-openapi-ts.output`. */\n\n/** The key of an API's openapi-typesafe settings in `redocly.yaml`. */\nconst REDOCLY_CONFIG_KEY = \"x-openapi-ts\";\n\n/** An API of the config as written: `root` and the settings are not checked yet. */\ninterface RedoclyApi {\n  readonly name: string;\n  readonly root: unknown;\n  readonly settings: unknown;\n}\n\nfunction redoclyApisOf(redocly: RedoclyConfig): RedoclyApi[] {\n  return Object.entries(redocly.apis ?? {}).map(([name, api]) => {\n    const fields = api as Readonly<Record<string, unknown>>;\n    return { name, root: fields.root, settings: fields[REDOCLY_CONFIG_KEY] };\n  });\n}\n\nexport function hasRedoclyApis(redocly: RedoclyConfig): boolean {\n  return Object.keys(redocly.apis ?? {}).length > 0;\n}\n\n/** Paths in the config are relative to the config file; without a file, to the working dir. */\nfunction configRootOf(redocly: RedoclyConfig, cwd: URL): URL {\n  return redocly.configFile ? resolveLocationUrl(redocly.configFile, cwd) : cwd;\n}\n\n/** An API whose root and settings are usable, and the directory its paths are relative to. */\ninterface ApiTarget {\n  readonly name: string;\n  readonly root: string;\n  readonly settings: ApiSettings;\n  readonly configRoot: URL;\n}\n\nfunction isSettingsMap(value: unknown): value is ApiSettings {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/**\n * The API with its settings. Fails with `CLI_CONFIG_OUTPUT_MISSING` when they name no output, and\n * with `CLI_CONFIG_INVALID` when they are no map or `root` is no path or URL; only this API then\n * fails, the others are still generated.\n */\nfunction apiTarget(api: RedoclyApi, configRoot: URL): ApiTarget {\n  const { name, root, settings } = api;\n  if (settings !== undefined && !isSettingsMap(settings)) {\n    throw cliError(\"CLI_CONFIG_INVALID\", `API ${name}: \\`${REDOCLY_CONFIG_KEY}\\` must be a map`);\n  }\n  if (!settings?.[OUTPUT_SETTING]) {\n    throw cliError(\n      \"CLI_CONFIG_OUTPUT_MISSING\",\n      `API ${name} is missing an \\`${REDOCLY_CONFIG_KEY}.output\\` key. ` +\n        `See ${MULTIPLE_SCHEMAS_DOCS_URL}`,\n    );\n  }\n  if (typeof root !== \"string\" || root === \"\") {\n    throw cliError(\n      \"CLI_CONFIG_INVALID\",\n      `API ${name}: \\`root\\` in redocly.yaml must be the path or URL of its schema`,\n    );\n  }\n  return { name, root, settings, configRoot };\n}\n\n/**\n * What every API of a run shares: the config, the files of all APIs, and the reference limits of\n * the command line, which are checked once before any API, so an invalid flag fails the run once.\n */\ninterface ApiRun {\n  readonly redocly: RedoclyConfig;\n  readonly files: ConfigFiles;\n  readonly refLimits: RefLimitOptions;\n}\n\n/**\n * The generator options of one API: its own settings win over the CLI's flags. A flag that has\n * no effect with the merged flags is named for this API, since its settings may turn on the flag\n * that the command line lacks, or set one that has no effect themselves.\n */\nfunction apiOptions(run: CliRun, apiRun: ApiRun, target: ApiTarget): GeneratorOptions {\n  const { name, settings, configRoot } = target;\n  const flags = { ...run.args.generatorFlags, ...apiFlags(name, settings) };\n  for (const notice of ineffectiveFlagNotices(flags)) {\n    run.deps.console.notice(`API ${name}: ${notice}`);\n  }\n  return {\n    ...flags,\n    ...apiRun.refLimits,\n    ...apiRefLimitOptions(name, settings, configRoot),\n    ...fixOption(apiFixNames(name, settings) ?? run.args.fix),\n    redocly: apiRun.redocly,\n  };\n}\n\n/** The schemas and outputs of every API of the config, keyed by API name for the outputs. */\ninterface ConfigFiles {\n  readonly schemas: readonly NamedFile[];\n  readonly outputs: ReadonlyMap<string, URL>;\n}\n\n/** The outputs of the other APIs, as `ensureOutputIsOwn` names them. */\nfunction otherOutputs(files: ConfigFiles, apiName: string): NamedFile[] {\n  return [...files.outputs]\n    .filter(([name]) => name !== apiName)\n    .map(([name, location]) => ({ name: `API ${name}`, location }));\n}\n\n/**\n * Generate the types of one API. Its output must not be a file the run reads before any API is\n * loaded (the root of any API, the Redocly config) nor another API's output.\n */\nasync function generateApi(run: CliRun, apiRun: ApiRun, target: ApiTarget): Promise<GeneratedApi> {\n  const { files } = apiRun;\n  for (const warning of unknownSettingWarnings(target.name, target.settings)) {\n    run.deps.logger.warn(warning);\n  }\n  const output = apiOutputOf(target.name, target.settings);\n  const outputFile = outputFileOf(run, { source: target.name, output }, target.configRoot);\n  ensureOutputIsNotSchema(run, outputFile, files.schemas);\n  ensureOutputIsOwn(run, outputFile, otherOutputs(files, target.name));\n  const source = resolveLocationUrl(target.root, target.configRoot);\n  const options = apiOptions(run, apiRun, target);\n  try {\n    const types = await run.deps.generate(source, options, target.name);\n    return { name: target.name, outputFile, types };\n  } catch (error) {\n    throw new ApiFailure(target.name, error);\n  }\n}\n\n/**\n * The schema and the output of every API, and the config file itself. A location that is no\n * text or no valid URL is left out: it is no file that an output could be, and its own API fails\n * on it, not every API.\n */\nfunction configFilesOf(run: CliRun, redocly: RedoclyConfig, apis: readonly RedoclyApi[]) {\n  const configRoot = configRootOf(redocly, run.deps.cwd);\n  const roots = apis.flatMap(({ name, root }) => {\n    const location = typeof root === \"string\" ? parseLocationUrl(root, configRoot) : undefined;\n    return location ? [{ name: `schema ${root} of API ${name}`, location }] : [];\n  });\n  const outputs = new Map<string, URL>();\n  for (const api of apis) {\n    const output = isSettingsMap(api.settings) ? api.settings[OUTPUT_SETTING] : undefined;\n    const location = typeof output === \"string\" ? parseLocationUrl(output, configRoot) : undefined;\n    if (location) {\n      outputs.set(api.name, location);\n    }\n  }\n  const schemas = [...roots, ...redoclyConfigFiles(run, redocly)];\n  return { configRoot, files: { schemas, outputs } satisfies ConfigFiles };\n}\n\n/** What `task` gives for each item, run one after another: the next starts when one settles. */\nasync function settledInTurn<T, R>(\n  items: readonly T[],\n  task: (item: T) => Promise<R>,\n): Promise<PromiseSettledResult<R>[]> {\n  const results: PromiseSettledResult<R>[] = [];\n  for (const item of items) {\n    try {\n      results.push({ status: \"fulfilled\", value: await task(item) });\n    } catch (reason) {\n      results.push({ status: \"rejected\", reason });\n    }\n  }\n  return results;\n}\n\n/**\n * Generate every API of the config, one after another in the order of the config, then write\n * them. One at a time, so a run takes the memory of its largest API, not the sum of all of them,\n * and the work of one API cannot hold up the fetches of another until their timeout ends them.\n * Nothing is written until every API is read and every output is claimed, so no output can\n * replace a file that another API still reads; an output that is a file any API read (a `$ref`'d\n * schema) fails with `CLI_OUTPUT_IS_INPUT`. Every API is generated or checked even when another\n * fails, so `--check` reports a stale output wherever it is; the failures are returned in the\n * order of the config.\n */\nexport async function generateRedoclyApis(run: CliRun, redocly: RedoclyConfig): Promise<unknown[]> {\n  const apis = redoclyApisOf(redocly);\n  const { configRoot, files } = configFilesOf(run, redocly, apis);\n  const apiRun = { redocly, files, refLimits: refLimitOptions(run.args, run.deps.cwd) };\n  const results = await settledInTurn(apis, (api) =>\n    generateApi(run, apiRun, apiTarget(api, configRoot)),\n  );\n  const generated = results.flatMap((result) =>\n    result.status === \"fulfilled\" ? [result.value] : [],\n  );\n  const readFiles = generated.flatMap(({ name, types }) => filesReadBy(run, types, `API ${name}`));\n  const writeFailures = writeGeneratedApis(run, generated, readFiles);\n  return results.flatMap((result) =>\n    result.status === \"rejected\" ? [result.reason] : (writeFailures.get(result.value.name) ?? []),\n  );\n}\n"],"names":["resolveLocationUrl","cliError","OUTPUT_SETTING","MULTIPLE_SCHEMAS_DOCS_URL","apiFlags","ineffectiveFlagNotices","apiRefLimitOptions","fixOption","apiFixNames","unknownSettingWarnings","apiOutputOf","outputFileOf","ensureOutputIsNotSchema","ensureOutputIsOwn","ApiFailure","parseLocationUrl","redoclyConfigFiles","refLimitOptions","filesReadBy","writeGeneratedApis"],"mappings":"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"}