openapi-typesafe 0.0.0 → 1.0.0-rc.1

package/dist/application/transform/ref-pointer/inline-cycles.mjs

@@ -0,0 +1,42 @@
+import { isJsonObject } from './generated-shape.mjs';
+import { refPointerOf, pointerNode } from './pointer-walk.mjs';
+import { typedWalk } from './typed-walk.mjs';
+
+function refsIn(node, found = []) {
+  if (Array.isArray(node)) {
+    for (const item of node) {
+      refsIn(item, found);
+    }
+  } else if (isJsonObject(node)) {
+    if (typeof node.$ref === "string") {
+      found.push(node.$ref);
+    }
+    for (const value of Object.values(node)) {
+      refsIn(value, found);
+    }
+  }
+  return found;
+}
+function isWrittenInline(ref, input) {
+  const pointer = refPointerOf(ref);
+  return pointer !== null && typedWalk({ pointer, ...input }).kind === "untyped";
+}
+function reachesOpenRef(ref, open, input) {
+  if (open.has(ref)) {
+    return open.get(ref) === true;
+  }
+  open.set(ref, true);
+  const pointer = refPointerOf(ref);
+  const target = pointer === null ? void 0 : pointerNode(pointer, input.refs);
+  const isCycle = refsIn(target).some(
+    (inner) => isWrittenInline(inner, input) && reachesOpenRef(inner, open, input)
+  );
+  open.set(ref, false);
+  return isCycle;
+}
+function hasInlineCycle(ref, options, refs) {
+  return reachesOpenRef(ref, /* @__PURE__ */ new Map(), { options, refs });
+}
+
+export { hasInlineCycle };
+//# sourceMappingURL=inline-cycles.mjs.map

package/dist/application/transform/ref-pointer/inline-cycles.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline-cycles.mjs","sources":["../../../../src/application/transform/ref-pointer/inline-cycles.ts"],"sourcesContent":["import type { RefResolver, SchemaOptions } from \"../schema/schema-context.js\";\nimport { isJsonObject } from \"./generated-shape.js\";\nimport { pointerNode, refPointerOf } from \"./pointer-walk.js\";\nimport { typedWalk } from \"./typed-walk.js\";\n\n/**\n * A `$ref` whose pointer crosses a segment with no type (`definitions/A`) is typed by writing its\n * target inline. If the target, directly or through other such `$ref`s, points back at itself,\n * writing it inline never ends; such a `$ref` keeps the original type.\n */\n\ninterface CycleInput {\n  readonly options: SchemaOptions;\n  readonly refs: RefResolver;\n}\n\nfunction refsIn(node: unknown, found: string[] = []): string[] {\n  if (Array.isArray(node)) {\n    for (const item of node) {\n      refsIn(item, found);\n    }\n  } else if (isJsonObject(node)) {\n    if (typeof node.$ref === \"string\") {\n      found.push(node.$ref);\n    }\n    for (const value of Object.values(node)) {\n      refsIn(value, found);\n    }\n  }\n  return found;\n}\n\nfunction isWrittenInline(ref: string, input: CycleInput): boolean {\n  const pointer = refPointerOf(ref);\n  return pointer !== null && typedWalk({ pointer, ...input }).kind === \"untyped\";\n}\n\n/** Depth-first search with the usual colors: a `$ref` met again while it is open is a cycle. */\nfunction reachesOpenRef(ref: string, open: Map<string, boolean>, input: CycleInput): boolean {\n  if (open.has(ref)) {\n    return open.get(ref) === true;\n  }\n  open.set(ref, true);\n  const pointer = refPointerOf(ref);\n  const target = pointer === null ? undefined : pointerNode(pointer, input.refs);\n  const isCycle = refsIn(target).some(\n    (inner) => isWrittenInline(inner, input) && reachesOpenRef(inner, open, input),\n  );\n  open.set(ref, false);\n  return isCycle;\n}\n\n/** Whether writing the target of `ref` inline would write it again inside itself. */\nexport function hasInlineCycle(ref: string, options: SchemaOptions, refs: RefResolver): boolean {\n  return reachesOpenRef(ref, new Map(), { options, refs });\n}\n"],"names":[],"mappings":";;;;AAgBA,SAAS,MAAA,CAAO,IAAA,EAAe,KAAA,GAAkB,EAAC,EAAa;AAC7D,EAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,IAAI,CAAA,EAAG;AACvB,IAAA,KAAA,MAAW,QAAQ,IAAA,EAAM;AACvB,MAAA,MAAA,CAAO,MAAM,KAAK,CAAA;AAAA,IACpB;AAAA,EACF,CAAA,MAAA,IAAW,YAAA,CAAa,IAAI,CAAA,EAAG;AAC7B,IAAA,IAAI,OAAO,IAAA,CAAK,IAAA,KAAS,QAAA,EAAU;AACjC,MAAA,KAAA,CAAM,IAAA,CAAK,KAAK,IAAI,CAAA;AAAA,IACtB;AACA,IAAA,KAAA,MAAW,KAAA,IAAS,MAAA,CAAO,MAAA,CAAO,IAAI,CAAA,EAAG;AACvC,MAAA,MAAA,CAAO,OAAO,KAAK,CAAA;AAAA,IACrB;AAAA,EACF;AACA,EAAA,OAAO,KAAA;AACT;AAEA,SAAS,eAAA,CAAgB,KAAa,KAAA,EAA4B;AAChE,EAAA,MAAM,OAAA,GAAU,aAAa,GAAG,CAAA;AAChC,EAAA,OAAO,OAAA,KAAY,QAAQ,SAAA,CAAU,EAAE,SAAS,GAAG,KAAA,EAAO,CAAA,CAAE,IAAA,KAAS,SAAA;AACvE;AAGA,SAAS,cAAA,CAAe,GAAA,EAAa,IAAA,EAA4B,KAAA,EAA4B;AAC3F,EAAA,IAAI,IAAA,CAAK,GAAA,CAAI,GAAG,CAAA,EAAG;AACjB,IAAA,OAAO,IAAA,CAAK,GAAA,CAAI,GAAG,CAAA,KAAM,IAAA;AAAA,EAC3B;AACA,EAAA,IAAA,CAAK,GAAA,CAAI,KAAK,IAAI,CAAA;AAClB,EAAA,MAAM,OAAA,GAAU,aAAa,GAAG,CAAA;AAChC,EAAA,MAAM,SAAS,OAAA,KAAY,IAAA,GAAO,SAAY,WAAA,CAAY,OAAA,EAAS,MAAM,IAAI,CAAA;AAC7E,EAAA,MAAM,OAAA,GAAU,MAAA,CAAO,MAAM,CAAA,CAAE,IAAA;AAAA,IAC7B,CAAC,UAAU,eAAA,CAAgB,KAAA,EAAO,KAAK,CAAA,IAAK,cAAA,CAAe,KAAA,EAAO,IAAA,EAAM,KAAK;AAAA,GAC/E;AACA,EAAA,IAAA,CAAK,GAAA,CAAI,KAAK,KAAK,CAAA;AACnB,EAAA,OAAO,OAAA;AACT;AAGO,SAAS,cAAA,CAAe,GAAA,EAAa,OAAA,EAAwB,IAAA,EAA4B;AAC9F,EAAA,OAAO,cAAA,CAAe,qBAAK,IAAI,GAAA,IAAO,EAAE,OAAA,EAAS,MAAM,CAAA;AACzD;;"}

