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

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,31 +44,50 @@ 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: run.deps.redoclyConfigs.forApi(apiRun.redocly, name)
   };
 }
 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);
   }
   const output = apiSettings.apiOutputOf(target.name, target.settings);
-  const outputFile = cliOutput.outputFileOf(run, { source: target.name, output }, target.configRoot);
-  cliOutput.ensureOutputIsNotSchema(run, outputFile, files.schemas);
-  cliOutput.ensureOutputIsOwn(run, outputFile, otherOutputs(files, target.name));
+  const outputFile = failingAsApi(target.name, () => {
+    const file = cliOutput.outputFileOf(run, { source: target.name, output }, target.configRoot);
+    cliOutput.ensureOutputIsNotSchema(run, file, files.schemas);
+    cliOutput.ensureOutputIsOwn(run, file, otherOutputs(files, target.name));
+    return file;
+  });
   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 failingAsApi(apiName, step) {
+  try {
+    return step();
+  } catch (error) {
+    throw new cliErrors.ApiFailure(apiName, error);
+  }
 }
 function configFilesOf(run, redocly, apis) {
   const configRoot = configRootOf(redocly, run.deps.cwd);
@@ -100,9 +120,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":"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"}
+{"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, and its own lint\n * rules in `redocly.yaml` over the root's (upstream used the root's only). 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: run.deps.redoclyConfigs.forApi(apiRun.redocly, name),\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 = failingAsApi(target.name, () => {\n    const file = outputFileOf(run, { source: target.name, output }, target.configRoot);\n    ensureOutputIsNotSchema(run, file, files.schemas);\n    ensureOutputIsOwn(run, file, otherOutputs(files, target.name));\n    return file;\n  });\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 result of a step of one API, whose failure is reported with the API's name. Errors of an\n * API's settings name the API in their own message and are not wrapped.\n */\nfunction failingAsApi<T>(apiName: string, step: () => T): T {\n  try {\n    return step();\n  } catch (error) {\n    throw new ApiFailure(apiName, 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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"}

package/dist/cli/redocly-apis.mjs

@@ -1,6 +1,7 @@
-import { OUTPUT_SETTING, unknownSettingWarnings, apiOutputOf, apiFixNames, apiRefLimitOptions, apiFlags } from './api-settings.mjs';
+import { OUTPUT_SETTING, unknownSettingWarnings, apiOutputOf, apiFlags, apiFixNames, apiRefLimitOptions } from './api-settings.mjs';
 import { writeGeneratedApis } from './api-writes.mjs';
-import { cliError } from './cli-errors.mjs';
+import { ineffectiveFlagNotices } from './cli-arguments.mjs';
+import { ApiFailure, cliError } from './cli-errors.mjs';
 import { filesReadBy, parseLocationUrl, redoclyConfigFiles, resolveLocationUrl, outputFileOf, ensureOutputIsNotSchema, ensureOutputIsOwn } from './cli-output.mjs';
 import { MULTIPLE_SCHEMAS_DOCS_URL } from './docs-links.mjs';
 import { fixOption } from './fix-option.mjs';
@@ -41,31 +42,50 @@ 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, ...apiFlags(name, settings) };
+  for (const notice of ineffectiveFlagNotices(flags)) {
+    run.deps.console.notice(`API ${name}: ${notice}`);
+  }
   return {
-    ...run.args.generatorFlags,
-    ...apiFlags(name, settings),
-    ...refLimitOptions(run.args, run.deps.cwd),
+    ...flags,
+    ...apiRun.refLimits,
     ...apiRefLimitOptions(name, settings, configRoot),
     ...fixOption(apiFixNames(name, settings) ?? run.args.fix),
-    redocly
+    redocly: run.deps.redoclyConfigs.forApi(apiRun.redocly, name)
   };
 }
 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 unknownSettingWarnings(target.name, target.settings)) {
     run.deps.logger.warn(warning);
   }
   const output = apiOutputOf(target.name, target.settings);
-  const outputFile = outputFileOf(run, { source: target.name, output }, target.configRoot);
-  ensureOutputIsNotSchema(run, outputFile, files.schemas);
-  ensureOutputIsOwn(run, outputFile, otherOutputs(files, target.name));
+  const outputFile = failingAsApi(target.name, () => {
+    const file = outputFileOf(run, { source: target.name, output }, target.configRoot);
+    ensureOutputIsNotSchema(run, file, files.schemas);
+    ensureOutputIsOwn(run, file, otherOutputs(files, target.name));
+    return file;
+  });
   const source = 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 ApiFailure(target.name, error);
+  }
+}
+function failingAsApi(apiName, step) {
+  try {
+    return step();
+  } catch (error) {
+    throw new ApiFailure(apiName, error);
+  }
 }
 function configFilesOf(run, redocly, apis) {
   const configRoot = configRootOf(redocly, run.deps.cwd);
@@ -98,9 +118,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: 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.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"redocly-apis.mjs","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":[],"mappings":"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"}
+{"version":3,"file":"redocly-apis.mjs","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, and its own lint\n * rules in `redocly.yaml` over the root's (upstream used the root's only). 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: run.deps.redoclyConfigs.forApi(apiRun.redocly, name),\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 = failingAsApi(target.name, () => {\n    const file = outputFileOf(run, { source: target.name, output }, target.configRoot);\n    ensureOutputIsNotSchema(run, file, files.schemas);\n    ensureOutputIsOwn(run, file, otherOutputs(files, target.name));\n    return file;\n  });\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 result of a step of one API, whose failure is reported with the API's name. Errors of an\n * API's settings name the API in their own message and are not wrapped.\n */\nfunction failingAsApi<T>(apiName: string, step: () => T): T {\n  try {\n    return step();\n  } catch (error) {\n    throw new ApiFailure(apiName, 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":[],"mappings":"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"}

