openapi-typesafe 0.0.0 → 1.0.0-rc.1

package/dist/cli/cli-errors.cjs

@@ -0,0 +1,81 @@
+'use strict';
+
+const errors = require('../domain/errors.cjs');
+
+const EXIT_CODES = {
+  SUCCESS: 0,
+  /** `--check` found output that differs from the generated types (as in the original CLI). */
+  OUTPUT_STALE: 1,
+  /** A flag, the Redocly config, the environment or a callback is wrong. */
+  USAGE: 2,
+  /** The OpenAPI document cannot be read, is invalid, or cannot be converted. */
+  SCHEMA: 3,
+  /** An output file cannot be read or written. */
+  OUTPUT: 4,
+  /** An unexpected failure: a bug in the generator (sysexits `EX_SOFTWARE`). */
+  INTERNAL: 70
+};
+function schemaInvalidMessage(error) {
+  const count = Array.isArray(error.details.problems) ? error.details.problems.length : 1;
+  return `The OpenAPI document has ${count} ${count === 1 ? "error" : "errors"} (see above)`;
+}
+function loadFailedMessage(error) {
+  const reason = error.cause instanceof Error ? error.cause.cause : void 0;
+  if (!(reason instanceof Error)) {
+    return error.message;
+  }
+  return `${error.message}: ${reason.message} (${String(error.details.source)})`;
+}
+const YAML_DEPTH_LIMIT_MESSAGE = /nesting exceeded maxDepth \((\d+)\)/;
+function parseFailedMessage(error) {
+  const limit = YAML_DEPTH_LIMIT_MESSAGE.exec(error.message)?.[1];
+  if (limit === void 0) {
+    return error.message;
+  }
+  return `${error.message}. The YAML parser reads at most ${limit} nested levels: move nested schemas to \`components\` and reference them with \`$ref\``;
+}
+const CLI_ERROR_REPORTS = {
+  SCHEMA_SOURCE_EMPTY: { exitCode: EXIT_CODES.SCHEMA },
+  SCHEMA_SOURCE_INVALID: { exitCode: EXIT_CODES.SCHEMA },
+  SCHEMA_LOAD_FAILED: { exitCode: EXIT_CODES.SCHEMA, message: loadFailedMessage },
+  SCHEMA_PARSE_FAILED: { exitCode: EXIT_CODES.SCHEMA, message: parseFailedMessage },
+  SCHEMA_VERSION_UNSUPPORTED: { exitCode: EXIT_CODES.SCHEMA },
+  SCHEMA_INVALID: { exitCode: EXIT_CODES.SCHEMA, message: schemaInvalidMessage },
+  SCHEMA_REF_INVALID: { exitCode: EXIT_CODES.SCHEMA },
+  SCHEMA_REF_FORBIDDEN: { exitCode: EXIT_CODES.SCHEMA },
+  SCHEMA_OBJECT_INVALID: { exitCode: EXIT_CODES.SCHEMA },
+  SCHEMA_PROPERTY_INVALID: { exitCode: EXIT_CODES.SCHEMA },
+  SCHEMA_TOO_DEEP: { exitCode: EXIT_CODES.SCHEMA },
+  SCHEMA_KEY_UNSUPPORTED: { exitCode: EXIT_CODES.SCHEMA },
+  ENUM_NAME_EMPTY: { exitCode: EXIT_CODES.SCHEMA },
+  CALLBACK_RESULT_UNREADABLE: { exitCode: EXIT_CODES.USAGE },
+  OPTION_FIX_UNKNOWN: { exitCode: EXIT_CODES.USAGE },
+  TYPESCRIPT_NOT_FOUND: { exitCode: EXIT_CODES.USAGE },
+  CLI_FLAG_REMOVED: { exitCode: EXIT_CODES.USAGE },
+  CLI_GLOB_UNSUPPORTED: { exitCode: EXIT_CODES.USAGE },
+  CLI_CONFIG_NOT_FOUND: { exitCode: EXIT_CODES.USAGE },
+  CLI_CONFIG_INVALID: { exitCode: EXIT_CODES.USAGE },
+  CLI_CONFIG_OUTPUT_MISSING: { exitCode: EXIT_CODES.USAGE },
+  CLI_CHECK_OUTPUT_MISSING: { exitCode: EXIT_CODES.USAGE },
+  CLI_INPUT_MISSING: { exitCode: EXIT_CODES.USAGE },
+  OUTPUT_STALE: { exitCode: EXIT_CODES.OUTPUT_STALE },
+  OUTPUT_READ_FAILED: { exitCode: EXIT_CODES.OUTPUT },
+  OUTPUT_WRITE_FAILED: { exitCode: EXIT_CODES.OUTPUT }
+};
+function describeCliFailure(error) {
+  if (!errors.isOpenAPITypesafeError(error)) {
+    const text = error instanceof Error ? error.stack ?? error.message : String(error);
+    return { exitCode: EXIT_CODES.INTERNAL, message: `Unexpected error: ${text}` };
+  }
+  const report = CLI_ERROR_REPORTS[error.code];
+  const message = report.message?.(error) ?? error.message;
+  return { exitCode: report.exitCode, message: `${message} (${error.code})` };
+}
+function cliError(code, message, cause) {
+  return new errors.OpenAPITypesafeError({ code: errors.ERROR_CODES[code], message, cause });
+}
+
+exports.EXIT_CODES = EXIT_CODES;
+exports.cliError = cliError;
+exports.describeCliFailure = describeCliFailure;
+//# sourceMappingURL=cli-errors.cjs.map

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

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

package/dist/cli/cli-errors.mjs