package/dist/application/transform/ref-pointer/original-index.cjs

@@ -0,0 +1,62 @@
+'use strict';
+
+const generatedShape = require('./generated-shape.cjs');
+const pointerWalk = require('./pointer-walk.cjs');
+
+function schemaStep(walk, segment, isLast, input) {
+  if (segment === "properties") {
+    return { step: "continue", walk };
+  }
+  const member = generatedShape.generatedMember(walk.node, segment, input.options, input.refs);
+  if (member.kind === "missing") {
+    return { step: "fails", walk };
+  }
+  if (member.kind === "opaque") {
+    return { step: "compiles", walk };
+  }
+  const isAbsentValue = member.kind === "index" && member.node === void 0;
+  const isUnsafe = member.kind === "property" ? member.isOptional : isAbsentValue;
+  return {
+    step: isUnsafe && !isLast ? "fails" : "continue",
+    walk: { ...walk, node: member.node }
+  };
+}
+function containerStep(walk, index, input) {
+  const segment = input.pointer.segments[index];
+  const isLast = index === input.pointer.segments.length - 1;
+  const isOptional = segment === "requestBody" && pointerWalk.isOptionalRequestBody(walk.node, input.refs) || pointerWalk.isOptionalHeader(input.pointer, index, walk.node);
+  if (isOptional && !isLast) {
+    return { step: "fails", walk };
+  }
+  const child = generatedShape.isJsonObject(walk.node) ? generatedShape.followRefs(walk.node[segment], input.refs) : void 0;
+  return {
+    step: child === void 0 ? "compiles" : "continue",
+    walk: { ...walk, node: child }
+  };
+}
+function originalIndexFails(input) {
+  const { segments } = input.pointer;
+  let walk = {
+    node: pointerWalk.leadingNode(input.pointer, input.refs),
+    isSchema: pointerWalk.startsInSchema(input.pointer)
+  };
+  for (let index = pointerWalk.leadingSegmentsOf(input.pointer); index < segments.length; index++) {
+    const segment = segments[index];
+    const isLast = index === segments.length - 1;
+    if (!walk.isSchema && pointerWalk.isParameterList(input.pointer, index)) {
+      return true;
+    }
+    if (!walk.isSchema && pointerWalk.isTypedAsSchema(input.pointer, index) && generatedShape.isJsonObject(walk.node)) {
+      walk = { node: generatedShape.followRefs(walk.node.schema, input.refs), isSchema: true };
+    }
+    const result = walk.isSchema ? schemaStep(walk, segment, isLast, input) : containerStep(walk, index, input);
+    if (result.step !== "continue") {
+      return result.step === "fails";
+    }
+    walk = result.walk;
+  }
+  return false;
+}
+
+exports.originalIndexFails = originalIndexFails;
+//# sourceMappingURL=original-index.cjs.map

package/dist/application/transform/ref-pointer/original-index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"original-index.cjs","sources":["../../../../src/application/transform/ref-pointer/original-index.ts"],"sourcesContent":["import type { RefResolver, SchemaOptions } from \"../schema/schema-context.js\";\nimport { followRefs, generatedMember, isJsonObject } from \"./generated-shape.js\";\nimport {\n  isOptionalHeader,\n  isOptionalRequestBody,\n  isParameterList,\n  isTypedAsSchema,\n  leadingNode,\n  leadingSegmentsOf,\n  type RefPointer,\n  startsInSchema,\n} from \"./pointer-walk.js\";\n\n/**\n * Whether the type the original wrote for a `$ref` (`refType`: every segment indexed by name,\n * `properties` skipped) surely fails to compile. It walks the document as TypeScript walks the\n * generated types and answers true only where TypeScript reports an error for sure; where the\n * answer depends on a shape it does not model, it answers false, so that output stays as it was.\n */\n\ntype Step = \"fails\" | \"compiles\" | \"continue\";\n\ninterface OriginalWalk {\n  readonly node: unknown;\n  readonly isSchema: boolean;\n}\n\ninterface WalkInput {\n  readonly pointer: RefPointer;\n  readonly options: SchemaOptions;\n  readonly refs: RefResolver;\n}\n\nfunction schemaStep(walk: OriginalWalk, segment: string, isLast: boolean, input: WalkInput) {\n  if (segment === \"properties\") {\n    return { step: \"continue\" as Step, walk };\n  }\n  const member = generatedMember(walk.node, segment, input.options, input.refs);\n  if (member.kind === \"missing\") {\n    return { step: \"fails\" as Step, walk };\n  }\n  if (member.kind === \"opaque\") {\n    return { step: \"compiles\" as Step, walk };\n  }\n  const isAbsentValue = member.kind === \"index\" && member.node === undefined;\n  const isUnsafe = member.kind === \"property\" ? member.isOptional : isAbsentValue;\n  return {\n    step: (isUnsafe && !isLast ? \"fails\" : \"continue\") as Step,\n    walk: { ...walk, node: member.node },\n  };\n}\n\nfunction containerStep(walk: OriginalWalk, index: number, input: WalkInput) {\n  const segment = input.pointer.segments[index] as string;\n  const isLast = index === input.pointer.segments.length - 1;\n  const isOptional =\n    (segment === \"requestBody\" && isOptionalRequestBody(walk.node, input.refs)) ||\n    isOptionalHeader(input.pointer, index, walk.node);\n  if (isOptional && !isLast) {\n    return { step: \"fails\" as Step, walk };\n  }\n  const child = isJsonObject(walk.node) ? followRefs(walk.node[segment], input.refs) : undefined;\n  return {\n    step: (child === undefined ? \"compiles\" : \"continue\") as Step,\n    walk: { ...walk, node: child },\n  };\n}\n\n/** True when the original type of the `$ref` does not compile for sure. */\nexport function originalIndexFails(input: WalkInput): boolean {\n  const { segments } = input.pointer;\n  let walk: OriginalWalk = {\n    node: leadingNode(input.pointer, input.refs),\n    isSchema: startsInSchema(input.pointer),\n  };\n  for (let index = leadingSegmentsOf(input.pointer); index < segments.length; index++) {\n    const segment = segments[index] as string;\n    const isLast = index === segments.length - 1;\n    if (!walk.isSchema && isParameterList(input.pointer, index)) {\n      return true;\n    }\n    if (!walk.isSchema && isTypedAsSchema(input.pointer, index) && isJsonObject(walk.node)) {\n      // The container's type is its schema's type: the segment indexes that type.\n      walk = { node: followRefs(walk.node.schema, input.refs), isSchema: true };\n    }\n    const result = walk.isSchema\n      ? schemaStep(walk, segment, isLast, input)\n      : containerStep(walk, index, input);\n    if (result.step !== \"continue\") {\n      return result.step === \"fails\";\n    }\n    walk = result.walk;\n  }\n  return false;\n}\n"],"names":["generatedMember","isOptionalRequestBody","isOptionalHeader","isJsonObject","followRefs","leadingNode","startsInSchema","leadingSegmentsOf","isParameterList","isTypedAsSchema"],"mappings":"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"}

