openapi-typesafe 0.0.0 → 1.0.0-rc.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"redocly-apis.cjs","sources":["../../src/cli/redocly-apis.ts"],"sourcesContent":["import { kebabCase } from \"scule\";\nimport type { RedoclyConfig } from \"../application/ports/redocly-config-source.js\";\nimport type { OutputFixName } from \"../domain/output-fixes.js\";\nimport type { GeneratorOptions } from \"../types.js\";\nimport { GENERATOR_FLAGS, type GeneratorFlags } from \"./cli-arguments.js\";\nimport { cliError } from \"./cli-errors.js\";\nimport { type CliRun, emitOutput, resolveFileUrl } from \"./cli-output.js\";\nimport { MULTIPLE_SCHEMAS_DOCS_URL } from \"./docs-links.js\";\nimport { fixNamesOf, 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/** The setting of an API that lists its output fixes. */\nconst FIX_SETTING = \"fix\";\n\ntype ApiSettings = Readonly<Record<string, unknown>>;\n\ninterface RedoclyApi {\n  readonly name: string;\n  readonly root: string;\n  readonly settings: ApiSettings | undefined;\n}\n\nfunction redoclyApisOf(redocly: RedoclyConfig): RedoclyApi[] {\n  return Object.entries(redocly.apis ?? {}).map(([name, api]) => {\n    const settings = (api as Record<string, unknown>)[REDOCLY_CONFIG_KEY];\n    return { name, root: api.root, settings: settings as ApiSettings | undefined };\n  });\n}\n\nexport function hasRedoclyApis(redocly: RedoclyConfig): boolean {\n  return Object.keys(redocly.apis ?? {}).length > 0;\n}\n\n/** The boolean flags an API sets, in camelCase or kebab-case; they win over the CLI's flags. */\nfunction apiFlags(settings: ApiSettings): GeneratorFlags {\n  const flags: Partial<Record<(typeof GENERATOR_FLAGS)[number], boolean>> = {};\n  for (const name of GENERATOR_FLAGS) {\n    const value = typeof settings[name] === \"boolean\" ? settings[name] : settings[kebabCase(name)];\n    if (typeof value === \"boolean\") {\n      flags[name] = value;\n    }\n  }\n  return flags;\n}\n\n/** The API's `fix` names; they replace the CLI's `--fix`, as its boolean settings win (ADR-021). */\nfunction apiFixNames(settings: ApiSettings): readonly OutputFixName[] | undefined {\n  return fixNamesOf(settings[FIX_SETTING]);\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 ? resolveFileUrl(redocly.configFile, cwd) : cwd;\n}\n\nasync function generateApi(run: CliRun, redocly: RedoclyConfig, api: RedoclyApi): Promise<void> {\n  if (!api.settings?.output) {\n    throw cliError(\n      \"CLI_CONFIG_OUTPUT_MISSING\",\n      `API ${api.name} is missing an \\`${REDOCLY_CONFIG_KEY}.output\\` key. ` +\n        `See ${MULTIPLE_SCHEMAS_DOCS_URL}`,\n    );\n  }\n  const output = String(api.settings.output);\n  const configRoot = configRootOf(redocly, run.deps.cwd);\n  const options: GeneratorOptions = {\n    ...run.args.generatorFlags,\n    ...apiFlags(api.settings),\n    ...refLimitOptions(run.args, run.deps.cwd),\n    ...fixOption(apiFixNames(api.settings) ?? run.args.fix),\n    redocly,\n  };\n  const contents = await run.deps.generate(new URL(api.root, configRoot), options);\n  emitOutput(run, { source: api.name, output, file: new URL(output, configRoot) }, contents);\n}\n\n/**\n * Generate every API of the config, concurrently. Every API is generated or checked even when\n * another fails, so `--check` reports a stale output wherever it is; the failures are returned\n * in the order of the config.\n */\nexport async function generateRedoclyApis(run: CliRun, redocly: RedoclyConfig): Promise<unknown[]> {\n  const apis = redoclyApisOf(redocly);\n  const results = await Promise.allSettled(apis.map((api) => generateApi(run, redocly, api)));\n  return results.flatMap((result) => (result.status === \"rejected\" ? [result.reason] : []));\n}\n"],"names":["GENERATOR_FLAGS","kebabCase","fixNamesOf","resolveFileUrl","cliError","MULTIPLE_SCHEMAS_DOCS_URL","refLimitOptions","fixOption","emitOutput"],"mappings":"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"}

package/dist/cli/redocly-apis.mjs