package/dist/cli/ref-limits.cjs

@@ -1,14 +1,28 @@
 'use strict';
 
+const cliErrors = require('./cli-errors.cjs');
 const cliOutput = require('./cli-output.cjs');
 
+const FILE_PROTOCOL = "file:";
+function localRootUrl(location, base) {
+  const url = cliOutput.resolveLocationUrl(location, base);
+  return url.protocol === FILE_PROTOCOL ? url : void 0;
+}
 function refLimitOptions(args, cwd) {
   const { localRefRoot, remoteRefHosts } = args.refLimits;
+  const localRoot = localRefRoot === void 0 ? void 0 : localRootUrl(localRefRoot, cwd);
+  if (localRefRoot !== void 0 && localRoot === void 0) {
+    throw cliErrors.cliError(
+      "CLI_FLAG_INVALID",
+      `--local-ref-root ${localRefRoot}: a directory path or a file: URL.`
+    );
+  }
   return {
-    ...localRefRoot === void 0 ? {} : { localRefRoot: cliOutput.resolveLocationUrl(localRefRoot, cwd) },
+    ...localRoot === void 0 ? {} : { localRefRoot: localRoot },
     ...remoteRefHosts === void 0 ? {} : { remoteRefHosts }
   };
 }
 
+exports.localRootUrl = localRootUrl;
 exports.refLimitOptions = refLimitOptions;
 //# sourceMappingURL=ref-limits.cjs.map

package/dist/cli/ref-limits.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ref-limits.cjs","sources":["../../src/cli/ref-limits.ts"],"sourcesContent":["import type { GeneratorOptions } from \"../types.js\";\nimport type { CliArguments } from \"./cli-arguments.js\";\nimport { resolveLocationUrl } from \"./cli-output.js\";\n\n/** The `$ref` limits of the CLI flags as generator options (threat model R1, R2, ADR-017). */\n\nexport type RefLimitOptions = Pick<GeneratorOptions, \"localRefRoot\" | \"remoteRefHosts\">;\n\n/** `--local-ref-root` resolves against the working directory, like every other CLI path. */\nexport function refLimitOptions(args: CliArguments, cwd: URL): RefLimitOptions {\n  const { localRefRoot, remoteRefHosts } = args.refLimits;\n  return {\n    ...(localRefRoot === undefined ? {} : { localRefRoot: resolveLocationUrl(localRefRoot, cwd) }),\n    ...(remoteRefHosts === undefined ? {} : { remoteRefHosts }),\n  };\n}\n"],"names":["resolveLocationUrl"],"mappings":";;;;AASO,SAAS,eAAA,CAAgB,MAAoB,GAAA,EAA2B;AAC7E,EAAA,MAAM,EAAE,YAAA,EAAc,cAAA,EAAe,GAAI,IAAA,CAAK,SAAA;AAC9C,EAAA,OAAO;AAAA,IACL,GAAI,YAAA,KAAiB,MAAA,GAAY,EAAC,GAAI,EAAE,YAAA,EAAcA,4BAAA,CAAmB,YAAA,EAAc,GAAG,CAAA,EAAE;AAAA,IAC5F,GAAI,cAAA,KAAmB,MAAA,GAAY,EAAC,GAAI,EAAE,cAAA;AAAe,GAC3D;AACF;;"}
+{"version":3,"file":"ref-limits.cjs","sources":["../../src/cli/ref-limits.ts"],"sourcesContent":["import type { GeneratorOptions } from \"../types.js\";\nimport type { CliArguments } from \"./cli-arguments.js\";\nimport { cliError } from \"./cli-errors.js\";\nimport { resolveLocationUrl } from \"./cli-output.js\";\n\n/** The `$ref` limits of the CLI flags as generator options (threat model R1, R2, ADR-017). */\n\nexport type RefLimitOptions = Pick<GeneratorOptions, \"localRefRoot\" | \"remoteRefHosts\">;\n\nconst FILE_PROTOCOL = \"file:\";\n\n/** A local `$ref` root as a URL; undefined for a URL of another protocol, which names no folder. */\nexport function localRootUrl(location: string, base: URL): URL | undefined {\n  const url = resolveLocationUrl(location, base);\n  return url.protocol === FILE_PROTOCOL ? url : undefined;\n}\n\n/**\n * `--local-ref-root` resolves against the working directory, like every other CLI path. A URL of\n * another protocol (`https://…`) fails with `CLI_FLAG_INVALID`.\n */\nexport function refLimitOptions(args: CliArguments, cwd: URL): RefLimitOptions {\n  const { localRefRoot, remoteRefHosts } = args.refLimits;\n  const localRoot = localRefRoot === undefined ? undefined : localRootUrl(localRefRoot, cwd);\n  if (localRefRoot !== undefined && localRoot === undefined) {\n    throw cliError(\n      \"CLI_FLAG_INVALID\",\n      `--local-ref-root ${localRefRoot}: a directory path or a file: URL.`,\n    );\n  }\n  return {\n    ...(localRoot === undefined ? {} : { localRefRoot: localRoot }),\n    ...(remoteRefHosts === undefined ? {} : { remoteRefHosts }),\n  };\n}\n"],"names":["resolveLocationUrl","cliError"],"mappings":";;;;;AASA,MAAM,aAAA,GAAgB,OAAA;AAGf,SAAS,YAAA,CAAa,UAAkB,IAAA,EAA4B;AACzE,EAAA,MAAM,GAAA,GAAMA,4BAAA,CAAmB,QAAA,EAAU,IAAI,CAAA;AAC7C,EAAA,OAAO,GAAA,CAAI,QAAA,KAAa,aAAA,GAAgB,GAAA,GAAM,MAAA;AAChD;AAMO,SAAS,eAAA,CAAgB,MAAoB,GAAA,EAA2B;AAC7E,EAAA,MAAM,EAAE,YAAA,EAAc,cAAA,EAAe,GAAI,IAAA,CAAK,SAAA;AAC9C,EAAA,MAAM,YAAY,YAAA,KAAiB,MAAA,GAAY,MAAA,GAAY,YAAA,CAAa,cAAc,GAAG,CAAA;AACzF,EAAA,IAAI,YAAA,KAAiB,MAAA,IAAa,SAAA,KAAc,MAAA,EAAW;AACzD,IAAA,MAAMC,kBAAA;AAAA,MACJ,kBAAA;AAAA,MACA,oBAAoB,YAAY,CAAA,kCAAA;AAAA,KAClC;AAAA,EACF;AACA,EAAA,OAAO;AAAA,IACL,GAAI,SAAA,KAAc,MAAA,GAAY,EAAC,GAAI,EAAE,cAAc,SAAA,EAAU;AAAA,IAC7D,GAAI,cAAA,KAAmB,MAAA,GAAY,EAAC,GAAI,EAAE,cAAA;AAAe,GAC3D;AACF;;;"}

