openapi-typesafe 0.0.0 → 1.0.0-rc.0

package/dist/api/discriminator-scan.cjs

@@ -0,0 +1,168 @@
+'use strict';
+
+const defaultPorts = require('./default-ports.cjs');
+const discriminatorEnum = require('./discriminator-enum.cjs');
+const documentRefs = require('./document-refs.cjs');
+const legacyUtils = require('./legacy-utils.cjs');
+
+function addDiscriminatorEnum(state, patch) {
+  const { silent, logger } = state;
+  const resolved = documentRefs.resolveDocumentRef(state.schema, patch.ref, { silent, logger });
+  const added = discriminatorEnum.addEnumProperty(resolved, patch);
+  if (added === null) {
+    warnInvalidMapping(patch, state.logger);
+  }
+  return added;
+}
+function enumKey(patch) {
+  return `${patch.ref}
+${patch.discriminator.propertyName}`;
+}
+function mergeIntoPatchedEnum(state, key, values) {
+  const patched = state.patchedEnums.get(key);
+  if (patched === void 0) {
+    return false;
+  }
+  const merged = patched.enum;
+  merged.push(...values.filter((value) => !merged.includes(value)));
+  return true;
+}
+function patchDiscriminatorEnum(state, patch) {
+  if (!state.fixesValueConflicts) {
+    return addDiscriminatorEnum(state, patch) !== null;
+  }
+  const key = enumKey(patch);
+  if (mergeIntoPatchedEnum(state, key, patch.values)) {
+    return true;
+  }
+  const added = addDiscriminatorEnum(state, patch);
+  if (added !== null) {
+    state.patchedEnums.set(key, added);
+  }
+  return added !== null;
+}
+function markHandled(state, ref) {
+  if (!state.refsHandled.includes(ref)) {
+    state.refsHandled.push(ref);
+  }
+}
+function warnInvalidMapping(patch, logger) {
+  const mapped = `${patch.ref} => ${patch.values.join(", ")}`;
+  logger.warn(
+    `Discriminator mapping has an invalid schema (neither an object schema nor an allOf array): ${mapped} (Discriminator: ${patch.discriminatorRef})`
+  );
+}
+function inferredMapping(oneOf) {
+  const mapping = {};
+  for (const item of oneOf) {
+    if (!("$ref" in item)) {
+      continue;
+    }
+    const value = item.$ref.split("/").pop();
+    if (value) {
+      mapping[item.$ref] = { ...mapping[item.$ref], inferred: value };
+    }
+  }
+  return mapping;
+}
+function addDefinedMapping(mapping, discriminator) {
+  for (const [mappedValue, mappedRef] of Object.entries(discriminator.mapping ?? {})) {
+    if (!mappedRef) {
+      continue;
+    }
+    if (!mapping[mappedRef]?.defined) {
+      mapping[mappedRef] = { defined: [] };
+    }
+    mapping[mappedRef].defined?.push(mappedValue);
+  }
+}
+function patchMappedSchemas(state, mapping, discriminator) {
+  for (const [ref, { inferred, defined }] of Object.entries(mapping)) {
+    const isSkipped = !state.fixesValueConflicts && state.refsHandled.includes(ref);
+    if (isSkipped || !inferred && !defined) {
+      continue;
+    }
+    const values = defined ?? [inferred];
+    if (state.fixesValueConflicts && defined === void 0) {
+      state.inferredPatches.push({ ...discriminator, ref, values });
+    } else if (patchDiscriminatorEnum(state, { ...discriminator, ref, values })) {
+      markHandled(state, ref);
+    }
+  }
+}
+function collectDiscriminator(state, value, path) {
+  const discriminator = value.discriminator;
+  if (!discriminator?.propertyName) {
+    return;
+  }
+  const discriminatorRef = legacyUtils.createRef(path);
+  state.objects[discriminatorRef] = discriminator;
+  if (!Array.isArray(value.oneOf)) {
+    return;
+  }
+  const mapping = inferredMapping(value.oneOf);
+  if (discriminator.mapping) {
+    addDefinedMapping(mapping, discriminator);
+  }
+  patchMappedSchemas(state, mapping, { discriminator, discriminatorRef });
+}
+function valuesMappedTo(discriminator, ref) {
+  return Object.entries(discriminator.mapping ?? {}).filter(([, mappedRef]) => mappedRef === ref).map(([mappedValue]) => mappedValue);
+}
+function inheritFromRef(state, parentRef, ref) {
+  const discriminator = state.objects[parentRef];
+  if (!discriminator) {
+    return false;
+  }
+  const values = valuesMappedTo(discriminator, ref);
+  const patch = { ref, values, discriminator, discriminatorRef: parentRef };
+  if (values.length > 0 && patchDiscriminatorEnum(state, patch)) {
+    markHandled(state, ref);
+  }
+  state.objects[ref] = { ...discriminator };
+  return true;
+}
+function inheritDiscriminators(state, value, path) {
+  if (!Array.isArray(value.allOf)) {
+    return;
+  }
+  for (const item of value.allOf) {
+    if ("$ref" in item) {
+      if (!inheritFromRef(state, item.$ref, legacyUtils.createRef(path))) {
+        return;
+      }
+    } else if (item.discriminator?.propertyName) {
+      state.objects[legacyUtils.createRef(path)] = { ...item.discriminator };
+    }
+  }
+}
+function applyInferredPatches(state) {
+  const mapped = new Set(state.patchedEnums.keys());
+  for (const patch of state.inferredPatches) {
+    if (!mapped.has(enumKey(patch)) && patchDiscriminatorEnum(state, patch)) {
+      markHandled(state, patch.ref);
+    }
+  }
+}
+function findDiscriminators(schema, options) {
+  const state = {
+    ...options,
+    schema,
+    objects: {},
+    refsHandled: [],
+    patchedEnums: /* @__PURE__ */ new Map(),
+    inferredPatches: []
+  };
+  documentRefs.walkDocument(schema, (value, path) => collectDiscriminator(state, value, path));
+  documentRefs.walkDocument(schema, (value, path) => inheritDiscriminators(state, value, path));
+  applyInferredPatches(state);
+  return { objects: state.objects, refsHandled: state.refsHandled };
+}
+function scanDiscriminators(schema, options, logger = defaultPorts.defaultLogger(options.silent ?? false)) {
+  const silent = options.silent ?? false;
+  return findDiscriminators(schema, { silent, logger, fixesValueConflicts: false });
+}
+
+exports.findDiscriminators = findDiscriminators;
+exports.scanDiscriminators = scanDiscriminators;
+//# sourceMappingURL=discriminator-scan.cjs.map