@@ -0,0 +1,77 @@
+import { isOpenAPITypesafeError, OpenAPITypesafeError, ERROR_CODES } from '../domain/errors.mjs';
+
+const EXIT_CODES = {
+  SUCCESS: 0,
+  /** `--check` found output that differs from the generated types (as in the original CLI). */
+  OUTPUT_STALE: 1,
+  /** A flag, the Redocly config, the environment or a callback is wrong. */
+  USAGE: 2,
+  /** The OpenAPI document cannot be read, is invalid, or cannot be converted. */
+  SCHEMA: 3,
+  /** An output file cannot be read or written. */
+  OUTPUT: 4,
+  /** An unexpected failure: a bug in the generator (sysexits `EX_SOFTWARE`). */
+  INTERNAL: 70
+};
+function schemaInvalidMessage(error) {
+  const count = Array.isArray(error.details.problems) ? error.details.problems.length : 1;
+  return `The OpenAPI document has ${count} ${count === 1 ? "error" : "errors"} (see above)`;
+}
+function loadFailedMessage(error) {
+  const reason = error.cause instanceof Error ? error.cause.cause : void 0;
+  if (!(reason instanceof Error)) {
+    return error.message;
+  }
+  return `${error.message}: ${reason.message} (${String(error.details.source)})`;
+}
+const YAML_DEPTH_LIMIT_MESSAGE = /nesting exceeded maxDepth \((\d+)\)/;
+function parseFailedMessage(error) {
+  const limit = YAML_DEPTH_LIMIT_MESSAGE.exec(error.message)?.[1];
+  if (limit === void 0) {
+    return error.message;
+  }
+  return `${error.message}. The YAML parser reads at most ${limit} nested levels: move nested schemas to \`components\` and reference them with \`$ref\``;
+}
+const CLI_ERROR_REPORTS = {
+  SCHEMA_SOURCE_EMPTY: { exitCode: EXIT_CODES.SCHEMA },
+  SCHEMA_SOURCE_INVALID: { exitCode: EXIT_CODES.SCHEMA },
+  SCHEMA_LOAD_FAILED: { exitCode: EXIT_CODES.SCHEMA, message: loadFailedMessage },
+  SCHEMA_PARSE_FAILED: { exitCode: EXIT_CODES.SCHEMA, message: parseFailedMessage },
+  SCHEMA_VERSION_UNSUPPORTED: { exitCode: EXIT_CODES.SCHEMA },
+  SCHEMA_INVALID: { exitCode: EXIT_CODES.SCHEMA, message: schemaInvalidMessage },
+  SCHEMA_REF_INVALID: { exitCode: EXIT_CODES.SCHEMA },
+  SCHEMA_REF_FORBIDDEN: { exitCode: EXIT_CODES.SCHEMA },
+  SCHEMA_OBJECT_INVALID: { exitCode: EXIT_CODES.SCHEMA },
+  SCHEMA_PROPERTY_INVALID: { exitCode: EXIT_CODES.SCHEMA },
+  SCHEMA_TOO_DEEP: { exitCode: EXIT_CODES.SCHEMA },
+  SCHEMA_KEY_UNSUPPORTED: { exitCode: EXIT_CODES.SCHEMA },
+  ENUM_NAME_EMPTY: { exitCode: EXIT_CODES.SCHEMA },
+  CALLBACK_RESULT_UNREADABLE: { exitCode: EXIT_CODES.USAGE },
+  OPTION_FIX_UNKNOWN: { exitCode: EXIT_CODES.USAGE },
+  TYPESCRIPT_NOT_FOUND: { exitCode: EXIT_CODES.USAGE },
+  CLI_FLAG_REMOVED: { exitCode: EXIT_CODES.USAGE },
+  CLI_GLOB_UNSUPPORTED: { exitCode: EXIT_CODES.USAGE },
+  CLI_CONFIG_NOT_FOUND: { exitCode: EXIT_CODES.USAGE },
+  CLI_CONFIG_INVALID: { exitCode: EXIT_CODES.USAGE },
+  CLI_CONFIG_OUTPUT_MISSING: { exitCode: EXIT_CODES.USAGE },
+  CLI_CHECK_OUTPUT_MISSING: { exitCode: EXIT_CODES.USAGE },
+  CLI_INPUT_MISSING: { exitCode: EXIT_CODES.USAGE },
+  OUTPUT_STALE: { exitCode: EXIT_CODES.OUTPUT_STALE },
+  OUTPUT_READ_FAILED: { exitCode: EXIT_CODES.OUTPUT },
+  OUTPUT_WRITE_FAILED: { exitCode: EXIT_CODES.OUTPUT }
+};
+function describeCliFailure(error) {
+  if (!isOpenAPITypesafeError(error)) {
+    const text = error instanceof Error ? error.stack ?? error.message : String(error);
+    return { exitCode: EXIT_CODES.INTERNAL, message: `Unexpected error: ${text}` };
+  }
+  const report = CLI_ERROR_REPORTS[error.code];
+  const message = report.message?.(error) ?? error.message;
+  return { exitCode: report.exitCode, message: `${message} (${error.code})` };
+}
+function cliError(code, message, cause) {
+  return new OpenAPITypesafeError({ code: ERROR_CODES[code], message, cause });
+}
+
+export { EXIT_CODES, cliError, describeCliFailure };
+//# sourceMappingURL=cli-errors.mjs.map

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

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

package/dist/cli/cli-output.cjs

