openapi-typesafe 1.0.0-rc.0 → 1.0.0-rc.2

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

@@ -1 +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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"}
+{"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 { WARNING_CODES, warningText } from \"../domain/warnings.js\";\nimport type { SchemaSource } from \"../types.js\";\nimport { ineffectiveFlagNotices, parseCliArguments } from \"./cli-arguments.js\";\nimport type { CliDependencies } from \"./cli-dependencies.js\";\nimport { cliError, describeCliFailure, EXIT_CODES, type ExitCode } from \"./cli-errors.js\";\nimport { type CliRun, emitOutput, resolveLocationUrl } from \"./cli-output.js\";\nimport { MULTIPLE_SCHEMAS_DOCS_URL } from \"./docs-links.js\";\nimport { fixOption } from \"./fix-option.js\";\nimport { HELP_TEXT } from \"./help-text.js\";\nimport { generateRedoclyApis, hasRedoclyApis } from \"./redocly-apis.js\";\nimport { refLimitOptions } from \"./ref-limits.js\";\n\n/**\n * The CLI's use case: parse the arguments, then generate the APIs of the Redocly config, one\n * schema file or URL, or stdin. It has no process access of its own; `main.ts` wires it (ADR-012).\n */\n\nasync function loadRedoclyConfig(run: CliRun): Promise<RedoclyConfig> {\n  const { redoclyConfigs } = run.deps;\n  const explicitPath = run.args.redocly;\n  const configPath = redoclyConfigs.find(explicitPath);\n  if (explicitPath && !configPath) {\n    throw cliError(\"CLI_CONFIG_NOT_FOUND\", `Redocly config not found at: ${explicitPath}`);\n  }\n  return configPath ? redoclyConfigs.load(configPath) : redoclyConfigs.createDefault();\n}\n\n/** The schema's URL, or stdin when no path or URL is given and something is piped in. */\nfunction schemaSource(run: CliRun): SchemaSource {\n  const { input } = run.args;\n  if (input) {\n    return resolveLocationUrl(input, run.deps.cwd);\n  }\n  if (run.deps.isStdinTerminal()) {\n    throw cliError(\n      \"CLI_INPUT_MISSING\",\n      \"No schema given: pass a schema path or URL, pipe a schema into stdin, or define `apis` \" +\n        \"in redocly.yaml. See --help.\",\n    );\n  }\n  return run.deps.stdin();\n}\n\n/** 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 = schemaSource(run);\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 = resolveLocationUrl(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      warningText(\n        \"APIs are specified both in Redocly Config and CLI argument. Only using Redocly config.\",\n        WARNING_CODES.CLI_INPUT_IGNORED,\n      ),\n    );\n  }\n  return generateRedoclyApis(run, redocly);\n}\n\n/** Run the command; the failures it returns did not stop the other outputs. */\nasync function runCommand(argv: readonly string[], deps: CliDependencies): Promise<unknown[]> {\n  const startedAt = deps.now();\n  for (const notice of ineffectiveFlagNotices(argv)) {\n    deps.console.notice(notice);\n  }\n  const args = parseCliArguments(argv);\n  for (const flag of args.unknownFlags) {\n    deps.console.notice(`Unknown flag ${flag} is ignored (see --help)`);\n  }\n  if (args.isHelp || args.isVersion) {\n    deps.console.info(args.isHelp ? HELP_TEXT : `v${deps.version}`);\n    return [];\n  }\n  if (args.output) {\n    deps.console.info(`✨ ${deps.style.bold(`openapi-typesafe ${deps.version}`)}`);\n  }\n  return generate({ deps, args, startedAt });\n}\n\n/** Print one line per failure; the exit code is the first failure's (ADR-011). */\nfunction reportFailures(failures: readonly unknown[], logger: Logger): ExitCode {\n  const reports = failures.map(describeCliFailure);\n  for (const report of reports) {\n    logger.error(report.message);\n  }\n  return reports[0]?.exitCode ?? EXIT_CODES.SUCCESS;\n}\n\n/** Run the CLI with the arguments after `node cli.js`, and return the process exit code. */\nexport async function runCli(argv: readonly string[], deps: CliDependencies): Promise<ExitCode> {\n  let failures: unknown[];\n  try {\n    failures = await runCommand(argv, deps);\n  } catch (thrown) {\n    failures = [thrown];\n  }\n  return reportFailures(failures, deps.logger);\n}\n"],"names":[],"mappings":"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"}

package/dist/domain/errors.cjs

@@ -1,5 +1,7 @@
 'use strict';
 