package/dist/application/transform/ref-pointer/original-index.mjs

@@ -0,0 +1,60 @@
+import { isJsonObject, followRefs, generatedMember } from './generated-shape.mjs';
+import { startsInSchema, leadingNode, leadingSegmentsOf, isParameterList, isTypedAsSchema, isOptionalRequestBody, isOptionalHeader } from './pointer-walk.mjs';
+
+function schemaStep(walk, segment, isLast, input) {
+  if (segment === "properties") {
+    return { step: "continue", walk };
+  }
+  const member = generatedMember(walk.node, segment, input.options, input.refs);
+  if (member.kind === "missing") {
+    return { step: "fails", walk };
+  }
+  if (member.kind === "opaque") {
+    return { step: "compiles", walk };
+  }
+  const isAbsentValue = member.kind === "index" && member.node === void 0;
+  const isUnsafe = member.kind === "property" ? member.isOptional : isAbsentValue;
+  return {
+    step: isUnsafe && !isLast ? "fails" : "continue",
+    walk: { ...walk, node: member.node }
+  };
+}
+function containerStep(walk, index, input) {
+  const segment = input.pointer.segments[index];
+  const isLast = index === input.pointer.segments.length - 1;
+  const isOptional = segment === "requestBody" && isOptionalRequestBody(walk.node, input.refs) || isOptionalHeader(input.pointer, index, walk.node);
+  if (isOptional && !isLast) {
+    return { step: "fails", walk };
+  }
+  const child = isJsonObject(walk.node) ? followRefs(walk.node[segment], input.refs) : void 0;
+  return {
+    step: child === void 0 ? "compiles" : "continue",
+    walk: { ...walk, node: child }
+  };
+}
+function originalIndexFails(input) {
+  const { segments } = input.pointer;
+  let walk = {
+    node: leadingNode(input.pointer, input.refs),
+    isSchema: startsInSchema(input.pointer)
+  };
+  for (let index = leadingSegmentsOf(input.pointer); index < segments.length; index++) {
+    const segment = segments[index];
+    const isLast = index === segments.length - 1;
+    if (!walk.isSchema && isParameterList(input.pointer, index)) {
+      return true;
+    }
+    if (!walk.isSchema && isTypedAsSchema(input.pointer, index) && isJsonObject(walk.node)) {
+      walk = { node: followRefs(walk.node.schema, input.refs), isSchema: true };
+    }
+    const result = walk.isSchema ? schemaStep(walk, segment, isLast, input) : containerStep(walk, index, input);
+    if (result.step !== "continue") {
+      return result.step === "fails";
+    }
+    walk = result.walk;
+  }
+  return false;
+}
+
+export { originalIndexFails };
+//# sourceMappingURL=original-index.mjs.map

package/dist/application/transform/ref-pointer/original-index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"original-index.mjs","sources":["../../../../src/application/transform/ref-pointer/original-index.ts"],"sourcesContent":["import type { RefResolver, SchemaOptions } from \"../schema/schema-context.js\";\nimport { followRefs, generatedMember, isJsonObject } from \"./generated-shape.js\";\nimport {\n  isOptionalHeader,\n  isOptionalRequestBody,\n  isParameterList,\n  isTypedAsSchema,\n  leadingNode,\n  leadingSegmentsOf,\n  type RefPointer,\n  startsInSchema,\n} from \"./pointer-walk.js\";\n\n/**\n * Whether the type the original wrote for a `$ref` (`refType`: every segment indexed by name,\n * `properties` skipped) surely fails to compile. It walks the document as TypeScript walks the\n * generated types and answers true only where TypeScript reports an error for sure; where the\n * answer depends on a shape it does not model, it answers false, so that output stays as it was.\n */\n\ntype Step = \"fails\" | \"compiles\" | \"continue\";\n\ninterface OriginalWalk {\n  readonly node: unknown;\n  readonly isSchema: boolean;\n}\n\ninterface WalkInput {\n  readonly pointer: RefPointer;\n  readonly options: SchemaOptions;\n  readonly refs: RefResolver;\n}\n\nfunction schemaStep(walk: OriginalWalk, segment: string, isLast: boolean, input: WalkInput) {\n  if (segment === \"properties\") {\n    return { step: \"continue\" as Step, walk };\n  }\n  const member = generatedMember(walk.node, segment, input.options, input.refs);\n  if (member.kind === \"missing\") {\n    return { step: \"fails\" as Step, walk };\n  }\n  if (member.kind === \"opaque\") {\n    return { step: \"compiles\" as Step, walk };\n  }\n  const isAbsentValue = member.kind === \"index\" && member.node === undefined;\n  const isUnsafe = member.kind === \"property\" ? member.isOptional : isAbsentValue;\n  return {\n    step: (isUnsafe && !isLast ? \"fails\" : \"continue\") as Step,\n    walk: { ...walk, node: member.node },\n  };\n}\n\nfunction containerStep(walk: OriginalWalk, index: number, input: WalkInput) {\n  const segment = input.pointer.segments[index] as string;\n  const isLast = index === input.pointer.segments.length - 1;\n  const isOptional =\n    (segment === \"requestBody\" && isOptionalRequestBody(walk.node, input.refs)) ||\n    isOptionalHeader(input.pointer, index, walk.node);\n  if (isOptional && !isLast) {\n    return { step: \"fails\" as Step, walk };\n  }\n  const child = isJsonObject(walk.node) ? followRefs(walk.node[segment], input.refs) : undefined;\n  return {\n    step: (child === undefined ? \"compiles\" : \"continue\") as Step,\n    walk: { ...walk, node: child },\n  };\n}\n\n/** True when the original type of the `$ref` does not compile for sure. */\nexport function originalIndexFails(input: WalkInput): boolean {\n  const { segments } = input.pointer;\n  let walk: OriginalWalk = {\n    node: leadingNode(input.pointer, input.refs),\n    isSchema: startsInSchema(input.pointer),\n  };\n  for (let index = leadingSegmentsOf(input.pointer); index < segments.length; index++) {\n    const segment = segments[index] as string;\n    const isLast = index === segments.length - 1;\n    if (!walk.isSchema && isParameterList(input.pointer, index)) {\n      return true;\n    }\n    if (!walk.isSchema && isTypedAsSchema(input.pointer, index) && isJsonObject(walk.node)) {\n      // The container's type is its schema's type: the segment indexes that type.\n      walk = { node: followRefs(walk.node.schema, input.refs), isSchema: true };\n    }\n    const result = walk.isSchema\n      ? schemaStep(walk, segment, isLast, input)\n      : containerStep(walk, index, input);\n    if (result.step !== \"continue\") {\n      return result.step === \"fails\";\n    }\n    walk = result.walk;\n  }\n  return false;\n}\n"],"names":[],"mappings":"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"}