package/dist/api/discriminator-scan.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"discriminator-scan.cjs","sources":["../../src/api/discriminator-scan.ts"],"sourcesContent":["import type { Logger } from \"../application/ports/logger.js\";\nimport type {\n  DiscriminatorObject,\n  GeneratorOptions,\n  OpenAPI3,\n  ReferenceObject,\n  SchemaObject,\n} from \"../types.js\";\nimport { defaultLogger } from \"./default-ports.js\";\nimport { addEnumProperty, type EnumPatch } from \"./discriminator-enum.js\";\nimport { resolveDocumentRef, walkDocument } from \"./document-refs.js\";\nimport { createRef } from \"./legacy-utils.js\";\n\n/**\n * The inherited discriminator pre-pass. It finds every discriminator in the bundled document and\n * patches the mapped schemas in place with a required enum property, so that TypeScript can narrow\n * the generated union. The behavior and the warning text match the original `scanDiscriminators`.\n */\n\ntype DiscriminatorMapping = Record<string, { inferred?: string; defined?: string[] }>;\n\n/** How to scan; `fixesValueConflicts` is the `discriminator-values` fix (ADR-021, roadmap R12). */\nexport interface DiscriminatorScanOptions {\n  readonly silent: boolean;\n  readonly logger: Logger;\n  readonly fixesValueConflicts: boolean;\n}\n\n/** What the two passes share: the document they patch and what they found so far. */\ninterface ScanState extends DiscriminatorScanOptions {\n  readonly schema: OpenAPI3;\n  readonly objects: Record<string, DiscriminatorObject>;\n  readonly refsHandled: string[];\n  /** With the fix: the enum added to each schema, by schema and property, so values merge. */\n  readonly patchedEnums: Map<string, SchemaObject>;\n  /** With the fix: schema-name values, applied after both passes where no mapping names one. */\n  readonly inferredPatches: EnumPatch[];\n}\n\n/** The enum the schema at `patch.ref` gets, or null (with a warning) for another kind of schema. */\nfunction addDiscriminatorEnum(state: ScanState, patch: EnumPatch): SchemaObject | null {\n  const { silent, logger } = state;\n  const resolved = resolveDocumentRef<SchemaObject>(state.schema, patch.ref, { silent, logger });\n  const added = addEnumProperty(resolved, patch);\n  if (added === null) {\n    warnInvalidMapping(patch, state.logger);\n  }\n  return added;\n}\n\n/** One schema and discriminator property; two discriminators of one property share an enum. */\nfunction enumKey(patch: EnumPatch): string {\n  return `${patch.ref}\\n${patch.discriminator.propertyName}`;\n}\n\n/** With the fix, a second discriminator of the same property adds its values to the first enum. */\nfunction mergeIntoPatchedEnum(state: ScanState, key: string, values: readonly string[]): boolean {\n  const patched = state.patchedEnums.get(key);\n  if (patched === undefined) {\n    return false;\n  }\n  const merged = patched.enum as unknown[];\n  merged.push(...values.filter((value) => !merged.includes(value)));\n  return true;\n}\n\n/**\n * Add or replace the discriminator enum in the schema at `patch.ref`. Returns false, with a\n * warning, when that schema is neither an `allOf` nor an object schema. Without the fix every\n * patch adds a property, so two discriminators with different values intersect to `never`.\n */\nfunction patchDiscriminatorEnum(state: ScanState, patch: EnumPatch): boolean {\n  if (!state.fixesValueConflicts) {\n    return addDiscriminatorEnum(state, patch) !== null;\n  }\n  const key = enumKey(patch);\n  if (mergeIntoPatchedEnum(state, key, patch.values)) {\n    return true;\n  }\n  const added = addDiscriminatorEnum(state, patch);\n  if (added !== null) {\n    state.patchedEnums.set(key, added);\n  }\n  return added !== null;\n}\n\nfunction markHandled(state: ScanState, ref: string): void {\n  if (!state.refsHandled.includes(ref)) {\n    state.refsHandled.push(ref);\n  }\n}\n\nfunction warnInvalidMapping(patch: EnumPatch, logger: Logger): void {\n  const mapped = `${patch.ref} => ${patch.values.join(\", \")}`;\n  logger.warn(\n    \"Discriminator mapping has an invalid schema (neither an object schema nor an allOf array): \" +\n      `${mapped} (Discriminator: ${patch.discriminatorRef})`,\n  );\n}\n\n/** The schema name at the end of each `oneOf` `$ref` is the inferred discriminator value. */\nfunction inferredMapping(oneOf: (SchemaObject | ReferenceObject)[]): DiscriminatorMapping {\n  const mapping: DiscriminatorMapping = {};\n  for (const item of oneOf) {\n    if (!(\"$ref\" in item)) {\n      continue;\n    }\n    const value = item.$ref.split(\"/\").pop();\n    if (value) {\n      mapping[item.$ref] = { ...mapping[item.$ref], inferred: value };\n    }\n  }\n  return mapping;\n}\n\n/** Values defined in `discriminator.mapping` replace inferred ones for the same schema. */\nfunction addDefinedMapping(\n  mapping: DiscriminatorMapping,\n  discriminator: DiscriminatorObject,\n): void {\n  for (const [mappedValue, mappedRef] of Object.entries(discriminator.mapping ?? {})) {\n    if (!mappedRef) {\n      continue;\n    }\n    if (!mapping[mappedRef]?.defined) {\n      mapping[mappedRef] = { defined: [] };\n    }\n    mapping[mappedRef].defined?.push(mappedValue);\n  }\n}\n\nfunction patchMappedSchemas(\n  state: ScanState,\n  mapping: DiscriminatorMapping,\n  discriminator: Omit<EnumPatch, \"ref\" | \"values\">,\n): void {\n  for (const [ref, { inferred, defined }] of Object.entries(mapping)) {\n    const isSkipped = !state.fixesValueConflicts && state.refsHandled.includes(ref);\n    if (isSkipped || (!inferred && !defined)) {\n      continue;\n    }\n    // A defined value wins: the schema name may not be the value the API sends.\n    const values = defined ?? [inferred as string];\n    if (state.fixesValueConflicts && defined === undefined) {\n      // A mapping found later, in this pass or the next, may name the schema.\n      state.inferredPatches.push({ ...discriminator, ref, values });\n    } else if (patchDiscriminatorEnum(state, { ...discriminator, ref, values })) {\n      markHandled(state, ref);\n    }\n  }\n}\n\n/** Pass 1: collect every discriminator; patch the schemas of a discriminator + `oneOf`. */\nfunction collectDiscriminator(\n  state: ScanState,\n  value: Record<string, unknown>,\n  path: (string | number)[],\n): void {\n  const discriminator = value.discriminator as DiscriminatorObject | undefined;\n  if (!discriminator?.propertyName) {\n    return;\n  }\n  const discriminatorRef = createRef(path);\n  state.objects[discriminatorRef] = discriminator;\n  if (!Array.isArray(value.oneOf)) {\n    return;\n  }\n  const mapping = inferredMapping(value.oneOf);\n  if (discriminator.mapping) {\n    addDefinedMapping(mapping, discriminator);\n  }\n  patchMappedSchemas(state, mapping, { discriminator, discriminatorRef });\n}\n\n/** The mapping keys of `discriminator` that point at `ref`. */\nfunction valuesMappedTo(discriminator: DiscriminatorObject, ref: string): string[] {\n  return Object.entries(discriminator.mapping ?? {})\n    .filter(([, mappedRef]) => mappedRef === ref)\n    .map(([mappedValue]) => mappedValue);\n}\n\n/**\n * An `allOf` item that is a `$ref` to a discriminator owner: the schema at `ref` inherits the\n * discriminator, and gets its enum when the parent's mapping names it. Returns false when the\n * `$ref` owns no discriminator, which ends the scan of this `allOf` (as in the original).\n */\nfunction inheritFromRef(state: ScanState, parentRef: string, ref: string): boolean {\n  const discriminator = state.objects[parentRef];\n  if (!discriminator) {\n    return false;\n  }\n  const values = valuesMappedTo(discriminator, ref);\n  const patch = { ref, values, discriminator, discriminatorRef: parentRef };\n  if (values.length > 0 && patchDiscriminatorEnum(state, patch)) {\n    markHandled(state, ref);\n  }\n  state.objects[ref] = { ...discriminator };\n  return true;\n}\n\n/** Pass 2: a schema whose `allOf` holds a discriminator, or a `$ref` to one, inherits it. */\nfunction inheritDiscriminators(\n  state: ScanState,\n  value: Record<string, unknown>,\n  path: (string | number)[],\n): void {\n  if (!Array.isArray(value.allOf)) {\n    return;\n  }\n  for (const item of value.allOf as (SchemaObject | ReferenceObject)[]) {\n    if (\"$ref\" in item) {\n      if (!inheritFromRef(state, item.$ref, createRef(path))) {\n        return;\n      }\n    } else if (item.discriminator?.propertyName) {\n      state.objects[createRef(path)] = { ...item.discriminator };\n    }\n  }\n}\n\n/** The discriminators of a bundled document, after patching the mapped schemas in place. */\nexport interface DiscriminatorScan {\n  objects: Record<string, DiscriminatorObject>;\n  refsHandled: string[];\n}\n\n/**\n * With the fix: a schema-name value, only for a schema and property that no mapping gave a value.\n * Every enum patched so far came from a mapping, since schema-name values wait for this step.\n */\nfunction applyInferredPatches(state: ScanState): void {\n  const mapped = new Set(state.patchedEnums.keys());\n  for (const patch of state.inferredPatches) {\n    if (!mapped.has(enumKey(patch)) && patchDiscriminatorEnum(state, patch)) {\n      markHandled(state, patch.ref);\n    }\n  }\n}\n\n/** Find every discriminator in `schema`; warnings go to `logger` unless `silent`. */\nexport function findDiscriminators(\n  schema: OpenAPI3,\n  options: DiscriminatorScanOptions,\n): DiscriminatorScan {\n  const state: ScanState = {\n    ...options,\n    schema,\n    objects: {},\n    refsHandled: [],\n    patchedEnums: new Map(),\n    inferredPatches: [],\n  };\n  walkDocument(schema, (value, path) => collectDiscriminator(state, value, path));\n  // A second pass, because an `allOf` may name a discriminator that is defined later.\n  walkDocument(schema, (value, path) => inheritDiscriminators(state, value, path));\n  applyInferredPatches(state);\n  return { objects: state.objects, refsHandled: state.refsHandled };\n}\n\n/**\n * Return a key–value map of discriminator objects found in a schema. Warnings go to `logger`;\n * without one, to the default terminal logger, as the original did.\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function scanDiscriminators(\n  schema: OpenAPI3,\n  options: GeneratorOptions,\n  logger: Logger = defaultLogger(options.silent ?? false),\n): DiscriminatorScan {\n  const silent = options.silent ?? false;\n  return findDiscriminators(schema, { silent, logger, fixesValueConflicts: false });\n}\n"],"names":["resolveDocumentRef","addEnumProperty","createRef","walkDocument","defaultLogger"],"mappings":"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"}