@@ -0,0 +1,42 @@
+'use strict';
+
+const path = require('node:path');
+const node_url = require('node:url');
+const terminalLogger = require('../adapters/terminal-logger/terminal-logger.cjs');
+const cliErrors = require('./cli-errors.cjs');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
+
+const path__default = /*#__PURE__*/_interopDefaultCompat(path);
+
+const URL_SCHEME = /^[a-z][a-z\d+.-]+:/i;
+function resolveLocationUrl(location, base) {
+  if (URL_SCHEME.test(location)) {
+    return new URL(location);
+  }
+  const baseDirectory = node_url.fileURLToPath(new URL(".", base));
+  return node_url.pathToFileURL(path__default.resolve(baseDirectory, location));
+}
+function printDone(run, output) {
+  const { style, now } = run.deps;
+  const target = style.green(`${output.source} \u2192 ${style.bold(output.output)}`);
+  const duration = style.dim(`[${terminalLogger.formatDuration(now() - run.startedAt)}]`);
+  run.deps.console.info(`\u{1F680} ${target} ${duration}`);
+}
+function emitOutput(run, output, contents) {
+  if (run.args.isCheck) {
+    if (run.deps.files.readText(output.file) !== contents) {
+      throw cliErrors.cliError(
+        "OUTPUT_STALE",
+        `Generated types are not up-to-date! ${output.output} differs from its schema.`
+      );
+    }
+    return;
+  }
+  run.deps.files.writeText(output.file, contents);
+  printDone(run, output);
+}
+
+exports.emitOutput = emitOutput;
+exports.resolveLocationUrl = resolveLocationUrl;
+//# sourceMappingURL=cli-output.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-output.cjs","sources":["../../src/cli/cli-output.ts"],"sourcesContent":["import path from \"node:path\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport { formatDuration } from \"../adapters/terminal-logger/terminal-logger.js\";\nimport type { CliArguments } from \"./cli-arguments.js\";\nimport type { CliDependencies } from \"./cli-dependencies.js\";\nimport { cliError } from \"./cli-errors.js\";\n\n/** Writing one generated file, or checking it with `--check`, and the line printed for it. */\n\n/** One CLI run: its dependencies, its arguments and when it started. */\nexport interface CliRun {\n  readonly deps: CliDependencies;\n  readonly args: CliArguments;\n  readonly startedAt: number;\n}\n\n/** A generated file: `source` names the schema and `output` is the path as the user wrote it. */\nexport interface OutputFile {\n  readonly source: string;\n  readonly output: string;\n  readonly file: URL;\n}\n\n/**\n * A scheme of two or more characters (`https:`, `file:`). One letter is a Windows drive (`C:`), so\n * `C:\\\\specs\\\\api.yaml` stays a path.\n */\nconst URL_SCHEME = /^[a-z][a-z\\d+.-]+:/i;\n\n/**\n * The URL of a location the user wrote: a URL as it is, else a file path, absolute or relative to\n * the directory of `base` (a directory or file URL). A path is not parsed as a URL, so `#`, `?` and\n * `%` are part of the file name.\n */\nexport function resolveLocationUrl(location: string, base: URL): URL {\n  if (URL_SCHEME.test(location)) {\n    return new URL(location);\n  }\n  const baseDirectory = fileURLToPath(new URL(\".\", base));\n  return pathToFileURL(path.resolve(baseDirectory, location));\n}\n\nfunction printDone(run: CliRun, output: OutputFile): void {\n  const { style, now } = run.deps;\n  const target = style.green(`${output.source} → ${style.bold(output.output)}`);\n  const duration = style.dim(`[${formatDuration(now() - run.startedAt)}]`);\n  run.deps.console.info(`🚀 ${target} ${duration}`);\n}\n\n/**\n * With `--check`, fail with `OUTPUT_STALE` when the file differs from `contents` and leave it\n * alone otherwise. Without it, write the file and print where it went.\n */\nexport function emitOutput(run: CliRun, output: OutputFile, contents: string): void {\n  if (run.args.isCheck) {\n    if (run.deps.files.readText(output.file) !== contents) {\n      // The original message, then the file: with several APIs it tells which one is stale.\n      throw cliError(\n        \"OUTPUT_STALE\",\n        `Generated types are not up-to-date! ${output.output} differs from its schema.`,\n      );\n    }\n    return;\n  }\n  run.deps.files.writeText(output.file, contents);\n  printDone(run, output);\n}\n"],"names":["fileURLToPath","pathToFileURL","path","formatDuration","cliError"],"mappings":";;;;;;;;;;;AA2BA,MAAM,UAAA,GAAa,qBAAA;AAOZ,SAAS,kBAAA,CAAmB,UAAkB,IAAA,EAAgB;AACnE,EAAA,IAAI,UAAA,CAAW,IAAA,CAAK,QAAQ,CAAA,EAAG;AAC7B,IAAA,OAAO,IAAI,IAAI,QAAQ,CAAA;AAAA,EACzB;AACA,EAAA,MAAM,gBAAgBA,sBAAA,CAAc,IAAI,GAAA,CAAI,GAAA,EAAK,IAAI,CAAC,CAAA;AACtD,EAAA,OAAOC,sBAAA,CAAcC,aAAA,CAAK,OAAA,CAAQ,aAAA,EAAe,QAAQ,CAAC,CAAA;AAC5D;AAEA,SAAS,SAAA,CAAU,KAAa,MAAA,EAA0B;AACxD,EAAA,MAAM,EAAE,KAAA,EAAO,GAAA,EAAI,GAAI,GAAA,CAAI,IAAA;AAC3B,EAAA,MAAM,MAAA,GAAS,KAAA,CAAM,KAAA,CAAM,CAAA,EAAG,MAAA,CAAO,MAAM,CAAA,QAAA,EAAM,KAAA,CAAM,IAAA,CAAK,MAAA,CAAO,MAAM,CAAC,CAAA,CAAE,CAAA;AAC5E,EAAA,MAAM,QAAA,GAAW,KAAA,CAAM,GAAA,CAAI,CAAA,CAAA,EAAIC,6BAAA,CAAe,KAAI,GAAI,GAAA,CAAI,SAAS,CAAC,CAAA,CAAA,CAAG,CAAA;AACvE,EAAA,GAAA,CAAI,KAAK,OAAA,CAAQ,IAAA,CAAK,aAAM,MAAM,CAAA,CAAA,EAAI,QAAQ,CAAA,CAAE,CAAA;AAClD;AAMO,SAAS,UAAA,CAAW,GAAA,EAAa,MAAA,EAAoB,QAAA,EAAwB;AAClF,EAAA,IAAI,GAAA,CAAI,KAAK,OAAA,EAAS;AACpB,IAAA,IAAI,IAAI,IAAA,CAAK,KAAA,CAAM,SAAS,MAAA,CAAO,IAAI,MAAM,QAAA,EAAU;AAErD,MAAA,MAAMC,kBAAA;AAAA,QACJ,cAAA;AAAA,QACA,CAAA,oCAAA,EAAuC,OAAO,MAAM,CAAA,yBAAA;AAAA,OACtD;AAAA,IACF;AACA,IAAA;AAAA,EACF;AACA,EAAA,GAAA,CAAI,IAAA,CAAK,KAAA,CAAM,SAAA,CAAU,MAAA,CAAO,MAAM,QAAQ,CAAA;AAC9C,EAAA,SAAA,CAAU,KAAK,MAAM,CAAA;AACvB;;;"}

package/dist/cli/cli-output.mjs