package/dist/application/transform/ref-pointer/pointer-type.cjs

@@ -0,0 +1,60 @@
+'use strict';
+
+const constructors = require('../../../domain/ir/constructors.cjs');
+const outputFixes = require('../../../domain/output-fixes.cjs');
+const refType = require('../ref-type.cjs');
+const generatedLocation = require('./generated-location.cjs');
+const generatedShape = require('./generated-shape.cjs');
+const inlineCycles = require('./inline-cycles.cjs');
+const originalIndex = require('./original-index.cjs');
+const pointerWalk = require('./pointer-walk.cjs');
+const typedWalk = require('./typed-walk.cjs');
+
+function pointerOf(ref) {
+  const pointer = pointerWalk.refPointerOf(ref);
+  if (pointer === null) {
+    throw new refType.InvalidRefError(ref);
+  }
+  return pointer;
+}
+function targetType(ref, pointer, request, seen) {
+  const target = pointerWalk.pointerNode(pointer, request.context.refs);
+  if (generatedShape.isJsonObject(target) && typeof target.$ref === "string") {
+    return seen.includes(target.$ref) ? null : schemaRefType(target.$ref, request, [...seen, ref]);
+  }
+  if (target === void 0 || inlineCycles.hasInlineCycle(ref, request.context.options, request.context.refs)) {
+    return null;
+  }
+  const location = generatedLocation.generatedLocationOf(ref, request.context.refs);
+  return request.transformNested(
+    target,
+    { path: location.path, schema: target },
+    location.isFromAdditionalProperties
+  );
+}
+function correctedType(ref, pointer, request, seen) {
+  const { options, refs } = request.context;
+  const result = typedWalk.typedWalk({ pointer, options, refs });
+  return result.kind === "typed" ? result.walk.type : targetType(ref, pointer, request, seen);
+}
+function isCorrected(pointer, request) {
+  const { options, refs } = request.context;
+  return options.fixes.has(outputFixes.OutputFix.REF_POINTERS) || originalIndex.originalIndexFails({ pointer, options, refs });
+}
+function schemaRefType(ref, request, seen = []) {
+  const pointer = pointerOf(ref);
+  if (pointer.segments.length <= pointerWalk.leadingSegmentsOf(pointer) || !isCorrected(pointer, request)) {
+    return refType.refType(ref);
+  }
+  return correctedType(ref, pointer, request, seen) ?? refType.refType(ref);
+}
+function requirableRefType(ref, type, request) {
+  const { options, refs } = request.context;
+  const result = typedWalk.typedWalk({ pointer: pointerOf(ref), options, refs });
+  const isAbsent = result.kind === "typed" && result.walk.presence === "absent";
+  return isAbsent ? constructors.irReference("NonNullable", [type]) : type;
+}
+
+exports.requirableRefType = requirableRefType;
+exports.schemaRefType = schemaRefType;
+//# sourceMappingURL=pointer-type.cjs.map