package/dist/api/discriminator-scan.mjs

@@ -0,0 +1,165 @@
+import { defaultLogger } from './default-ports.mjs';
+import { addEnumProperty } from './discriminator-enum.mjs';
+import { walkDocument, resolveDocumentRef } from './document-refs.mjs';
+import { createRef } from './legacy-utils.mjs';
+
+function addDiscriminatorEnum(state, patch) {
+  const { silent, logger } = state;
+  const resolved = resolveDocumentRef(state.schema, patch.ref, { silent, logger });
+  const added = addEnumProperty(resolved, patch);
+  if (added === null) {
+    warnInvalidMapping(patch, state.logger);
+  }
+  return added;
+}
+function enumKey(patch) {
+  return `${patch.ref}
+${patch.discriminator.propertyName}`;
+}
+function mergeIntoPatchedEnum(state, key, values) {
+  const patched = state.patchedEnums.get(key);
+  if (patched === void 0) {
+    return false;
+  }
+  const merged = patched.enum;
+  merged.push(...values.filter((value) => !merged.includes(value)));
+  return true;
+}
+function patchDiscriminatorEnum(state, patch) {
+  if (!state.fixesValueConflicts) {
+    return addDiscriminatorEnum(state, patch) !== null;
+  }
+  const key = enumKey(patch);
+  if (mergeIntoPatchedEnum(state, key, patch.values)) {
+    return true;
+  }
+  const added = addDiscriminatorEnum(state, patch);
+  if (added !== null) {
+    state.patchedEnums.set(key, added);
+  }
+  return added !== null;
+}
+function markHandled(state, ref) {
+  if (!state.refsHandled.includes(ref)) {
+    state.refsHandled.push(ref);
+  }
+}
+function warnInvalidMapping(patch, logger) {
+  const mapped = `${patch.ref} => ${patch.values.join(", ")}`;
+  logger.warn(
+    `Discriminator mapping has an invalid schema (neither an object schema nor an allOf array): ${mapped} (Discriminator: ${patch.discriminatorRef})`
+  );
+}
+function inferredMapping(oneOf) {
+  const mapping = {};
+  for (const item of oneOf) {
+    if (!("$ref" in item)) {
+      continue;
+    }
+    const value = item.$ref.split("/").pop();
+    if (value) {
+      mapping[item.$ref] = { ...mapping[item.$ref], inferred: value };
+    }
+  }
+  return mapping;
+}
+function addDefinedMapping(mapping, discriminator) {
+  for (const [mappedValue, mappedRef] of Object.entries(discriminator.mapping ?? {})) {
+    if (!mappedRef) {
+      continue;
+    }
+    if (!mapping[mappedRef]?.defined) {
+      mapping[mappedRef] = { defined: [] };
+    }
+    mapping[mappedRef].defined?.push(mappedValue);
+  }
+}
+function patchMappedSchemas(state, mapping, discriminator) {
+  for (const [ref, { inferred, defined }] of Object.entries(mapping)) {
+    const isSkipped = !state.fixesValueConflicts && state.refsHandled.includes(ref);
+    if (isSkipped || !inferred && !defined) {
+      continue;
+    }
+    const values = defined ?? [inferred];
+    if (state.fixesValueConflicts && defined === void 0) {
+      state.inferredPatches.push({ ...discriminator, ref, values });
+    } else if (patchDiscriminatorEnum(state, { ...discriminator, ref, values })) {
+      markHandled(state, ref);
+    }
+  }
+}
+function collectDiscriminator(state, value, path) {
+  const discriminator = value.discriminator;
+  if (!discriminator?.propertyName) {
+    return;
+  }
+  const discriminatorRef = createRef(path);
+  state.objects[discriminatorRef] = discriminator;
+  if (!Array.isArray(value.oneOf)) {
+    return;
+  }
+  const mapping = inferredMapping(value.oneOf);
+  if (discriminator.mapping) {
+    addDefinedMapping(mapping, discriminator);
+  }
+  patchMappedSchemas(state, mapping, { discriminator, discriminatorRef });
+}
+function valuesMappedTo(discriminator, ref) {
+  return Object.entries(discriminator.mapping ?? {}).filter(([, mappedRef]) => mappedRef === ref).map(([mappedValue]) => mappedValue);
+}
+function inheritFromRef(state, parentRef, ref) {
+  const discriminator = state.objects[parentRef];
+  if (!discriminator) {
+    return false;
+  }
+  const values = valuesMappedTo(discriminator, ref);
+  const patch = { ref, values, discriminator, discriminatorRef: parentRef };
+  if (values.length > 0 && patchDiscriminatorEnum(state, patch)) {
+    markHandled(state, ref);
+  }
+  state.objects[ref] = { ...discriminator };
+  return true;
+}
+function inheritDiscriminators(state, value, path) {
+  if (!Array.isArray(value.allOf)) {
+    return;
+  }
+  for (const item of value.allOf) {
+    if ("$ref" in item) {
+      if (!inheritFromRef(state, item.$ref, createRef(path))) {
+        return;
+      }
+    } else if (item.discriminator?.propertyName) {
+      state.objects[createRef(path)] = { ...item.discriminator };
+    }
+  }
+}
+function applyInferredPatches(state) {
+  const mapped = new Set(state.patchedEnums.keys());
+  for (const patch of state.inferredPatches) {
+    if (!mapped.has(enumKey(patch)) && patchDiscriminatorEnum(state, patch)) {
+      markHandled(state, patch.ref);
+    }
+  }
+}
+function findDiscriminators(schema, options) {
+  const state = {
+    ...options,
+    schema,
+    objects: {},
+    refsHandled: [],
+    patchedEnums: /* @__PURE__ */ new Map(),
+    inferredPatches: []
+  };
+  walkDocument(schema, (value, path) => collectDiscriminator(state, value, path));
+  walkDocument(schema, (value, path) => inheritDiscriminators(state, value, path));
+  applyInferredPatches(state);
+  return { objects: state.objects, refsHandled: state.refsHandled };
+}
+function scanDiscriminators(schema, options, logger = defaultLogger(options.silent ?? false)) {
+  const silent = options.silent ?? false;
+  return findDiscriminators(schema, { silent, logger, fixesValueConflicts: false });
+}
+
+export { findDiscriminators, scanDiscriminators };
+//# sourceMappingURL=discriminator-scan.mjs.map