+const urlCredentials = require('./url-credentials.cjs');
+
 const ERROR_CODES = {
   SCHEMA_SOURCE_EMPTY: "SCHEMA_SOURCE_EMPTY",
   SCHEMA_SOURCE_INVALID: "SCHEMA_SOURCE_INVALID",
@@ -20,8 +22,10 @@ const ERROR_CODES = {
   CLI_FLAG_REMOVED: "CLI_FLAG_REMOVED",
   CLI_GLOB_UNSUPPORTED: "CLI_GLOB_UNSUPPORTED",
   CLI_CONFIG_NOT_FOUND: "CLI_CONFIG_NOT_FOUND",
+  CLI_CONFIG_INVALID: "CLI_CONFIG_INVALID",
   CLI_CONFIG_OUTPUT_MISSING: "CLI_CONFIG_OUTPUT_MISSING",
   CLI_CHECK_OUTPUT_MISSING: "CLI_CHECK_OUTPUT_MISSING",
+  CLI_INPUT_MISSING: "CLI_INPUT_MISSING",
   OUTPUT_STALE: "OUTPUT_STALE",
   OUTPUT_READ_FAILED: "OUTPUT_READ_FAILED",
   OUTPUT_WRITE_FAILED: "OUTPUT_WRITE_FAILED"
@@ -30,7 +34,8 @@ class OpenAPITypesafeError extends Error {
   code;
   details;
   constructor(init) {
-    super(init.message, init.cause === void 0 ? void 0 : { cause: init.cause });
+    const message = urlCredentials.redactUrlCredentials(init.message);
+    super(message, init.cause === void 0 ? void 0 : { cause: init.cause });
     this.name = "OpenAPITypesafeError";
     this.code = init.code;
     this.details = init.details ?? {};

package/dist/domain/errors.cjs.map

@@ -1 +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;;;;"}
+{"version":3,"file":"errors.cjs","sources":["../../src/domain/errors.ts"],"sourcesContent":["import { redactUrlCredentials } from \"./url-credentials.js\";\n\n/**\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_INVALID: \"CLI_CONFIG_INVALID\",\n  CLI_CONFIG_OUTPUT_MISSING: \"CLI_CONFIG_OUTPUT_MISSING\",\n  CLI_CHECK_OUTPUT_MISSING: \"CLI_CHECK_OUTPUT_MISSING\",\n  CLI_INPUT_MISSING: \"CLI_INPUT_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/**\n * The base of every expected failure; check `code`, not the class or the message. The message\n * never shows the user info of a URL (`url-credentials.ts`).\n */\nexport class OpenAPITypesafeError extends Error {\n  readonly code: ErrorCode;\n  readonly details: ErrorDetails;\n\n  constructor(init: OpenAPITypesafeErrorInit) {\n    const message = redactUrlCredentials(init.message);\n    super(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":["redactUrlCredentials"],"mappings":";;;;AAUO,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,kBAAA,EAAoB,oBAAA;AAAA,EACpB,yBAAA,EAA2B,2BAAA;AAAA,EAC3B,wBAAA,EAA0B,0BAAA;AAAA,EAC1B,iBAAA,EAAmB,mBAAA;AAAA,EACnB,YAAA,EAAc,cAAA;AAAA,EACd,kBAAA,EAAoB,oBAAA;AAAA,EACpB,mBAAA,EAAqB;AACvB;AAmBO,MAAM,6BAA6B,KAAA,CAAM;AAAA,EACrC,IAAA;AAAA,EACA,OAAA;AAAA,EAET,YAAY,IAAA,EAAgC;AAC1C,IAAA,MAAM,OAAA,GAAUA,mCAAA,CAAqB,IAAA,CAAK,OAAO,CAAA;AACjD,IAAA,KAAA,CAAM,OAAA,EAAS,KAAK,KAAA,KAAU,MAAA,GAAY,SAAY,EAAE,KAAA,EAAO,IAAA,CAAK,KAAA,EAAO,CAAA;AAC3E,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

@@ -1,3 +1,5 @@
+import { redactUrlCredentials } from './url-credentials.mjs';
+
 const ERROR_CODES = {
   SCHEMA_SOURCE_EMPTY: "SCHEMA_SOURCE_EMPTY",
   SCHEMA_SOURCE_INVALID: "SCHEMA_SOURCE_INVALID",
@@ -18,8 +20,10 @@ const ERROR_CODES = {
   CLI_FLAG_REMOVED: "CLI_FLAG_REMOVED",
   CLI_GLOB_UNSUPPORTED: "CLI_GLOB_UNSUPPORTED",
   CLI_CONFIG_NOT_FOUND: "CLI_CONFIG_NOT_FOUND",
+  CLI_CONFIG_INVALID: "CLI_CONFIG_INVALID",
   CLI_CONFIG_OUTPUT_MISSING: "CLI_CONFIG_OUTPUT_MISSING",
   CLI_CHECK_OUTPUT_MISSING: "CLI_CHECK_OUTPUT_MISSING",
+  CLI_INPUT_MISSING: "CLI_INPUT_MISSING",
   OUTPUT_STALE: "OUTPUT_STALE",
   OUTPUT_READ_FAILED: "OUTPUT_READ_FAILED",
   OUTPUT_WRITE_FAILED: "OUTPUT_WRITE_FAILED"
@@ -28,7 +32,8 @@ class OpenAPITypesafeError extends Error {
   code;
   details;
   constructor(init) {
-    super(init.message, init.cause === void 0 ? void 0 : { cause: init.cause });
+    const message = redactUrlCredentials(init.message);
+    super(message, init.cause === void 0 ? void 0 : { cause: init.cause });
     this.name = "OpenAPITypesafeError";
     this.code = init.code;
     this.details = init.details ?? {};

package/dist/domain/errors.mjs.map

@@ -1 +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;;"}
+{"version":3,"file":"errors.mjs","sources":["../../src/domain/errors.ts"],"sourcesContent":["import { redactUrlCredentials } from \"./url-credentials.js\";\n\n/**\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_INVALID: \"CLI_CONFIG_INVALID\",\n  CLI_CONFIG_OUTPUT_MISSING: \"CLI_CONFIG_OUTPUT_MISSING\",\n  CLI_CHECK_OUTPUT_MISSING: \"CLI_CHECK_OUTPUT_MISSING\",\n  CLI_INPUT_MISSING: \"CLI_INPUT_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/**\n * The base of every expected failure; check `code`, not the class or the message. The message\n * never shows the user info of a URL (`url-credentials.ts`).\n */\nexport class OpenAPITypesafeError extends Error {\n  readonly code: ErrorCode;\n  readonly details: ErrorDetails;\n\n  constructor(init: OpenAPITypesafeErrorInit) {\n    const message = redactUrlCredentials(init.message);\n    super(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":";;AAUO,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,kBAAA,EAAoB,oBAAA;AAAA,EACpB,yBAAA,EAA2B,2BAAA;AAAA,EAC3B,wBAAA,EAA0B,0BAAA;AAAA,EAC1B,iBAAA,EAAmB,mBAAA;AAAA,EACnB,YAAA,EAAc,cAAA;AAAA,EACd,kBAAA,EAAoB,oBAAA;AAAA,EACpB,mBAAA,EAAqB;AACvB;AAmBO,MAAM,6BAA6B,KAAA,CAAM;AAAA,EACrC,IAAA;AAAA,EACA,OAAA;AAAA,EAET,YAAY,IAAA,EAAgC;AAC1C,IAAA,MAAM,OAAA,GAAU,oBAAA,CAAqB,IAAA,CAAK,OAAO,CAAA;AACjD,IAAA,KAAA,CAAM,OAAA,EAAS,KAAK,KAAA,KAAU,MAAA,GAAY,SAAY,EAAE,KAAA,EAAO,IAAA,CAAK,KAAA,EAAO,CAAA;AAC3E,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

@@ -3,6 +3,7 @@
 function irKeyword(keyword) {
   return { kind: "keyword", keyword };
 }
+const DEFAULT_STRING_ENCODING = "json";
 function irString(value, encoding) {
   return { kind: "stringLiteral", value, encoding };
 }
@@ -25,7 +26,10 @@ function irTuple(elements) {
   return { kind: "tuple", elements };
 }
 function irTupleElement(type, isRest = false) {
-  return { type, isRest };
+  return { type, isRest, isOptional: false };
+}
+function irOptionalTupleElement(type) {
+  return { type, isRest: false, isOptional: true };
 }
 function irUnion(types) {
   return { kind: "union", types };
@@ -69,6 +73,7 @@ function irRecord(key, value) {
   return irReference("Record", [key, value]);
 }
 
+exports.DEFAULT_STRING_ENCODING = DEFAULT_STRING_ENCODING;
 exports.irArray = irArray;
 exports.irBoolean = irBoolean;
 exports.irIndexedAccess = irIndexedAccess;
@@ -76,6 +81,7 @@ exports.irIntersection = irIntersection;
 exports.irKeyword = irKeyword;
 exports.irNumber = irNumber;
 exports.irObject = irObject;
+exports.irOptionalTupleElement = irOptionalTupleElement;
 exports.irProperty = irProperty;
 exports.irRaw = irRaw;
 exports.irReadonly = irReadonly;

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

@@ -1 +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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"}
+{"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\n/** The encoding of a string literal that does not name one. */\nexport const DEFAULT_STRING_ENCODING: IrStringEncoding = \"json\";\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, isOptional: false };\n}\n\n/** `T?`: an element the tuple may end before. */\nexport function irOptionalTupleElement(type: IrType): IrTupleElement {\n  return { type, isRest: false, isOptional: true };\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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"}

package/dist/domain/ir/constructors.mjs

@@ -1,6 +1,7 @@
 function irKeyword(keyword) {
   return { kind: "keyword", keyword };
 }
+const DEFAULT_STRING_ENCODING = "json";
 function irString(value, encoding) {
   return { kind: "stringLiteral", value, encoding };
 }
@@ -23,7 +24,10 @@ function irTuple(elements) {
   return { kind: "tuple", elements };
 }
 function irTupleElement(type, isRest = false) {
-  return { type, isRest };
+  return { type, isRest, isOptional: false };
+}
+function irOptionalTupleElement(type) {
+  return { type, isRest: false, isOptional: true };
 }
 function irUnion(types) {
   return { kind: "union", types };
@@ -67,5 +71,5 @@ function irRecord(key, value) {
   return irReference("Record", [key, value]);
 }
 
-export { irArray, irBoolean, irIndexedAccess, irIntersection, irKeyword, irNumber, irObject, irProperty, irRaw, irReadonly, irRecord, irReference, irString, irStringIndexSignature, irTuple, irTupleElement, irUnion };
+export { DEFAULT_STRING_ENCODING, irArray, irBoolean, irIndexedAccess, irIntersection, irKeyword, irNumber, irObject, irOptionalTupleElement, irProperty, irRaw, irReadonly, irRecord, irReference, irString, irStringIndexSignature, irTuple, irTupleElement, irUnion };
 //# sourceMappingURL=constructors.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"constructors.mjs","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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"}
+{"version":3,"file":"constructors.mjs","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\n/** The encoding of a string literal that does not name one. */\nexport const DEFAULT_STRING_ENCODING: IrStringEncoding = \"json\";\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, isOptional: false };\n}\n\n/** `T?`: an element the tuple may end before. */\nexport function irOptionalTupleElement(type: IrType): IrTupleElement {\n  return { type, isRest: false, isOptional: true };\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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"}

package/dist/domain/openapi/admitted-values.cjs

@@ -0,0 +1,75 @@
+'use strict';
+
+const jsonPointer = require('./json-pointer.cjs');
+
+const MAX_DEPTH = 16;
+const LOCAL_REF_PREFIX = "#/";
+function isObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function resolveLocalRef(document, ref) {
+  if (!ref.startsWith(LOCAL_REF_PREFIX)) {
+    return void 0;
+  }
+  let node = document;
+  for (const segment of jsonPointer.parseRefPointer(ref)) {
+    node = isObject(node) || Array.isArray(node) ? node[segment] : void 0;
+  }
+  return node;
+}
+function intersect(left, right) {
+  if (left === null || right === null) {
+    return left ?? right;
+  }
+  return new Set([...left].filter((value) => right.has(value)));
+}
+function unite(sets) {
+  return sets.some((set) => set === null) ? null : new Set(sets.flatMap((set) => [...set ?? []]));
+}
+function isAdmittedValue(value) {
+  return value === null || ["string", "number", "boolean"].includes(typeof value);
+}
+function follow(node, walk) {
+  if (!isObject(node) || typeof node.$ref !== "string") {
+    return node;
+  }
+  return walk.skipped.has(node.$ref) ? void 0 : resolveLocalRef(walk.document, node.$ref);
+}
+function members(node, keyword) {
+  const list = node[keyword];
+  return Array.isArray(list) ? list : [];
+}
+function ownValues(node) {
+  const listed = Array.isArray(node.enum) ? node.enum.filter(isAdmittedValue) : null;
+  const constant = "const" in node && isAdmittedValue(node.const) ? /* @__PURE__ */ new Set([node.const]) : null;
+  return intersect(listed === null ? null : new Set(listed), constant);
+}
+function schemaValues(schema, walk) {
+  const node = follow(schema, walk);
+  if (!isObject(node) || walk.depth > MAX_DEPTH) {
+    return null;
+  }
+  const next = { ...walk, depth: walk.depth + 1 };
+  const parts = members(node, "allOf").map((part) => schemaValues(part, next));
+  const variants = [...members(node, "anyOf"), ...members(node, "oneOf")];
+  const union = variants.length === 0 ? null : unite(variants.map((v) => schemaValues(v, next)));
+  return [...parts, union].reduce(intersect, ownValues(node));
+}
+function propertyValues(schema, key, walk) {
+  const node = follow(schema, walk);
+  if (!isObject(node) || walk.depth > MAX_DEPTH) {
+    return null;
+  }
+  const next = { ...walk, depth: walk.depth + 1 };
+  const properties = isObject(node.properties) ? node.properties : {};
+  const own = Object.hasOwn(properties, key) ? schemaValues(properties[key], next) : null;
+  const parts = members(node, "allOf").map((part) => propertyValues(part, key, next));
+  return parts.reduce(intersect, own);
+}
+function admittedPropertyValues(schema, key, document, skipped = /* @__PURE__ */ new Set()) {
+  return propertyValues(schema, key, { document, depth: 0, skipped });
+}
+
+exports.admittedPropertyValues = admittedPropertyValues;
+exports.resolveLocalRef = resolveLocalRef;
+//# sourceMappingURL=admitted-values.cjs.map

package/dist/domain/openapi/admitted-values.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"admitted-values.cjs","sources":["../../../src/domain/openapi/admitted-values.ts"],"sourcesContent":["import { parseRefPointer } from \"./json-pointer.js\";\n\n/**\n * The values a schema admits when it admits only finitely many (`enum`, `const`, and `allOf` /\n * `anyOf` / `oneOf` of those), read from the document. Null means \"any value\" as far as this\n * reading goes: a schema of any other shape, or a `$ref` it cannot follow, is never assumed to\n * exclude a value.\n */\n\nexport type AdmittedValue = string | number | boolean | null;\n/** A finite set of values, or null for every value. */\nexport type AdmittedValues = ReadonlySet<AdmittedValue> | null;\n\ntype JsonObject = Readonly<Record<string, unknown>>;\n\n/** How deep `$ref`s and compositions are followed; deeper schemas admit every value. */\nconst MAX_DEPTH = 16;\nconst LOCAL_REF_PREFIX = \"#/\";\n\nfunction isObject(value: unknown): value is JsonObject {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** The node at a local `$ref` (`#/...`) of the document, or undefined. */\nexport function resolveLocalRef(document: unknown, ref: string): unknown {\n  if (!ref.startsWith(LOCAL_REF_PREFIX)) {\n    return undefined;\n  }\n  let node: unknown = document;\n  for (const segment of parseRefPointer(ref)) {\n    node = isObject(node) || Array.isArray(node) ? (node as JsonObject)[segment] : undefined;\n  }\n  return node;\n}\n\nfunction intersect(left: AdmittedValues, right: AdmittedValues): AdmittedValues {\n  if (left === null || right === null) {\n    return left ?? right;\n  }\n  return new Set([...left].filter((value) => right.has(value)));\n}\n\nfunction unite(sets: readonly AdmittedValues[]): AdmittedValues {\n  return sets.some((set) => set === null) ? null : new Set(sets.flatMap((set) => [...(set ?? [])]));\n}\n\nfunction isAdmittedValue(value: unknown): value is AdmittedValue {\n  return value === null || [\"string\", \"number\", \"boolean\"].includes(typeof value);\n}\n\ninterface Walk {\n  readonly document: unknown;\n  readonly depth: number;\n  /** `$ref`s whose targets are left out: they add nothing to the generated type here. */\n  readonly skipped: ReadonlySet<string>;\n}\n\nfunction follow(node: unknown, walk: Walk): unknown {\n  if (!isObject(node) || typeof node.$ref !== \"string\") {\n    return node;\n  }\n  return walk.skipped.has(node.$ref) ? undefined : resolveLocalRef(walk.document, node.$ref);\n}\n\nfunction members(node: JsonObject, keyword: string): readonly unknown[] {\n  const list = node[keyword];\n  return Array.isArray(list) ? list : [];\n}\n\n/** `enum` and `const` of the schema itself, before its compositions. */\nfunction ownValues(node: JsonObject): AdmittedValues {\n  const listed = Array.isArray(node.enum) ? node.enum.filter(isAdmittedValue) : null;\n  const constant = \"const\" in node && isAdmittedValue(node.const) ? new Set([node.const]) : null;\n  return intersect(listed === null ? null : new Set(listed), constant);\n}\n\nfunction schemaValues(schema: unknown, walk: Walk): AdmittedValues {\n  const node = follow(schema, walk);\n  if (!isObject(node) || walk.depth > MAX_DEPTH) {\n    return null;\n  }\n  const next = { ...walk, depth: walk.depth + 1 };\n  const parts = members(node, \"allOf\").map((part) => schemaValues(part, next));\n  const variants = [...members(node, \"anyOf\"), ...members(node, \"oneOf\")];\n  const union = variants.length === 0 ? null : unite(variants.map((v) => schemaValues(v, next)));\n  return [...parts, union].reduce<AdmittedValues>(intersect, ownValues(node));\n}\n\nfunction propertyValues(schema: unknown, key: string, walk: Walk): AdmittedValues {\n  const node = follow(schema, walk);\n  if (!isObject(node) || walk.depth > MAX_DEPTH) {\n    return null;\n  }\n  const next = { ...walk, depth: walk.depth + 1 };\n  const properties = isObject(node.properties) ? node.properties : {};\n  const own = Object.hasOwn(properties, key) ? schemaValues(properties[key], next) : null;\n  const parts = members(node, \"allOf\").map((part) => propertyValues(part, key, next));\n  return parts.reduce<AdmittedValues>(intersect, own);\n}\n\n/**\n * The values property `key` of an object schema admits: the intersection over the schema's own\n * `properties` and its `allOf` parts (followed through `$ref`s, except `skipped` ones); null for\n * every value.\n */\nexport function admittedPropertyValues(\n  schema: unknown,\n  key: string,\n  document: unknown,\n  skipped: ReadonlySet<string> = new Set(),\n): AdmittedValues {\n  return propertyValues(schema, key, { document, depth: 0, skipped });\n}\n"],"names":["parseRefPointer"],"mappings":";;;;AAgBA,MAAM,SAAA,GAAY,EAAA;AAClB,MAAM,gBAAA,GAAmB,IAAA;AAEzB,SAAS,SAAS,KAAA,EAAqC;AACrD,EAAA,OAAO,OAAO,UAAU,QAAA,IAAY,KAAA,KAAU,QAAQ,CAAC,KAAA,CAAM,QAAQ,KAAK,CAAA;AAC5E;AAGO,SAAS,eAAA,CAAgB,UAAmB,GAAA,EAAsB;AACvE,EAAA,IAAI,CAAC,GAAA,CAAI,UAAA,CAAW,gBAAgB,CAAA,EAAG;AACrC,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,IAAI,IAAA,GAAgB,QAAA;AACpB,EAAA,KAAA,MAAW,OAAA,IAAWA,2BAAA,CAAgB,GAAG,CAAA,EAAG;AAC1C,IAAA,IAAA,GAAO,QAAA,CAAS,IAAI,CAAA,IAAK,KAAA,CAAM,QAAQ,IAAI,CAAA,GAAK,IAAA,CAAoB,OAAO,CAAA,GAAI,MAAA;AAAA,EACjF;AACA,EAAA,OAAO,IAAA;AACT;AAEA,SAAS,SAAA,CAAU,MAAsB,KAAA,EAAuC;AAC9E,EAAA,IAAI,IAAA,KAAS,IAAA,IAAQ,KAAA,KAAU,IAAA,EAAM;AACnC,IAAA,OAAO,IAAA,IAAQ,KAAA;AAAA,EACjB;AACA,EAAA,OAAO,IAAI,GAAA,CAAI,CAAC,GAAG,IAAI,CAAA,CAAE,MAAA,CAAO,CAAC,KAAA,KAAU,KAAA,CAAM,GAAA,CAAI,KAAK,CAAC,CAAC,CAAA;AAC9D;AAEA,SAAS,MAAM,IAAA,EAAiD;AAC9D,EAAA,OAAO,IAAA,CAAK,KAAK,CAAC,GAAA,KAAQ,QAAQ,IAAI,CAAA,GAAI,OAAO,IAAI,GAAA,CAAI,KAAK,OAAA,CAAQ,CAAC,QAAQ,CAAC,GAAI,OAAO,EAAG,CAAC,CAAC,CAAA;AAClG;AAEA,SAAS,gBAAgB,KAAA,EAAwC;AAC/D,EAAA,OAAO,KAAA,KAAU,QAAQ,CAAC,QAAA,EAAU,UAAU,SAAS,CAAA,CAAE,QAAA,CAAS,OAAO,KAAK,CAAA;AAChF;AASA,SAAS,MAAA,CAAO,MAAe,IAAA,EAAqB;AAClD,EAAA,IAAI,CAAC,QAAA,CAAS,IAAI,KAAK,OAAO,IAAA,CAAK,SAAS,QAAA,EAAU;AACpD,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,IAAA,CAAK,IAAI,CAAA,GAAI,MAAA,GAAY,eAAA,CAAgB,IAAA,CAAK,QAAA,EAAU,IAAA,CAAK,IAAI,CAAA;AAC3F;AAEA,SAAS,OAAA,CAAQ,MAAkB,OAAA,EAAqC;AACtE,EAAA,MAAM,IAAA,GAAO,KAAK,OAAO,CAAA;AACzB,EAAA,OAAO,KAAA,CAAM,OAAA,CAAQ,IAAI,CAAA,GAAI,OAAO,EAAC;AACvC;AAGA,SAAS,UAAU,IAAA,EAAkC;AACnD,EAAA,MAAM,MAAA,GAAS,KAAA,CAAM,OAAA,CAAQ,IAAA,CAAK,IAAI,IAAI,IAAA,CAAK,IAAA,CAAK,MAAA,CAAO,eAAe,CAAA,GAAI,IAAA;AAC9E,EAAA,MAAM,QAAA,GAAW,OAAA,IAAW,IAAA,IAAQ,eAAA,CAAgB,IAAA,CAAK,KAAK,CAAA,mBAAI,IAAI,GAAA,CAAI,CAAC,IAAA,CAAK,KAAK,CAAC,CAAA,GAAI,IAAA;AAC1F,EAAA,OAAO,SAAA,CAAU,WAAW,IAAA,GAAO,IAAA,GAAO,IAAI,GAAA,CAAI,MAAM,GAAG,QAAQ,CAAA;AACrE;AAEA,SAAS,YAAA,CAAa,QAAiB,IAAA,EAA4B;AACjE,EAAA,MAAM,IAAA,GAAO,MAAA,CAAO,MAAA,EAAQ,IAAI,CAAA;AAChC,EAAA,IAAI,CAAC,QAAA,CAAS,IAAI,CAAA,IAAK,IAAA,CAAK,QAAQ,SAAA,EAAW;AAC7C,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,MAAM,OAAO,EAAE,GAAG,MAAM,KAAA,EAAO,IAAA,CAAK,QAAQ,CAAA,EAAE;AAC9C,EAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,IAAA,EAAM,OAAO,CAAA,CAAE,GAAA,CAAI,CAAC,IAAA,KAAS,YAAA,CAAa,IAAA,EAAM,IAAI,CAAC,CAAA;AAC3E,EAAA,MAAM,QAAA,GAAW,CAAC,GAAG,OAAA,CAAQ,IAAA,EAAM,OAAO,CAAA,EAAG,GAAG,OAAA,CAAQ,IAAA,EAAM,OAAO,CAAC,CAAA;AACtE,EAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,MAAA,KAAW,CAAA,GAAI,OAAO,KAAA,CAAM,QAAA,CAAS,GAAA,CAAI,CAAC,CAAA,KAAM,YAAA,CAAa,CAAA,EAAG,IAAI,CAAC,CAAC,CAAA;AAC7F,EAAA,OAAO,CAAC,GAAG,KAAA,EAAO,KAAK,EAAE,MAAA,CAAuB,SAAA,EAAW,SAAA,CAAU,IAAI,CAAC,CAAA;AAC5E;AAEA,SAAS,cAAA,CAAe,MAAA,EAAiB,GAAA,EAAa,IAAA,EAA4B;AAChF,EAAA,MAAM,IAAA,GAAO,MAAA,CAAO,MAAA,EAAQ,IAAI,CAAA;AAChC,EAAA,IAAI,CAAC,QAAA,CAAS,IAAI,CAAA,IAAK,IAAA,CAAK,QAAQ,SAAA,EAAW;AAC7C,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,MAAM,OAAO,EAAE,GAAG,MAAM,KAAA,EAAO,IAAA,CAAK,QAAQ,CAAA,EAAE;AAC9C,EAAA,MAAM,aAAa,QAAA,CAAS,IAAA,CAAK,UAAU,CAAA,GAAI,IAAA,CAAK,aAAa,EAAC;AAClE,EAAA,MAAM,GAAA,GAAM,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,GAAG,CAAA,GAAI,YAAA,CAAa,UAAA,CAAW,GAAG,CAAA,EAAG,IAAI,CAAA,GAAI,IAAA;AACnF,EAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,IAAA,EAAM,OAAO,CAAA,CAAE,GAAA,CAAI,CAAC,IAAA,KAAS,cAAA,CAAe,IAAA,EAAM,GAAA,EAAK,IAAI,CAAC,CAAA;AAClF,EAAA,OAAO,KAAA,CAAM,MAAA,CAAuB,SAAA,EAAW,GAAG,CAAA;AACpD;AAOO,SAAS,uBACd,MAAA,EACA,GAAA,EACA,UACA,OAAA,mBAA+B,IAAI,KAAI,EACvB;AAChB,EAAA,OAAO,cAAA,CAAe,QAAQ,GAAA,EAAK,EAAE,UAAU,KAAA,EAAO,CAAA,EAAG,SAAS,CAAA;AACpE;;;"}

package/dist/domain/openapi/admitted-values.mjs

@@ -0,0 +1,72 @@
+import { parseRefPointer } from './json-pointer.mjs';
+
+const MAX_DEPTH = 16;
+const LOCAL_REF_PREFIX = "#/";
+function isObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function resolveLocalRef(document, ref) {
+  if (!ref.startsWith(LOCAL_REF_PREFIX)) {
+    return void 0;
+  }
+  let node = document;
+  for (const segment of parseRefPointer(ref)) {
+    node = isObject(node) || Array.isArray(node) ? node[segment] : void 0;
+  }
+  return node;
+}
+function intersect(left, right) {
+  if (left === null || right === null) {
+    return left ?? right;
+  }
+  return new Set([...left].filter((value) => right.has(value)));
+}
+function unite(sets) {
+  return sets.some((set) => set === null) ? null : new Set(sets.flatMap((set) => [...set ?? []]));
+}
+function isAdmittedValue(value) {
+  return value === null || ["string", "number", "boolean"].includes(typeof value);
+}
+function follow(node, walk) {
+  if (!isObject(node) || typeof node.$ref !== "string") {
+    return node;
+  }
+  return walk.skipped.has(node.$ref) ? void 0 : resolveLocalRef(walk.document, node.$ref);
+}
+function members(node, keyword) {
+  const list = node[keyword];
+  return Array.isArray(list) ? list : [];
+}
+function ownValues(node) {
+  const listed = Array.isArray(node.enum) ? node.enum.filter(isAdmittedValue) : null;
+  const constant = "const" in node && isAdmittedValue(node.const) ? /* @__PURE__ */ new Set([node.const]) : null;
+  return intersect(listed === null ? null : new Set(listed), constant);
+}
+function schemaValues(schema, walk) {
+  const node = follow(schema, walk);
+  if (!isObject(node) || walk.depth > MAX_DEPTH) {
+    return null;
+  }
+  const next = { ...walk, depth: walk.depth + 1 };
+  const parts = members(node, "allOf").map((part) => schemaValues(part, next));
+  const variants = [...members(node, "anyOf"), ...members(node, "oneOf")];
+  const union = variants.length === 0 ? null : unite(variants.map((v) => schemaValues(v, next)));
+  return [...parts, union].reduce(intersect, ownValues(node));
+}
+function propertyValues(schema, key, walk) {
+  const node = follow(schema, walk);
+  if (!isObject(node) || walk.depth > MAX_DEPTH) {
+    return null;
+  }
+  const next = { ...walk, depth: walk.depth + 1 };
+  const properties = isObject(node.properties) ? node.properties : {};
+  const own = Object.hasOwn(properties, key) ? schemaValues(properties[key], next) : null;
+  const parts = members(node, "allOf").map((part) => propertyValues(part, key, next));
+  return parts.reduce(intersect, own);
+}
+function admittedPropertyValues(schema, key, document, skipped = /* @__PURE__ */ new Set()) {
+  return propertyValues(schema, key, { document, depth: 0, skipped });
+}
+
+export { admittedPropertyValues, resolveLocalRef };
+//# sourceMappingURL=admitted-values.mjs.map

package/dist/domain/openapi/admitted-values.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"admitted-values.mjs","sources":["../../../src/domain/openapi/admitted-values.ts"],"sourcesContent":["import { parseRefPointer } from \"./json-pointer.js\";\n\n/**\n * The values a schema admits when it admits only finitely many (`enum`, `const`, and `allOf` /\n * `anyOf` / `oneOf` of those), read from the document. Null means \"any value\" as far as this\n * reading goes: a schema of any other shape, or a `$ref` it cannot follow, is never assumed to\n * exclude a value.\n */\n\nexport type AdmittedValue = string | number | boolean | null;\n/** A finite set of values, or null for every value. */\nexport type AdmittedValues = ReadonlySet<AdmittedValue> | null;\n\ntype JsonObject = Readonly<Record<string, unknown>>;\n\n/** How deep `$ref`s and compositions are followed; deeper schemas admit every value. */\nconst MAX_DEPTH = 16;\nconst LOCAL_REF_PREFIX = \"#/\";\n\nfunction isObject(value: unknown): value is JsonObject {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** The node at a local `$ref` (`#/...`) of the document, or undefined. */\nexport function resolveLocalRef(document: unknown, ref: string): unknown {\n  if (!ref.startsWith(LOCAL_REF_PREFIX)) {\n    return undefined;\n  }\n  let node: unknown = document;\n  for (const segment of parseRefPointer(ref)) {\n    node = isObject(node) || Array.isArray(node) ? (node as JsonObject)[segment] : undefined;\n  }\n  return node;\n}\n\nfunction intersect(left: AdmittedValues, right: AdmittedValues): AdmittedValues {\n  if (left === null || right === null) {\n    return left ?? right;\n  }\n  return new Set([...left].filter((value) => right.has(value)));\n}\n\nfunction unite(sets: readonly AdmittedValues[]): AdmittedValues {\n  return sets.some((set) => set === null) ? null : new Set(sets.flatMap((set) => [...(set ?? [])]));\n}\n\nfunction isAdmittedValue(value: unknown): value is AdmittedValue {\n  return value === null || [\"string\", \"number\", \"boolean\"].includes(typeof value);\n}\n\ninterface Walk {\n  readonly document: unknown;\n  readonly depth: number;\n  /** `$ref`s whose targets are left out: they add nothing to the generated type here. */\n  readonly skipped: ReadonlySet<string>;\n}\n\nfunction follow(node: unknown, walk: Walk): unknown {\n  if (!isObject(node) || typeof node.$ref !== \"string\") {\n    return node;\n  }\n  return walk.skipped.has(node.$ref) ? undefined : resolveLocalRef(walk.document, node.$ref);\n}\n\nfunction members(node: JsonObject, keyword: string): readonly unknown[] {\n  const list = node[keyword];\n  return Array.isArray(list) ? list : [];\n}\n\n/** `enum` and `const` of the schema itself, before its compositions. */\nfunction ownValues(node: JsonObject): AdmittedValues {\n  const listed = Array.isArray(node.enum) ? node.enum.filter(isAdmittedValue) : null;\n  const constant = \"const\" in node && isAdmittedValue(node.const) ? new Set([node.const]) : null;\n  return intersect(listed === null ? null : new Set(listed), constant);\n}\n\nfunction schemaValues(schema: unknown, walk: Walk): AdmittedValues {\n  const node = follow(schema, walk);\n  if (!isObject(node) || walk.depth > MAX_DEPTH) {\n    return null;\n  }\n  const next = { ...walk, depth: walk.depth + 1 };\n  const parts = members(node, \"allOf\").map((part) => schemaValues(part, next));\n  const variants = [...members(node, \"anyOf\"), ...members(node, \"oneOf\")];\n  const union = variants.length === 0 ? null : unite(variants.map((v) => schemaValues(v, next)));\n  return [...parts, union].reduce<AdmittedValues>(intersect, ownValues(node));\n}\n\nfunction propertyValues(schema: unknown, key: string, walk: Walk): AdmittedValues {\n  const node = follow(schema, walk);\n  if (!isObject(node) || walk.depth > MAX_DEPTH) {\n    return null;\n  }\n  const next = { ...walk, depth: walk.depth + 1 };\n  const properties = isObject(node.properties) ? node.properties : {};\n  const own = Object.hasOwn(properties, key) ? schemaValues(properties[key], next) : null;\n  const parts = members(node, \"allOf\").map((part) => propertyValues(part, key, next));\n  return parts.reduce<AdmittedValues>(intersect, own);\n}\n\n/**\n * The values property `key` of an object schema admits: the intersection over the schema's own\n * `properties` and its `allOf` parts (followed through `$ref`s, except `skipped` ones); null for\n * every value.\n */\nexport function admittedPropertyValues(\n  schema: unknown,\n  key: string,\n  document: unknown,\n  skipped: ReadonlySet<string> = new Set(),\n): AdmittedValues {\n  return propertyValues(schema, key, { document, depth: 0, skipped });\n}\n"],"names":[],"mappings":";;AAgBA,MAAM,SAAA,GAAY,EAAA;AAClB,MAAM,gBAAA,GAAmB,IAAA;AAEzB,SAAS,SAAS,KAAA,EAAqC;AACrD,EAAA,OAAO,OAAO,UAAU,QAAA,IAAY,KAAA,KAAU,QAAQ,CAAC,KAAA,CAAM,QAAQ,KAAK,CAAA;AAC5E;AAGO,SAAS,eAAA,CAAgB,UAAmB,GAAA,EAAsB;AACvE,EAAA,IAAI,CAAC,GAAA,CAAI,UAAA,CAAW,gBAAgB,CAAA,EAAG;AACrC,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,IAAI,IAAA,GAAgB,QAAA;AACpB,EAAA,KAAA,MAAW,OAAA,IAAW,eAAA,CAAgB,GAAG,CAAA,EAAG;AAC1C,IAAA,IAAA,GAAO,QAAA,CAAS,IAAI,CAAA,IAAK,KAAA,CAAM,QAAQ,IAAI,CAAA,GAAK,IAAA,CAAoB,OAAO,CAAA,GAAI,MAAA;AAAA,EACjF;AACA,EAAA,OAAO,IAAA;AACT;AAEA,SAAS,SAAA,CAAU,MAAsB,KAAA,EAAuC;AAC9E,EAAA,IAAI,IAAA,KAAS,IAAA,IAAQ,KAAA,KAAU,IAAA,EAAM;AACnC,IAAA,OAAO,IAAA,IAAQ,KAAA;AAAA,EACjB;AACA,EAAA,OAAO,IAAI,GAAA,CAAI,CAAC,GAAG,IAAI,CAAA,CAAE,MAAA,CAAO,CAAC,KAAA,KAAU,KAAA,CAAM,GAAA,CAAI,KAAK,CAAC,CAAC,CAAA;AAC9D;AAEA,SAAS,MAAM,IAAA,EAAiD;AAC9D,EAAA,OAAO,IAAA,CAAK,KAAK,CAAC,GAAA,KAAQ,QAAQ,IAAI,CAAA,GAAI,OAAO,IAAI,GAAA,CAAI,KAAK,OAAA,CAAQ,CAAC,QAAQ,CAAC,GAAI,OAAO,EAAG,CAAC,CAAC,CAAA;AAClG;AAEA,SAAS,gBAAgB,KAAA,EAAwC;AAC/D,EAAA,OAAO,KAAA,KAAU,QAAQ,CAAC,QAAA,EAAU,UAAU,SAAS,CAAA,CAAE,QAAA,CAAS,OAAO,KAAK,CAAA;AAChF;AASA,SAAS,MAAA,CAAO,MAAe,IAAA,EAAqB;AAClD,EAAA,IAAI,CAAC,QAAA,CAAS,IAAI,KAAK,OAAO,IAAA,CAAK,SAAS,QAAA,EAAU;AACpD,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,IAAA,CAAK,IAAI,CAAA,GAAI,MAAA,GAAY,eAAA,CAAgB,IAAA,CAAK,QAAA,EAAU,IAAA,CAAK,IAAI,CAAA;AAC3F;AAEA,SAAS,OAAA,CAAQ,MAAkB,OAAA,EAAqC;AACtE,EAAA,MAAM,IAAA,GAAO,KAAK,OAAO,CAAA;AACzB,EAAA,OAAO,KAAA,CAAM,OAAA,CAAQ,IAAI,CAAA,GAAI,OAAO,EAAC;AACvC;AAGA,SAAS,UAAU,IAAA,EAAkC;AACnD,EAAA,MAAM,MAAA,GAAS,KAAA,CAAM,OAAA,CAAQ,IAAA,CAAK,IAAI,IAAI,IAAA,CAAK,IAAA,CAAK,MAAA,CAAO,eAAe,CAAA,GAAI,IAAA;AAC9E,EAAA,MAAM,QAAA,GAAW,OAAA,IAAW,IAAA,IAAQ,eAAA,CAAgB,IAAA,CAAK,KAAK,CAAA,mBAAI,IAAI,GAAA,CAAI,CAAC,IAAA,CAAK,KAAK,CAAC,CAAA,GAAI,IAAA;AAC1F,EAAA,OAAO,SAAA,CAAU,WAAW,IAAA,GAAO,IAAA,GAAO,IAAI,GAAA,CAAI,MAAM,GAAG,QAAQ,CAAA;AACrE;AAEA,SAAS,YAAA,CAAa,QAAiB,IAAA,EAA4B;AACjE,EAAA,MAAM,IAAA,GAAO,MAAA,CAAO,MAAA,EAAQ,IAAI,CAAA;AAChC,EAAA,IAAI,CAAC,QAAA,CAAS,IAAI,CAAA,IAAK,IAAA,CAAK,QAAQ,SAAA,EAAW;AAC7C,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,MAAM,OAAO,EAAE,GAAG,MAAM,KAAA,EAAO,IAAA,CAAK,QAAQ,CAAA,EAAE;AAC9C,EAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,IAAA,EAAM,OAAO,CAAA,CAAE,GAAA,CAAI,CAAC,IAAA,KAAS,YAAA,CAAa,IAAA,EAAM,IAAI,CAAC,CAAA;AAC3E,EAAA,MAAM,QAAA,GAAW,CAAC,GAAG,OAAA,CAAQ,IAAA,EAAM,OAAO,CAAA,EAAG,GAAG,OAAA,CAAQ,IAAA,EAAM,OAAO,CAAC,CAAA;AACtE,EAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,MAAA,KAAW,CAAA,GAAI,OAAO,KAAA,CAAM,QAAA,CAAS,GAAA,CAAI,CAAC,CAAA,KAAM,YAAA,CAAa,CAAA,EAAG,IAAI,CAAC,CAAC,CAAA;AAC7F,EAAA,OAAO,CAAC,GAAG,KAAA,EAAO,KAAK,EAAE,MAAA,CAAuB,SAAA,EAAW,SAAA,CAAU,IAAI,CAAC,CAAA;AAC5E;AAEA,SAAS,cAAA,CAAe,MAAA,EAAiB,GAAA,EAAa,IAAA,EAA4B;AAChF,EAAA,MAAM,IAAA,GAAO,MAAA,CAAO,MAAA,EAAQ,IAAI,CAAA;AAChC,EAAA,IAAI,CAAC,QAAA,CAAS,IAAI,CAAA,IAAK,IAAA,CAAK,QAAQ,SAAA,EAAW;AAC7C,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,MAAM,OAAO,EAAE,GAAG,MAAM,KAAA,EAAO,IAAA,CAAK,QAAQ,CAAA,EAAE;AAC9C,EAAA,MAAM,aAAa,QAAA,CAAS,IAAA,CAAK,UAAU,CAAA,GAAI,IAAA,CAAK,aAAa,EAAC;AAClE,EAAA,MAAM,GAAA,GAAM,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,GAAG,CAAA,GAAI,YAAA,CAAa,UAAA,CAAW,GAAG,CAAA,EAAG,IAAI,CAAA,GAAI,IAAA;AACnF,EAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,IAAA,EAAM,OAAO,CAAA,CAAE,GAAA,CAAI,CAAC,IAAA,KAAS,cAAA,CAAe,IAAA,EAAM,GAAA,EAAK,IAAI,CAAC,CAAA;AAClF,EAAA,OAAO,KAAA,CAAM,MAAA,CAAuB,SAAA,EAAW,GAAG,CAAA;AACpD;AAOO,SAAS,uBACd,MAAA,EACA,GAAA,EACA,UACA,OAAA,mBAA+B,IAAI,KAAI,EACvB;AAChB,EAAA,OAAO,cAAA,CAAe,QAAQ,GAAA,EAAK,EAAE,UAAU,KAAA,EAAO,CAAA,EAAG,SAAS,CAAA;AACpE;;"}

package/dist/domain/openapi/discriminated-union.cjs

@@ -0,0 +1,68 @@
+'use strict';
+
+const jsonPointer = require('./json-pointer.cjs');
+
+const UNION_KEYWORDS = ["oneOf", "anyOf"];
+const COMPOSITION_KEYWORDS = ["allOf", ...UNION_KEYWORDS];
+function isSchemaObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function keywordItems(schema, keywords) {
+  const record = schema;
+  return keywords.flatMap((keyword) => {
+    const items = record[keyword];
+    return Array.isArray(items) ? items : [];
+  });
+}
+function unionMembers(schema) {
+  return isSchemaObject(schema) ? keywordItems(schema, UNION_KEYWORDS) : [];
+}
+function unionAt(ref, resolve) {
+  const schema = resolve(ref);
+  return isSchemaObject(schema) && unionMembers(schema).length > 0 ? schema : void 0;
+}
+function reaches(schema, search) {
+  if (!isSchemaObject(schema)) {
+    return false;
+  }
+  const ref = schema.$ref;
+  if (typeof ref === "string") {
+    if (ref === search.target) {
+      return true;
+    }
+    if (search.visited.has(ref)) {
+      return false;
+    }
+    search.visited.add(ref);
+    return reaches(search.resolve(ref), search);
+  }
+  return keywordItems(schema, COMPOSITION_KEYWORDS).some((item) => reaches(item, search));
+}
+function unionReaches(union, target, resolve) {
+  const search = { target, resolve, visited: /* @__PURE__ */ new Set() };
+  return unionMembers(union).some((member) => reaches(member, search));
+}
+const COMPONENT_SCHEMAS = "#/components/schemas/";
+function mappingRef(target) {
+  if (typeof target !== "string") {
+    return void 0;
+  }
+  return target.startsWith("#") ? target : `${COMPONENT_SCHEMAS}${jsonPointer.escapePointerSegment(target)}`;
+}
+function unionMaps(union, target) {
+  const mapping = union.discriminator?.mapping;
+  if (!isSchemaObject(mapping)) {
+    return false;
+  }
+  return Object.values(mapping).some((value) => mappingRef(value) === target);
+}
+function isUnionMember(union, target, resolve) {
+  return unionMaps(union, target) || unionReaches(union, target, resolve);
+}
+
+exports.isUnionMember = isUnionMember;
+exports.unionAt = unionAt;
+exports.unionMaps = unionMaps;
+exports.unionMembers = unionMembers;
+exports.unionReaches = unionReaches;
+//# sourceMappingURL=discriminated-union.cjs.map

package/dist/domain/openapi/discriminated-union.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"discriminated-union.cjs","sources":["../../../src/domain/openapi/discriminated-union.ts"],"sourcesContent":["import { escapePointerSegment } from \"./json-pointer.js\";\nimport type { Schema, SchemaObject } from \"./schema-object.js\";\n\n/**\n * A discriminator owner is either a parent that its members `allOf` (an object with the\n * discriminator property) or a union (`oneOf` / `anyOf` of the members). The generated type of a\n * union is a TypeScript union, so it cannot be used like a parent: `Omit<Union, \"kind\">` keeps\n * only the keys that every member has, and a member that intersects the union it belongs to\n * refers to itself (TS2502, upstream #1665).\n */\n\n/** Resolves a `$ref` of the document; `undefined` when it points nowhere. */\nexport type ResolveSchemaRef = (ref: string) => unknown;\n\nconst UNION_KEYWORDS = [\"oneOf\", \"anyOf\"] as const;\nconst COMPOSITION_KEYWORDS = [\"allOf\", ...UNION_KEYWORDS] as const;\n\nfunction isSchemaObject(value: unknown): value is SchemaObject {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction keywordItems(schema: SchemaObject, keywords: readonly string[]): readonly Schema[] {\n  const record = schema as Readonly<Record<string, unknown>>;\n  return keywords.flatMap((keyword) => {\n    const items = record[keyword];\n    return Array.isArray(items) ? (items as readonly Schema[]) : [];\n  });\n}\n\n/** The `oneOf` and `anyOf` members of a schema; empty when it is not a union. */\nexport function unionMembers(schema: unknown): readonly Schema[] {\n  return isSchemaObject(schema) ? keywordItems(schema, UNION_KEYWORDS) : [];\n}\n\n/** The schema at `ref` when it is a union (has `oneOf` or `anyOf` members), else undefined. */\nexport function unionAt(ref: string, resolve: ResolveSchemaRef): SchemaObject | undefined {\n  const schema = resolve(ref);\n  return isSchemaObject(schema) && unionMembers(schema).length > 0 ? schema : undefined;\n}\n\n/** What one search for a `$ref` has seen, so that a `$ref` cycle ends. */\ninterface Search {\n  readonly target: string;\n  readonly resolve: ResolveSchemaRef;\n  readonly visited: Set<string>;\n}\n\nfunction reaches(schema: Schema, search: Search): boolean {\n  if (!isSchemaObject(schema)) {\n    return false;\n  }\n  const ref = (schema as { readonly $ref?: unknown }).$ref;\n  if (typeof ref === \"string\") {\n    if (ref === search.target) {\n      return true;\n    }\n    if (search.visited.has(ref)) {\n      return false;\n    }\n    search.visited.add(ref);\n    return reaches(search.resolve(ref) as Schema, search);\n  }\n  return keywordItems(schema, COMPOSITION_KEYWORDS).some((item) => reaches(item, search));\n}\n\n/**\n * Whether the type of `union` contains the schema at `target` without an object in between: one\n * of its members is a `$ref` to it, or `allOf` / `oneOf` / `anyOf` such a `$ref`, at any depth.\n * Such a reference is resolved at once by TypeScript, unlike one in a property or an array.\n */\nexport function unionReaches(\n  union: SchemaObject,\n  target: string,\n  resolve: ResolveSchemaRef,\n): boolean {\n  const search = { target, resolve, visited: new Set<string>() };\n  return unionMembers(union).some((member) => reaches(member, search));\n}\n\nconst COMPONENT_SCHEMAS = \"#/components/schemas/\";\n\n/** A mapping value as a `$ref`: a bare name is a component schema's name. */\nfunction mappingRef(target: unknown): string | undefined {\n  if (typeof target !== \"string\") {\n    return undefined;\n  }\n  return target.startsWith(\"#\") ? target : `${COMPONENT_SCHEMAS}${escapePointerSegment(target)}`;\n}\n\n/** Whether the discriminator `mapping` of `union` names the schema at `target`. */\nexport function unionMaps(union: SchemaObject, target: string): boolean {\n  const mapping = (union.discriminator as { readonly mapping?: unknown } | undefined)?.mapping;\n  if (!isSchemaObject(mapping)) {\n    return false;\n  }\n  return Object.values(mapping).some((value) => mappingRef(value) === target);\n}\n\n/**\n * Whether the schema at `target` is a member of `union`: the union's type contains it, or the\n * discriminator `mapping` names it, which gives it a value of the union as a member does.\n */\nexport function isUnionMember(\n  union: SchemaObject,\n  target: string,\n  resolve: ResolveSchemaRef,\n): boolean {\n  return unionMaps(union, target) || unionReaches(union, target, resolve);\n}\n"],"names":["escapePointerSegment"],"mappings":"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"}

package/dist/domain/openapi/discriminated-union.mjs

@@ -0,0 +1,62 @@
+import { escapePointerSegment } from './json-pointer.mjs';
+
+const UNION_KEYWORDS = ["oneOf", "anyOf"];
+const COMPOSITION_KEYWORDS = ["allOf", ...UNION_KEYWORDS];
+function isSchemaObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function keywordItems(schema, keywords) {
+  const record = schema;
+  return keywords.flatMap((keyword) => {
+    const items = record[keyword];
+    return Array.isArray(items) ? items : [];
+  });
+}
+function unionMembers(schema) {
+  return isSchemaObject(schema) ? keywordItems(schema, UNION_KEYWORDS) : [];
+}
+function unionAt(ref, resolve) {
+  const schema = resolve(ref);
+  return isSchemaObject(schema) && unionMembers(schema).length > 0 ? schema : void 0;
+}
+function reaches(schema, search) {
+  if (!isSchemaObject(schema)) {
+    return false;
+  }
+  const ref = schema.$ref;
+  if (typeof ref === "string") {
+    if (ref === search.target) {
+      return true;
+    }
+    if (search.visited.has(ref)) {
+      return false;
+    }
+    search.visited.add(ref);
+    return reaches(search.resolve(ref), search);
+  }
+  return keywordItems(schema, COMPOSITION_KEYWORDS).some((item) => reaches(item, search));
+}
+function unionReaches(union, target, resolve) {
+  const search = { target, resolve, visited: /* @__PURE__ */ new Set() };
+  return unionMembers(union).some((member) => reaches(member, search));
+}
+const COMPONENT_SCHEMAS = "#/components/schemas/";
+function mappingRef(target) {
+  if (typeof target !== "string") {
+    return void 0;
+  }
+  return target.startsWith("#") ? target : `${COMPONENT_SCHEMAS}${escapePointerSegment(target)}`;
+}
+function unionMaps(union, target) {
+  const mapping = union.discriminator?.mapping;
+  if (!isSchemaObject(mapping)) {
+    return false;
+  }
+  return Object.values(mapping).some((value) => mappingRef(value) === target);
+}
+function isUnionMember(union, target, resolve) {
+  return unionMaps(union, target) || unionReaches(union, target, resolve);
+}
+
+export { isUnionMember, unionAt, unionMaps, unionMembers, unionReaches };
+//# sourceMappingURL=discriminated-union.mjs.map