package/dist/application/transform/ref-pointer/pointer-type.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer-type.cjs","sources":["../../../../src/application/transform/ref-pointer/pointer-type.ts"],"sourcesContent":["import { irReference } from \"../../../domain/ir/constructors.js\";\nimport type { IrType } from \"../../../domain/ir/nodes.js\";\nimport { OutputFix } from \"../../../domain/output-fixes.js\";\nimport { InvalidRefError, refType } from \"../ref-type.js\";\nimport type { SchemaRequest } from \"../schema/schema-rule.js\";\nimport { generatedLocationOf } from \"./generated-location.js\";\nimport { isJsonObject } from \"./generated-shape.js\";\nimport { hasInlineCycle } from \"./inline-cycles.js\";\nimport { originalIndexFails } from \"./original-index.js\";\nimport { leadingSegmentsOf, pointerNode, type RefPointer, refPointerOf } from \"./pointer-walk.js\";\nimport { typedWalk } from \"./typed-walk.js\";\n\n/**\n * The type of a schema `$ref` (ADR-026). The original indexed every segment of the pointer by\n * name (`refType`), also schema keywords the generated types do not have (`[\"schema\"]`,\n * `[\"items\"]`, `[\"allOf\"][\"0\"]`), and did not look through optional or nullable values. Where that\n * type does not compile, the `$ref` now gets the type of what it points at; where it compiles\n * (through an index signature), it stays, and the `ref-pointers` fix gives the right type there.\n */\n\nfunction pointerOf(ref: string): RefPointer {\n  const pointer = refPointerOf(ref);\n  if (pointer === null) {\n    throw new InvalidRefError(ref);\n  }\n  return pointer;\n}\n\n/** The target of a pointer that crosses a segment with no type: its `$ref`, or its own type. */\nfunction targetType(\n  ref: string,\n  pointer: RefPointer,\n  request: SchemaRequest,\n  seen: readonly string[],\n) {\n  const target = pointerNode(pointer, request.context.refs);\n  if (isJsonObject(target) && typeof target.$ref === \"string\") {\n    return seen.includes(target.$ref) ? null : schemaRefType(target.$ref, request, [...seen, ref]);\n  }\n  if (target === undefined || hasInlineCycle(ref, request.context.options, request.context.refs)) {\n    return null;\n  }\n  // Typed where the generator types the node, so it shares the node's enum (`--enum`).\n  const location = generatedLocationOf(ref, request.context.refs);\n  return request.transformNested(\n    target as never,\n    { path: location.path, schema: target },\n    location.isFromAdditionalProperties,\n  );\n}\n\nfunction correctedType(\n  ref: string,\n  pointer: RefPointer,\n  request: SchemaRequest,\n  seen: readonly string[],\n) {\n  const { options, refs } = request.context;\n  const result = typedWalk({ pointer, options, refs });\n  return result.kind === \"typed\" ? result.walk.type : targetType(ref, pointer, request, seen);\n}\n\nfunction isCorrected(pointer: RefPointer, request: SchemaRequest): boolean {\n  const { options, refs } = request.context;\n  return (\n    options.fixes.has(OutputFix.REF_POINTERS) || originalIndexFails({ pointer, options, refs })\n  );\n}\n\n/** The type of a schema `$ref`. Throws InvalidRefError when the `$ref` has no pointer. */\nexport function schemaRefType(\n  ref: string,\n  request: SchemaRequest,\n  seen: readonly string[] = [],\n): IrType {\n  const pointer = pointerOf(ref);\n  if (pointer.segments.length <= leadingSegmentsOf(pointer) || !isCorrected(pointer, request)) {\n    return refType(ref);\n  }\n  return correctedType(ref, pointer, request, seen) ?? refType(ref);\n}\n\n/**\n * The type of a `$ref` that `WithRequired` takes. A `$ref` to an optional or nullable value has\n * no keys (`keyof (T | undefined)` is `never`), so it is wrapped in `NonNullable` (TS2344).\n */\nexport function requirableRefType(ref: string, type: IrType, request: SchemaRequest): IrType {\n  const { options, refs } = request.context;\n  const result = typedWalk({ pointer: pointerOf(ref), options, refs });\n  const isAbsent = result.kind === \"typed\" && result.walk.presence === \"absent\";\n  return isAbsent ? irReference(\"NonNullable\", [type]) : type;\n}\n"],"names":["refPointerOf","InvalidRefError","pointerNode","isJsonObject","hasInlineCycle","generatedLocationOf","typedWalk","OutputFix","originalIndexFails","leadingSegmentsOf","refType","irReference"],"mappings":"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"}

package/dist/application/transform/ref-pointer/pointer-type.mjs

@@ -0,0 +1,57 @@
+import { irReference } from '../../../domain/ir/constructors.mjs';
+import { OutputFix } from '../../../domain/output-fixes.mjs';
+import { refType, InvalidRefError } from '../ref-type.mjs';
+import { generatedLocationOf } from './generated-location.mjs';
+import { isJsonObject } from './generated-shape.mjs';
+import { hasInlineCycle } from './inline-cycles.mjs';
+import { originalIndexFails } from './original-index.mjs';
+import { leadingSegmentsOf, refPointerOf, pointerNode } from './pointer-walk.mjs';
+import { typedWalk } from './typed-walk.mjs';
+
+function pointerOf(ref) {
+  const pointer = refPointerOf(ref);
+  if (pointer === null) {
+    throw new InvalidRefError(ref);
+  }
+  return pointer;
+}
+function targetType(ref, pointer, request, seen) {
+  const target = pointerNode(pointer, request.context.refs);
+  if (isJsonObject(target) && typeof target.$ref === "string") {
+    return seen.includes(target.$ref) ? null : schemaRefType(target.$ref, request, [...seen, ref]);
+  }
+  if (target === void 0 || hasInlineCycle(ref, request.context.options, request.context.refs)) {
+    return null;
+  }
+  const location = generatedLocationOf(ref, request.context.refs);
+  return request.transformNested(
+    target,
+    { path: location.path, schema: target },
+    location.isFromAdditionalProperties
+  );
+}
+function correctedType(ref, pointer, request, seen) {
+  const { options, refs } = request.context;
+  const result = typedWalk({ pointer, options, refs });
+  return result.kind === "typed" ? result.walk.type : targetType(ref, pointer, request, seen);
+}
+function isCorrected(pointer, request) {
+  const { options, refs } = request.context;
+  return options.fixes.has(OutputFix.REF_POINTERS) || originalIndexFails({ pointer, options, refs });
+}
+function schemaRefType(ref, request, seen = []) {
+  const pointer = pointerOf(ref);
+  if (pointer.segments.length <= leadingSegmentsOf(pointer) || !isCorrected(pointer, request)) {
+    return refType(ref);
+  }
+  return correctedType(ref, pointer, request, seen) ?? refType(ref);
+}
+function requirableRefType(ref, type, request) {
+  const { options, refs } = request.context;
+  const result = typedWalk({ pointer: pointerOf(ref), options, refs });
+  const isAbsent = result.kind === "typed" && result.walk.presence === "absent";
+  return isAbsent ? irReference("NonNullable", [type]) : type;
+}
+
+export { requirableRefType, schemaRefType };
+//# sourceMappingURL=pointer-type.mjs.map