package/dist/api/discriminator-scan.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"discriminator-scan.mjs","sources":["../../src/api/discriminator-scan.ts"],"sourcesContent":["import type { Logger } from \"../application/ports/logger.js\";\nimport type {\n  DiscriminatorObject,\n  GeneratorOptions,\n  OpenAPI3,\n  ReferenceObject,\n  SchemaObject,\n} from \"../types.js\";\nimport { defaultLogger } from \"./default-ports.js\";\nimport { addEnumProperty, type EnumPatch } from \"./discriminator-enum.js\";\nimport { resolveDocumentRef, walkDocument } from \"./document-refs.js\";\nimport { createRef } from \"./legacy-utils.js\";\n\n/**\n * The inherited discriminator pre-pass. It finds every discriminator in the bundled document and\n * patches the mapped schemas in place with a required enum property, so that TypeScript can narrow\n * the generated union. The behavior and the warning text match the original `scanDiscriminators`.\n */\n\ntype DiscriminatorMapping = Record<string, { inferred?: string; defined?: string[] }>;\n\n/** How to scan; `fixesValueConflicts` is the `discriminator-values` fix (ADR-021, roadmap R12). */\nexport interface DiscriminatorScanOptions {\n  readonly silent: boolean;\n  readonly logger: Logger;\n  readonly fixesValueConflicts: boolean;\n}\n\n/** What the two passes share: the document they patch and what they found so far. */\ninterface ScanState extends DiscriminatorScanOptions {\n  readonly schema: OpenAPI3;\n  readonly objects: Record<string, DiscriminatorObject>;\n  readonly refsHandled: string[];\n  /** With the fix: the enum added to each schema, by schema and property, so values merge. */\n  readonly patchedEnums: Map<string, SchemaObject>;\n  /** With the fix: schema-name values, applied after both passes where no mapping names one. */\n  readonly inferredPatches: EnumPatch[];\n}\n\n/** The enum the schema at `patch.ref` gets, or null (with a warning) for another kind of schema. */\nfunction addDiscriminatorEnum(state: ScanState, patch: EnumPatch): SchemaObject | null {\n  const { silent, logger } = state;\n  const resolved = resolveDocumentRef<SchemaObject>(state.schema, patch.ref, { silent, logger });\n  const added = addEnumProperty(resolved, patch);\n  if (added === null) {\n    warnInvalidMapping(patch, state.logger);\n  }\n  return added;\n}\n\n/** One schema and discriminator property; two discriminators of one property share an enum. */\nfunction enumKey(patch: EnumPatch): string {\n  return `${patch.ref}\\n${patch.discriminator.propertyName}`;\n}\n\n/** With the fix, a second discriminator of the same property adds its values to the first enum. */\nfunction mergeIntoPatchedEnum(state: ScanState, key: string, values: readonly string[]): boolean {\n  const patched = state.patchedEnums.get(key);\n  if (patched === undefined) {\n    return false;\n  }\n  const merged = patched.enum as unknown[];\n  merged.push(...values.filter((value) => !merged.includes(value)));\n  return true;\n}\n\n/**\n * Add or replace the discriminator enum in the schema at `patch.ref`. Returns false, with a\n * warning, when that schema is neither an `allOf` nor an object schema. Without the fix every\n * patch adds a property, so two discriminators with different values intersect to `never`.\n */\nfunction patchDiscriminatorEnum(state: ScanState, patch: EnumPatch): boolean {\n  if (!state.fixesValueConflicts) {\n    return addDiscriminatorEnum(state, patch) !== null;\n  }\n  const key = enumKey(patch);\n  if (mergeIntoPatchedEnum(state, key, patch.values)) {\n    return true;\n  }\n  const added = addDiscriminatorEnum(state, patch);\n  if (added !== null) {\n    state.patchedEnums.set(key, added);\n  }\n  return added !== null;\n}\n\nfunction markHandled(state: ScanState, ref: string): void {\n  if (!state.refsHandled.includes(ref)) {\n    state.refsHandled.push(ref);\n  }\n}\n\nfunction warnInvalidMapping(patch: EnumPatch, logger: Logger): void {\n  const mapped = `${patch.ref} => ${patch.values.join(\", \")}`;\n  logger.warn(\n    \"Discriminator mapping has an invalid schema (neither an object schema nor an allOf array): \" +\n      `${mapped} (Discriminator: ${patch.discriminatorRef})`,\n  );\n}\n\n/** The schema name at the end of each `oneOf` `$ref` is the inferred discriminator value. */\nfunction inferredMapping(oneOf: (SchemaObject | ReferenceObject)[]): DiscriminatorMapping {\n  const mapping: DiscriminatorMapping = {};\n  for (const item of oneOf) {\n    if (!(\"$ref\" in item)) {\n      continue;\n    }\n    const value = item.$ref.split(\"/\").pop();\n    if (value) {\n      mapping[item.$ref] = { ...mapping[item.$ref], inferred: value };\n    }\n  }\n  return mapping;\n}\n\n/** Values defined in `discriminator.mapping` replace inferred ones for the same schema. */\nfunction addDefinedMapping(\n  mapping: DiscriminatorMapping,\n  discriminator: DiscriminatorObject,\n): void {\n  for (const [mappedValue, mappedRef] of Object.entries(discriminator.mapping ?? {})) {\n    if (!mappedRef) {\n      continue;\n    }\n    if (!mapping[mappedRef]?.defined) {\n      mapping[mappedRef] = { defined: [] };\n    }\n    mapping[mappedRef].defined?.push(mappedValue);\n  }\n}\n\nfunction patchMappedSchemas(\n  state: ScanState,\n  mapping: DiscriminatorMapping,\n  discriminator: Omit<EnumPatch, \"ref\" | \"values\">,\n): void {\n  for (const [ref, { inferred, defined }] of Object.entries(mapping)) {\n    const isSkipped = !state.fixesValueConflicts && state.refsHandled.includes(ref);\n    if (isSkipped || (!inferred && !defined)) {\n      continue;\n    }\n    // A defined value wins: the schema name may not be the value the API sends.\n    const values = defined ?? [inferred as string];\n    if (state.fixesValueConflicts && defined === undefined) {\n      // A mapping found later, in this pass or the next, may name the schema.\n      state.inferredPatches.push({ ...discriminator, ref, values });\n    } else if (patchDiscriminatorEnum(state, { ...discriminator, ref, values })) {\n      markHandled(state, ref);\n    }\n  }\n}\n\n/** Pass 1: collect every discriminator; patch the schemas of a discriminator + `oneOf`. */\nfunction collectDiscriminator(\n  state: ScanState,\n  value: Record<string, unknown>,\n  path: (string | number)[],\n): void {\n  const discriminator = value.discriminator as DiscriminatorObject | undefined;\n  if (!discriminator?.propertyName) {\n    return;\n  }\n  const discriminatorRef = createRef(path);\n  state.objects[discriminatorRef] = discriminator;\n  if (!Array.isArray(value.oneOf)) {\n    return;\n  }\n  const mapping = inferredMapping(value.oneOf);\n  if (discriminator.mapping) {\n    addDefinedMapping(mapping, discriminator);\n  }\n  patchMappedSchemas(state, mapping, { discriminator, discriminatorRef });\n}\n\n/** The mapping keys of `discriminator` that point at `ref`. */\nfunction valuesMappedTo(discriminator: DiscriminatorObject, ref: string): string[] {\n  return Object.entries(discriminator.mapping ?? {})\n    .filter(([, mappedRef]) => mappedRef === ref)\n    .map(([mappedValue]) => mappedValue);\n}\n\n/**\n * An `allOf` item that is a `$ref` to a discriminator owner: the schema at `ref` inherits the\n * discriminator, and gets its enum when the parent's mapping names it. Returns false when the\n * `$ref` owns no discriminator, which ends the scan of this `allOf` (as in the original).\n */\nfunction inheritFromRef(state: ScanState, parentRef: string, ref: string): boolean {\n  const discriminator = state.objects[parentRef];\n  if (!discriminator) {\n    return false;\n  }\n  const values = valuesMappedTo(discriminator, ref);\n  const patch = { ref, values, discriminator, discriminatorRef: parentRef };\n  if (values.length > 0 && patchDiscriminatorEnum(state, patch)) {\n    markHandled(state, ref);\n  }\n  state.objects[ref] = { ...discriminator };\n  return true;\n}\n\n/** Pass 2: a schema whose `allOf` holds a discriminator, or a `$ref` to one, inherits it. */\nfunction inheritDiscriminators(\n  state: ScanState,\n  value: Record<string, unknown>,\n  path: (string | number)[],\n): void {\n  if (!Array.isArray(value.allOf)) {\n    return;\n  }\n  for (const item of value.allOf as (SchemaObject | ReferenceObject)[]) {\n    if (\"$ref\" in item) {\n      if (!inheritFromRef(state, item.$ref, createRef(path))) {\n        return;\n      }\n    } else if (item.discriminator?.propertyName) {\n      state.objects[createRef(path)] = { ...item.discriminator };\n    }\n  }\n}\n\n/** The discriminators of a bundled document, after patching the mapped schemas in place. */\nexport interface DiscriminatorScan {\n  objects: Record<string, DiscriminatorObject>;\n  refsHandled: string[];\n}\n\n/**\n * With the fix: a schema-name value, only for a schema and property that no mapping gave a value.\n * Every enum patched so far came from a mapping, since schema-name values wait for this step.\n */\nfunction applyInferredPatches(state: ScanState): void {\n  const mapped = new Set(state.patchedEnums.keys());\n  for (const patch of state.inferredPatches) {\n    if (!mapped.has(enumKey(patch)) && patchDiscriminatorEnum(state, patch)) {\n      markHandled(state, patch.ref);\n    }\n  }\n}\n\n/** Find every discriminator in `schema`; warnings go to `logger` unless `silent`. */\nexport function findDiscriminators(\n  schema: OpenAPI3,\n  options: DiscriminatorScanOptions,\n): DiscriminatorScan {\n  const state: ScanState = {\n    ...options,\n    schema,\n    objects: {},\n    refsHandled: [],\n    patchedEnums: new Map(),\n    inferredPatches: [],\n  };\n  walkDocument(schema, (value, path) => collectDiscriminator(state, value, path));\n  // A second pass, because an `allOf` may name a discriminator that is defined later.\n  walkDocument(schema, (value, path) => inheritDiscriminators(state, value, path));\n  applyInferredPatches(state);\n  return { objects: state.objects, refsHandled: state.refsHandled };\n}\n\n/**\n * Return a key–value map of discriminator objects found in a schema. Warnings go to `logger`;\n * without one, to the default terminal logger, as the original did.\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function scanDiscriminators(\n  schema: OpenAPI3,\n  options: GeneratorOptions,\n  logger: Logger = defaultLogger(options.silent ?? false),\n): DiscriminatorScan {\n  const silent = options.silent ?? false;\n  return findDiscriminators(schema, { silent, logger, fixesValueConflicts: false });\n}\n"],"names":[],"mappings":"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"}