@@ -0,0 +1,62 @@
+import { kebabCase } from 'scule';
+import { GENERATOR_FLAGS } from './cli-arguments.mjs';
+import { cliError } from './cli-errors.mjs';
+import { emitOutput, resolveFileUrl } from './cli-output.mjs';
+import { MULTIPLE_SCHEMAS_DOCS_URL } from './docs-links.mjs';
+import { fixOption, fixNamesOf } from './fix-option.mjs';
+import { refLimitOptions } from './ref-limits.mjs';
+
+const REDOCLY_CONFIG_KEY = "x-openapi-ts";
+const FIX_SETTING = "fix";
+function redoclyApisOf(redocly) {
+  return Object.entries(redocly.apis ?? {}).map(([name, api]) => {
+    const settings = api[REDOCLY_CONFIG_KEY];
+    return { name, root: api.root, settings };
+  });
+}
+function hasRedoclyApis(redocly) {
+  return Object.keys(redocly.apis ?? {}).length > 0;
+}
+function apiFlags(settings) {
+  const flags = {};
+  for (const name of GENERATOR_FLAGS) {
+    const value = typeof settings[name] === "boolean" ? settings[name] : settings[kebabCase(name)];
+    if (typeof value === "boolean") {
+      flags[name] = value;
+    }
+  }
+  return flags;
+}
+function apiFixNames(settings) {
+  return fixNamesOf(settings[FIX_SETTING]);
+}
+function configRootOf(redocly, cwd) {
+  return redocly.configFile ? resolveFileUrl(redocly.configFile, cwd) : cwd;
+}
+async function generateApi(run, redocly, api) {
+  if (!api.settings?.output) {
+    throw cliError(
+      "CLI_CONFIG_OUTPUT_MISSING",
+      `API ${api.name} is missing an \`${REDOCLY_CONFIG_KEY}.output\` key. See ${MULTIPLE_SCHEMAS_DOCS_URL}`
+    );
+  }
+  const output = String(api.settings.output);
+  const configRoot = configRootOf(redocly, run.deps.cwd);
+  const options = {
+    ...run.args.generatorFlags,
+    ...apiFlags(api.settings),
+    ...refLimitOptions(run.args, run.deps.cwd),
+    ...fixOption(apiFixNames(api.settings) ?? run.args.fix),
+    redocly
+  };
+  const contents = await run.deps.generate(new URL(api.root, configRoot), options);
+  emitOutput(run, { source: api.name, output, file: new URL(output, configRoot) }, contents);
+}
+async function generateRedoclyApis(run, redocly) {
+  const apis = redoclyApisOf(redocly);
+  const results = await Promise.allSettled(apis.map((api) => generateApi(run, redocly, api)));
+  return results.flatMap((result) => result.status === "rejected" ? [result.reason] : []);
+}
+
+export { generateRedoclyApis, hasRedoclyApis };
+//# sourceMappingURL=redocly-apis.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redocly-apis.mjs","sources":["../../src/cli/redocly-apis.ts"],"sourcesContent":["import { kebabCase } from \"scule\";\nimport type { RedoclyConfig } from \"../application/ports/redocly-config-source.js\";\nimport type { OutputFixName } from \"../domain/output-fixes.js\";\nimport type { GeneratorOptions } from \"../types.js\";\nimport { GENERATOR_FLAGS, type GeneratorFlags } from \"./cli-arguments.js\";\nimport { cliError } from \"./cli-errors.js\";\nimport { type CliRun, emitOutput, resolveFileUrl } from \"./cli-output.js\";\nimport { MULTIPLE_SCHEMAS_DOCS_URL } from \"./docs-links.js\";\nimport { fixNamesOf, 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/** The setting of an API that lists its output fixes. */\nconst FIX_SETTING = \"fix\";\n\ntype ApiSettings = Readonly<Record<string, unknown>>;\n\ninterface RedoclyApi {\n  readonly name: string;\n  readonly root: string;\n  readonly settings: ApiSettings | undefined;\n}\n\nfunction redoclyApisOf(redocly: RedoclyConfig): RedoclyApi[] {\n  return Object.entries(redocly.apis ?? {}).map(([name, api]) => {\n    const settings = (api as Record<string, unknown>)[REDOCLY_CONFIG_KEY];\n    return { name, root: api.root, settings: settings as ApiSettings | undefined };\n  });\n}\n\nexport function hasRedoclyApis(redocly: RedoclyConfig): boolean {\n  return Object.keys(redocly.apis ?? {}).length > 0;\n}\n\n/** The boolean flags an API sets, in camelCase or kebab-case; they win over the CLI's flags. */\nfunction apiFlags(settings: ApiSettings): GeneratorFlags {\n  const flags: Partial<Record<(typeof GENERATOR_FLAGS)[number], boolean>> = {};\n  for (const name of GENERATOR_FLAGS) {\n    const value = typeof settings[name] === \"boolean\" ? settings[name] : settings[kebabCase(name)];\n    if (typeof value === \"boolean\") {\n      flags[name] = value;\n    }\n  }\n  return flags;\n}\n\n/** The API's `fix` names; they replace the CLI's `--fix`, as its boolean settings win (ADR-021). */\nfunction apiFixNames(settings: ApiSettings): readonly OutputFixName[] | undefined {\n  return fixNamesOf(settings[FIX_SETTING]);\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 ? resolveFileUrl(redocly.configFile, cwd) : cwd;\n}\n\nasync function generateApi(run: CliRun, redocly: RedoclyConfig, api: RedoclyApi): Promise<void> {\n  if (!api.settings?.output) {\n    throw cliError(\n      \"CLI_CONFIG_OUTPUT_MISSING\",\n      `API ${api.name} is missing an \\`${REDOCLY_CONFIG_KEY}.output\\` key. ` +\n        `See ${MULTIPLE_SCHEMAS_DOCS_URL}`,\n    );\n  }\n  const output = String(api.settings.output);\n  const configRoot = configRootOf(redocly, run.deps.cwd);\n  const options: GeneratorOptions = {\n    ...run.args.generatorFlags,\n    ...apiFlags(api.settings),\n    ...refLimitOptions(run.args, run.deps.cwd),\n    ...fixOption(apiFixNames(api.settings) ?? run.args.fix),\n    redocly,\n  };\n  const contents = await run.deps.generate(new URL(api.root, configRoot), options);\n  emitOutput(run, { source: api.name, output, file: new URL(output, configRoot) }, contents);\n}\n\n/**\n * Generate every API of the config, concurrently. Every API is generated or checked even when\n * another fails, so `--check` reports a stale output wherever it is; the failures are returned\n * in the order of the config.\n */\nexport async function generateRedoclyApis(run: CliRun, redocly: RedoclyConfig): Promise<unknown[]> {\n  const apis = redoclyApisOf(redocly);\n  const results = await Promise.allSettled(apis.map((api) => generateApi(run, redocly, api)));\n  return results.flatMap((result) => (result.status === \"rejected\" ? [result.reason] : []));\n}\n"],"names":[],"mappings":"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"}

package/dist/cli/ref-limits.cjs

@@ -0,0 +1,14 @@
+'use strict';
+
+const cliOutput = require('./cli-output.cjs');
+
+function refLimitOptions(args, cwd) {
+  const { localRefRoot, remoteRefHosts } = args.refLimits;
+  return {
+    ...localRefRoot === void 0 ? {} : { localRefRoot: cliOutput.resolveFileUrl(localRefRoot, cwd) },
+    ...remoteRefHosts === void 0 ? {} : { remoteRefHosts }
+  };
+}
+
+exports.refLimitOptions = refLimitOptions;
+//# sourceMappingURL=ref-limits.cjs.map

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

@@ -0,0 +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 { resolveFileUrl } 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: resolveFileUrl(localRefRoot, cwd) }),\n    ...(remoteRefHosts === undefined ? {} : { remoteRefHosts }),\n  };\n}\n"],"names":["resolveFileUrl"],"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,wBAAA,CAAe,YAAA,EAAc,GAAG,CAAA,EAAE;AAAA,IACxF,GAAI,cAAA,KAAmB,MAAA,GAAY,EAAC,GAAI,EAAE,cAAA;AAAe,GAC3D;AACF;;"}

package/dist/cli/ref-limits.mjs

@@ -0,0 +1,12 @@
+import { resolveFileUrl } from './cli-output.mjs';
+
+function refLimitOptions(args, cwd) {
+  const { localRefRoot, remoteRefHosts } = args.refLimits;
+  return {
+    ...localRefRoot === void 0 ? {} : { localRefRoot: resolveFileUrl(localRefRoot, cwd) },
+    ...remoteRefHosts === void 0 ? {} : { remoteRefHosts }
+  };
+}
+
+export { refLimitOptions };
+//# sourceMappingURL=ref-limits.mjs.map

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