@@ -0,0 +1,35 @@
+import path from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { formatDuration } from '../adapters/terminal-logger/terminal-logger.mjs';
+import { cliError } from './cli-errors.mjs';
+
+const URL_SCHEME = /^[a-z][a-z\d+.-]+:/i;
+function resolveLocationUrl(location, base) {
+  if (URL_SCHEME.test(location)) {
+    return new URL(location);
+  }
+  const baseDirectory = fileURLToPath(new URL(".", base));
+  return pathToFileURL(path.resolve(baseDirectory, location));
+}
+function printDone(run, output) {
+  const { style, now } = run.deps;
+  const target = style.green(`${output.source} \u2192 ${style.bold(output.output)}`);
+  const duration = style.dim(`[${formatDuration(now() - run.startedAt)}]`);
+  run.deps.console.info(`\u{1F680} ${target} ${duration}`);
+}
+function emitOutput(run, output, contents) {
+  if (run.args.isCheck) {
+    if (run.deps.files.readText(output.file) !== contents) {
+      throw cliError(
+        "OUTPUT_STALE",
+        `Generated types are not up-to-date! ${output.output} differs from its schema.`
+      );
+    }
+    return;
+  }
+  run.deps.files.writeText(output.file, contents);
+  printDone(run, output);
+}
+
+export { emitOutput, resolveLocationUrl };
+//# sourceMappingURL=cli-output.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-output.mjs","sources":["../../src/cli/cli-output.ts"],"sourcesContent":["import path from \"node:path\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport { formatDuration } from \"../adapters/terminal-logger/terminal-logger.js\";\nimport type { CliArguments } from \"./cli-arguments.js\";\nimport type { CliDependencies } from \"./cli-dependencies.js\";\nimport { cliError } from \"./cli-errors.js\";\n\n/** Writing one generated file, or checking it with `--check`, and the line printed for it. */\n\n/** One CLI run: its dependencies, its arguments and when it started. */\nexport interface CliRun {\n  readonly deps: CliDependencies;\n  readonly args: CliArguments;\n  readonly startedAt: number;\n}\n\n/** A generated file: `source` names the schema and `output` is the path as the user wrote it. */\nexport interface OutputFile {\n  readonly source: string;\n  readonly output: string;\n  readonly file: URL;\n}\n\n/**\n * A scheme of two or more characters (`https:`, `file:`). One letter is a Windows drive (`C:`), so\n * `C:\\\\specs\\\\api.yaml` stays a path.\n */\nconst URL_SCHEME = /^[a-z][a-z\\d+.-]+:/i;\n\n/**\n * The URL of a location the user wrote: a URL as it is, else a file path, absolute or relative to\n * the directory of `base` (a directory or file URL). A path is not parsed as a URL, so `#`, `?` and\n * `%` are part of the file name.\n */\nexport function resolveLocationUrl(location: string, base: URL): URL {\n  if (URL_SCHEME.test(location)) {\n    return new URL(location);\n  }\n  const baseDirectory = fileURLToPath(new URL(\".\", base));\n  return pathToFileURL(path.resolve(baseDirectory, location));\n}\n\nfunction printDone(run: CliRun, output: OutputFile): void {\n  const { style, now } = run.deps;\n  const target = style.green(`${output.source} → ${style.bold(output.output)}`);\n  const duration = style.dim(`[${formatDuration(now() - run.startedAt)}]`);\n  run.deps.console.info(`🚀 ${target} ${duration}`);\n}\n\n/**\n * With `--check`, fail with `OUTPUT_STALE` when the file differs from `contents` and leave it\n * alone otherwise. Without it, write the file and print where it went.\n */\nexport function emitOutput(run: CliRun, output: OutputFile, contents: string): void {\n  if (run.args.isCheck) {\n    if (run.deps.files.readText(output.file) !== contents) {\n      // The original message, then the file: with several APIs it tells which one is stale.\n      throw cliError(\n        \"OUTPUT_STALE\",\n        `Generated types are not up-to-date! ${output.output} differs from its schema.`,\n      );\n    }\n    return;\n  }\n  run.deps.files.writeText(output.file, contents);\n  printDone(run, output);\n}\n"],"names":[],"mappings":";;;;;AA2BA,MAAM,UAAA,GAAa,qBAAA;AAOZ,SAAS,kBAAA,CAAmB,UAAkB,IAAA,EAAgB;AACnE,EAAA,IAAI,UAAA,CAAW,IAAA,CAAK,QAAQ,CAAA,EAAG;AAC7B,IAAA,OAAO,IAAI,IAAI,QAAQ,CAAA;AAAA,EACzB;AACA,EAAA,MAAM,gBAAgB,aAAA,CAAc,IAAI,GAAA,CAAI,GAAA,EAAK,IAAI,CAAC,CAAA;AACtD,EAAA,OAAO,aAAA,CAAc,IAAA,CAAK,OAAA,CAAQ,aAAA,EAAe,QAAQ,CAAC,CAAA;AAC5D;AAEA,SAAS,SAAA,CAAU,KAAa,MAAA,EAA0B;AACxD,EAAA,MAAM,EAAE,KAAA,EAAO,GAAA,EAAI,GAAI,GAAA,CAAI,IAAA;AAC3B,EAAA,MAAM,MAAA,GAAS,KAAA,CAAM,KAAA,CAAM,CAAA,EAAG,MAAA,CAAO,MAAM,CAAA,QAAA,EAAM,KAAA,CAAM,IAAA,CAAK,MAAA,CAAO,MAAM,CAAC,CAAA,CAAE,CAAA;AAC5E,EAAA,MAAM,QAAA,GAAW,KAAA,CAAM,GAAA,CAAI,CAAA,CAAA,EAAI,cAAA,CAAe,KAAI,GAAI,GAAA,CAAI,SAAS,CAAC,CAAA,CAAA,CAAG,CAAA;AACvE,EAAA,GAAA,CAAI,KAAK,OAAA,CAAQ,IAAA,CAAK,aAAM,MAAM,CAAA,CAAA,EAAI,QAAQ,CAAA,CAAE,CAAA;AAClD;AAMO,SAAS,UAAA,CAAW,GAAA,EAAa,MAAA,EAAoB,QAAA,EAAwB;AAClF,EAAA,IAAI,GAAA,CAAI,KAAK,OAAA,EAAS;AACpB,IAAA,IAAI,IAAI,IAAA,CAAK,KAAA,CAAM,SAAS,MAAA,CAAO,IAAI,MAAM,QAAA,EAAU;AAErD,MAAA,MAAM,QAAA;AAAA,QACJ,cAAA;AAAA,QACA,CAAA,oCAAA,EAAuC,OAAO,MAAM,CAAA,yBAAA;AAAA,OACtD;AAAA,IACF;AACA,IAAA;AAAA,EACF;AACA,EAAA,GAAA,CAAI,IAAA,CAAK,KAAA,CAAM,SAAA,CAAU,MAAA,CAAO,MAAM,QAAQ,CAAA;AAC9C,EAAA,SAAA,CAAU,KAAK,MAAM,CAAA;AACvB;;"}

package/dist/cli/docs-links.cjs

@@ -0,0 +1,6 @@
+'use strict';
+
+const MULTIPLE_SCHEMAS_DOCS_URL = "https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs/cli.md#multiple-schemas";
+
+exports.MULTIPLE_SCHEMAS_DOCS_URL = MULTIPLE_SCHEMAS_DOCS_URL;
+//# sourceMappingURL=docs-links.cjs.map