package/dist/api/document-declarations.cjs

@@ -0,0 +1,28 @@
+'use strict';
+
+const loadTypescript = require('../adapters/type-ast-bridge/load-typescript.cjs');
+const printTypescript = require('../adapters/type-ast-bridge/print-typescript.cjs');
+const footerEntry = require('./footer-entry.cjs');
+
+function withoutFinalLineBreak(text) {
+  return text.endsWith("\n") ? text.slice(0, -1) : text;
+}
+function printedNode(node) {
+  return {
+    kind: "rawDeclaration",
+    text: withoutFinalLineBreak(printTypescript.printWithTypeScript(loadTypescript.loadTypeScript(), [node]))
+  };
+}
+function entryDeclaration(entry) {
+  return footerEntry.isIrDeclaration(entry) ? entry : printedNode(entry);
+}
+function documentDeclarations({
+  body,
+  footer,
+  closing
+}) {
+  return [...body, ...footer.map(entryDeclaration), ...closing];
+}
+
+exports.documentDeclarations = documentDeclarations;
+//# sourceMappingURL=document-declarations.cjs.map

package/dist/api/document-declarations.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-declarations.cjs","sources":["../../src/api/document-declarations.ts"],"sourcesContent":["import { loadTypeScript } from \"../adapters/type-ast-bridge/load-typescript.js\";\nimport { printWithTypeScript } from \"../adapters/type-ast-bridge/print-typescript.js\";\nimport type { ts } from \"../adapters/type-ast-bridge/typescript-types.js\";\nimport type { IrDeclaration } from \"../domain/ir/nodes.js\";\nimport { type FooterEntry, isIrDeclaration } from \"./footer-entry.js\";\n\n/** The document in three parts; the footer may hold TypeScript nodes from user code. */\nexport interface TransformedDocument {\n  readonly body: readonly IrDeclaration[];\n  readonly footer: readonly FooterEntry[];\n  readonly closing: readonly IrDeclaration[];\n}\n\n/** The TypeScript printer ends the file with a line break; a raw declaration's text has none. */\nfunction withoutFinalLineBreak(text: string): string {\n  return text.endsWith(\"\\n\") ? text.slice(0, -1) : text;\n}\n\n/** A TypeScript node from user code, as the TypeScript printer prints it. */\nfunction printedNode(node: ts.Node): IrDeclaration {\n  return {\n    kind: \"rawDeclaration\",\n    text: withoutFinalLineBreak(printWithTypeScript(loadTypeScript(), [node])),\n  };\n}\n\nfunction entryDeclaration(entry: FooterEntry): IrDeclaration {\n  return isIrDeclaration(entry) ? entry : printedNode(entry);\n}\n\n/**\n * The document as IR declarations in output order. Footer TypeScript nodes from user code become\n * raw text through the bridge; raw text is printed as written (ADR-010, decision 4).\n */\nexport function documentDeclarations({\n  body,\n  footer,\n  closing,\n}: TransformedDocument): IrDeclaration[] {\n  return [...body, ...footer.map(entryDeclaration), ...closing];\n}\n"],"names":["printWithTypeScript","loadTypeScript","isIrDeclaration"],"mappings":";;;;;;AAcA,SAAS,sBAAsB,IAAA,EAAsB;AACnD,EAAA,OAAO,IAAA,CAAK,SAAS,IAAI,CAAA,GAAI,KAAK,KAAA,CAAM,CAAA,EAAG,EAAE,CAAA,GAAI,IAAA;AACnD;AAGA,SAAS,YAAY,IAAA,EAA8B;AACjD,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,gBAAA;AAAA,IACN,IAAA,EAAM,sBAAsBA,mCAAA,CAAoBC,6BAAA,IAAkB,CAAC,IAAI,CAAC,CAAC;AAAA,GAC3E;AACF;AAEA,SAAS,iBAAiB,KAAA,EAAmC;AAC3D,EAAA,OAAOC,2BAAA,CAAgB,KAAK,CAAA,GAAI,KAAA,GAAQ,YAAY,KAAK,CAAA;AAC3D;AAMO,SAAS,oBAAA,CAAqB;AAAA,EACnC,IAAA;AAAA,EACA,MAAA;AAAA,EACA;AACF,CAAA,EAAyC;AACvC,EAAA,OAAO,CAAC,GAAG,IAAA,EAAM,GAAG,OAAO,GAAA,CAAI,gBAAgB,CAAA,EAAG,GAAG,OAAO,CAAA;AAC9D;;"}