package/dist/cli/ref-limits.mjs

@@ -1,12 +1,25 @@
+import { cliError } from './cli-errors.mjs';
 import { resolveLocationUrl } from './cli-output.mjs';
 
+const FILE_PROTOCOL = "file:";
+function localRootUrl(location, base) {
+  const url = resolveLocationUrl(location, base);
+  return url.protocol === FILE_PROTOCOL ? url : void 0;
+}
 function refLimitOptions(args, cwd) {
   const { localRefRoot, remoteRefHosts } = args.refLimits;
+  const localRoot = localRefRoot === void 0 ? void 0 : localRootUrl(localRefRoot, cwd);
+  if (localRefRoot !== void 0 && localRoot === void 0) {
+    throw cliError(
+      "CLI_FLAG_INVALID",
+      `--local-ref-root ${localRefRoot}: a directory path or a file: URL.`
+    );
+  }
   return {
-    ...localRefRoot === void 0 ? {} : { localRefRoot: resolveLocationUrl(localRefRoot, cwd) },
+    ...localRoot === void 0 ? {} : { localRefRoot: localRoot },
     ...remoteRefHosts === void 0 ? {} : { remoteRefHosts }
   };
 }
 
-export { refLimitOptions };
+export { localRootUrl, refLimitOptions };
 //# sourceMappingURL=ref-limits.mjs.map