package/dist/application/transform/ref-pointer/pointer-type.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer-type.mjs","sources":["../../../../src/application/transform/ref-pointer/pointer-type.ts"],"sourcesContent":["import { irReference } from \"../../../domain/ir/constructors.js\";\nimport type { IrType } from \"../../../domain/ir/nodes.js\";\nimport { OutputFix } from \"../../../domain/output-fixes.js\";\nimport { InvalidRefError, refType } from \"../ref-type.js\";\nimport type { SchemaRequest } from \"../schema/schema-rule.js\";\nimport { generatedLocationOf } from \"./generated-location.js\";\nimport { isJsonObject } from \"./generated-shape.js\";\nimport { hasInlineCycle } from \"./inline-cycles.js\";\nimport { originalIndexFails } from \"./original-index.js\";\nimport { leadingSegmentsOf, pointerNode, type RefPointer, refPointerOf } from \"./pointer-walk.js\";\nimport { typedWalk } from \"./typed-walk.js\";\n\n/**\n * The type of a schema `$ref` (ADR-026). The original indexed every segment of the pointer by\n * name (`refType`), also schema keywords the generated types do not have (`[\"schema\"]`,\n * `[\"items\"]`, `[\"allOf\"][\"0\"]`), and did not look through optional or nullable values. Where that\n * type does not compile, the `$ref` now gets the type of what it points at; where it compiles\n * (through an index signature), it stays, and the `ref-pointers` fix gives the right type there.\n */\n\nfunction pointerOf(ref: string): RefPointer {\n  const pointer = refPointerOf(ref);\n  if (pointer === null) {\n    throw new InvalidRefError(ref);\n  }\n  return pointer;\n}\n\n/** The target of a pointer that crosses a segment with no type: its `$ref`, or its own type. */\nfunction targetType(\n  ref: string,\n  pointer: RefPointer,\n  request: SchemaRequest,\n  seen: readonly string[],\n) {\n  const target = pointerNode(pointer, request.context.refs);\n  if (isJsonObject(target) && typeof target.$ref === \"string\") {\n    return seen.includes(target.$ref) ? null : schemaRefType(target.$ref, request, [...seen, ref]);\n  }\n  if (target === undefined || hasInlineCycle(ref, request.context.options, request.context.refs)) {\n    return null;\n  }\n  // Typed where the generator types the node, so it shares the node's enum (`--enum`).\n  const location = generatedLocationOf(ref, request.context.refs);\n  return request.transformNested(\n    target as never,\n    { path: location.path, schema: target },\n    location.isFromAdditionalProperties,\n  );\n}\n\nfunction correctedType(\n  ref: string,\n  pointer: RefPointer,\n  request: SchemaRequest,\n  seen: readonly string[],\n) {\n  const { options, refs } = request.context;\n  const result = typedWalk({ pointer, options, refs });\n  return result.kind === \"typed\" ? result.walk.type : targetType(ref, pointer, request, seen);\n}\n\nfunction isCorrected(pointer: RefPointer, request: SchemaRequest): boolean {\n  const { options, refs } = request.context;\n  return (\n    options.fixes.has(OutputFix.REF_POINTERS) || originalIndexFails({ pointer, options, refs })\n  );\n}\n\n/** The type of a schema `$ref`. Throws InvalidRefError when the `$ref` has no pointer. */\nexport function schemaRefType(\n  ref: string,\n  request: SchemaRequest,\n  seen: readonly string[] = [],\n): IrType {\n  const pointer = pointerOf(ref);\n  if (pointer.segments.length <= leadingSegmentsOf(pointer) || !isCorrected(pointer, request)) {\n    return refType(ref);\n  }\n  return correctedType(ref, pointer, request, seen) ?? refType(ref);\n}\n\n/**\n * The type of a `$ref` that `WithRequired` takes. A `$ref` to an optional or nullable value has\n * no keys (`keyof (T | undefined)` is `never`), so it is wrapped in `NonNullable` (TS2344).\n */\nexport function requirableRefType(ref: string, type: IrType, request: SchemaRequest): IrType {\n  const { options, refs } = request.context;\n  const result = typedWalk({ pointer: pointerOf(ref), options, refs });\n  const isAbsent = result.kind === \"typed\" && result.walk.presence === \"absent\";\n  return isAbsent ? irReference(\"NonNullable\", [type]) : type;\n}\n"],"names":[],"mappings":"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"}

package/dist/application/transform/ref-pointer/pointer-walk.cjs

@@ -0,0 +1,66 @@
+'use strict';
+
+const jsonPointer = require('../../../domain/openapi/json-pointer.cjs');
+const generatedShape = require('./generated-shape.cjs');
+
+const NAMED_ROOTS = /* @__PURE__ */ new Set(["paths", "webhooks"]);
+function leadingSegmentsOf(pointer) {
+  return NAMED_ROOTS.has(pointer.rootSegment) ? 1 : 2;
+}
+function refPointerOf(ref) {
+  const [rootSegment, ...segments] = jsonPointer.parseRefPointer(ref);
+  return rootSegment === void 0 ? null : { rootSegment, segments };
+}
+function leadingNode(pointer, refs) {
+  let node = refs.resolve(`#/${pointer.rootSegment}`);
+  for (const segment of pointer.segments.slice(0, leadingSegmentsOf(pointer))) {
+    node = generatedShape.isJsonObject(node) ? generatedShape.followRefs(node[segment], refs) : void 0;
+  }
+  return node;
+}
+function pointerNode(pointer, refs) {
+  let node = refs.resolve(`#/${pointer.rootSegment}`);
+  pointer.segments.forEach((segment, index) => {
+    const child = generatedShape.isJsonObject(node) || Array.isArray(node) ? node[segment] : void 0;
+    node = index === pointer.segments.length - 1 ? child : generatedShape.followRefs(child, refs);
+  });
+  return node;
+}
+function startsInSchema(pointer) {
+  return pointer.rootSegment === "components" && pointer.segments[0] === "schemas";
+}
+function isTypedAsSchema(pointer, index) {
+  const owner = pointer.segments[index - 2];
+  const isComponentParameter = pointer.rootSegment === "components" && index === 2 && owner === "parameters";
+  return owner === "content" || owner === "headers" || isComponentParameter;
+}
+function isParameterList(pointer, index) {
+  const next = pointer.segments[index + 1] ?? "";
+  return pointer.segments[index] === "parameters" && /^\d+$/.test(next);
+}
+function isOptionalHeader(pointer, index, headers) {
+  const isComponentHeader = pointer.rootSegment === "components" && index === 1;
+  if (pointer.segments[index - 1] !== "headers" || isComponentHeader || !generatedShape.isJsonObject(headers)) {
+    return false;
+  }
+  const header = headers[pointer.segments[index]];
+  return generatedShape.isJsonObject(header) && header.$ref === void 0 && header.required !== true;
+}
+function isOptionalRequestBody(container, refs) {
+  if (!generatedShape.isJsonObject(container) || container.requestBody === void 0) {
+    return false;
+  }
+  const body = generatedShape.followRefs(container.requestBody, refs);
+  return !(generatedShape.isJsonObject(body) && body.required === true);
+}
+
+exports.isOptionalHeader = isOptionalHeader;
+exports.isOptionalRequestBody = isOptionalRequestBody;
+exports.isParameterList = isParameterList;
+exports.isTypedAsSchema = isTypedAsSchema;
+exports.leadingNode = leadingNode;
+exports.leadingSegmentsOf = leadingSegmentsOf;
+exports.pointerNode = pointerNode;
+exports.refPointerOf = refPointerOf;
+exports.startsInSchema = startsInSchema;
+//# sourceMappingURL=pointer-walk.cjs.map