package/dist/api/document-declarations.mjs

@@ -0,0 +1,26 @@
+import { loadTypeScript } from '../adapters/type-ast-bridge/load-typescript.mjs';
+import { printWithTypeScript } from '../adapters/type-ast-bridge/print-typescript.mjs';
+import { isIrDeclaration } from './footer-entry.mjs';
+
+function withoutFinalLineBreak(text) {
+  return text.endsWith("\n") ? text.slice(0, -1) : text;
+}
+function printedNode(node) {
+  return {
+    kind: "rawDeclaration",
+    text: withoutFinalLineBreak(printWithTypeScript(loadTypeScript(), [node]))
+  };
+}
+function entryDeclaration(entry) {
+  return isIrDeclaration(entry) ? entry : printedNode(entry);
+}
+function documentDeclarations({
+  body,
+  footer,
+  closing
+}) {
+  return [...body, ...footer.map(entryDeclaration), ...closing];
+}
+
+export { documentDeclarations };
+//# sourceMappingURL=document-declarations.mjs.map

package/dist/api/document-declarations.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-declarations.mjs","sources":["../../src/api/document-declarations.ts"],"sourcesContent":["import { loadTypeScript } from \"../adapters/type-ast-bridge/load-typescript.js\";\nimport { printWithTypeScript } from \"../adapters/type-ast-bridge/print-typescript.js\";\nimport type { ts } from \"../adapters/type-ast-bridge/typescript-types.js\";\nimport type { IrDeclaration } from \"../domain/ir/nodes.js\";\nimport { type FooterEntry, isIrDeclaration } from \"./footer-entry.js\";\n\n/** The document in three parts; the footer may hold TypeScript nodes from user code. */\nexport interface TransformedDocument {\n  readonly body: readonly IrDeclaration[];\n  readonly footer: readonly FooterEntry[];\n  readonly closing: readonly IrDeclaration[];\n}\n\n/** The TypeScript printer ends the file with a line break; a raw declaration's text has none. */\nfunction withoutFinalLineBreak(text: string): string {\n  return text.endsWith(\"\\n\") ? text.slice(0, -1) : text;\n}\n\n/** A TypeScript node from user code, as the TypeScript printer prints it. */\nfunction printedNode(node: ts.Node): IrDeclaration {\n  return {\n    kind: \"rawDeclaration\",\n    text: withoutFinalLineBreak(printWithTypeScript(loadTypeScript(), [node])),\n  };\n}\n\nfunction entryDeclaration(entry: FooterEntry): IrDeclaration {\n  return isIrDeclaration(entry) ? entry : printedNode(entry);\n}\n\n/**\n * The document as IR declarations in output order. Footer TypeScript nodes from user code become\n * raw text through the bridge; raw text is printed as written (ADR-010, decision 4).\n */\nexport function documentDeclarations({\n  body,\n  footer,\n  closing,\n}: TransformedDocument): IrDeclaration[] {\n  return [...body, ...footer.map(entryDeclaration), ...closing];\n}\n"],"names":[],"mappings":";;;;AAcA,SAAS,sBAAsB,IAAA,EAAsB;AACnD,EAAA,OAAO,IAAA,CAAK,SAAS,IAAI,CAAA,GAAI,KAAK,KAAA,CAAM,CAAA,EAAG,EAAE,CAAA,GAAI,IAAA;AACnD;AAGA,SAAS,YAAY,IAAA,EAA8B;AACjD,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,gBAAA;AAAA,IACN,IAAA,EAAM,sBAAsB,mBAAA,CAAoB,cAAA,IAAkB,CAAC,IAAI,CAAC,CAAC;AAAA,GAC3E;AACF;AAEA,SAAS,iBAAiB,KAAA,EAAmC;AAC3D,EAAA,OAAO,eAAA,CAAgB,KAAK,CAAA,GAAI,KAAA,GAAQ,YAAY,KAAK,CAAA;AAC3D;AAMO,SAAS,oBAAA,CAAqB;AAAA,EACnC,IAAA;AAAA,EACA,MAAA;AAAA,EACA;AACF,CAAA,EAAyC;AACvC,EAAA,OAAO,CAAC,GAAG,IAAA,EAAM,GAAG,OAAO,GAAA,CAAI,gBAAgB,CAAA,EAAG,GAAG,OAAO,CAAA;AAC9D;;"}

package/dist/api/document-refs.cjs

@@ -0,0 +1,53 @@
+'use strict';
+
+const refUtils_js = require('@redocly/openapi-core/lib/ref-utils.js');
+const defaultPorts = require('./default-ports.cjs');
+
+function resolveDocumentRef(schema, $ref, options) {
+  const { visited = [] } = options;
+  const logger = options.logger ?? defaultPorts.defaultLogger(options.silent ?? false);
+  const { pointer } = refUtils_js.parseRef($ref);
+  if (!pointer.length) {
+    return void 0;
+  }
+  let node = schema;
+  for (const key of pointer) {
+    if (node && typeof node === "object" && node[key]) {
+      node = node[key];
+    } else {
+      logger.warn(`Could not resolve $ref "${$ref}"`);
+      return void 0;
+    }
+  }
+  if (node && typeof node === "object" && node.$ref) {
+    if (visited.includes(node.$ref)) {
+      logger.warn(`Could not resolve circular $ref "${$ref}"`);
+      return void 0;
+    }
+    return resolveDocumentRef(schema, node.$ref, {
+      ...options,
+      logger,
+      visited: [...visited, node.$ref]
+    });
+  }
+  return node;
+}
+function walkDocument(obj, cb, path = []) {
+  if (!obj || typeof obj !== "object") {
+    return;
+  }
+  if (Array.isArray(obj)) {
+    for (let i = 0; i < obj.length; i++) {
+      walkDocument(obj[i], cb, path.concat(i));
+    }
+    return;
+  }
+  cb(obj, path);
+  for (const k of Object.keys(obj)) {
+    walkDocument(obj[k], cb, path.concat(k));
+  }
+}
+
+exports.resolveDocumentRef = resolveDocumentRef;
+exports.walkDocument = walkDocument;
+//# sourceMappingURL=document-refs.cjs.map