package/dist/cli/docs-links.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-links.cjs","sources":["../../src/cli/docs-links.ts"],"sourcesContent":["/**\n * Links that CLI messages print. They point at the docs in this repository on GitHub, which work\n * before the docs site is published and stay valid after.\n */\nexport const MULTIPLE_SCHEMAS_DOCS_URL =\n  \"https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs/cli.md#multiple-schemas\";\n"],"names":[],"mappings":";;AAIO,MAAM,yBAAA,GACX;;"}

package/dist/cli/docs-links.mjs

@@ -0,0 +1,4 @@
+const MULTIPLE_SCHEMAS_DOCS_URL = "https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs/cli.md#multiple-schemas";
+
+export { MULTIPLE_SCHEMAS_DOCS_URL };
+//# sourceMappingURL=docs-links.mjs.map

package/dist/cli/docs-links.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-links.mjs","sources":["../../src/cli/docs-links.ts"],"sourcesContent":["/**\n * Links that CLI messages print. They point at the docs in this repository on GitHub, which work\n * before the docs site is published and stay valid after.\n */\nexport const MULTIPLE_SCHEMAS_DOCS_URL =\n  \"https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs/cli.md#multiple-schemas\";\n"],"names":[],"mappings":"AAIO,MAAM,yBAAA,GACX;;"}

package/dist/cli/fix-option.cjs

@@ -0,0 +1,19 @@
+'use strict';
+
+const outputFixes = require('../domain/output-fixes.cjs');
+
+const SEPARATOR = ",";
+function fixNamesOf(value) {
+  if (value === void 0) {
+    return void 0;
+  }
+  const names = [value].flat().flatMap((entry) => String(entry).split(SEPARATOR)).map((name) => name.trim()).filter((name) => name !== "");
+  return outputFixes.outputFixNamesOf(names);
+}
+function fixOption(names) {
+  return names === void 0 ? {} : { fix: names };
+}
+
+exports.fixNamesOf = fixNamesOf;
+exports.fixOption = fixOption;
+//# sourceMappingURL=fix-option.cjs.map

package/dist/cli/fix-option.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-option.cjs","sources":["../../src/cli/fix-option.ts"],"sourcesContent":["import { type OutputFixName, outputFixNamesOf } from \"../domain/output-fixes.js\";\nimport type { GeneratorOptions } from \"../types.js\";\n\n/**\n * The `fix` option (ADR-021) as the CLI and `redocly.yaml` give it: `--fix a,b`, repeatable, or\n * `fix: [a, b]` / `fix: a,b` in an API's settings. Unknown names fail with `OPTION_FIX_UNKNOWN`.\n */\n\nconst SEPARATOR = \",\";\n\n/** The names of a flag value or a config value; `undefined` when the option is not set. */\nexport function fixNamesOf(value: unknown): readonly OutputFixName[] | undefined {\n  if (value === undefined) {\n    return undefined;\n  }\n  const names = [value]\n    .flat()\n    .flatMap((entry) => String(entry).split(SEPARATOR))\n    .map((name) => name.trim())\n    .filter((name) => name !== \"\");\n  return outputFixNamesOf(names);\n}\n\n/** The generator option for the names; nothing when the option is not set. */\nexport function fixOption(\n  names: readonly OutputFixName[] | undefined,\n): Pick<GeneratorOptions, \"fix\"> {\n  return names === undefined ? {} : { fix: names };\n}\n"],"names":["outputFixNamesOf"],"mappings":";;;;AAQA,MAAM,SAAA,GAAY,GAAA;AAGX,SAAS,WAAW,KAAA,EAAsD;AAC/E,EAAA,IAAI,UAAU,MAAA,EAAW;AACvB,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,MAAM,KAAA,GAAQ,CAAC,KAAK,CAAA,CACjB,IAAA,EAAK,CACL,OAAA,CAAQ,CAAC,KAAA,KAAU,MAAA,CAAO,KAAK,CAAA,CAAE,KAAA,CAAM,SAAS,CAAC,CAAA,CACjD,GAAA,CAAI,CAAC,IAAA,KAAS,IAAA,CAAK,IAAA,EAAM,CAAA,CACzB,MAAA,CAAO,CAAC,IAAA,KAAS,IAAA,KAAS,EAAE,CAAA;AAC/B,EAAA,OAAOA,6BAAiB,KAAK,CAAA;AAC/B;AAGO,SAAS,UACd,KAAA,EAC+B;AAC/B,EAAA,OAAO,UAAU,MAAA,GAAY,EAAC,GAAI,EAAE,KAAK,KAAA,EAAM;AACjD;;;"}

package/dist/cli/fix-option.mjs

@@ -0,0 +1,16 @@
+import { outputFixNamesOf } from '../domain/output-fixes.mjs';
+
+const SEPARATOR = ",";
+function fixNamesOf(value) {
+  if (value === void 0) {
+    return void 0;
+  }
+  const names = [value].flat().flatMap((entry) => String(entry).split(SEPARATOR)).map((name) => name.trim()).filter((name) => name !== "");
+  return outputFixNamesOf(names);
+}
+function fixOption(names) {
+  return names === void 0 ? {} : { fix: names };
+}
+
+export { fixNamesOf, fixOption };
+//# sourceMappingURL=fix-option.mjs.map