package/dist/application/transform/ref-pointer/pointer-walk.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer-walk.cjs","sources":["../../../../src/application/transform/ref-pointer/pointer-walk.ts"],"sourcesContent":["import { parseRefPointer } from \"../../../domain/openapi/json-pointer.js\";\nimport type { RefResolver } from \"../schema/schema-context.js\";\nimport { followRefs, isJsonObject } from \"./generated-shape.js\";\n\n/** The parts of a `$ref` pointer that both the original and the new types walk. */\n\nexport interface RefPointer {\n  readonly rootSegment: string;\n  /** The segments after the root: `#/components/schemas/A` gives `[\"schemas\", \"A\"]`. */\n  readonly segments: readonly string[];\n}\n\n/** Roots whose generated type is keyed by one segment: the path or webhook name. */\nconst NAMED_ROOTS: ReadonlySet<string> = new Set([\"paths\", \"webhooks\"]);\n\n/**\n * How many segments after the root index the generated root type directly: one for `paths` and\n * `webhooks` (`paths[\"/a\"]`, so the path item's own `parameters/0` is walked), two otherwise\n * (`components[\"schemas\"][\"A\"]`).\n */\nexport function leadingSegmentsOf(pointer: RefPointer): number {\n  return NAMED_ROOTS.has(pointer.rootSegment) ? 1 : 2;\n}\n\nexport function refPointerOf(ref: string): RefPointer | null {\n  const [rootSegment, ...segments] = parseRefPointer(ref);\n  return rootSegment === undefined ? null : { rootSegment, segments };\n}\n\n/** The document node at the end of the leading segments, `$ref`s followed. */\nexport function leadingNode(pointer: RefPointer, refs: RefResolver): unknown {\n  let node = refs.resolve(`#/${pointer.rootSegment}`);\n  for (const segment of pointer.segments.slice(0, leadingSegmentsOf(pointer))) {\n    node = isJsonObject(node) ? followRefs(node[segment], refs) : undefined;\n  }\n  return node;\n}\n\n/** The node at the whole pointer, without following a `$ref` at its end. */\nexport function pointerNode(pointer: RefPointer, refs: RefResolver): unknown {\n  let node = refs.resolve(`#/${pointer.rootSegment}`);\n  pointer.segments.forEach((segment, index) => {\n    const child = isJsonObject(node) || Array.isArray(node) ? (node as never)[segment] : undefined;\n    node = index === pointer.segments.length - 1 ? child : followRefs(child, refs);\n  });\n  return node;\n}\n\n/** Whether the leading segments name a component schema, so the walk starts inside a schema. */\nexport function startsInSchema(pointer: RefPointer): boolean {\n  return pointer.rootSegment === \"components\" && pointer.segments[0] === \"schemas\";\n}\n\n/**\n * Whether the container at `index` is typed as its `schema`: a media type\n * (`content/<media type>`), a header (`headers/<name>`) or a component parameter.\n */\nexport function isTypedAsSchema(pointer: RefPointer, index: number): boolean {\n  const owner = pointer.segments[index - 2];\n  const isComponentParameter =\n    pointer.rootSegment === \"components\" && index === 2 && owner === \"parameters\";\n  return owner === \"content\" || owner === \"headers\" || isComponentParameter;\n}\n\n/**\n * Whether the segment at `index` is an operation's or path item's `parameters` list, indexed by\n * position next. The generated type groups parameters by `in` (`query`, `path`), so it has no\n * member `0`.\n */\nexport function isParameterList(pointer: RefPointer, index: number): boolean {\n  const next = pointer.segments[index + 1] ?? \"\";\n  return pointer.segments[index] === \"parameters\" && /^\\d+$/.test(next);\n}\n\n/**\n * Whether the segment at `index` names a response header that is an optional member: one the\n * response lists without `required: true`. A `$ref` header counts as required, as the generated\n * type has it; a component header (`components/headers/<name>`) is a member of its own.\n */\nexport function isOptionalHeader(pointer: RefPointer, index: number, headers: unknown): boolean {\n  const isComponentHeader = pointer.rootSegment === \"components\" && index === 1;\n  if (pointer.segments[index - 1] !== \"headers\" || isComponentHeader || !isJsonObject(headers)) {\n    return false;\n  }\n  const header = headers[pointer.segments[index] as string];\n  return isJsonObject(header) && header.$ref === undefined && header.required !== true;\n}\n\n/** A `requestBody` the operation does not mark `required` is an optional member. */\nexport function isOptionalRequestBody(container: unknown, refs: RefResolver): boolean {\n  if (!isJsonObject(container) || container.requestBody === undefined) {\n    return false;\n  }\n  const body = followRefs(container.requestBody, refs);\n  return !(isJsonObject(body) && body.required === true);\n}\n"],"names":["parseRefPointer","isJsonObject","followRefs"],"mappings":"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"}

package/dist/application/transform/ref-pointer/pointer-walk.mjs