package/dist/cli/ref-limits.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ref-limits.mjs","sources":["../../src/cli/ref-limits.ts"],"sourcesContent":["import type { GeneratorOptions } from \"../types.js\";\nimport type { CliArguments } from \"./cli-arguments.js\";\nimport { resolveLocationUrl } from \"./cli-output.js\";\n\n/** The `$ref` limits of the CLI flags as generator options (threat model R1, R2, ADR-017). */\n\nexport type RefLimitOptions = Pick<GeneratorOptions, \"localRefRoot\" | \"remoteRefHosts\">;\n\n/** `--local-ref-root` resolves against the working directory, like every other CLI path. */\nexport function refLimitOptions(args: CliArguments, cwd: URL): RefLimitOptions {\n  const { localRefRoot, remoteRefHosts } = args.refLimits;\n  return {\n    ...(localRefRoot === undefined ? {} : { localRefRoot: resolveLocationUrl(localRefRoot, cwd) }),\n    ...(remoteRefHosts === undefined ? {} : { remoteRefHosts }),\n  };\n}\n"],"names":[],"mappings":";;AASO,SAAS,eAAA,CAAgB,MAAoB,GAAA,EAA2B;AAC7E,EAAA,MAAM,EAAE,YAAA,EAAc,cAAA,EAAe,GAAI,IAAA,CAAK,SAAA;AAC9C,EAAA,OAAO;AAAA,IACL,GAAI,YAAA,KAAiB,MAAA,GAAY,EAAC,GAAI,EAAE,YAAA,EAAc,kBAAA,CAAmB,YAAA,EAAc,GAAG,CAAA,EAAE;AAAA,IAC5F,GAAI,cAAA,KAAmB,MAAA,GAAY,EAAC,GAAI,EAAE,cAAA;AAAe,GAC3D;AACF;;"}
+{"version":3,"file":"ref-limits.mjs","sources":["../../src/cli/ref-limits.ts"],"sourcesContent":["import type { GeneratorOptions } from \"../types.js\";\nimport type { CliArguments } from \"./cli-arguments.js\";\nimport { cliError } from \"./cli-errors.js\";\nimport { resolveLocationUrl } from \"./cli-output.js\";\n\n/** The `$ref` limits of the CLI flags as generator options (threat model R1, R2, ADR-017). */\n\nexport type RefLimitOptions = Pick<GeneratorOptions, \"localRefRoot\" | \"remoteRefHosts\">;\n\nconst FILE_PROTOCOL = \"file:\";\n\n/** A local `$ref` root as a URL; undefined for a URL of another protocol, which names no folder. */\nexport function localRootUrl(location: string, base: URL): URL | undefined {\n  const url = resolveLocationUrl(location, base);\n  return url.protocol === FILE_PROTOCOL ? url : undefined;\n}\n\n/**\n * `--local-ref-root` resolves against the working directory, like every other CLI path. A URL of\n * another protocol (`https://…`) fails with `CLI_FLAG_INVALID`.\n */\nexport function refLimitOptions(args: CliArguments, cwd: URL): RefLimitOptions {\n  const { localRefRoot, remoteRefHosts } = args.refLimits;\n  const localRoot = localRefRoot === undefined ? undefined : localRootUrl(localRefRoot, cwd);\n  if (localRefRoot !== undefined && localRoot === undefined) {\n    throw cliError(\n      \"CLI_FLAG_INVALID\",\n      `--local-ref-root ${localRefRoot}: a directory path or a file: URL.`,\n    );\n  }\n  return {\n    ...(localRoot === undefined ? {} : { localRefRoot: localRoot }),\n    ...(remoteRefHosts === undefined ? {} : { remoteRefHosts }),\n  };\n}\n"],"names":[],"mappings":";;;AASA,MAAM,aAAA,GAAgB,OAAA;AAGf,SAAS,YAAA,CAAa,UAAkB,IAAA,EAA4B;AACzE,EAAA,MAAM,GAAA,GAAM,kBAAA,CAAmB,QAAA,EAAU,IAAI,CAAA;AAC7C,EAAA,OAAO,GAAA,CAAI,QAAA,KAAa,aAAA,GAAgB,GAAA,GAAM,MAAA;AAChD;AAMO,SAAS,eAAA,CAAgB,MAAoB,GAAA,EAA2B;AAC7E,EAAA,MAAM,EAAE,YAAA,EAAc,cAAA,EAAe,GAAI,IAAA,CAAK,SAAA;AAC9C,EAAA,MAAM,YAAY,YAAA,KAAiB,MAAA,GAAY,MAAA,GAAY,YAAA,CAAa,cAAc,GAAG,CAAA;AACzF,EAAA,IAAI,YAAA,KAAiB,MAAA,IAAa,SAAA,KAAc,MAAA,EAAW;AACzD,IAAA,MAAM,QAAA;AAAA,MACJ,kBAAA;AAAA,MACA,oBAAoB,YAAY,CAAA,kCAAA;AAAA,KAClC;AAAA,EACF;AACA,EAAA,OAAO;AAAA,IACL,GAAI,SAAA,KAAc,MAAA,GAAY,EAAC,GAAI,EAAE,cAAc,SAAA,EAAU;AAAA,IAC7D,GAAI,cAAA,KAAmB,MAAA,GAAY,EAAC,GAAI,EAAE,cAAA;AAAe,GAC3D;AACF;;"}

package/dist/cli/run-cli.cjs

@@ -1,5 +1,6 @@
 'use strict';
 
+const locationText = require('../domain/location-text.cjs');
 const warnings = require('../domain/warnings.cjs');
 const cliArguments = require('./cli-arguments.cjs');
 const cliErrors = require('./cli-errors.cjs');
@@ -32,9 +33,13 @@ function schemaSource(run) {
   }
   return run.deps.stdin();
 }