package/dist/cli/fix-option.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-option.mjs","sources":["../../src/cli/fix-option.ts"],"sourcesContent":["import { type OutputFixName, outputFixNamesOf } from \"../domain/output-fixes.js\";\nimport type { GeneratorOptions } from \"../types.js\";\n\n/**\n * The `fix` option (ADR-021) as the CLI and `redocly.yaml` give it: `--fix a,b`, repeatable, or\n * `fix: [a, b]` / `fix: a,b` in an API's settings. Unknown names fail with `OPTION_FIX_UNKNOWN`.\n */\n\nconst SEPARATOR = \",\";\n\n/** The names of a flag value or a config value; `undefined` when the option is not set. */\nexport function fixNamesOf(value: unknown): readonly OutputFixName[] | undefined {\n  if (value === undefined) {\n    return undefined;\n  }\n  const names = [value]\n    .flat()\n    .flatMap((entry) => String(entry).split(SEPARATOR))\n    .map((name) => name.trim())\n    .filter((name) => name !== \"\");\n  return outputFixNamesOf(names);\n}\n\n/** The generator option for the names; nothing when the option is not set. */\nexport function fixOption(\n  names: readonly OutputFixName[] | undefined,\n): Pick<GeneratorOptions, \"fix\"> {\n  return names === undefined ? {} : { fix: names };\n}\n"],"names":[],"mappings":";;AAQA,MAAM,SAAA,GAAY,GAAA;AAGX,SAAS,WAAW,KAAA,EAAsD;AAC/E,EAAA,IAAI,UAAU,MAAA,EAAW;AACvB,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,MAAM,KAAA,GAAQ,CAAC,KAAK,CAAA,CACjB,IAAA,EAAK,CACL,OAAA,CAAQ,CAAC,KAAA,KAAU,MAAA,CAAO,KAAK,CAAA,CAAE,KAAA,CAAM,SAAS,CAAC,CAAA,CACjD,GAAA,CAAI,CAAC,IAAA,KAAS,IAAA,CAAK,IAAA,EAAM,CAAA,CACzB,MAAA,CAAO,CAAC,IAAA,KAAS,IAAA,KAAS,EAAE,CAAA;AAC/B,EAAA,OAAO,iBAAiB,KAAK,CAAA;AAC/B;AAGO,SAAS,UACd,KAAA,EAC+B;AAC/B,EAAA,OAAO,UAAU,MAAA,GAAY,EAAC,GAAI,EAAE,KAAK,KAAA,EAAM;AACjD;;"}

package/dist/cli/help-text.cjs

@@ -0,0 +1,44 @@
+'use strict';
+
+const HELP_TEXT = [
+  "Usage",
+  "  $ openapi-typesafe [input] [options]",
+  "",
+  "Options",
+  "  --help                     Display this",
+  "  --version                  Display the version",
+  "  --redocly [path], -c       Specify path to Redocly config (default: redocly.yaml)",
+  "  --output, -o               Specify output file (if not specified in redocly.yaml)",
+  "  --enum                     Export true TS enums instead of unions",
+  "  --enum-values              Export enum values as arrays",
+  "  --conditional-enums        Only generate true TS enums when enum metadata is available (default: false)",
+  "  --dedupe-enums             Dedupe enum types when `--enum=true` is set",
+  "  --check                    Check that the generated types are up-to-date. (default: false)",
+  "  --export-type, -t          Export top-level `type` instead of `interface`",
+  "  --immutable                Generate readonly types",
+  "  --additional-properties    Treat schema objects as if `additionalProperties: true` is set",
+  "  --empty-objects-unknown    Generate `unknown` instead of `Record<string, never>` for empty objects",
+  "  --default-non-nullable     Set to `false` to ignore default values when generating non-nullable types",
+  "  --properties-required-by-default",
+  "                             Treat schema objects as if `required` is set to all properties by default",
+  "  --array-length             Generate tuples using array minItems / maxItems",
+  "  --binary-as-blob           Type raw binary strings (format: binary, contentMediaType) as Blob",
+  '  --fix [names]              Turn on output fixes, comma-separated, or "all" (see docs/cli.md#fix)',
+  "  --path-params-as-types     Convert paths to template literal types",
+  "  --generate-path-params     Generate path parameters for all paths where they are undefined by schema",
+  "  --alphabetize              Sort object keys alphabetically",
+  "  --exclude-deprecated       Exclude deprecated types",
+  "  --root-types               Export schemas types at root level",
+  "  --root-types-no-schema-prefix",
+  '                             Do not add "Schema" prefix to types at the root level (should only be used with --root-types)',
+  "  --root-types-keep-casing   Keep casing of root types (should only be used with --root-types)",
+  "  --make-paths-enum          Generate ApiPaths enum for all paths",
+  "  --read-write-markers       Generate $Read/$Write markers for readOnly/writeOnly properties",
+  "  --no-lint                  Skip the Redocly lint (bundling errors still fail)",
+  "  --local-ref-root [dir]     Load local $ref files only from this directory",
+  "  --remote-ref-hosts [hosts] Load remote $ref documents only from these comma-separated hosts (empty: none)",
+  ""
+].join("\n");
+
+exports.HELP_TEXT = HELP_TEXT;
+//# sourceMappingURL=help-text.cjs.map

package/dist/cli/help-text.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-text.cjs","sources":["../../src/cli/help-text.ts"],"sourcesContent":["/** The text of `--help`, as in the original CLI; long lines are split only in this source. */\nexport const HELP_TEXT = [\n  \"Usage\",\n  \"  $ openapi-typesafe [input] [options]\",\n  \"\",\n  \"Options\",\n  \"  --help                     Display this\",\n  \"  --version                  Display the version\",\n  \"  --redocly [path], -c       Specify path to Redocly config (default: redocly.yaml)\",\n  \"  --output, -o               Specify output file (if not specified in redocly.yaml)\",\n  \"  --enum                     Export true TS enums instead of unions\",\n  \"  --enum-values              Export enum values as arrays\",\n  \"  --conditional-enums        Only generate true TS enums when enum\" +\n    \" metadata is available (default: false)\",\n  \"  --dedupe-enums             Dedupe enum types when `--enum=true` is set\",\n  \"  --check                    Check that the generated types are\" +\n    \" up-to-date. (default: false)\",\n  \"  --export-type, -t          Export top-level `type` instead of `interface`\",\n  \"  --immutable                Generate readonly types\",\n  \"  --additional-properties    Treat schema objects as if `additionalProperties: true` is set\",\n  \"  --empty-objects-unknown    Generate `unknown` instead of\" +\n    \" `Record<string, never>` for empty objects\",\n  \"  --default-non-nullable     Set to `false` to ignore default values\" +\n    \" when generating non-nullable types\",\n  \"  --properties-required-by-default\",\n  \"                             Treat schema objects as if `required` is\" +\n    \" set to all properties by default\",\n  \"  --array-length             Generate tuples using array minItems / maxItems\",\n  \"  --binary-as-blob           Type raw binary strings (format: binary,\" +\n    \" contentMediaType) as Blob\",\n  \"  --fix [names]              Turn on output fixes, comma-separated, or\" +\n    ' \"all\" (see docs/cli.md#fix)',\n  \"  --path-params-as-types     Convert paths to template literal types\",\n  \"  --generate-path-params     Generate path parameters for all paths where they are\" +\n    \" undefined by schema\",\n  \"  --alphabetize              Sort object keys alphabetically\",\n  \"  --exclude-deprecated       Exclude deprecated types\",\n  \"  --root-types               Export schemas types at root level\",\n  \"  --root-types-no-schema-prefix\",\n  '                             Do not add \"Schema\" prefix to types at' +\n    \" the root level (should only be used with --root-types)\",\n  \"  --root-types-keep-casing   Keep casing of root types (should only be\" +\n    \" used with --root-types)\",\n  \"  --make-paths-enum          Generate ApiPaths enum for all paths\",\n  \"  --read-write-markers       Generate $Read/$Write markers for\" +\n    \" readOnly/writeOnly properties\",\n  \"  --no-lint                  Skip the Redocly lint (bundling errors still fail)\",\n  \"  --local-ref-root [dir]     Load local $ref files only from this directory\",\n  \"  --remote-ref-hosts [hosts] Load remote $ref documents only from these\" +\n    \" comma-separated hosts (empty: none)\",\n  \"\",\n].join(\"\\n\");\n"],"names":[],"mappings":";;AACO,MAAM,SAAA,GAAY;AAAA,EACvB,OAAA;AAAA,EACA,wCAAA;AAAA,EACA,EAAA;AAAA,EACA,SAAA;AAAA,EACA,2CAAA;AAAA,EACA,kDAAA;AAAA,EACA,qFAAA;AAAA,EACA,qFAAA;AAAA,EACA,qEAAA;AAAA,EACA,2DAAA;AAAA,EACA,2GAAA;AAAA,EAEA,0EAAA;AAAA,EACA,8FAAA;AAAA,EAEA,6EAAA;AAAA,EACA,sDAAA;AAAA,EACA,6FAAA;AAAA,EACA,sGAAA;AAAA,EAEA,yGAAA;AAAA,EAEA,oCAAA;AAAA,EACA,wGAAA;AAAA,EAEA,8EAAA;AAAA,EACA,iGAAA;AAAA,EAEA,oGAAA;AAAA,EAEA,sEAAA;AAAA,EACA,wGAAA;AAAA,EAEA,8DAAA;AAAA,EACA,uDAAA;AAAA,EACA,iEAAA;AAAA,EACA,iCAAA;AAAA,EACA,4HAAA;AAAA,EAEA,gGAAA;AAAA,EAEA,mEAAA;AAAA,EACA,8FAAA;AAAA,EAEA,iFAAA;AAAA,EACA,6EAAA;AAAA,EACA,6GAAA;AAAA,EAEA;AACF,CAAA,CAAE,KAAK,IAAI;;"}