@@ -0,0 +1,56 @@
+import { parseRefPointer } from '../../../domain/openapi/json-pointer.mjs';
+import { isJsonObject, followRefs } from './generated-shape.mjs';
+
+const NAMED_ROOTS = /* @__PURE__ */ new Set(["paths", "webhooks"]);
+function leadingSegmentsOf(pointer) {
+  return NAMED_ROOTS.has(pointer.rootSegment) ? 1 : 2;
+}
+function refPointerOf(ref) {
+  const [rootSegment, ...segments] = parseRefPointer(ref);
+  return rootSegment === void 0 ? null : { rootSegment, segments };
+}
+function leadingNode(pointer, refs) {
+  let node = refs.resolve(`#/${pointer.rootSegment}`);
+  for (const segment of pointer.segments.slice(0, leadingSegmentsOf(pointer))) {
+    node = isJsonObject(node) ? followRefs(node[segment], refs) : void 0;
+  }
+  return node;
+}
+function pointerNode(pointer, refs) {
+  let node = refs.resolve(`#/${pointer.rootSegment}`);
+  pointer.segments.forEach((segment, index) => {
+    const child = isJsonObject(node) || Array.isArray(node) ? node[segment] : void 0;
+    node = index === pointer.segments.length - 1 ? child : followRefs(child, refs);
+  });
+  return node;
+}
+function startsInSchema(pointer) {
+  return pointer.rootSegment === "components" && pointer.segments[0] === "schemas";
+}
+function isTypedAsSchema(pointer, index) {
+  const owner = pointer.segments[index - 2];
+  const isComponentParameter = pointer.rootSegment === "components" && index === 2 && owner === "parameters";
+  return owner === "content" || owner === "headers" || isComponentParameter;
+}
+function isParameterList(pointer, index) {
+  const next = pointer.segments[index + 1] ?? "";
+  return pointer.segments[index] === "parameters" && /^\d+$/.test(next);
+}
+function isOptionalHeader(pointer, index, headers) {
+  const isComponentHeader = pointer.rootSegment === "components" && index === 1;
+  if (pointer.segments[index - 1] !== "headers" || isComponentHeader || !isJsonObject(headers)) {
+    return false;
+  }
+  const header = headers[pointer.segments[index]];
+  return isJsonObject(header) && header.$ref === void 0 && header.required !== true;
+}
+function isOptionalRequestBody(container, refs) {
+  if (!isJsonObject(container) || container.requestBody === void 0) {
+    return false;
+  }
+  const body = followRefs(container.requestBody, refs);
+  return !(isJsonObject(body) && body.required === true);
+}
+
+export { isOptionalHeader, isOptionalRequestBody, isParameterList, isTypedAsSchema, leadingNode, leadingSegmentsOf, pointerNode, refPointerOf, startsInSchema };
+//# sourceMappingURL=pointer-walk.mjs.map

package/dist/application/transform/ref-pointer/pointer-walk.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer-walk.mjs","sources":["../../../../src/application/transform/ref-pointer/pointer-walk.ts"],"sourcesContent":["import { parseRefPointer } from \"../../../domain/openapi/json-pointer.js\";\nimport type { RefResolver } from \"../schema/schema-context.js\";\nimport { followRefs, isJsonObject } from \"./generated-shape.js\";\n\n/** The parts of a `$ref` pointer that both the original and the new types walk. */\n\nexport interface RefPointer {\n  readonly rootSegment: string;\n  /** The segments after the root: `#/components/schemas/A` gives `[\"schemas\", \"A\"]`. */\n  readonly segments: readonly string[];\n}\n\n/** Roots whose generated type is keyed by one segment: the path or webhook name. */\nconst NAMED_ROOTS: ReadonlySet<string> = new Set([\"paths\", \"webhooks\"]);\n\n/**\n * How many segments after the root index the generated root type directly: one for `paths` and\n * `webhooks` (`paths[\"/a\"]`, so the path item's own `parameters/0` is walked), two otherwise\n * (`components[\"schemas\"][\"A\"]`).\n */\nexport function leadingSegmentsOf(pointer: RefPointer): number {\n  return NAMED_ROOTS.has(pointer.rootSegment) ? 1 : 2;\n}\n\nexport function refPointerOf(ref: string): RefPointer | null {\n  const [rootSegment, ...segments] = parseRefPointer(ref);\n  return rootSegment === undefined ? null : { rootSegment, segments };\n}\n\n/** The document node at the end of the leading segments, `$ref`s followed. */\nexport function leadingNode(pointer: RefPointer, refs: RefResolver): unknown {\n  let node = refs.resolve(`#/${pointer.rootSegment}`);\n  for (const segment of pointer.segments.slice(0, leadingSegmentsOf(pointer))) {\n    node = isJsonObject(node) ? followRefs(node[segment], refs) : undefined;\n  }\n  return node;\n}\n\n/** The node at the whole pointer, without following a `$ref` at its end. */\nexport function pointerNode(pointer: RefPointer, refs: RefResolver): unknown {\n  let node = refs.resolve(`#/${pointer.rootSegment}`);\n  pointer.segments.forEach((segment, index) => {\n    const child = isJsonObject(node) || Array.isArray(node) ? (node as never)[segment] : undefined;\n    node = index === pointer.segments.length - 1 ? child : followRefs(child, refs);\n  });\n  return node;\n}\n\n/** Whether the leading segments name a component schema, so the walk starts inside a schema. */\nexport function startsInSchema(pointer: RefPointer): boolean {\n  return pointer.rootSegment === \"components\" && pointer.segments[0] === \"schemas\";\n}\n\n/**\n * Whether the container at `index` is typed as its `schema`: a media type\n * (`content/<media type>`), a header (`headers/<name>`) or a component parameter.\n */\nexport function isTypedAsSchema(pointer: RefPointer, index: number): boolean {\n  const owner = pointer.segments[index - 2];\n  const isComponentParameter =\n    pointer.rootSegment === \"components\" && index === 2 && owner === \"parameters\";\n  return owner === \"content\" || owner === \"headers\" || isComponentParameter;\n}\n\n/**\n * Whether the segment at `index` is an operation's or path item's `parameters` list, indexed by\n * position next. The generated type groups parameters by `in` (`query`, `path`), so it has no\n * member `0`.\n */\nexport function isParameterList(pointer: RefPointer, index: number): boolean {\n  const next = pointer.segments[index + 1] ?? \"\";\n  return pointer.segments[index] === \"parameters\" && /^\\d+$/.test(next);\n}\n\n/**\n * Whether the segment at `index` names a response header that is an optional member: one the\n * response lists without `required: true`. A `$ref` header counts as required, as the generated\n * type has it; a component header (`components/headers/<name>`) is a member of its own.\n */\nexport function isOptionalHeader(pointer: RefPointer, index: number, headers: unknown): boolean {\n  const isComponentHeader = pointer.rootSegment === \"components\" && index === 1;\n  if (pointer.segments[index - 1] !== \"headers\" || isComponentHeader || !isJsonObject(headers)) {\n    return false;\n  }\n  const header = headers[pointer.segments[index] as string];\n  return isJsonObject(header) && header.$ref === undefined && header.required !== true;\n}\n\n/** A `requestBody` the operation does not mark `required` is an optional member. */\nexport function isOptionalRequestBody(container: unknown, refs: RefResolver): boolean {\n  if (!isJsonObject(container) || container.requestBody === undefined) {\n    return false;\n  }\n  const body = followRefs(container.requestBody, refs);\n  return !(isJsonObject(body) && body.required === true);\n}\n"],"names":[],"mappings":"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"}