@@ -0,0 +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 { resolveFileUrl } 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: resolveFileUrl(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,cAAA,CAAe,YAAA,EAAc,GAAG,CAAA,EAAE;AAAA,IACxF,GAAI,cAAA,KAAmB,MAAA,GAAY,EAAC,GAAI,EAAE,cAAA;AAAe,GAC3D;AACF;;"}

package/dist/cli/run-cli.cjs

@@ -0,0 +1,100 @@
+'use strict';
+
+const cliArguments = require('./cli-arguments.cjs');
+const cliErrors = require('./cli-errors.cjs');
+const cliOutput = require('./cli-output.cjs');
+const docsLinks = require('./docs-links.cjs');
+const fixOption = require('./fix-option.cjs');
+const helpText = require('./help-text.cjs');
+const redoclyApis = require('./redocly-apis.cjs');
+const refLimits = require('./ref-limits.cjs');
+
+async function loadRedoclyConfig(run) {
+  const { redoclyConfigs } = run.deps;
+  const explicitPath = run.args.redocly;
+  const configPath = redoclyConfigs.find(explicitPath);
+  if (explicitPath && !configPath) {
+    throw cliErrors.cliError("CLI_CONFIG_NOT_FOUND", `Redocly config not found at: ${explicitPath}`);
+  }
+  return configPath ? redoclyConfigs.load(configPath) : redoclyConfigs.createDefault();
+}
+async function generateSingleSchema(run, redocly) {
+  const { input, output } = run.args;
+  if (input?.includes("*")) {
+    throw cliErrors.cliError(
+      "CLI_GLOB_UNSUPPORTED",
+      `Globbing has been deprecated in favor of redocly.yaml\u2019s \`apis\` keys. See ${docsLinks.MULTIPLE_SCHEMAS_DOCS_URL}`
+    );
+  }
+  if (run.args.isCheck && !output) {
+    throw cliErrors.cliError(
+      "CLI_CHECK_OUTPUT_MISSING",
+      "--check needs the generated file to compare with: add --output <file>."
+    );
+  }
+  const source = input ? new URL(input, run.deps.cwd) : run.deps.stdin();
+  const options = {
+    ...run.args.generatorFlags,
+    ...refLimits.refLimitOptions(run.args, run.deps.cwd),
+    ...fixOption.fixOption(run.args.fix),
+    redocly,
+    silent: !output
+  };
+  const contents = await run.deps.generate(source, options);
+  if (!output) {
+    run.deps.writeStdout(contents);
+    return;
+  }
+  const file = cliOutput.resolveFileUrl(output, run.deps.cwd);
+  cliOutput.emitOutput(run, { source: input ?? "stdin", output, file }, contents);
+}
+async function generate(run) {
+  const redocly = await loadRedoclyConfig(run);
+  if (!redoclyApis.hasRedoclyApis(redocly)) {
+    await generateSingleSchema(run, redocly);
+    return [];
+  }
+  if (run.args.input) {
+    run.deps.logger.warn(
+      "APIs are specified both in Redocly Config and CLI argument. Only using Redocly config."
+    );
+  }
+  return redoclyApis.generateRedoclyApis(run, redocly);
+}
+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)`);
+  }
+  if (args.isHelp || args.isVersion) {
+    deps.console.info(args.isHelp ? helpText.HELP_TEXT : `v${deps.version}`);
+    return [];
+  }
+  if (args.output) {
+    deps.console.info(`\u2728 ${deps.style.bold(`openapi-typesafe ${deps.version}`)}`);
+  }
+  return generate({ deps, args, startedAt });
+}
+function reportFailures(failures, logger) {
+  const reports = failures.map(cliErrors.describeCliFailure);
+  for (const report of reports) {
+    logger.error(report.message);
+  }
+  return reports[0]?.exitCode ?? cliErrors.EXIT_CODES.SUCCESS;
+}
+async function runCli(argv, deps) {
+  let failures;
+  try {
+    failures = await runCommand(argv, deps);
+  } catch (thrown) {
+    failures = [thrown];
+  }
+  return reportFailures(failures, deps.logger);
+}
+
+exports.runCli = runCli;
+//# sourceMappingURL=run-cli.cjs.map

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

@@ -0,0 +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 { 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 { type CliRun, emitOutput, resolveFileUrl } 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/** One schema from a path, a URL or stdin; without `--output`, the types go to stdout only. */\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 = input ? new URL(input, run.deps.cwd) : run.deps.stdin();\n  const options = {\n    ...run.args.generatorFlags,\n    ...refLimitOptions(run.args, run.deps.cwd),\n    ...fixOption(run.args.fix),\n    redocly,\n    silent: !output,\n  };\n  const contents = await run.deps.generate(source, options);\n  if (!output) {\n    run.deps.writeStdout(contents);\n    return;\n  }\n  const file = resolveFileUrl(output, run.deps.cwd);\n  emitOutput(run, { source: input ?? \"stdin\", output, file }, contents);\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      \"APIs are specified both in Redocly Config and CLI argument. Only using Redocly config.\",\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","MULTIPLE_SCHEMAS_DOCS_URL","refLimitOptions","fixOption","resolveFileUrl","emitOutput","hasRedoclyApis","generateRedoclyApis","ineffectiveFlagNotices","parseCliArguments","HELP_TEXT","describeCliFailure","EXIT_CODES"],"mappings":"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"}

package/dist/cli/run-cli.mjs

@@ -0,0 +1,98 @@
+import { ineffectiveFlagNotices, parseCliArguments } from './cli-arguments.mjs';
+import { describeCliFailure, EXIT_CODES, cliError } from './cli-errors.mjs';
+import { resolveFileUrl, emitOutput } from './cli-output.mjs';
+import { MULTIPLE_SCHEMAS_DOCS_URL } from './docs-links.mjs';
+import { fixOption } from './fix-option.mjs';
+import { HELP_TEXT } from './help-text.mjs';
+import { hasRedoclyApis, generateRedoclyApis } from './redocly-apis.mjs';
+import { refLimitOptions } from './ref-limits.mjs';
+
+async function loadRedoclyConfig(run) {
+  const { redoclyConfigs } = run.deps;
+  const explicitPath = run.args.redocly;
+  const configPath = redoclyConfigs.find(explicitPath);
+  if (explicitPath && !configPath) {
+    throw cliError("CLI_CONFIG_NOT_FOUND", `Redocly config not found at: ${explicitPath}`);
+  }
+  return configPath ? redoclyConfigs.load(configPath) : redoclyConfigs.createDefault();
+}
+async function generateSingleSchema(run, redocly) {
+  const { input, output } = run.args;
+  if (input?.includes("*")) {
+    throw cliError(
+      "CLI_GLOB_UNSUPPORTED",
+      `Globbing has been deprecated in favor of redocly.yaml\u2019s \`apis\` keys. See ${MULTIPLE_SCHEMAS_DOCS_URL}`
+    );
+  }
+  if (run.args.isCheck && !output) {
+    throw cliError(
+      "CLI_CHECK_OUTPUT_MISSING",
+      "--check needs the generated file to compare with: add --output <file>."
+    );
+  }
+  const source = input ? new URL(input, run.deps.cwd) : run.deps.stdin();
+  const options = {
+    ...run.args.generatorFlags,
+    ...refLimitOptions(run.args, run.deps.cwd),
+    ...fixOption(run.args.fix),
+    redocly,
+    silent: !output
+  };
+  const contents = await run.deps.generate(source, options);
+  if (!output) {
+    run.deps.writeStdout(contents);
+    return;
+  }
+  const file = resolveFileUrl(output, run.deps.cwd);
+  emitOutput(run, { source: input ?? "stdin", output, file }, contents);
+}
+async function generate(run) {
+  const redocly = await loadRedoclyConfig(run);
+  if (!hasRedoclyApis(redocly)) {
+    await generateSingleSchema(run, redocly);
+    return [];
+  }
+  if (run.args.input) {
+    run.deps.logger.warn(
+      "APIs are specified both in Redocly Config and CLI argument. Only using Redocly config."
+    );
+  }
+  return generateRedoclyApis(run, redocly);
+}
+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)`);
+  }
+  if (args.isHelp || args.isVersion) {
+    deps.console.info(args.isHelp ? HELP_TEXT : `v${deps.version}`);
+    return [];
+  }
+  if (args.output) {
+    deps.console.info(`\u2728 ${deps.style.bold(`openapi-typesafe ${deps.version}`)}`);
+  }
+  return generate({ deps, args, startedAt });
+}
+function reportFailures(failures, logger) {
+  const reports = failures.map(describeCliFailure);
+  for (const report of reports) {
+    logger.error(report.message);
+  }
+  return reports[0]?.exitCode ?? EXIT_CODES.SUCCESS;
+}
+async function runCli(argv, deps) {
+  let failures;
+  try {
+    failures = await runCommand(argv, deps);
+  } catch (thrown) {
+    failures = [thrown];
+  }
+  return reportFailures(failures, deps.logger);
+}
+
+export { runCli };
+//# sourceMappingURL=run-cli.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run-cli.mjs","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 { 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 { type CliRun, emitOutput, resolveFileUrl } 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/** One schema from a path, a URL or stdin; without `--output`, the types go to stdout only. */\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 = input ? new URL(input, run.deps.cwd) : run.deps.stdin();\n  const options = {\n    ...run.args.generatorFlags,\n    ...refLimitOptions(run.args, run.deps.cwd),\n    ...fixOption(run.args.fix),\n    redocly,\n    silent: !output,\n  };\n  const contents = await run.deps.generate(source, options);\n  if (!output) {\n    run.deps.writeStdout(contents);\n    return;\n  }\n  const file = resolveFileUrl(output, run.deps.cwd);\n  emitOutput(run, { source: input ?? \"stdin\", output, file }, contents);\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      \"APIs are specified both in Redocly Config and CLI argument. Only using Redocly config.\",\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":[],"mappings":"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"}

package/dist/domain/assert-never.cjs

@@ -0,0 +1,8 @@
+'use strict';
+
+function assertNever(value) {
+  throw new Error(`Unexpected variant: ${JSON.stringify(value)}`);
+}
+
+exports.assertNever = assertNever;
+//# sourceMappingURL=assert-never.cjs.map

package/dist/domain/assert-never.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-never.cjs","sources":["../../src/domain/assert-never.ts"],"sourcesContent":["/**\n * Exhaustiveness guard for `switch` over a closed union: the call compiles only when every variant\n * is handled. Reaching it at run time means a value outside the union, which is a bug, so it\n * throws.\n */\nexport function assertNever(value: never): never {\n  throw new Error(`Unexpected variant: ${JSON.stringify(value)}`);\n}\n"],"names":[],"mappings":";;AAKO,SAAS,YAAY,KAAA,EAAqB;AAC/C,EAAA,MAAM,IAAI,KAAA,CAAM,CAAA,oBAAA,EAAuB,KAAK,SAAA,CAAU,KAAK,CAAC,CAAA,CAAE,CAAA;AAChE;;"}

package/dist/domain/assert-never.mjs

@@ -0,0 +1,6 @@
+function assertNever(value) {
+  throw new Error(`Unexpected variant: ${JSON.stringify(value)}`);
+}
+
+export { assertNever };
+//# sourceMappingURL=assert-never.mjs.map

package/dist/domain/assert-never.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-never.mjs","sources":["../../src/domain/assert-never.ts"],"sourcesContent":["/**\n * Exhaustiveness guard for `switch` over a closed union: the call compiles only when every variant\n * is handled. Reaching it at run time means a value outside the union, which is a bug, so it\n * throws.\n */\nexport function assertNever(value: never): never {\n  throw new Error(`Unexpected variant: ${JSON.stringify(value)}`);\n}\n"],"names":[],"mappings":"AAKO,SAAS,YAAY,KAAA,EAAqB;AAC/C,EAAA,MAAM,IAAI,KAAA,CAAM,CAAA,oBAAA,EAAuB,KAAK,SAAA,CAAU,KAAK,CAAC,CAAA,CAAE,CAAA;AAChE;;"}

package/dist/domain/errors.cjs

@@ -0,0 +1,50 @@
+'use strict';
+
+const ERROR_CODES = {
+  SCHEMA_SOURCE_EMPTY: "SCHEMA_SOURCE_EMPTY",
+  SCHEMA_SOURCE_INVALID: "SCHEMA_SOURCE_INVALID",
+  SCHEMA_LOAD_FAILED: "SCHEMA_LOAD_FAILED",
+  SCHEMA_PARSE_FAILED: "SCHEMA_PARSE_FAILED",
+  SCHEMA_VERSION_UNSUPPORTED: "SCHEMA_VERSION_UNSUPPORTED",
+  SCHEMA_INVALID: "SCHEMA_INVALID",
+  SCHEMA_REF_INVALID: "SCHEMA_REF_INVALID",
+  SCHEMA_REF_FORBIDDEN: "SCHEMA_REF_FORBIDDEN",
+  SCHEMA_OBJECT_INVALID: "SCHEMA_OBJECT_INVALID",
+  SCHEMA_PROPERTY_INVALID: "SCHEMA_PROPERTY_INVALID",
+  SCHEMA_TOO_DEEP: "SCHEMA_TOO_DEEP",
+  SCHEMA_KEY_UNSUPPORTED: "SCHEMA_KEY_UNSUPPORTED",
+  ENUM_NAME_EMPTY: "ENUM_NAME_EMPTY",
+  CALLBACK_RESULT_UNREADABLE: "CALLBACK_RESULT_UNREADABLE",
+  OPTION_FIX_UNKNOWN: "OPTION_FIX_UNKNOWN",
+  TYPESCRIPT_NOT_FOUND: "TYPESCRIPT_NOT_FOUND",
+  CLI_FLAG_REMOVED: "CLI_FLAG_REMOVED",
+  CLI_GLOB_UNSUPPORTED: "CLI_GLOB_UNSUPPORTED",
+  CLI_CONFIG_NOT_FOUND: "CLI_CONFIG_NOT_FOUND",
+  CLI_CONFIG_OUTPUT_MISSING: "CLI_CONFIG_OUTPUT_MISSING",
+  CLI_CHECK_OUTPUT_MISSING: "CLI_CHECK_OUTPUT_MISSING",
+  OUTPUT_STALE: "OUTPUT_STALE",
+  OUTPUT_READ_FAILED: "OUTPUT_READ_FAILED",
+  OUTPUT_WRITE_FAILED: "OUTPUT_WRITE_FAILED"
+};
+class OpenAPITypesafeError extends Error {
+  code;
+  details;
+  constructor(init) {
+    super(init.message, init.cause === void 0 ? void 0 : { cause: init.cause });
+    this.name = "OpenAPITypesafeError";
+    this.code = init.code;
+    this.details = init.details ?? {};
+  }
+}
+function isOpenAPITypesafeError(value) {
+  if (value instanceof OpenAPITypesafeError) {
+    return true;
+  }
+  const code = value?.code;
+  return value instanceof Error && typeof code === "string" && Object.hasOwn(ERROR_CODES, code) && typeof value.details === "object";
+}
+
+exports.ERROR_CODES = ERROR_CODES;
+exports.OpenAPITypesafeError = OpenAPITypesafeError;
+exports.isOpenAPITypesafeError = isOpenAPITypesafeError;
+//# sourceMappingURL=errors.cjs.map

package/dist/domain/errors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.cjs","sources":["../../src/domain/errors.ts"],"sourcesContent":["/**\n * Typed errors (ENGINEERING_PLAN 4.6, ADR-011). Every expected failure of the generator and the CLI\n * is an `OpenAPITypesafeError` with a stable machine-readable `code` and structured `details`. The\n * `message` is English text for people; programs and the CLI decide by `code`. A bug (a broken\n * invariant) is a plain `Error`, not one of these.\n */\n\n/** Every error code. The set is closed: a new code must be handled by the CLI exit-code table. */\nexport const ERROR_CODES = {\n  SCHEMA_SOURCE_EMPTY: \"SCHEMA_SOURCE_EMPTY\",\n  SCHEMA_SOURCE_INVALID: \"SCHEMA_SOURCE_INVALID\",\n  SCHEMA_LOAD_FAILED: \"SCHEMA_LOAD_FAILED\",\n  SCHEMA_PARSE_FAILED: \"SCHEMA_PARSE_FAILED\",\n  SCHEMA_VERSION_UNSUPPORTED: \"SCHEMA_VERSION_UNSUPPORTED\",\n  SCHEMA_INVALID: \"SCHEMA_INVALID\",\n  SCHEMA_REF_INVALID: \"SCHEMA_REF_INVALID\",\n  SCHEMA_REF_FORBIDDEN: \"SCHEMA_REF_FORBIDDEN\",\n  SCHEMA_OBJECT_INVALID: \"SCHEMA_OBJECT_INVALID\",\n  SCHEMA_PROPERTY_INVALID: \"SCHEMA_PROPERTY_INVALID\",\n  SCHEMA_TOO_DEEP: \"SCHEMA_TOO_DEEP\",\n  SCHEMA_KEY_UNSUPPORTED: \"SCHEMA_KEY_UNSUPPORTED\",\n  ENUM_NAME_EMPTY: \"ENUM_NAME_EMPTY\",\n  CALLBACK_RESULT_UNREADABLE: \"CALLBACK_RESULT_UNREADABLE\",\n  OPTION_FIX_UNKNOWN: \"OPTION_FIX_UNKNOWN\",\n  TYPESCRIPT_NOT_FOUND: \"TYPESCRIPT_NOT_FOUND\",\n  CLI_FLAG_REMOVED: \"CLI_FLAG_REMOVED\",\n  CLI_GLOB_UNSUPPORTED: \"CLI_GLOB_UNSUPPORTED\",\n  CLI_CONFIG_NOT_FOUND: \"CLI_CONFIG_NOT_FOUND\",\n  CLI_CONFIG_OUTPUT_MISSING: \"CLI_CONFIG_OUTPUT_MISSING\",\n  CLI_CHECK_OUTPUT_MISSING: \"CLI_CHECK_OUTPUT_MISSING\",\n  OUTPUT_STALE: \"OUTPUT_STALE\",\n  OUTPUT_READ_FAILED: \"OUTPUT_READ_FAILED\",\n  OUTPUT_WRITE_FAILED: \"OUTPUT_WRITE_FAILED\",\n} as const;\n\nexport type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];\n\n/** Structured, JSON-serializable facts about a failure, for programs and logs. */\nexport type ErrorDetails = Readonly<Record<string, unknown>>;\n\nexport interface OpenAPITypesafeErrorInit {\n  readonly code: ErrorCode;\n  readonly message: string;\n  readonly details?: ErrorDetails;\n  /** The lower-level error this one reports, if any (kept as the standard `cause`). */\n  readonly cause?: unknown;\n}\n\n/** The base of every expected failure; check `code`, not the class or the message. */\nexport class OpenAPITypesafeError extends Error {\n  readonly code: ErrorCode;\n  readonly details: ErrorDetails;\n\n  constructor(init: OpenAPITypesafeErrorInit) {\n    super(init.message, init.cause === undefined ? undefined : { cause: init.cause });\n    this.name = \"OpenAPITypesafeError\";\n    this.code = init.code;\n    this.details = init.details ?? {};\n  }\n}\n\n/** Whether a thrown value is one of our typed errors (also across bundled copies of the class). */\nexport function isOpenAPITypesafeError(value: unknown): value is OpenAPITypesafeError {\n  if (value instanceof OpenAPITypesafeError) {\n    return true;\n  }\n  const code = (value as { code?: unknown } | null)?.code;\n  return (\n    value instanceof Error &&\n    typeof code === \"string\" &&\n    Object.hasOwn(ERROR_CODES, code) &&\n    typeof (value as { details?: unknown }).details === \"object\"\n  );\n}\n"],"names":[],"mappings":";;AAQO,MAAM,WAAA,GAAc;AAAA,EACzB,mBAAA,EAAqB,qBAAA;AAAA,EACrB,qBAAA,EAAuB,uBAAA;AAAA,EACvB,kBAAA,EAAoB,oBAAA;AAAA,EACpB,mBAAA,EAAqB,qBAAA;AAAA,EACrB,0BAAA,EAA4B,4BAAA;AAAA,EAC5B,cAAA,EAAgB,gBAAA;AAAA,EAChB,kBAAA,EAAoB,oBAAA;AAAA,EACpB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,qBAAA,EAAuB,uBAAA;AAAA,EACvB,uBAAA,EAAyB,yBAAA;AAAA,EACzB,eAAA,EAAiB,iBAAA;AAAA,EACjB,sBAAA,EAAwB,wBAAA;AAAA,EACxB,eAAA,EAAiB,iBAAA;AAAA,EACjB,0BAAA,EAA4B,4BAAA;AAAA,EAC5B,kBAAA,EAAoB,oBAAA;AAAA,EACpB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,gBAAA,EAAkB,kBAAA;AAAA,EAClB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,yBAAA,EAA2B,2BAAA;AAAA,EAC3B,wBAAA,EAA0B,0BAAA;AAAA,EAC1B,YAAA,EAAc,cAAA;AAAA,EACd,kBAAA,EAAoB,oBAAA;AAAA,EACpB,mBAAA,EAAqB;AACvB;AAgBO,MAAM,6BAA6B,KAAA,CAAM;AAAA,EACrC,IAAA;AAAA,EACA,OAAA;AAAA,EAET,YAAY,IAAA,EAAgC;AAC1C,IAAA,KAAA,CAAM,IAAA,CAAK,OAAA,EAAS,IAAA,CAAK,KAAA,KAAU,MAAA,GAAY,SAAY,EAAE,KAAA,EAAO,IAAA,CAAK,KAAA,EAAO,CAAA;AAChF,IAAA,IAAA,CAAK,IAAA,GAAO,sBAAA;AACZ,IAAA,IAAA,CAAK,OAAO,IAAA,CAAK,IAAA;AACjB,IAAA,IAAA,CAAK,OAAA,GAAU,IAAA,CAAK,OAAA,IAAW,EAAC;AAAA,EAClC;AACF;AAGO,SAAS,uBAAuB,KAAA,EAA+C;AACpF,EAAA,IAAI,iBAAiB,oBAAA,EAAsB;AACzC,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,MAAM,OAAQ,KAAA,EAAqC,IAAA;AACnD,EAAA,OACE,KAAA,YAAiB,KAAA,IACjB,OAAO,IAAA,KAAS,QAAA,IAChB,MAAA,CAAO,MAAA,CAAO,WAAA,EAAa,IAAI,CAAA,IAC/B,OAAQ,KAAA,CAAgC,OAAA,KAAY,QAAA;AAExD;;;;"}

package/dist/domain/errors.mjs

@@ -0,0 +1,46 @@
+const ERROR_CODES = {
+  SCHEMA_SOURCE_EMPTY: "SCHEMA_SOURCE_EMPTY",
+  SCHEMA_SOURCE_INVALID: "SCHEMA_SOURCE_INVALID",
+  SCHEMA_LOAD_FAILED: "SCHEMA_LOAD_FAILED",
+  SCHEMA_PARSE_FAILED: "SCHEMA_PARSE_FAILED",
+  SCHEMA_VERSION_UNSUPPORTED: "SCHEMA_VERSION_UNSUPPORTED",
+  SCHEMA_INVALID: "SCHEMA_INVALID",
+  SCHEMA_REF_INVALID: "SCHEMA_REF_INVALID",
+  SCHEMA_REF_FORBIDDEN: "SCHEMA_REF_FORBIDDEN",
+  SCHEMA_OBJECT_INVALID: "SCHEMA_OBJECT_INVALID",
+  SCHEMA_PROPERTY_INVALID: "SCHEMA_PROPERTY_INVALID",
+  SCHEMA_TOO_DEEP: "SCHEMA_TOO_DEEP",
+  SCHEMA_KEY_UNSUPPORTED: "SCHEMA_KEY_UNSUPPORTED",
+  ENUM_NAME_EMPTY: "ENUM_NAME_EMPTY",
+  CALLBACK_RESULT_UNREADABLE: "CALLBACK_RESULT_UNREADABLE",
+  OPTION_FIX_UNKNOWN: "OPTION_FIX_UNKNOWN",
+  TYPESCRIPT_NOT_FOUND: "TYPESCRIPT_NOT_FOUND",
+  CLI_FLAG_REMOVED: "CLI_FLAG_REMOVED",
+  CLI_GLOB_UNSUPPORTED: "CLI_GLOB_UNSUPPORTED",
+  CLI_CONFIG_NOT_FOUND: "CLI_CONFIG_NOT_FOUND",
+  CLI_CONFIG_OUTPUT_MISSING: "CLI_CONFIG_OUTPUT_MISSING",
+  CLI_CHECK_OUTPUT_MISSING: "CLI_CHECK_OUTPUT_MISSING",
+  OUTPUT_STALE: "OUTPUT_STALE",
+  OUTPUT_READ_FAILED: "OUTPUT_READ_FAILED",
+  OUTPUT_WRITE_FAILED: "OUTPUT_WRITE_FAILED"
+};
+class OpenAPITypesafeError extends Error {
+  code;
+  details;
+  constructor(init) {
+    super(init.message, init.cause === void 0 ? void 0 : { cause: init.cause });
+    this.name = "OpenAPITypesafeError";
+    this.code = init.code;
+    this.details = init.details ?? {};
+  }
+}
+function isOpenAPITypesafeError(value) {
+  if (value instanceof OpenAPITypesafeError) {
+    return true;
+  }
+  const code = value?.code;
+  return value instanceof Error && typeof code === "string" && Object.hasOwn(ERROR_CODES, code) && typeof value.details === "object";
+}
+
+export { ERROR_CODES, OpenAPITypesafeError, isOpenAPITypesafeError };
+//# sourceMappingURL=errors.mjs.map

package/dist/domain/errors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.mjs","sources":["../../src/domain/errors.ts"],"sourcesContent":["/**\n * Typed errors (ENGINEERING_PLAN 4.6, ADR-011). Every expected failure of the generator and the CLI\n * is an `OpenAPITypesafeError` with a stable machine-readable `code` and structured `details`. The\n * `message` is English text for people; programs and the CLI decide by `code`. A bug (a broken\n * invariant) is a plain `Error`, not one of these.\n */\n\n/** Every error code. The set is closed: a new code must be handled by the CLI exit-code table. */\nexport const ERROR_CODES = {\n  SCHEMA_SOURCE_EMPTY: \"SCHEMA_SOURCE_EMPTY\",\n  SCHEMA_SOURCE_INVALID: \"SCHEMA_SOURCE_INVALID\",\n  SCHEMA_LOAD_FAILED: \"SCHEMA_LOAD_FAILED\",\n  SCHEMA_PARSE_FAILED: \"SCHEMA_PARSE_FAILED\",\n  SCHEMA_VERSION_UNSUPPORTED: \"SCHEMA_VERSION_UNSUPPORTED\",\n  SCHEMA_INVALID: \"SCHEMA_INVALID\",\n  SCHEMA_REF_INVALID: \"SCHEMA_REF_INVALID\",\n  SCHEMA_REF_FORBIDDEN: \"SCHEMA_REF_FORBIDDEN\",\n  SCHEMA_OBJECT_INVALID: \"SCHEMA_OBJECT_INVALID\",\n  SCHEMA_PROPERTY_INVALID: \"SCHEMA_PROPERTY_INVALID\",\n  SCHEMA_TOO_DEEP: \"SCHEMA_TOO_DEEP\",\n  SCHEMA_KEY_UNSUPPORTED: \"SCHEMA_KEY_UNSUPPORTED\",\n  ENUM_NAME_EMPTY: \"ENUM_NAME_EMPTY\",\n  CALLBACK_RESULT_UNREADABLE: \"CALLBACK_RESULT_UNREADABLE\",\n  OPTION_FIX_UNKNOWN: \"OPTION_FIX_UNKNOWN\",\n  TYPESCRIPT_NOT_FOUND: \"TYPESCRIPT_NOT_FOUND\",\n  CLI_FLAG_REMOVED: \"CLI_FLAG_REMOVED\",\n  CLI_GLOB_UNSUPPORTED: \"CLI_GLOB_UNSUPPORTED\",\n  CLI_CONFIG_NOT_FOUND: \"CLI_CONFIG_NOT_FOUND\",\n  CLI_CONFIG_OUTPUT_MISSING: \"CLI_CONFIG_OUTPUT_MISSING\",\n  CLI_CHECK_OUTPUT_MISSING: \"CLI_CHECK_OUTPUT_MISSING\",\n  OUTPUT_STALE: \"OUTPUT_STALE\",\n  OUTPUT_READ_FAILED: \"OUTPUT_READ_FAILED\",\n  OUTPUT_WRITE_FAILED: \"OUTPUT_WRITE_FAILED\",\n} as const;\n\nexport type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];\n\n/** Structured, JSON-serializable facts about a failure, for programs and logs. */\nexport type ErrorDetails = Readonly<Record<string, unknown>>;\n\nexport interface OpenAPITypesafeErrorInit {\n  readonly code: ErrorCode;\n  readonly message: string;\n  readonly details?: ErrorDetails;\n  /** The lower-level error this one reports, if any (kept as the standard `cause`). */\n  readonly cause?: unknown;\n}\n\n/** The base of every expected failure; check `code`, not the class or the message. */\nexport class OpenAPITypesafeError extends Error {\n  readonly code: ErrorCode;\n  readonly details: ErrorDetails;\n\n  constructor(init: OpenAPITypesafeErrorInit) {\n    super(init.message, init.cause === undefined ? undefined : { cause: init.cause });\n    this.name = \"OpenAPITypesafeError\";\n    this.code = init.code;\n    this.details = init.details ?? {};\n  }\n}\n\n/** Whether a thrown value is one of our typed errors (also across bundled copies of the class). */\nexport function isOpenAPITypesafeError(value: unknown): value is OpenAPITypesafeError {\n  if (value instanceof OpenAPITypesafeError) {\n    return true;\n  }\n  const code = (value as { code?: unknown } | null)?.code;\n  return (\n    value instanceof Error &&\n    typeof code === \"string\" &&\n    Object.hasOwn(ERROR_CODES, code) &&\n    typeof (value as { details?: unknown }).details === \"object\"\n  );\n}\n"],"names":[],"mappings":"AAQO,MAAM,WAAA,GAAc;AAAA,EACzB,mBAAA,EAAqB,qBAAA;AAAA,EACrB,qBAAA,EAAuB,uBAAA;AAAA,EACvB,kBAAA,EAAoB,oBAAA;AAAA,EACpB,mBAAA,EAAqB,qBAAA;AAAA,EACrB,0BAAA,EAA4B,4BAAA;AAAA,EAC5B,cAAA,EAAgB,gBAAA;AAAA,EAChB,kBAAA,EAAoB,oBAAA;AAAA,EACpB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,qBAAA,EAAuB,uBAAA;AAAA,EACvB,uBAAA,EAAyB,yBAAA;AAAA,EACzB,eAAA,EAAiB,iBAAA;AAAA,EACjB,sBAAA,EAAwB,wBAAA;AAAA,EACxB,eAAA,EAAiB,iBAAA;AAAA,EACjB,0BAAA,EAA4B,4BAAA;AAAA,EAC5B,kBAAA,EAAoB,oBAAA;AAAA,EACpB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,gBAAA,EAAkB,kBAAA;AAAA,EAClB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,oBAAA,EAAsB,sBAAA;AAAA,EACtB,yBAAA,EAA2B,2BAAA;AAAA,EAC3B,wBAAA,EAA0B,0BAAA;AAAA,EAC1B,YAAA,EAAc,cAAA;AAAA,EACd,kBAAA,EAAoB,oBAAA;AAAA,EACpB,mBAAA,EAAqB;AACvB;AAgBO,MAAM,6BAA6B,KAAA,CAAM;AAAA,EACrC,IAAA;AAAA,EACA,OAAA;AAAA,EAET,YAAY,IAAA,EAAgC;AAC1C,IAAA,KAAA,CAAM,IAAA,CAAK,OAAA,EAAS,IAAA,CAAK,KAAA,KAAU,MAAA,GAAY,SAAY,EAAE,KAAA,EAAO,IAAA,CAAK,KAAA,EAAO,CAAA;AAChF,IAAA,IAAA,CAAK,IAAA,GAAO,sBAAA;AACZ,IAAA,IAAA,CAAK,OAAO,IAAA,CAAK,IAAA;AACjB,IAAA,IAAA,CAAK,OAAA,GAAU,IAAA,CAAK,OAAA,IAAW,EAAC;AAAA,EAClC;AACF;AAGO,SAAS,uBAAuB,KAAA,EAA+C;AACpF,EAAA,IAAI,iBAAiB,oBAAA,EAAsB;AACzC,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,MAAM,OAAQ,KAAA,EAAqC,IAAA;AACnD,EAAA,OACE,KAAA,YAAiB,KAAA,IACjB,OAAO,IAAA,KAAS,QAAA,IAChB,MAAA,CAAO,MAAA,CAAO,WAAA,EAAa,IAAI,CAAA,IAC/B,OAAQ,KAAA,CAAgC,OAAA,KAAY,QAAA;AAExD;;"}

package/dist/domain/ir/constructors.cjs

@@ -0,0 +1,89 @@
+'use strict';
+
+function irKeyword(keyword) {
+  return { kind: "keyword", keyword };
+}
+function irString(value, encoding) {
+  return { kind: "stringLiteral", value, encoding };
+}
+function irNumber(value) {
+  if (!Number.isFinite(value)) {
+    throw new RangeError(`A number literal type needs a finite number, got ${value}`);
+  }
+  return { kind: "numberLiteral", value };
+}
+function irBoolean(value) {
+  return { kind: "booleanLiteral", value };
+}
+function irReference(name, typeArguments = []) {
+  return { kind: "reference", name, typeArguments };
+}
+function irArray(element) {
+  return { kind: "array", element };
+}
+function irTuple(elements) {
+  return { kind: "tuple", elements };
+}
+function irTupleElement(type, isRest = false) {
+  return { type, isRest };
+}
+function irUnion(types) {
+  return { kind: "union", types };
+}
+function irIntersection(types) {
+  return { kind: "intersection", types };
+}
+function irObject(members) {
+  return { kind: "object", members };
+}
+function irIndexedAccess(object, index) {
+  return { kind: "indexedAccess", object, index };
+}
+function irReadonly(type) {
+  return { kind: "readonly", type };
+}
+function irRaw(text, origin) {
+  return origin === void 0 ? { kind: "raw", text } : { kind: "raw", text, origin };
+}
+function irProperty(name, type, options = {}) {
+  return {
+    kind: "property",
+    name,
+    type,
+    isOptional: options.isOptional ?? false,
+    isReadonly: options.isReadonly ?? false,
+    comments: options.comments ?? []
+  };
+}
+function irStringIndexSignature(parameterName, type, isReadonly = false) {
+  return {
+    kind: "indexSignature",
+    parameterName,
+    parameterType: irKeyword("string"),
+    type,
+    isReadonly,
+    comments: []
+  };
+}
+function irRecord(key, value) {
+  return irReference("Record", [key, value]);
+}
+
+exports.irArray = irArray;
+exports.irBoolean = irBoolean;
+exports.irIndexedAccess = irIndexedAccess;
+exports.irIntersection = irIntersection;
+exports.irKeyword = irKeyword;
+exports.irNumber = irNumber;
+exports.irObject = irObject;
+exports.irProperty = irProperty;
+exports.irRaw = irRaw;
+exports.irReadonly = irReadonly;
+exports.irRecord = irRecord;
+exports.irReference = irReference;
+exports.irString = irString;
+exports.irStringIndexSignature = irStringIndexSignature;
+exports.irTuple = irTuple;
+exports.irTupleElement = irTupleElement;
+exports.irUnion = irUnion;
+//# sourceMappingURL=constructors.cjs.map

package/dist/domain/ir/constructors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constructors.cjs","sources":["../../../src/domain/ir/constructors.ts"],"sourcesContent":["import type {\n  IrArrayType,\n  IrBooleanLiteralType,\n  IrComment,\n  IrIndexedAccessType,\n  IrIndexSignature,\n  IrIntersectionType,\n  IrKeyword,\n  IrKeywordType,\n  IrMember,\n  IrNumberLiteralType,\n  IrObjectType,\n  IrPropertyName,\n  IrPropertySignature,\n  IrRawType,\n  IrReadonlyType,\n  IrReferenceType,\n  IrStringEncoding,\n  IrStringLiteralType,\n  IrTupleElement,\n  IrTupleType,\n  IrType,\n  IrUnionType,\n} from \"./nodes.js\";\n\n/**\n * Constructors of IR nodes. They build exactly the node asked for: no flattening, de-duplication or\n * sorting happens here (ENGINEERING_PLAN §4.2). Callers that need those call the functions in\n * `normalize.ts` explicitly, at the same places the original generator does.\n */\n\nexport function irKeyword(keyword: IrKeyword): IrKeywordType {\n  return { kind: \"keyword\", keyword };\n}\n\nexport function irString(value: string, encoding: IrStringEncoding): IrStringLiteralType {\n  return { kind: \"stringLiteral\", value, encoding };\n}\n\n/** Throws on NaN and infinities: they have no literal type. */\nexport function irNumber(value: number): IrNumberLiteralType {\n  if (!Number.isFinite(value)) {\n    throw new RangeError(`A number literal type needs a finite number, got ${value}`);\n  }\n  return { kind: \"numberLiteral\", value };\n}\n\nexport function irBoolean(value: boolean): IrBooleanLiteralType {\n  return { kind: \"booleanLiteral\", value };\n}\n\nexport function irReference(name: string, typeArguments: readonly IrType[] = []): IrReferenceType {\n  return { kind: \"reference\", name, typeArguments };\n}\n\nexport function irArray(element: IrType): IrArrayType {\n  return { kind: \"array\", element };\n}\n\nexport function irTuple(elements: readonly IrTupleElement[]): IrTupleType {\n  return { kind: \"tuple\", elements };\n}\n\nexport function irTupleElement(type: IrType, isRest = false): IrTupleElement {\n  return { type, isRest };\n}\n\nexport function irUnion(types: readonly IrType[]): IrUnionType {\n  return { kind: \"union\", types };\n}\n\nexport function irIntersection(types: readonly IrType[]): IrIntersectionType {\n  return { kind: \"intersection\", types };\n}\n\nexport function irObject(members: readonly IrMember[]): IrObjectType {\n  return { kind: \"object\", members };\n}\n\nexport function irIndexedAccess(object: IrType, index: IrType): IrIndexedAccessType {\n  return { kind: \"indexedAccess\", object, index };\n}\n\nexport function irReadonly(type: IrType): IrReadonlyType {\n  return { kind: \"readonly\", type };\n}\n\n/**\n * Type text printed as is. The original builds some types from text (template literal path keys,\n * root type aliases); keeping them as text keeps their exact spelling.\n */\nexport function irRaw(text: string, origin?: unknown): IrRawType {\n  return origin === undefined ? { kind: \"raw\", text } : { kind: \"raw\", text, origin };\n}\n\n/** Options of a property signature; omitted flags are false and there are no comments. */\nexport interface IrPropertyOptions {\n  readonly isOptional?: boolean;\n  readonly isReadonly?: boolean;\n  readonly comments?: readonly IrComment[];\n}\n\nexport function irProperty(\n  name: IrPropertyName,\n  type: IrType,\n  options: IrPropertyOptions = {},\n): IrPropertySignature {\n  return {\n    kind: \"property\",\n    name,\n    type,\n    isOptional: options.isOptional ?? false,\n    isReadonly: options.isReadonly ?? false,\n    comments: options.comments ?? [],\n  };\n}\n\n/** `[name: string]: type` (a `string` key, the only kind the generator writes). */\nexport function irStringIndexSignature(\n  parameterName: string,\n  type: IrType,\n  isReadonly = false,\n): IrIndexSignature {\n  return {\n    kind: \"indexSignature\",\n    parameterName,\n    parameterType: irKeyword(\"string\"),\n    type,\n    isReadonly,\n    comments: [],\n  };\n}\n\n/** `Record<key, value>`. */\nexport function irRecord(key: IrType, value: IrType): IrReferenceType {\n  return irReference(\"Record\", [key, value]);\n}\n"],"names":[],"mappings":"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"}