package/dist/cli/help-text.mjs

@@ -0,0 +1,42 @@
+const HELP_TEXT = [
+  "Usage",
+  "  $ openapi-typesafe [input] [options]",
+  "",
+  "Options",
+  "  --help                     Display this",
+  "  --version                  Display the version",
+  "  --redocly [path], -c       Specify path to Redocly config (default: redocly.yaml)",
+  "  --output, -o               Specify output file (if not specified in redocly.yaml)",
+  "  --enum                     Export true TS enums instead of unions",
+  "  --enum-values              Export enum values as arrays",
+  "  --conditional-enums        Only generate true TS enums when enum metadata is available (default: false)",
+  "  --dedupe-enums             Dedupe enum types when `--enum=true` is set",
+  "  --check                    Check that the generated types are up-to-date. (default: false)",
+  "  --export-type, -t          Export top-level `type` instead of `interface`",
+  "  --immutable                Generate readonly types",
+  "  --additional-properties    Treat schema objects as if `additionalProperties: true` is set",
+  "  --empty-objects-unknown    Generate `unknown` instead of `Record<string, never>` for empty objects",
+  "  --default-non-nullable     Set to `false` to ignore default values when generating non-nullable types",
+  "  --properties-required-by-default",
+  "                             Treat schema objects as if `required` is set to all properties by default",
+  "  --array-length             Generate tuples using array minItems / maxItems",
+  "  --binary-as-blob           Type raw binary strings (format: binary, contentMediaType) as Blob",
+  '  --fix [names]              Turn on output fixes, comma-separated, or "all" (see docs/cli.md#fix)',
+  "  --path-params-as-types     Convert paths to template literal types",
+  "  --generate-path-params     Generate path parameters for all paths where they are undefined by schema",
+  "  --alphabetize              Sort object keys alphabetically",
+  "  --exclude-deprecated       Exclude deprecated types",
+  "  --root-types               Export schemas types at root level",
+  "  --root-types-no-schema-prefix",
+  '                             Do not add "Schema" prefix to types at the root level (should only be used with --root-types)',
+  "  --root-types-keep-casing   Keep casing of root types (should only be used with --root-types)",
+  "  --make-paths-enum          Generate ApiPaths enum for all paths",
+  "  --read-write-markers       Generate $Read/$Write markers for readOnly/writeOnly properties",
+  "  --no-lint                  Skip the Redocly lint (bundling errors still fail)",
+  "  --local-ref-root [dir]     Load local $ref files only from this directory",
+  "  --remote-ref-hosts [hosts] Load remote $ref documents only from these comma-separated hosts (empty: none)",
+  ""
+].join("\n");
+
+export { HELP_TEXT };
+//# sourceMappingURL=help-text.mjs.map