package/dist/api/document-refs.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-refs.cjs","sources":["../../src/api/document-refs.ts"],"sourcesContent":["import { parseRef } from \"@redocly/openapi-core/lib/ref-utils.js\";\nimport type { Logger } from \"../application/ports/logger.js\";\nimport { defaultLogger } from \"./default-ports.js\";\n\n/** `$ref` resolution and the document walk that the generator's pre-pass uses. */\n\nexport interface ResolveRefOptions {\n  silent: boolean;\n  visited?: string[];\n  /** @internal Where warnings go; the default terminal logger (respecting `silent`) if absent. */\n  logger?: Logger;\n}\n\n/** Resolve a `$ref` in a document; warns and returns undefined when it cannot. */\nexport function resolveDocumentRef<T>(\n  schema: any,\n  $ref: string,\n  options: ResolveRefOptions,\n): T | undefined {\n  const { visited = [] } = options;\n  const logger = options.logger ?? defaultLogger(options.silent ?? false);\n  const { pointer } = parseRef($ref);\n  if (!pointer.length) {\n    return undefined;\n  }\n  let node = schema;\n  for (const key of pointer) {\n    if (node && typeof node === \"object\" && node[key]) {\n      node = node[key];\n    } else {\n      logger.warn(`Could not resolve $ref \"${$ref}\"`);\n      return undefined;\n    }\n  }\n\n  // if this is also a $ref, keep tracing\n  if (node && typeof node === \"object\" && node.$ref) {\n    if (visited.includes(node.$ref)) {\n      logger.warn(`Could not resolve circular $ref \"${$ref}\"`);\n      return undefined;\n    }\n    return resolveDocumentRef(schema, node.$ref, {\n      ...options,\n      logger,\n      visited: [...visited, node.$ref],\n    });\n  }\n\n  return node;\n}\n\n/** Call `cb` for every object in a JSON-serializable (non-circular) value, depth first. */\nexport function walkDocument(\n  obj: unknown,\n  cb: (value: Record<string, unknown>, path: (string | number)[]) => void,\n  path: (string | number)[] = [],\n): void {\n  if (!obj || typeof obj !== \"object\") {\n    return;\n  }\n  if (Array.isArray(obj)) {\n    for (let i = 0; i < obj.length; i++) {\n      walkDocument(obj[i], cb, path.concat(i));\n    }\n    return;\n  }\n  cb(obj as Record<string, unknown>, path);\n  for (const k of Object.keys(obj)) {\n    walkDocument((obj as Record<string, unknown>)[k], cb, path.concat(k));\n  }\n}\n"],"names":["defaultLogger","parseRef"],"mappings":";;;;;AAcO,SAAS,kBAAA,CACd,MAAA,EACA,IAAA,EACA,OAAA,EACe;AACf,EAAA,MAAM,EAAE,OAAA,GAAU,EAAC,EAAE,GAAI,OAAA;AACzB,EAAA,MAAM,SAAS,OAAA,CAAQ,MAAA,IAAUA,0BAAA,CAAc,OAAA,CAAQ,UAAU,KAAK,CAAA;AACtE,EAAA,MAAM,EAAE,OAAA,EAAQ,GAAIC,oBAAA,CAAS,IAAI,CAAA;AACjC,EAAA,IAAI,CAAC,QAAQ,MAAA,EAAQ;AACnB,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,IAAI,IAAA,GAAO,MAAA;AACX,EAAA,KAAA,MAAW,OAAO,OAAA,EAAS;AACzB,IAAA,IAAI,QAAQ,OAAO,IAAA,KAAS,QAAA,IAAY,IAAA,CAAK,GAAG,CAAA,EAAG;AACjD,MAAA,IAAA,GAAO,KAAK,GAAG,CAAA;AAAA,IACjB,CAAA,MAAO;AACL,MAAA,MAAA,CAAO,IAAA,CAAK,CAAA,wBAAA,EAA2B,IAAI,CAAA,CAAA,CAAG,CAAA;AAC9C,MAAA,OAAO,MAAA;AAAA,IACT;AAAA,EACF;AAGA,EAAA,IAAI,IAAA,IAAQ,OAAO,IAAA,KAAS,QAAA,IAAY,KAAK,IAAA,EAAM;AACjD,IAAA,IAAI,OAAA,CAAQ,QAAA,CAAS,IAAA,CAAK,IAAI,CAAA,EAAG;AAC/B,MAAA,MAAA,CAAO,IAAA,CAAK,CAAA,iCAAA,EAAoC,IAAI,CAAA,CAAA,CAAG,CAAA;AACvD,MAAA,OAAO,MAAA;AAAA,IACT;AACA,IAAA,OAAO,kBAAA,CAAmB,MAAA,EAAQ,IAAA,CAAK,IAAA,EAAM;AAAA,MAC3C,GAAG,OAAA;AAAA,MACH,MAAA;AAAA,MACA,OAAA,EAAS,CAAC,GAAG,OAAA,EAAS,KAAK,IAAI;AAAA,KAChC,CAAA;AAAA,EACH;AAEA,EAAA,OAAO,IAAA;AACT;AAGO,SAAS,YAAA,CACd,GAAA,EACA,EAAA,EACA,IAAA,GAA4B,EAAC,EACvB;AACN,EAAA,IAAI,CAAC,GAAA,IAAO,OAAO,GAAA,KAAQ,QAAA,EAAU;AACnC,IAAA;AAAA,EACF;AACA,EAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,GAAG,CAAA,EAAG;AACtB,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,GAAA,CAAI,QAAQ,CAAA,EAAA,EAAK;AACnC,MAAA,YAAA,CAAa,IAAI,CAAC,CAAA,EAAG,IAAI,IAAA,CAAK,MAAA,CAAO,CAAC,CAAC,CAAA;AAAA,IACzC;AACA,IAAA;AAAA,EACF;AACA,EAAA,EAAA,CAAG,KAAgC,IAAI,CAAA;AACvC,EAAA,KAAA,MAAW,CAAA,IAAK,MAAA,CAAO,IAAA,CAAK,GAAG,CAAA,EAAG;AAChC,IAAA,YAAA,CAAc,IAAgC,CAAC,CAAA,EAAG,IAAI,IAAA,CAAK,MAAA,CAAO,CAAC,CAAC,CAAA;AAAA,EACtE;AACF;;;"}

package/dist/api/document-refs.mjs