+const GLOB_WILDCARD = "*";
+function isGlobPattern(run, input) {
+  return input.includes(GLOB_WILDCARD) && !locationText.hasUrlScheme(input) && !run.deps.files.isFile(cliOutput.resolveLocationUrl(input, run.deps.cwd));
+}
 async function generateSingleSchema(run, redocly) {
   const { input, output } = run.args;
-  if (input?.includes("*")) {
+  if (input !== void 0 && isGlobPattern(run, input)) {
     throw cliErrors.cliError(
       "CLI_GLOB_UNSUPPORTED",
       `Globbing has been deprecated in favor of redocly.yaml\u2019s \`apis\` keys. See ${docsLinks.MULTIPLE_SCHEMAS_DOCS_URL}`
@@ -46,6 +51,9 @@ async function generateSingleSchema(run, redocly) {
       "--check needs the generated file to compare with: add --output <file>."
     );
   }
+  for (const notice of cliArguments.ineffectiveFlagNotices(run.args.generatorFlags)) {
+    run.deps.console.notice(notice);
+  }
   const source = schemaSource(run);
   const outputFile = output ? singleOutputFile(run, output, source, redocly) : void 0;
   const options = {
@@ -74,21 +82,30 @@ async function generate(run) {
     await generateSingleSchema(run, redocly);
     return [];
   }
-  if (run.args.input) {
-    run.deps.logger.warn(
+  warnAboutIgnoredArguments(run);
+  return redoclyApis.generateRedoclyApis(run, redocly);
+}
+function warnAboutIgnoredArguments(run) {
+  const { args, deps } = run;
+  if (args.input) {
+    deps.logger.warn(
       warnings.warningText(
         "APIs are specified both in Redocly Config and CLI argument. Only using Redocly config.",
         warnings.WARNING_CODES.CLI_INPUT_IGNORED
       )
     );
   }
-  return redoclyApis.generateRedoclyApis(run, redocly);
+  if (args.output) {
+    deps.logger.warn(
+      warnings.warningText(
+        `APIs are specified in Redocly Config, so --output ${args.output} is ignored: each API is written to its x-openapi-ts.output.`,
+        warnings.WARNING_CODES.CLI_OUTPUT_IGNORED
+      )
+    );
+  }
 }
 async function runCommand(argv, deps) {
   const startedAt = deps.now();
-  for (const notice of cliArguments.ineffectiveFlagNotices(argv)) {
-    deps.console.notice(notice);
-  }
   const args = cliArguments.parseCliArguments(argv);
   for (const flag of args.unknownFlags) {
     deps.console.notice(`Unknown flag ${flag} is ignored (see --help)`);

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

@@ -1 +1 @@
-{"version":3,"file":"run-cli.cjs","sources":["../../src/cli/run-cli.ts"],"sourcesContent":["import type { Logger } from \"../application/ports/logger.js\";\nimport type { RedoclyConfig } from \"../application/ports/redocly-config-source.js\";\nimport { WARNING_CODES, warningText } from \"../domain/warnings.js\";\nimport type { SchemaSource } from \"../types.js\";\nimport { ineffectiveFlagNotices, parseCliArguments } from \"./cli-arguments.js\";\nimport type { CliDependencies } from \"./cli-dependencies.js\";\nimport { cliError, describeCliFailure, EXIT_CODES, type ExitCode } from \"./cli-errors.js\";\nimport {\n  type CliRun,\n  ensureOutputIsNotSchema,\n  filesReadBy,\n  type OutputFile,\n  outputFileOf,\n  redoclyConfigFiles,\n  resolveLocationUrl,\n  writeOutput,\n} from \"./cli-output.js\";\nimport { MULTIPLE_SCHEMAS_DOCS_URL } from \"./docs-links.js\";\nimport { fixOption } from \"./fix-option.js\";\nimport { HELP_TEXT } from \"./help-text.js\";\nimport { generateRedoclyApis, hasRedoclyApis } from \"./redocly-apis.js\";\nimport { refLimitOptions } from \"./ref-limits.js\";\n\n/**\n * The CLI's use case: parse the arguments, then generate the APIs of the Redocly config, one\n * schema file or URL, or stdin. It has no process access of its own; `main.ts` wires it (ADR-012).\n */\n\nasync function loadRedoclyConfig(run: CliRun): Promise<RedoclyConfig> {\n  const { redoclyConfigs } = run.deps;\n  const explicitPath = run.args.redocly;\n  const configPath = redoclyConfigs.find(explicitPath);\n  if (explicitPath && !configPath) {\n    throw cliError(\"CLI_CONFIG_NOT_FOUND\", `Redocly config not found at: ${explicitPath}`);\n  }\n  return configPath ? redoclyConfigs.load(configPath) : redoclyConfigs.createDefault();\n}\n\n/** The schema's URL, or stdin when no path or URL is given and something is piped in. */\nfunction schemaSource(run: CliRun): SchemaSource {\n  const { input } = run.args;\n  if (input) {\n    return resolveLocationUrl(input, run.deps.cwd);\n  }\n  if (run.deps.isStdinTerminal()) {\n    throw cliError(\n      \"CLI_INPUT_MISSING\",\n      \"No schema given: pass a schema path or URL, pipe a schema into stdin, or define `apis` \" +\n        \"in redocly.yaml. See --help.\",\n    );\n  }\n  return run.deps.stdin();\n}\n\n/**\n * One schema from a path, a URL or stdin; without `--output`, the types go to stdout. Warnings and\n * errors go to stderr either way, so they never mix with the types (upstream dropped warnings).\n */\nasync function generateSingleSchema(run: CliRun, redocly: RedoclyConfig): Promise<void> {\n  const { input, output } = run.args;\n  if (input?.includes(\"*\")) {\n    throw cliError(\n      \"CLI_GLOB_UNSUPPORTED\",\n      \"Globbing has been deprecated in favor of redocly.yaml’s `apis` keys. \" +\n        `See ${MULTIPLE_SCHEMAS_DOCS_URL}`,\n    );\n  }\n  if (run.args.isCheck && !output) {\n    // Without a file there is nothing to compare: the original printed the types and passed.\n    throw cliError(\n      \"CLI_CHECK_OUTPUT_MISSING\",\n      \"--check needs the generated file to compare with: add --output <file>.\",\n    );\n  }\n  const source = schemaSource(run);\n  const outputFile = output ? singleOutputFile(run, output, source, redocly) : undefined;\n  const options = {\n    ...run.args.generatorFlags,\n    ...refLimitOptions(run.args, run.deps.cwd),\n    ...fixOption(run.args.fix),\n    redocly,\n  };\n  const types = await run.deps.generate(source, options);\n  if (!outputFile) {\n    run.deps.writeStdout(types.contents);\n    return;\n  }\n  writeOutput(run, outputFile, types, filesReadBy(run, types, outputFile.source));\n}\n\n/**\n * The `--output` file; it must not be the schema file nor the Redocly config, which writing it\n * would replace.\n */\nfunction singleOutputFile(\n  run: CliRun,\n  output: string,\n  source: SchemaSource,\n  redocly: RedoclyConfig,\n): OutputFile {\n  const { input } = run.args;\n  const outputFile = outputFileOf(run, { source: input ?? \"stdin\", output }, run.deps.cwd);\n  const schemas =\n    input && source instanceof URL ? [{ name: `schema ${input}`, location: source }] : [];\n  ensureOutputIsNotSchema(run, outputFile, [...schemas, ...redoclyConfigFiles(run, redocly)]);\n  return outputFile;\n}\n\nasync function generate(run: CliRun): Promise<unknown[]> {\n  const redocly = await loadRedoclyConfig(run);\n  if (!hasRedoclyApis(redocly)) {\n    await generateSingleSchema(run, redocly);\n    return [];\n  }\n  if (run.args.input) {\n    run.deps.logger.warn(\n      warningText(\n        \"APIs are specified both in Redocly Config and CLI argument. Only using Redocly config.\",\n        WARNING_CODES.CLI_INPUT_IGNORED,\n      ),\n    );\n  }\n  return generateRedoclyApis(run, redocly);\n}\n\n/** Run the command; the failures it returns did not stop the other outputs. */\nasync function runCommand(argv: readonly string[], deps: CliDependencies): Promise<unknown[]> {\n  const startedAt = deps.now();\n  for (const notice of ineffectiveFlagNotices(argv)) {\n    deps.console.notice(notice);\n  }\n  const args = parseCliArguments(argv);\n  for (const flag of args.unknownFlags) {\n    deps.console.notice(`Unknown flag ${flag} is ignored (see --help)`);\n  }\n  if (args.isHelp || args.isVersion) {\n    deps.console.info(args.isHelp ? HELP_TEXT : `v${deps.version}`);\n    return [];\n  }\n  if (args.output) {\n    deps.console.info(`✨ ${deps.style.bold(`openapi-typesafe ${deps.version}`)}`);\n  }\n  return generate({ deps, args, startedAt });\n}\n\n/** Print one line per failure; the exit code is the first failure's (ADR-011). */\nfunction reportFailures(failures: readonly unknown[], logger: Logger): ExitCode {\n  const reports = failures.map(describeCliFailure);\n  for (const report of reports) {\n    logger.error(report.message);\n  }\n  return reports[0]?.exitCode ?? EXIT_CODES.SUCCESS;\n}\n\n/** Run the CLI with the arguments after `node cli.js`, and return the process exit code. */\nexport async function runCli(argv: readonly string[], deps: CliDependencies): Promise<ExitCode> {\n  let failures: unknown[];\n  try {\n    failures = await runCommand(argv, deps);\n  } catch (thrown) {\n    failures = [thrown];\n  }\n  return reportFailures(failures, deps.logger);\n}\n"],"names":["cliError","resolveLocationUrl","MULTIPLE_SCHEMAS_DOCS_URL","refLimitOptions","fixOption","writeOutput","filesReadBy","outputFileOf","ensureOutputIsNotSchema","redoclyConfigFiles","hasRedoclyApis","warningText","WARNING_CODES","generateRedoclyApis","ineffectiveFlagNotices","parseCliArguments","HELP_TEXT","describeCliFailure","EXIT_CODES"],"mappings":"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"}
+{"version":3,"file":"run-cli.cjs","sources":["../../src/cli/run-cli.ts"],"sourcesContent":["import type { Logger } from \"../application/ports/logger.js\";\nimport type { RedoclyConfig } from \"../application/ports/redocly-config-source.js\";\nimport { hasUrlScheme } from \"../domain/location-text.js\";\nimport { WARNING_CODES, warningText } from \"../domain/warnings.js\";\nimport type { SchemaSource } from \"../types.js\";\nimport { ineffectiveFlagNotices, parseCliArguments } from \"./cli-arguments.js\";\nimport type { CliDependencies } from \"./cli-dependencies.js\";\nimport { cliError, describeCliFailure, EXIT_CODES, type ExitCode } from \"./cli-errors.js\";\nimport {\n  type CliRun,\n  ensureOutputIsNotSchema,\n  filesReadBy,\n  type OutputFile,\n  outputFileOf,\n  redoclyConfigFiles,\n  resolveLocationUrl,\n  writeOutput,\n} from \"./cli-output.js\";\nimport { MULTIPLE_SCHEMAS_DOCS_URL } from \"./docs-links.js\";\nimport { fixOption } from \"./fix-option.js\";\nimport { HELP_TEXT } from \"./help-text.js\";\nimport { generateRedoclyApis, hasRedoclyApis } from \"./redocly-apis.js\";\nimport { refLimitOptions } from \"./ref-limits.js\";\n\n/**\n * The CLI's use case: parse the arguments, then generate the APIs of the Redocly config, one\n * schema file or URL, or stdin. It has no process access of its own; `main.ts` wires it (ADR-012).\n */\n\nasync function loadRedoclyConfig(run: CliRun): Promise<RedoclyConfig> {\n  const { redoclyConfigs } = run.deps;\n  const explicitPath = run.args.redocly;\n  const configPath = redoclyConfigs.find(explicitPath);\n  if (explicitPath && !configPath) {\n    throw cliError(\"CLI_CONFIG_NOT_FOUND\", `Redocly config not found at: ${explicitPath}`);\n  }\n  return configPath ? redoclyConfigs.load(configPath) : redoclyConfigs.createDefault();\n}\n\n/** The schema's URL, or stdin when no path or URL is given and something is piped in. */\nfunction schemaSource(run: CliRun): SchemaSource {\n  const { input } = run.args;\n  if (input) {\n    return resolveLocationUrl(input, run.deps.cwd);\n  }\n  if (run.deps.isStdinTerminal()) {\n    throw cliError(\n      \"CLI_INPUT_MISSING\",\n      \"No schema given: pass a schema path or URL, pipe a schema into stdin, or define `apis` \" +\n        \"in redocly.yaml. See --help.\",\n    );\n  }\n  return run.deps.stdin();\n}\n\n/** The character that made the original CLI read a schema argument as a glob pattern. */\nconst GLOB_WILDCARD = \"*\";\n\n/**\n * Whether the schema argument is a glob pattern, which the CLI no longer expands: a path with a\n * `*` that names no file. A URL is no pattern (`?fields=*` is its query), nor a file whose name\n * has a `*`, which the CLI reads as any other file.\n */\nfunction isGlobPattern(run: CliRun, input: string): boolean {\n  return (\n    input.includes(GLOB_WILDCARD) &&\n    !hasUrlScheme(input) &&\n    !run.deps.files.isFile(resolveLocationUrl(input, run.deps.cwd))\n  );\n}\n\n/**\n * One schema from a path, a URL or stdin; without `--output`, the types go to stdout. Warnings and\n * errors go to stderr either way, so they never mix with the types (upstream dropped warnings).\n */\nasync function generateSingleSchema(run: CliRun, redocly: RedoclyConfig): Promise<void> {\n  const { input, output } = run.args;\n  if (input !== undefined && isGlobPattern(run, input)) {\n    throw cliError(\n      \"CLI_GLOB_UNSUPPORTED\",\n      \"Globbing has been deprecated in favor of redocly.yaml’s `apis` keys. \" +\n        `See ${MULTIPLE_SCHEMAS_DOCS_URL}`,\n    );\n  }\n  if (run.args.isCheck && !output) {\n    // Without a file there is nothing to compare: the original printed the types and passed.\n    throw cliError(\n      \"CLI_CHECK_OUTPUT_MISSING\",\n      \"--check needs the generated file to compare with: add --output <file>.\",\n    );\n  }\n  for (const notice of ineffectiveFlagNotices(run.args.generatorFlags)) {\n    run.deps.console.notice(notice);\n  }\n  const source = schemaSource(run);\n  const outputFile = output ? singleOutputFile(run, output, source, redocly) : undefined;\n  const options = {\n    ...run.args.generatorFlags,\n    ...refLimitOptions(run.args, run.deps.cwd),\n    ...fixOption(run.args.fix),\n    redocly,\n  };\n  const types = await run.deps.generate(source, options);\n  if (!outputFile) {\n    run.deps.writeStdout(types.contents);\n    return;\n  }\n  writeOutput(run, outputFile, types, filesReadBy(run, types, outputFile.source));\n}\n\n/**\n * The `--output` file; it must not be the schema file nor the Redocly config, which writing it\n * would replace.\n */\nfunction singleOutputFile(\n  run: CliRun,\n  output: string,\n  source: SchemaSource,\n  redocly: RedoclyConfig,\n): OutputFile {\n  const { input } = run.args;\n  const outputFile = outputFileOf(run, { source: input ?? \"stdin\", output }, run.deps.cwd);\n  const schemas =\n    input && source instanceof URL ? [{ name: `schema ${input}`, location: source }] : [];\n  ensureOutputIsNotSchema(run, outputFile, [...schemas, ...redoclyConfigFiles(run, redocly)]);\n  return outputFile;\n}\n\nasync function generate(run: CliRun): Promise<unknown[]> {\n  const redocly = await loadRedoclyConfig(run);\n  if (!hasRedoclyApis(redocly)) {\n    await generateSingleSchema(run, redocly);\n    return [];\n  }\n  warnAboutIgnoredArguments(run);\n  return generateRedoclyApis(run, redocly);\n}\n\n/** With the APIs of a Redocly config, the input and the output of the command line are unused. */\nfunction warnAboutIgnoredArguments(run: CliRun): void {\n  const { args, deps } = run;\n  if (args.input) {\n    deps.logger.warn(\n      warningText(\n        \"APIs are specified both in Redocly Config and CLI argument. Only using Redocly config.\",\n        WARNING_CODES.CLI_INPUT_IGNORED,\n      ),\n    );\n  }\n  if (args.output) {\n    deps.logger.warn(\n      warningText(\n        `APIs are specified in Redocly Config, so --output ${args.output} is ignored: ` +\n          \"each API is written to its x-openapi-ts.output.\",\n        WARNING_CODES.CLI_OUTPUT_IGNORED,\n      ),\n    );\n  }\n}\n\n/** Run the command; the failures it returns did not stop the other outputs. */\nasync function runCommand(argv: readonly string[], deps: CliDependencies): Promise<unknown[]> {\n  const startedAt = deps.now();\n  const args = parseCliArguments(argv);\n  for (const flag of args.unknownFlags) {\n    deps.console.notice(`Unknown flag ${flag} is ignored (see --help)`);\n  }\n  if (args.isHelp || args.isVersion) {\n    deps.console.info(args.isHelp ? HELP_TEXT : `v${deps.version}`);\n    return [];\n  }\n  if (args.output) {\n    deps.console.info(`✨ ${deps.style.bold(`openapi-typesafe ${deps.version}`)}`);\n  }\n  return generate({ deps, args, startedAt });\n}\n\n/** Print one line per failure; the exit code is the first failure's (ADR-011). */\nfunction reportFailures(failures: readonly unknown[], logger: Logger): ExitCode {\n  const reports = failures.map(describeCliFailure);\n  for (const report of reports) {\n    logger.error(report.message);\n  }\n  return reports[0]?.exitCode ?? EXIT_CODES.SUCCESS;\n}\n\n/** Run the CLI with the arguments after `node cli.js`, and return the process exit code. */\nexport async function runCli(argv: readonly string[], deps: CliDependencies): Promise<ExitCode> {\n  let failures: unknown[];\n  try {\n    failures = await runCommand(argv, deps);\n  } catch (thrown) {\n    failures = [thrown];\n  }\n  return reportFailures(failures, deps.logger);\n}\n"],"names":["cliError","resolveLocationUrl","hasUrlScheme","MULTIPLE_SCHEMAS_DOCS_URL","ineffectiveFlagNotices","refLimitOptions","fixOption","writeOutput","filesReadBy","outputFileOf","ensureOutputIsNotSchema","redoclyConfigFiles","hasRedoclyApis","generateRedoclyApis","warningText","WARNING_CODES","parseCliArguments","HELP_TEXT","describeCliFailure","EXIT_CODES"],"mappings":"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"}

package/dist/cli/run-cli.mjs

@@ -1,5 +1,6 @@
+import { hasUrlScheme } from '../domain/location-text.mjs';
 import { warningText, WARNING_CODES } from '../domain/warnings.mjs';
-import { ineffectiveFlagNotices, parseCliArguments } from './cli-arguments.mjs';
+import { parseCliArguments, ineffectiveFlagNotices } from './cli-arguments.mjs';
 import { describeCliFailure, EXIT_CODES, cliError } from './cli-errors.mjs';
 import { writeOutput, filesReadBy, resolveLocationUrl, outputFileOf, ensureOutputIsNotSchema, redoclyConfigFiles } from './cli-output.mjs';
 import { MULTIPLE_SCHEMAS_DOCS_URL } from './docs-links.mjs';
@@ -30,9 +31,13 @@ function schemaSource(run) {
   }
   return run.deps.stdin();
 }
+const GLOB_WILDCARD = "*";
+function isGlobPattern(run, input) {
+  return input.includes(GLOB_WILDCARD) && !hasUrlScheme(input) && !run.deps.files.isFile(resolveLocationUrl(input, run.deps.cwd));
+}
 async function generateSingleSchema(run, redocly) {
   const { input, output } = run.args;
-  if (input?.includes("*")) {
+  if (input !== void 0 && isGlobPattern(run, input)) {
     throw cliError(
       "CLI_GLOB_UNSUPPORTED",
       `Globbing has been deprecated in favor of redocly.yaml\u2019s \`apis\` keys. See ${MULTIPLE_SCHEMAS_DOCS_URL}`
@@ -44,6 +49,9 @@ async function generateSingleSchema(run, redocly) {
       "--check needs the generated file to compare with: add --output <file>."
     );
   }
+  for (const notice of ineffectiveFlagNotices(run.args.generatorFlags)) {
+    run.deps.console.notice(notice);
+  }
   const source = schemaSource(run);
   const outputFile = output ? singleOutputFile(run, output, source, redocly) : void 0;
   const options = {
@@ -72,21 +80,30 @@ async function generate(run) {
     await generateSingleSchema(run, redocly);
     return [];
   }
-  if (run.args.input) {
-    run.deps.logger.warn(
+  warnAboutIgnoredArguments(run);
+  return generateRedoclyApis(run, redocly);
+}
+function warnAboutIgnoredArguments(run) {
+  const { args, deps } = run;
+  if (args.input) {
+    deps.logger.warn(
       warningText(
         "APIs are specified both in Redocly Config and CLI argument. Only using Redocly config.",
         WARNING_CODES.CLI_INPUT_IGNORED
       )
     );
   }
-  return generateRedoclyApis(run, redocly);
+  if (args.output) {
+    deps.logger.warn(
+      warningText(
+        `APIs are specified in Redocly Config, so --output ${args.output} is ignored: each API is written to its x-openapi-ts.output.`,
+        WARNING_CODES.CLI_OUTPUT_IGNORED
+      )
+    );
+  }
 }
 async function runCommand(argv, deps) {
   const startedAt = deps.now();
-  for (const notice of ineffectiveFlagNotices(argv)) {
-    deps.console.notice(notice);
-  }
   const args = parseCliArguments(argv);
   for (const flag of args.unknownFlags) {
     deps.console.notice(`Unknown flag ${flag} is ignored (see --help)`);