package/dist/cli/help-text.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-text.mjs","sources":["../../src/cli/help-text.ts"],"sourcesContent":["/** The text of `--help`, as in the original CLI; long lines are split only in this source. */\nexport const HELP_TEXT = [\n  \"Usage\",\n  \"  $ openapi-typesafe [input] [options]\",\n  \"\",\n  \"Options\",\n  \"  --help                     Display this\",\n  \"  --version                  Display the version\",\n  \"  --redocly [path], -c       Specify path to Redocly config (default: redocly.yaml)\",\n  \"  --output, -o               Specify output file (if not specified in redocly.yaml)\",\n  \"  --enum                     Export true TS enums instead of unions\",\n  \"  --enum-values              Export enum values as arrays\",\n  \"  --conditional-enums        Only generate true TS enums when enum\" +\n    \" metadata is available (default: false)\",\n  \"  --dedupe-enums             Dedupe enum types when `--enum=true` is set\",\n  \"  --check                    Check that the generated types are\" +\n    \" up-to-date. (default: false)\",\n  \"  --export-type, -t          Export top-level `type` instead of `interface`\",\n  \"  --immutable                Generate readonly types\",\n  \"  --additional-properties    Treat schema objects as if `additionalProperties: true` is set\",\n  \"  --empty-objects-unknown    Generate `unknown` instead of\" +\n    \" `Record<string, never>` for empty objects\",\n  \"  --default-non-nullable     Set to `false` to ignore default values\" +\n    \" when generating non-nullable types\",\n  \"  --properties-required-by-default\",\n  \"                             Treat schema objects as if `required` is\" +\n    \" set to all properties by default\",\n  \"  --array-length             Generate tuples using array minItems / maxItems\",\n  \"  --binary-as-blob           Type raw binary strings (format: binary,\" +\n    \" contentMediaType) as Blob\",\n  \"  --fix [names]              Turn on output fixes, comma-separated, or\" +\n    ' \"all\" (see docs/cli.md#fix)',\n  \"  --path-params-as-types     Convert paths to template literal types\",\n  \"  --generate-path-params     Generate path parameters for all paths where they are\" +\n    \" undefined by schema\",\n  \"  --alphabetize              Sort object keys alphabetically\",\n  \"  --exclude-deprecated       Exclude deprecated types\",\n  \"  --root-types               Export schemas types at root level\",\n  \"  --root-types-no-schema-prefix\",\n  '                             Do not add \"Schema\" prefix to types at' +\n    \" the root level (should only be used with --root-types)\",\n  \"  --root-types-keep-casing   Keep casing of root types (should only be\" +\n    \" used with --root-types)\",\n  \"  --make-paths-enum          Generate ApiPaths enum for all paths\",\n  \"  --read-write-markers       Generate $Read/$Write markers for\" +\n    \" readOnly/writeOnly properties\",\n  \"  --no-lint                  Skip the Redocly lint (bundling errors still fail)\",\n  \"  --local-ref-root [dir]     Load local $ref files only from this directory\",\n  \"  --remote-ref-hosts [hosts] Load remote $ref documents only from these\" +\n    \" comma-separated hosts (empty: none)\",\n  \"\",\n].join(\"\\n\");\n"],"names":[],"mappings":"AACO,MAAM,SAAA,GAAY;AAAA,EACvB,OAAA;AAAA,EACA,wCAAA;AAAA,EACA,EAAA;AAAA,EACA,SAAA;AAAA,EACA,2CAAA;AAAA,EACA,kDAAA;AAAA,EACA,qFAAA;AAAA,EACA,qFAAA;AAAA,EACA,qEAAA;AAAA,EACA,2DAAA;AAAA,EACA,2GAAA;AAAA,EAEA,0EAAA;AAAA,EACA,8FAAA;AAAA,EAEA,6EAAA;AAAA,EACA,sDAAA;AAAA,EACA,6FAAA;AAAA,EACA,sGAAA;AAAA,EAEA,yGAAA;AAAA,EAEA,oCAAA;AAAA,EACA,wGAAA;AAAA,EAEA,8EAAA;AAAA,EACA,iGAAA;AAAA,EAEA,oGAAA;AAAA,EAEA,sEAAA;AAAA,EACA,wGAAA;AAAA,EAEA,8DAAA;AAAA,EACA,uDAAA;AAAA,EACA,iEAAA;AAAA,EACA,iCAAA;AAAA,EACA,4HAAA;AAAA,EAEA,gGAAA;AAAA,EAEA,mEAAA;AAAA,EACA,8FAAA;AAAA,EAEA,iFAAA;AAAA,EACA,6EAAA;AAAA,EACA,6GAAA;AAAA,EAEA;AACF,CAAA,CAAE,KAAK,IAAI;;"}

package/dist/cli/main.cjs

@@ -0,0 +1,67 @@
+'use strict';
+
+const fs = require('node:fs');
+const node_tty = require('node:tty');
+const node_url = require('node:url');
+const colors = require('ansi-colors');
+const nodeFileSystem = require('../adapters/node-file-system/node-file-system.cjs');
+const redoclyConfigSource = require('../adapters/redocly-loader/redocly-config-source.cjs');
+const astToString = require('../api/ast-to-string.cjs');
+const commentHeader = require('../api/comment-header.cjs');
+const defaultPorts = require('../api/default-ports.cjs');
+const openapiTs = require('../api/openapi-ts.cjs');
+const runCli = require('./run-cli.cjs');
+
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
+
+const fs__default = /*#__PURE__*/_interopDefaultCompat(fs);
+const colors__default = /*#__PURE__*/_interopDefaultCompat(colors);
+
+const PACKAGE_JSON = new URL("../../package.json", (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli/main.cjs', document.baseURI).href)));
+function readVersion() {
+  const packageJson = JSON.parse(fs__default.readFileSync(PACKAGE_JSON, "utf8"));
+  return packageJson.version;
+}
+function terminalStyle() {
+  const palette = colors__default.create();
+  palette.enabled = defaultPorts.terminalSupportsColor();
+  return {
+    bold: (text) => palette.bold(text),
+    green: (text) => palette.green(text),
+    dim: (text) => palette.dim(text)
+  };
+}
+const STDIN_DESCRIPTOR = 0;
+const generateTypes = async (source, options) => `${commentHeader.COMMENT_HEADER}${astToString.astToString(await openapiTs.default(source, options))}`;
+function terminalConsole() {
+  return {
+    // biome-ignore lint/suspicious/noConsole: the CLI's own output lines
+    info: (text) => console.info(text),
+    // biome-ignore lint/suspicious/noConsole: the CLI's own notices
+    notice: (text) => console.warn(text)
+  };
+}
+function processDependencies() {
+  const cwd = process.cwd();
+  return {
+    cwd: node_url.pathToFileURL(`${cwd}/`),
+    version: readVersion(),
+    logger: defaultPorts.defaultLogger(false),
+    console: terminalConsole(),
+    writeStdout: (text) => process.stdout.write(text),
+    stdin: () => process.stdin,
+    // `isatty` reads the descriptor without opening `process.stdin`, which would keep the
+    // process alive.
+    isStdinTerminal: () => node_tty.isatty(STDIN_DESCRIPTOR),
+    files: nodeFileSystem.createNodeFileSystem(),
+    redoclyConfigs: redoclyConfigSource.createRedoclyConfigSource(cwd),
+    generate: generateTypes,
+    now: defaultPorts.monotonicNow,
+    style: terminalStyle()
+  };
+}
+runCli.runCli(process.argv.slice(2), processDependencies()).then((exitCode) => {
+  process.exitCode = exitCode;
+});
+//# sourceMappingURL=main.cjs.map

package/dist/cli/main.cjs.map

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

package/dist/cli/main.d.cts

@@ -0,0 +1,2 @@
+
+export { };

package/dist/cli/main.d.mts

@@ -0,0 +1,2 @@
+
+export { };

package/dist/cli/main.d.ts

@@ -0,0 +1,2 @@
+
+export { };