@@ -0,0 +1,50 @@
+import { parseRef } from '@redocly/openapi-core/lib/ref-utils.js';
+import { defaultLogger } from './default-ports.mjs';
+
+function resolveDocumentRef(schema, $ref, options) {
+  const { visited = [] } = options;
+  const logger = options.logger ?? defaultLogger(options.silent ?? false);
+  const { pointer } = parseRef($ref);
+  if (!pointer.length) {
+    return void 0;
+  }
+  let node = schema;
+  for (const key of pointer) {
+    if (node && typeof node === "object" && node[key]) {
+      node = node[key];
+    } else {
+      logger.warn(`Could not resolve $ref "${$ref}"`);
+      return void 0;
+    }
+  }
+  if (node && typeof node === "object" && node.$ref) {
+    if (visited.includes(node.$ref)) {
+      logger.warn(`Could not resolve circular $ref "${$ref}"`);
+      return void 0;
+    }
+    return resolveDocumentRef(schema, node.$ref, {
+      ...options,
+      logger,
+      visited: [...visited, node.$ref]
+    });
+  }
+  return node;
+}
+function walkDocument(obj, cb, path = []) {
+  if (!obj || typeof obj !== "object") {
+    return;
+  }
+  if (Array.isArray(obj)) {
+    for (let i = 0; i < obj.length; i++) {
+      walkDocument(obj[i], cb, path.concat(i));
+    }
+    return;
+  }
+  cb(obj, path);
+  for (const k of Object.keys(obj)) {
+    walkDocument(obj[k], cb, path.concat(k));
+  }
+}
+
+export { resolveDocumentRef, walkDocument };
+//# sourceMappingURL=document-refs.mjs.map

package/dist/api/document-refs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-refs.mjs","sources":["../../src/api/document-refs.ts"],"sourcesContent":["import { parseRef } from \"@redocly/openapi-core/lib/ref-utils.js\";\nimport type { Logger } from \"../application/ports/logger.js\";\nimport { defaultLogger } from \"./default-ports.js\";\n\n/** `$ref` resolution and the document walk that the generator's pre-pass uses. */\n\nexport interface ResolveRefOptions {\n  silent: boolean;\n  visited?: string[];\n  /** @internal Where warnings go; the default terminal logger (respecting `silent`) if absent. */\n  logger?: Logger;\n}\n\n/** Resolve a `$ref` in a document; warns and returns undefined when it cannot. */\nexport function resolveDocumentRef<T>(\n  schema: any,\n  $ref: string,\n  options: ResolveRefOptions,\n): T | undefined {\n  const { visited = [] } = options;\n  const logger = options.logger ?? defaultLogger(options.silent ?? false);\n  const { pointer } = parseRef($ref);\n  if (!pointer.length) {\n    return undefined;\n  }\n  let node = schema;\n  for (const key of pointer) {\n    if (node && typeof node === \"object\" && node[key]) {\n      node = node[key];\n    } else {\n      logger.warn(`Could not resolve $ref \"${$ref}\"`);\n      return undefined;\n    }\n  }\n\n  // if this is also a $ref, keep tracing\n  if (node && typeof node === \"object\" && node.$ref) {\n    if (visited.includes(node.$ref)) {\n      logger.warn(`Could not resolve circular $ref \"${$ref}\"`);\n      return undefined;\n    }\n    return resolveDocumentRef(schema, node.$ref, {\n      ...options,\n      logger,\n      visited: [...visited, node.$ref],\n    });\n  }\n\n  return node;\n}\n\n/** Call `cb` for every object in a JSON-serializable (non-circular) value, depth first. */\nexport function walkDocument(\n  obj: unknown,\n  cb: (value: Record<string, unknown>, path: (string | number)[]) => void,\n  path: (string | number)[] = [],\n): void {\n  if (!obj || typeof obj !== \"object\") {\n    return;\n  }\n  if (Array.isArray(obj)) {\n    for (let i = 0; i < obj.length; i++) {\n      walkDocument(obj[i], cb, path.concat(i));\n    }\n    return;\n  }\n  cb(obj as Record<string, unknown>, path);\n  for (const k of Object.keys(obj)) {\n    walkDocument((obj as Record<string, unknown>)[k], cb, path.concat(k));\n  }\n}\n"],"names":[],"mappings":";;;AAcO,SAAS,kBAAA,CACd,MAAA,EACA,IAAA,EACA,OAAA,EACe;AACf,EAAA,MAAM,EAAE,OAAA,GAAU,EAAC,EAAE,GAAI,OAAA;AACzB,EAAA,MAAM,SAAS,OAAA,CAAQ,MAAA,IAAU,aAAA,CAAc,OAAA,CAAQ,UAAU,KAAK,CAAA;AACtE,EAAA,MAAM,EAAE,OAAA,EAAQ,GAAI,QAAA,CAAS,IAAI,CAAA;AACjC,EAAA,IAAI,CAAC,QAAQ,MAAA,EAAQ;AACnB,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,IAAI,IAAA,GAAO,MAAA;AACX,EAAA,KAAA,MAAW,OAAO,OAAA,EAAS;AACzB,IAAA,IAAI,QAAQ,OAAO,IAAA,KAAS,QAAA,IAAY,IAAA,CAAK,GAAG,CAAA,EAAG;AACjD,MAAA,IAAA,GAAO,KAAK,GAAG,CAAA;AAAA,IACjB,CAAA,MAAO;AACL,MAAA,MAAA,CAAO,IAAA,CAAK,CAAA,wBAAA,EAA2B,IAAI,CAAA,CAAA,CAAG,CAAA;AAC9C,MAAA,OAAO,MAAA;AAAA,IACT;AAAA,EACF;AAGA,EAAA,IAAI,IAAA,IAAQ,OAAO,IAAA,KAAS,QAAA,IAAY,KAAK,IAAA,EAAM;AACjD,IAAA,IAAI,OAAA,CAAQ,QAAA,CAAS,IAAA,CAAK,IAAI,CAAA,EAAG;AAC/B,MAAA,MAAA,CAAO,IAAA,CAAK,CAAA,iCAAA,EAAoC,IAAI,CAAA,CAAA,CAAG,CAAA;AACvD,MAAA,OAAO,MAAA;AAAA,IACT;AACA,IAAA,OAAO,kBAAA,CAAmB,MAAA,EAAQ,IAAA,CAAK,IAAA,EAAM;AAAA,MAC3C,GAAG,OAAA;AAAA,MACH,MAAA;AAAA,MACA,OAAA,EAAS,CAAC,GAAG,OAAA,EAAS,KAAK,IAAI;AAAA,KAChC,CAAA;AAAA,EACH;AAEA,EAAA,OAAO,IAAA;AACT;AAGO,SAAS,YAAA,CACd,GAAA,EACA,EAAA,EACA,IAAA,GAA4B,EAAC,EACvB;AACN,EAAA,IAAI,CAAC,GAAA,IAAO,OAAO,GAAA,KAAQ,QAAA,EAAU;AACnC,IAAA;AAAA,EACF;AACA,EAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,GAAG,CAAA,EAAG;AACtB,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,GAAA,CAAI,QAAQ,CAAA,EAAA,EAAK;AACnC,MAAA,YAAA,CAAa,IAAI,CAAC,CAAA,EAAG,IAAI,IAAA,CAAK,MAAA,CAAO,CAAC,CAAC,CAAA;AAAA,IACzC;AACA,IAAA;AAAA,EACF;AACA,EAAA,EAAA,CAAG,KAAgC,IAAI,CAAA;AACvC,EAAA,KAAA,MAAW,CAAA,IAAK,MAAA,CAAO,IAAA,CAAK,GAAG,CAAA,EAAG;AAChC,IAAA,YAAA,CAAc,IAAgC,CAAC,CAAA,EAAG,IAAI,IAAA,CAAK,MAAA,CAAO,CAAC,CAAC,CAAA;AAAA,EACtE;AACF;;"}