openapi-typesafe 0.0.0 → 1.0.0-rc.0

package/dist/domain/openapi/alias-expansion.cjs

@@ -0,0 +1,50 @@
+'use strict';
+
+const ALIAS_EXPANSION_MIN_NODES = 1e6;
+const ALIAS_EXPANSION_MAX_RATIO = 100;
+function childrenOf(node) {
+  return Array.isArray(node) ? node : Object.values(node);
+}
+function isContainer(value) {
+  return typeof value === "object" && value !== null;
+}
+function sizeOf(node, sizes) {
+  return childrenOf(node).reduce(
+    (total, child) => total + (isContainer(child) ? sizes.get(child) ?? 1 : 1),
+    1
+  );
+}
+function countNodes(root) {
+  if (!isContainer(root)) {
+    return { stored: 1, expanded: 1 };
+  }
+  const sizes = /* @__PURE__ */ new Map();
+  const entered = /* @__PURE__ */ new Set();
+  const stack = [root];
+  while (stack.length > 0) {
+    const node = stack[stack.length - 1];
+    const isFirstVisit = !entered.has(node);
+    entered.add(node);
+    const pending = isFirstVisit ? childrenOf(node).filter((child) => isContainer(child) && !entered.has(child)) : [];
+    if (pending.length > 0) {
+      stack.push(...pending);
+      continue;
+    }
+    stack.pop();
+    sizes.set(node, sizeOf(node, sizes));
+  }
+  let stored = 0;
+  for (const node of sizes.keys()) {
+    stored += 1 + childrenOf(node).filter((child) => !isContainer(child)).length;
+  }
+  return { stored, expanded: sizes.get(root) ?? 1 };
+}
+function isAliasExpansionExcessive({ stored, expanded }) {
+  return expanded > Math.max(ALIAS_EXPANSION_MIN_NODES, stored * ALIAS_EXPANSION_MAX_RATIO);
+}
+
+exports.ALIAS_EXPANSION_MAX_RATIO = ALIAS_EXPANSION_MAX_RATIO;
+exports.ALIAS_EXPANSION_MIN_NODES = ALIAS_EXPANSION_MIN_NODES;
+exports.countNodes = countNodes;
+exports.isAliasExpansionExcessive = isAliasExpansionExcessive;
+//# sourceMappingURL=alias-expansion.cjs.map

package/dist/domain/openapi/alias-expansion.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"alias-expansion.cjs","sources":["../../../src/domain/openapi/alias-expansion.ts"],"sourcesContent":["/**\n * YAML aliases (`*name`) make the parsed document share objects. A \"billion laughs\" document,\n * where each level refers to the previous one ten times, parses into a few hundred objects that\n * every walk over the document (Redocly's resolver, the generator) visits as 10^9 nodes: the run\n * took minutes and ended with \"RangeError: Set maximum size exceeded\" (pre-beta test plan 10.2).\n * A document is refused when its aliases expand it far beyond what it stores.\n */\n\n/** Expansion below this many nodes is allowed whatever the ratio: large real documents pass. */\nexport const ALIAS_EXPANSION_MIN_NODES = 1_000_000;\n/** Real documents reuse anchors a few times; a bomb multiplies its size by orders of magnitude. */\nexport const ALIAS_EXPANSION_MAX_RATIO = 100;\n\nexport interface NodeCounts {\n  /** Nodes of the document as written: each object once, with its entries. */\n  readonly stored: number;\n  /** Nodes a walk visits when it follows every shared object again. */\n  readonly expanded: number;\n}\n\nfunction childrenOf(node: object): unknown[] {\n  return Array.isArray(node) ? node : Object.values(node);\n}\n\nfunction isContainer(value: unknown): value is object {\n  return typeof value === \"object\" && value !== null;\n}\n\n/** The expanded size of `node`, whose container children are all sized (or in a cycle). */\nfunction sizeOf(node: object, sizes: ReadonlyMap<object, number>): number {\n  return childrenOf(node).reduce<number>(\n    (total, child) => total + (isContainer(child) ? (sizes.get(child) ?? 1) : 1),\n    1,\n  );\n}\n\n/**\n * Count stored and expanded nodes without recursion (documents can be thousands of levels deep)\n * and without expanding: each shared object is sized once. A cycle counts its back edge once.\n */\nexport function countNodes(root: unknown): NodeCounts {\n  if (!isContainer(root)) {\n    return { stored: 1, expanded: 1 };\n  }\n  const sizes = new Map<object, number>();\n  const entered = new Set<object>();\n  const stack: object[] = [root];\n  while (stack.length > 0) {\n    const node = stack[stack.length - 1] as object;\n    const isFirstVisit = !entered.has(node);\n    entered.add(node);\n    const pending = isFirstVisit\n      ? childrenOf(node).filter((child) => isContainer(child) && !entered.has(child))\n      : [];\n    if (pending.length > 0) {\n      stack.push(...(pending as object[]));\n      continue;\n    }\n    stack.pop();\n    sizes.set(node, sizeOf(node, sizes));\n  }\n  let stored = 0;\n  for (const node of sizes.keys()) {\n    stored += 1 + childrenOf(node).filter((child) => !isContainer(child)).length;\n  }\n  return { stored, expanded: sizes.get(root) ?? 1 };\n}\n\n/** Whether the aliases of a parsed document expand it beyond the limits above. */\nexport function isAliasExpansionExcessive({ stored, expanded }: NodeCounts): boolean {\n  return expanded > Math.max(ALIAS_EXPANSION_MIN_NODES, stored * ALIAS_EXPANSION_MAX_RATIO);\n}\n"],"names":[],"mappings":";;AASO,MAAM,yBAAA,GAA4B;AAElC,MAAM,yBAAA,GAA4B;AASzC,SAAS,WAAW,IAAA,EAAyB;AAC3C,EAAA,OAAO,MAAM,OAAA,CAAQ,IAAI,IAAI,IAAA,GAAO,MAAA,CAAO,OAAO,IAAI,CAAA;AACxD;AAEA,SAAS,YAAY,KAAA,EAAiC;AACpD,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,IAAA;AAChD;AAGA,SAAS,MAAA,CAAO,MAAc,KAAA,EAA4C;AACxE,EAAA,OAAO,UAAA,CAAW,IAAI,CAAA,CAAE,MAAA;AAAA,IACtB,CAAC,KAAA,EAAO,KAAA,KAAU,KAAA,IAAS,WAAA,CAAY,KAAK,CAAA,GAAK,KAAA,CAAM,GAAA,CAAI,KAAK,CAAA,IAAK,CAAA,GAAK,CAAA,CAAA;AAAA,IAC1E;AAAA,GACF;AACF;AAMO,SAAS,WAAW,IAAA,EAA2B;AACpD,EAAA,IAAI,CAAC,WAAA,CAAY,IAAI,CAAA,EAAG;AACtB,IAAA,OAAO,EAAE,MAAA,EAAQ,CAAA,EAAG,QAAA,EAAU,CAAA,EAAE;AAAA,EAClC;AACA,EAAA,MAAM,KAAA,uBAAY,GAAA,EAAoB;AACtC,EAAA,MAAM,OAAA,uBAAc,GAAA,EAAY;AAChC,EAAA,MAAM,KAAA,GAAkB,CAAC,IAAI,CAAA;AAC7B,EAAA,OAAO,KAAA,CAAM,SAAS,CAAA,EAAG;AACvB,IAAA,MAAM,IAAA,GAAO,KAAA,CAAM,KAAA,CAAM,MAAA,GAAS,CAAC,CAAA;AACnC,IAAA,MAAM,YAAA,GAAe,CAAC,OAAA,CAAQ,GAAA,CAAI,IAAI,CAAA;AACtC,IAAA,OAAA,CAAQ,IAAI,IAAI,CAAA;AAChB,IAAA,MAAM,UAAU,YAAA,GACZ,UAAA,CAAW,IAAI,CAAA,CAAE,OAAO,CAAC,KAAA,KAAU,WAAA,CAAY,KAAK,KAAK,CAAC,OAAA,CAAQ,IAAI,KAAK,CAAC,IAC5E,EAAC;AACL,IAAA,IAAI,OAAA,CAAQ,SAAS,CAAA,EAAG;AACtB,MAAA,KAAA,CAAM,IAAA,CAAK,GAAI,OAAoB,CAAA;AACnC,MAAA;AAAA,IACF;AACA,IAAA,KAAA,CAAM,GAAA,EAAI;AACV,IAAA,KAAA,CAAM,GAAA,CAAI,IAAA,EAAM,MAAA,CAAO,IAAA,EAAM,KAAK,CAAC,CAAA;AAAA,EACrC;AACA,EAAA,IAAI,MAAA,GAAS,CAAA;AACb,EAAA,KAAA,MAAW,IAAA,IAAQ,KAAA,CAAM,IAAA,EAAK,EAAG;AAC/B,IAAA,MAAA,IAAU,CAAA,GAAI,UAAA,CAAW,IAAI,CAAA,CAAE,MAAA,CAAO,CAAC,KAAA,KAAU,CAAC,WAAA,CAAY,KAAK,CAAC,CAAA,CAAE,MAAA;AAAA,EACxE;AACA,EAAA,OAAO,EAAE,MAAA,EAAQ,QAAA,EAAU,MAAM,GAAA,CAAI,IAAI,KAAK,CAAA,EAAE;AAClD;AAGO,SAAS,yBAAA,CAA0B,EAAE,MAAA,EAAQ,QAAA,EAAS,EAAwB;AACnF,EAAA,OAAO,QAAA,GAAW,IAAA,CAAK,GAAA,CAAI,yBAAA,EAA2B,SAAS,yBAAyB,CAAA;AAC1F;;;;;"}

package/dist/domain/openapi/alias-expansion.mjs

@@ -0,0 +1,45 @@
+const ALIAS_EXPANSION_MIN_NODES = 1e6;
+const ALIAS_EXPANSION_MAX_RATIO = 100;
+function childrenOf(node) {
+  return Array.isArray(node) ? node : Object.values(node);
+}
+function isContainer(value) {
+  return typeof value === "object" && value !== null;
+}
+function sizeOf(node, sizes) {
+  return childrenOf(node).reduce(
+    (total, child) => total + (isContainer(child) ? sizes.get(child) ?? 1 : 1),
+    1
+  );
+}
+function countNodes(root) {
+  if (!isContainer(root)) {
+    return { stored: 1, expanded: 1 };
+  }
+  const sizes = /* @__PURE__ */ new Map();
+  const entered = /* @__PURE__ */ new Set();
+  const stack = [root];
+  while (stack.length > 0) {
+    const node = stack[stack.length - 1];
+    const isFirstVisit = !entered.has(node);
+    entered.add(node);
+    const pending = isFirstVisit ? childrenOf(node).filter((child) => isContainer(child) && !entered.has(child)) : [];
+    if (pending.length > 0) {
+      stack.push(...pending);
+      continue;
+    }
+    stack.pop();
+    sizes.set(node, sizeOf(node, sizes));
+  }
+  let stored = 0;
+  for (const node of sizes.keys()) {
+    stored += 1 + childrenOf(node).filter((child) => !isContainer(child)).length;
+  }
+  return { stored, expanded: sizes.get(root) ?? 1 };
+}
+function isAliasExpansionExcessive({ stored, expanded }) {
+  return expanded > Math.max(ALIAS_EXPANSION_MIN_NODES, stored * ALIAS_EXPANSION_MAX_RATIO);
+}
+
+export { ALIAS_EXPANSION_MAX_RATIO, ALIAS_EXPANSION_MIN_NODES, countNodes, isAliasExpansionExcessive };
+//# sourceMappingURL=alias-expansion.mjs.map

package/dist/domain/openapi/alias-expansion.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"alias-expansion.mjs","sources":["../../../src/domain/openapi/alias-expansion.ts"],"sourcesContent":["/**\n * YAML aliases (`*name`) make the parsed document share objects. A \"billion laughs\" document,\n * where each level refers to the previous one ten times, parses into a few hundred objects that\n * every walk over the document (Redocly's resolver, the generator) visits as 10^9 nodes: the run\n * took minutes and ended with \"RangeError: Set maximum size exceeded\" (pre-beta test plan 10.2).\n * A document is refused when its aliases expand it far beyond what it stores.\n */\n\n/** Expansion below this many nodes is allowed whatever the ratio: large real documents pass. */\nexport const ALIAS_EXPANSION_MIN_NODES = 1_000_000;\n/** Real documents reuse anchors a few times; a bomb multiplies its size by orders of magnitude. */\nexport const ALIAS_EXPANSION_MAX_RATIO = 100;\n\nexport interface NodeCounts {\n  /** Nodes of the document as written: each object once, with its entries. */\n  readonly stored: number;\n  /** Nodes a walk visits when it follows every shared object again. */\n  readonly expanded: number;\n}\n\nfunction childrenOf(node: object): unknown[] {\n  return Array.isArray(node) ? node : Object.values(node);\n}\n\nfunction isContainer(value: unknown): value is object {\n  return typeof value === \"object\" && value !== null;\n}\n\n/** The expanded size of `node`, whose container children are all sized (or in a cycle). */\nfunction sizeOf(node: object, sizes: ReadonlyMap<object, number>): number {\n  return childrenOf(node).reduce<number>(\n    (total, child) => total + (isContainer(child) ? (sizes.get(child) ?? 1) : 1),\n    1,\n  );\n}\n\n/**\n * Count stored and expanded nodes without recursion (documents can be thousands of levels deep)\n * and without expanding: each shared object is sized once. A cycle counts its back edge once.\n */\nexport function countNodes(root: unknown): NodeCounts {\n  if (!isContainer(root)) {\n    return { stored: 1, expanded: 1 };\n  }\n  const sizes = new Map<object, number>();\n  const entered = new Set<object>();\n  const stack: object[] = [root];\n  while (stack.length > 0) {\n    const node = stack[stack.length - 1] as object;\n    const isFirstVisit = !entered.has(node);\n    entered.add(node);\n    const pending = isFirstVisit\n      ? childrenOf(node).filter((child) => isContainer(child) && !entered.has(child))\n      : [];\n    if (pending.length > 0) {\n      stack.push(...(pending as object[]));\n      continue;\n    }\n    stack.pop();\n    sizes.set(node, sizeOf(node, sizes));\n  }\n  let stored = 0;\n  for (const node of sizes.keys()) {\n    stored += 1 + childrenOf(node).filter((child) => !isContainer(child)).length;\n  }\n  return { stored, expanded: sizes.get(root) ?? 1 };\n}\n\n/** Whether the aliases of a parsed document expand it beyond the limits above. */\nexport function isAliasExpansionExcessive({ stored, expanded }: NodeCounts): boolean {\n  return expanded > Math.max(ALIAS_EXPANSION_MIN_NODES, stored * ALIAS_EXPANSION_MAX_RATIO);\n}\n"],"names":[],"mappings":"AASO,MAAM,yBAAA,GAA4B;AAElC,MAAM,yBAAA,GAA4B;AASzC,SAAS,WAAW,IAAA,EAAyB;AAC3C,EAAA,OAAO,MAAM,OAAA,CAAQ,IAAI,IAAI,IAAA,GAAO,MAAA,CAAO,OAAO,IAAI,CAAA;AACxD;AAEA,SAAS,YAAY,KAAA,EAAiC;AACpD,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,IAAA;AAChD;AAGA,SAAS,MAAA,CAAO,MAAc,KAAA,EAA4C;AACxE,EAAA,OAAO,UAAA,CAAW,IAAI,CAAA,CAAE,MAAA;AAAA,IACtB,CAAC,KAAA,EAAO,KAAA,KAAU,KAAA,IAAS,WAAA,CAAY,KAAK,CAAA,GAAK,KAAA,CAAM,GAAA,CAAI,KAAK,CAAA,IAAK,CAAA,GAAK,CAAA,CAAA;AAAA,IAC1E;AAAA,GACF;AACF;AAMO,SAAS,WAAW,IAAA,EAA2B;AACpD,EAAA,IAAI,CAAC,WAAA,CAAY,IAAI,CAAA,EAAG;AACtB,IAAA,OAAO,EAAE,MAAA,EAAQ,CAAA,EAAG,QAAA,EAAU,CAAA,EAAE;AAAA,EAClC;AACA,EAAA,MAAM,KAAA,uBAAY,GAAA,EAAoB;AACtC,EAAA,MAAM,OAAA,uBAAc,GAAA,EAAY;AAChC,EAAA,MAAM,KAAA,GAAkB,CAAC,IAAI,CAAA;AAC7B,EAAA,OAAO,KAAA,CAAM,SAAS,CAAA,EAAG;AACvB,IAAA,MAAM,IAAA,GAAO,KAAA,CAAM,KAAA,CAAM,MAAA,GAAS,CAAC,CAAA;AACnC,IAAA,MAAM,YAAA,GAAe,CAAC,OAAA,CAAQ,GAAA,CAAI,IAAI,CAAA;AACtC,IAAA,OAAA,CAAQ,IAAI,IAAI,CAAA;AAChB,IAAA,MAAM,UAAU,YAAA,GACZ,UAAA,CAAW,IAAI,CAAA,CAAE,OAAO,CAAC,KAAA,KAAU,WAAA,CAAY,KAAK,KAAK,CAAC,OAAA,CAAQ,IAAI,KAAK,CAAC,IAC5E,EAAC;AACL,IAAA,IAAI,OAAA,CAAQ,SAAS,CAAA,EAAG;AACtB,MAAA,KAAA,CAAM,IAAA,CAAK,GAAI,OAAoB,CAAA;AACnC,MAAA;AAAA,IACF;AACA,IAAA,KAAA,CAAM,GAAA,EAAI;AACV,IAAA,KAAA,CAAM,GAAA,CAAI,IAAA,EAAM,MAAA,CAAO,IAAA,EAAM,KAAK,CAAC,CAAA;AAAA,EACrC;AACA,EAAA,IAAI,MAAA,GAAS,CAAA;AACb,EAAA,KAAA,MAAW,IAAA,IAAQ,KAAA,CAAM,IAAA,EAAK,EAAG;AAC/B,IAAA,MAAA,IAAU,CAAA,GAAI,UAAA,CAAW,IAAI,CAAA,CAAE,MAAA,CAAO,CAAC,KAAA,KAAU,CAAC,WAAA,CAAY,KAAK,CAAC,CAAA,CAAE,MAAA;AAAA,EACxE;AACA,EAAA,OAAO,EAAE,MAAA,EAAQ,QAAA,EAAU,MAAM,GAAA,CAAI,IAAI,KAAK,CAAA,EAAE;AAClD;AAGO,SAAS,yBAAA,CAA0B,EAAE,MAAA,EAAQ,QAAA,EAAS,EAAwB;AACnF,EAAA,OAAO,QAAA,GAAW,IAAA,CAAK,GAAA,CAAI,yBAAA,EAA2B,SAAS,yBAAyB,CAAA;AAC1F;;"}

package/dist/domain/openapi/binary-content.cjs

@@ -0,0 +1,48 @@
+'use strict';
+
+const BINARY_FORMAT = "binary";
+const TEXT_TOP_LEVEL_TYPE = "text";
+const APPLICATION_TOP_LEVEL_TYPE = "application";
+const TEXT_STRUCTURED_SYNTAXES = /* @__PURE__ */ new Set(["json", "xml", "yaml"]);
+const TEXT_APPLICATION_SUBTYPES = /* @__PURE__ */ new Set([
+  "ecmascript",
+  "graphql",
+  "javascript",
+  "json-seq",
+  "jsonl",
+  "sql",
+  "x-ndjson",
+  "x-www-form-urlencoded",
+  "x-yaml"
+]);
+const PARAMETER_SEPARATOR = ";";
+const SUBTYPE_SEPARATOR = "/";
+const SUFFIX_SEPARATOR = "+";
+function isTextualMediaType(mediaType) {
+  const essence = (mediaType.split(PARAMETER_SEPARATOR)[0] ?? "").trim().toLowerCase();
+  const [topLevelType, subtype] = essence.split(SUBTYPE_SEPARATOR);
+  if (topLevelType === void 0 || subtype === void 0) {
+    return false;
+  }
+  if (topLevelType === TEXT_TOP_LEVEL_TYPE) {
+    return true;
+  }
+  const suffix = subtype.slice(subtype.lastIndexOf(SUFFIX_SEPARATOR) + 1);
+  if (TEXT_STRUCTURED_SYNTAXES.has(subtype) || TEXT_STRUCTURED_SYNTAXES.has(suffix)) {
+    return true;
+  }
+  return topLevelType === APPLICATION_TOP_LEVEL_TYPE && TEXT_APPLICATION_SUBTYPES.has(subtype);
+}
+function isRawBinarySchema(schema) {
+  if (schema.contentEncoding !== void 0) {
+    return false;
+  }
+  if (schema.format === BINARY_FORMAT) {
+    return true;
+  }
+  return schema.contentMediaType !== void 0 && !isTextualMediaType(schema.contentMediaType);
+}
+
+exports.isRawBinarySchema = isRawBinarySchema;
+exports.isTextualMediaType = isTextualMediaType;
+//# sourceMappingURL=binary-content.cjs.map

package/dist/domain/openapi/binary-content.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary-content.cjs","sources":["../../../src/domain/openapi/binary-content.ts"],"sourcesContent":["import type { SchemaObject } from \"./schema-object.js\";\n\n/**\n * Which string schemas describe raw binary data, following \"Working with Binary Data\" of the\n * OpenAPI specification (3.1): `format: binary` in 3.0, a `contentMediaType` without a\n * `contentEncoding` in 3.1. `--binary-as-blob` types these as `Blob`.\n * https://spec.openapis.org/oas/v3.1.1.html#working-with-binary-data\n */\n\n/** The OpenAPI 3.0 format of unencoded octets (`byte` is base64 text). */\nconst BINARY_FORMAT = \"binary\";\n\n/** The top-level media type whose contents are always text (RFC 2046). */\nconst TEXT_TOP_LEVEL_TYPE = \"text\";\n\n/** The top-level media type of the text formats in `TEXT_APPLICATION_SUBTYPES`. */\nconst APPLICATION_TOP_LEVEL_TYPE = \"application\";\n\n/**\n * Text syntaxes, as a subtype (`application/json`) or a structured syntax suffix\n * (`application/problem+json`, `image/svg+xml`; RFC 6839, RFC 9512).\n */\nconst TEXT_STRUCTURED_SYNTAXES: ReadonlySet<string> = new Set([\"json\", \"xml\", \"yaml\"]);\n\n/** Other text formats under `application/`, registered or in common use. */\nconst TEXT_APPLICATION_SUBTYPES: ReadonlySet<string> = new Set([\n  \"ecmascript\",\n  \"graphql\",\n  \"javascript\",\n  \"json-seq\",\n  \"jsonl\",\n  \"sql\",\n  \"x-ndjson\",\n  \"x-www-form-urlencoded\",\n  \"x-yaml\",\n]);\n\nconst PARAMETER_SEPARATOR = \";\";\nconst SUBTYPE_SEPARATOR = \"/\";\nconst SUFFIX_SEPARATOR = \"+\";\n\n/**\n * Whether a media type's contents are text, so a string schema with it holds the text itself.\n * Parameters (`; charset=utf-8`) and case are ignored; a value without a subtype is not text.\n */\nexport function isTextualMediaType(mediaType: string): boolean {\n  const essence = (mediaType.split(PARAMETER_SEPARATOR)[0] ?? \"\").trim().toLowerCase();\n  const [topLevelType, subtype] = essence.split(SUBTYPE_SEPARATOR);\n  if (topLevelType === undefined || subtype === undefined) {\n    return false;\n  }\n  if (topLevelType === TEXT_TOP_LEVEL_TYPE) {\n    return true;\n  }\n  const suffix = subtype.slice(subtype.lastIndexOf(SUFFIX_SEPARATOR) + 1);\n  if (TEXT_STRUCTURED_SYNTAXES.has(subtype) || TEXT_STRUCTURED_SYNTAXES.has(suffix)) {\n    return true;\n  }\n  return topLevelType === APPLICATION_TOP_LEVEL_TYPE && TEXT_APPLICATION_SUBTYPES.has(subtype);\n}\n\n/**\n * Whether a schema describes raw (unencoded) binary data. Any `contentEncoding` means the value\n * is encoded text, so it wins over `format: binary`.\n */\nexport function isRawBinarySchema(schema: SchemaObject): boolean {\n  if (schema.contentEncoding !== undefined) {\n    return false;\n  }\n  if (schema.format === BINARY_FORMAT) {\n    return true;\n  }\n  return schema.contentMediaType !== undefined && !isTextualMediaType(schema.contentMediaType);\n}\n"],"names":[],"mappings":";;AAUA,MAAM,aAAA,GAAgB,QAAA;AAGtB,MAAM,mBAAA,GAAsB,MAAA;AAG5B,MAAM,0BAAA,GAA6B,aAAA;AAMnC,MAAM,2CAAgD,IAAI,GAAA,CAAI,CAAC,MAAA,EAAQ,KAAA,EAAO,MAAM,CAAC,CAAA;AAGrF,MAAM,yBAAA,uBAAqD,GAAA,CAAI;AAAA,EAC7D,YAAA;AAAA,EACA,SAAA;AAAA,EACA,YAAA;AAAA,EACA,UAAA;AAAA,EACA,OAAA;AAAA,EACA,KAAA;AAAA,EACA,UAAA;AAAA,EACA,uBAAA;AAAA,EACA;AACF,CAAC,CAAA;AAED,MAAM,mBAAA,GAAsB,GAAA;AAC5B,MAAM,iBAAA,GAAoB,GAAA;AAC1B,MAAM,gBAAA,GAAmB,GAAA;AAMlB,SAAS,mBAAmB,SAAA,EAA4B;AAC7D,EAAA,MAAM,OAAA,GAAA,CAAW,SAAA,CAAU,KAAA,CAAM,mBAAmB,CAAA,CAAE,CAAC,CAAA,IAAK,EAAA,EAAI,IAAA,EAAK,CAAE,WAAA,EAAY;AACnF,EAAA,MAAM,CAAC,YAAA,EAAc,OAAO,CAAA,GAAI,OAAA,CAAQ,MAAM,iBAAiB,CAAA;AAC/D,EAAA,IAAI,YAAA,KAAiB,MAAA,IAAa,OAAA,KAAY,MAAA,EAAW;AACvD,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,IAAI,iBAAiB,mBAAA,EAAqB;AACxC,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,MAAM,SAAS,OAAA,CAAQ,KAAA,CAAM,QAAQ,WAAA,CAAY,gBAAgB,IAAI,CAAC,CAAA;AACtE,EAAA,IAAI,yBAAyB,GAAA,CAAI,OAAO,KAAK,wBAAA,CAAyB,GAAA,CAAI,MAAM,CAAA,EAAG;AACjF,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,OAAO,YAAA,KAAiB,0BAAA,IAA8B,yBAAA,CAA0B,GAAA,CAAI,OAAO,CAAA;AAC7F;AAMO,SAAS,kBAAkB,MAAA,EAA+B;AAC/D,EAAA,IAAI,MAAA,CAAO,oBAAoB,MAAA,EAAW;AACxC,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,IAAI,MAAA,CAAO,WAAW,aAAA,EAAe;AACnC,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,OAAO,OAAO,gBAAA,KAAqB,MAAA,IAAa,CAAC,kBAAA,CAAmB,OAAO,gBAAgB,CAAA;AAC7F;;;"}

package/dist/domain/openapi/binary-content.mjs

@@ -0,0 +1,45 @@
+const BINARY_FORMAT = "binary";
+const TEXT_TOP_LEVEL_TYPE = "text";
+const APPLICATION_TOP_LEVEL_TYPE = "application";
+const TEXT_STRUCTURED_SYNTAXES = /* @__PURE__ */ new Set(["json", "xml", "yaml"]);
+const TEXT_APPLICATION_SUBTYPES = /* @__PURE__ */ new Set([
+  "ecmascript",
+  "graphql",
+  "javascript",
+  "json-seq",
+  "jsonl",
+  "sql",
+  "x-ndjson",
+  "x-www-form-urlencoded",
+  "x-yaml"
+]);
+const PARAMETER_SEPARATOR = ";";
+const SUBTYPE_SEPARATOR = "/";
+const SUFFIX_SEPARATOR = "+";
+function isTextualMediaType(mediaType) {
+  const essence = (mediaType.split(PARAMETER_SEPARATOR)[0] ?? "").trim().toLowerCase();
+  const [topLevelType, subtype] = essence.split(SUBTYPE_SEPARATOR);
+  if (topLevelType === void 0 || subtype === void 0) {
+    return false;
+  }
+  if (topLevelType === TEXT_TOP_LEVEL_TYPE) {
+    return true;
+  }
+  const suffix = subtype.slice(subtype.lastIndexOf(SUFFIX_SEPARATOR) + 1);
+  if (TEXT_STRUCTURED_SYNTAXES.has(subtype) || TEXT_STRUCTURED_SYNTAXES.has(suffix)) {
+    return true;
+  }
+  return topLevelType === APPLICATION_TOP_LEVEL_TYPE && TEXT_APPLICATION_SUBTYPES.has(subtype);
+}
+function isRawBinarySchema(schema) {
+  if (schema.contentEncoding !== void 0) {
+    return false;
+  }
+  if (schema.format === BINARY_FORMAT) {
+    return true;
+  }
+  return schema.contentMediaType !== void 0 && !isTextualMediaType(schema.contentMediaType);
+}
+
+export { isRawBinarySchema, isTextualMediaType };
+//# sourceMappingURL=binary-content.mjs.map

package/dist/domain/openapi/binary-content.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary-content.mjs","sources":["../../../src/domain/openapi/binary-content.ts"],"sourcesContent":["import type { SchemaObject } from \"./schema-object.js\";\n\n/**\n * Which string schemas describe raw binary data, following \"Working with Binary Data\" of the\n * OpenAPI specification (3.1): `format: binary` in 3.0, a `contentMediaType` without a\n * `contentEncoding` in 3.1. `--binary-as-blob` types these as `Blob`.\n * https://spec.openapis.org/oas/v3.1.1.html#working-with-binary-data\n */\n\n/** The OpenAPI 3.0 format of unencoded octets (`byte` is base64 text). */\nconst BINARY_FORMAT = \"binary\";\n\n/** The top-level media type whose contents are always text (RFC 2046). */\nconst TEXT_TOP_LEVEL_TYPE = \"text\";\n\n/** The top-level media type of the text formats in `TEXT_APPLICATION_SUBTYPES`. */\nconst APPLICATION_TOP_LEVEL_TYPE = \"application\";\n\n/**\n * Text syntaxes, as a subtype (`application/json`) or a structured syntax suffix\n * (`application/problem+json`, `image/svg+xml`; RFC 6839, RFC 9512).\n */\nconst TEXT_STRUCTURED_SYNTAXES: ReadonlySet<string> = new Set([\"json\", \"xml\", \"yaml\"]);\n\n/** Other text formats under `application/`, registered or in common use. */\nconst TEXT_APPLICATION_SUBTYPES: ReadonlySet<string> = new Set([\n  \"ecmascript\",\n  \"graphql\",\n  \"javascript\",\n  \"json-seq\",\n  \"jsonl\",\n  \"sql\",\n  \"x-ndjson\",\n  \"x-www-form-urlencoded\",\n  \"x-yaml\",\n]);\n\nconst PARAMETER_SEPARATOR = \";\";\nconst SUBTYPE_SEPARATOR = \"/\";\nconst SUFFIX_SEPARATOR = \"+\";\n\n/**\n * Whether a media type's contents are text, so a string schema with it holds the text itself.\n * Parameters (`; charset=utf-8`) and case are ignored; a value without a subtype is not text.\n */\nexport function isTextualMediaType(mediaType: string): boolean {\n  const essence = (mediaType.split(PARAMETER_SEPARATOR)[0] ?? \"\").trim().toLowerCase();\n  const [topLevelType, subtype] = essence.split(SUBTYPE_SEPARATOR);\n  if (topLevelType === undefined || subtype === undefined) {\n    return false;\n  }\n  if (topLevelType === TEXT_TOP_LEVEL_TYPE) {\n    return true;\n  }\n  const suffix = subtype.slice(subtype.lastIndexOf(SUFFIX_SEPARATOR) + 1);\n  if (TEXT_STRUCTURED_SYNTAXES.has(subtype) || TEXT_STRUCTURED_SYNTAXES.has(suffix)) {\n    return true;\n  }\n  return topLevelType === APPLICATION_TOP_LEVEL_TYPE && TEXT_APPLICATION_SUBTYPES.has(subtype);\n}\n\n/**\n * Whether a schema describes raw (unencoded) binary data. Any `contentEncoding` means the value\n * is encoded text, so it wins over `format: binary`.\n */\nexport function isRawBinarySchema(schema: SchemaObject): boolean {\n  if (schema.contentEncoding !== undefined) {\n    return false;\n  }\n  if (schema.format === BINARY_FORMAT) {\n    return true;\n  }\n  return schema.contentMediaType !== undefined && !isTextualMediaType(schema.contentMediaType);\n}\n"],"names":[],"mappings":"AAUA,MAAM,aAAA,GAAgB,QAAA;AAGtB,MAAM,mBAAA,GAAsB,MAAA;AAG5B,MAAM,0BAAA,GAA6B,aAAA;AAMnC,MAAM,2CAAgD,IAAI,GAAA,CAAI,CAAC,MAAA,EAAQ,KAAA,EAAO,MAAM,CAAC,CAAA;AAGrF,MAAM,yBAAA,uBAAqD,GAAA,CAAI;AAAA,EAC7D,YAAA;AAAA,EACA,SAAA;AAAA,EACA,YAAA;AAAA,EACA,UAAA;AAAA,EACA,OAAA;AAAA,EACA,KAAA;AAAA,EACA,UAAA;AAAA,EACA,uBAAA;AAAA,EACA;AACF,CAAC,CAAA;AAED,MAAM,mBAAA,GAAsB,GAAA;AAC5B,MAAM,iBAAA,GAAoB,GAAA;AAC1B,MAAM,gBAAA,GAAmB,GAAA;AAMlB,SAAS,mBAAmB,SAAA,EAA4B;AAC7D,EAAA,MAAM,OAAA,GAAA,CAAW,SAAA,CAAU,KAAA,CAAM,mBAAmB,CAAA,CAAE,CAAC,CAAA,IAAK,EAAA,EAAI,IAAA,EAAK,CAAE,WAAA,EAAY;AACnF,EAAA,MAAM,CAAC,YAAA,EAAc,OAAO,CAAA,GAAI,OAAA,CAAQ,MAAM,iBAAiB,CAAA;AAC/D,EAAA,IAAI,YAAA,KAAiB,MAAA,IAAa,OAAA,KAAY,MAAA,EAAW;AACvD,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,IAAI,iBAAiB,mBAAA,EAAqB;AACxC,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,MAAM,SAAS,OAAA,CAAQ,KAAA,CAAM,QAAQ,WAAA,CAAY,gBAAgB,IAAI,CAAC,CAAA;AACtE,EAAA,IAAI,yBAAyB,GAAA,CAAI,OAAO,KAAK,wBAAA,CAAyB,GAAA,CAAI,MAAM,CAAA,EAAG;AACjF,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,OAAO,YAAA,KAAiB,0BAAA,IAA8B,yBAAA,CAA0B,GAAA,CAAI,OAAO,CAAA;AAC7F;AAMO,SAAS,kBAAkB,MAAA,EAA+B;AAC/D,EAAA,IAAI,MAAA,CAAO,oBAAoB,MAAA,EAAW;AACxC,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,IAAI,MAAA,CAAO,WAAW,aAAA,EAAe;AACnC,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,OAAO,OAAO,gBAAA,KAAqB,MAAA,IAAa,CAAC,kBAAA,CAAmB,OAAO,gBAAgB,CAAA;AAC7F;;"}

package/dist/domain/openapi/components-object.cjs

@@ -0,0 +1,29 @@
+'use strict';
+
+const mediaTypeObject = require('./media-type-object.cjs');
+
+const COMPONENT_KINDS = Object.freeze([
+  "schemas",
+  "responses",
+  "parameters",
+  "requestBodies",
+  "headers",
+  "pathItems"
+]);
+const DECLARED_COMPONENT_KINDS = Object.freeze([mediaTypeObject.MEDIA_TYPES_COMPONENT_KIND]);
+function singularizeComponentKind(kind) {
+  return kind === "requestBodies" ? "requestBody" : kind.slice(0, -1);
+}
+function isEnumSchema(schema) {
+  if (typeof schema !== "object" || schema === null || Array.isArray(schema)) {
+    return false;
+  }
+  const record = schema;
+  return "enum" in record && Array.isArray(record.enum) && (!("type" in record) || record.type !== "object") && !("properties" in record) && !("additionalProperties" in record);
+}
+
+exports.COMPONENT_KINDS = COMPONENT_KINDS;
+exports.DECLARED_COMPONENT_KINDS = DECLARED_COMPONENT_KINDS;
+exports.isEnumSchema = isEnumSchema;
+exports.singularizeComponentKind = singularizeComponentKind;
+//# sourceMappingURL=components-object.cjs.map

package/dist/domain/openapi/components-object.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"components-object.cjs","sources":["../../../src/domain/openapi/components-object.ts"],"sourcesContent":["import { MEDIA_TYPES_COMPONENT_KIND } from \"./media-type-object.js\";\n\n/**\n * The component maps the generator always writes, in output order (OpenAPI 3.1 §4.8.7); a kind the\n * document lacks is `never`.\n */\nexport const COMPONENT_KINDS = Object.freeze([\n  \"schemas\",\n  \"responses\",\n  \"parameters\",\n  \"requestBodies\",\n  \"headers\",\n  \"pathItems\",\n] as const);\n\n/**\n * OpenAPI 3.2 component maps, written after `COMPONENT_KINDS` and only when the document has them,\n * so documents without them keep their output (ADR-020).\n */\nexport const DECLARED_COMPONENT_KINDS = Object.freeze([MEDIA_TYPES_COMPONENT_KIND] as const);\n\nexport type ComponentKind =\n  | (typeof COMPONENT_KINDS)[number]\n  | (typeof DECLARED_COMPONENT_KINDS)[number];\n\n/** Components by kind and name; entries are read by each kind's transformer. */\nexport type ComponentsObject = {\n  readonly [kind in ComponentKind]?: Readonly<Record<string, unknown>>;\n};\n\n/** `requestBodies` → `requestBody`; other kinds drop the final `s`. */\nexport function singularizeComponentKind(kind: ComponentKind | `x-${string}`): string {\n  return kind === \"requestBodies\" ? \"requestBody\" : kind.slice(0, -1);\n}\n\n/**\n * Whether a schema is an enum that `--enum` turns into a TypeScript enum. With `--root-types`\n * such schemas get no root alias, because the enum is already exported under that name.\n */\nexport function isEnumSchema(schema: unknown): boolean {\n  if (typeof schema !== \"object\" || schema === null || Array.isArray(schema)) {\n    return false;\n  }\n  const record = schema as Record<string, unknown>;\n  return (\n    \"enum\" in record &&\n    Array.isArray(record.enum) &&\n    (!(\"type\" in record) || record.type !== \"object\") &&\n    !(\"properties\" in record) &&\n    !(\"additionalProperties\" in record)\n  );\n}\n"],"names":["MEDIA_TYPES_COMPONENT_KIND"],"mappings":";;;;AAMO,MAAM,eAAA,GAAkB,OAAO,MAAA,CAAO;AAAA,EAC3C,SAAA;AAAA,EACA,WAAA;AAAA,EACA,YAAA;AAAA,EACA,eAAA;AAAA,EACA,SAAA;AAAA,EACA;AACF,CAAU;AAMH,MAAM,wBAAA,GAA2B,MAAA,CAAO,MAAA,CAAO,CAACA,0CAA0B,CAAU;AAYpF,SAAS,yBAAyB,IAAA,EAA6C;AACpF,EAAA,OAAO,SAAS,eAAA,GAAkB,aAAA,GAAgB,IAAA,CAAK,KAAA,CAAM,GAAG,EAAE,CAAA;AACpE;AAMO,SAAS,aAAa,MAAA,EAA0B;AACrD,EAAA,IAAI,OAAO,WAAW,QAAA,IAAY,MAAA,KAAW,QAAQ,KAAA,CAAM,OAAA,CAAQ,MAAM,CAAA,EAAG;AAC1E,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,MAAM,MAAA,GAAS,MAAA;AACf,EAAA,OACE,UAAU,MAAA,IACV,KAAA,CAAM,OAAA,CAAQ,MAAA,CAAO,IAAI,CAAA,KACxB,EAAE,MAAA,IAAU,MAAA,CAAA,IAAW,OAAO,IAAA,KAAS,QAAA,CAAA,IACxC,EAAE,YAAA,IAAgB,MAAA,CAAA,IAClB,EAAE,sBAAA,IAA0B,MAAA,CAAA;AAEhC;;;;;"}

package/dist/domain/openapi/components-object.mjs

@@ -0,0 +1,24 @@
+import { MEDIA_TYPES_COMPONENT_KIND } from './media-type-object.mjs';
+
+const COMPONENT_KINDS = Object.freeze([
+  "schemas",
+  "responses",
+  "parameters",
+  "requestBodies",
+  "headers",
+  "pathItems"
+]);
+const DECLARED_COMPONENT_KINDS = Object.freeze([MEDIA_TYPES_COMPONENT_KIND]);
+function singularizeComponentKind(kind) {
+  return kind === "requestBodies" ? "requestBody" : kind.slice(0, -1);
+}
+function isEnumSchema(schema) {
+  if (typeof schema !== "object" || schema === null || Array.isArray(schema)) {
+    return false;
+  }
+  const record = schema;
+  return "enum" in record && Array.isArray(record.enum) && (!("type" in record) || record.type !== "object") && !("properties" in record) && !("additionalProperties" in record);
+}
+
+export { COMPONENT_KINDS, DECLARED_COMPONENT_KINDS, isEnumSchema, singularizeComponentKind };
+//# sourceMappingURL=components-object.mjs.map

package/dist/domain/openapi/components-object.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"components-object.mjs","sources":["../../../src/domain/openapi/components-object.ts"],"sourcesContent":["import { MEDIA_TYPES_COMPONENT_KIND } from \"./media-type-object.js\";\n\n/**\n * The component maps the generator always writes, in output order (OpenAPI 3.1 §4.8.7); a kind the\n * document lacks is `never`.\n */\nexport const COMPONENT_KINDS = Object.freeze([\n  \"schemas\",\n  \"responses\",\n  \"parameters\",\n  \"requestBodies\",\n  \"headers\",\n  \"pathItems\",\n] as const);\n\n/**\n * OpenAPI 3.2 component maps, written after `COMPONENT_KINDS` and only when the document has them,\n * so documents without them keep their output (ADR-020).\n */\nexport const DECLARED_COMPONENT_KINDS = Object.freeze([MEDIA_TYPES_COMPONENT_KIND] as const);\n\nexport type ComponentKind =\n  | (typeof COMPONENT_KINDS)[number]\n  | (typeof DECLARED_COMPONENT_KINDS)[number];\n\n/** Components by kind and name; entries are read by each kind's transformer. */\nexport type ComponentsObject = {\n  readonly [kind in ComponentKind]?: Readonly<Record<string, unknown>>;\n};\n\n/** `requestBodies` → `requestBody`; other kinds drop the final `s`. */\nexport function singularizeComponentKind(kind: ComponentKind | `x-${string}`): string {\n  return kind === \"requestBodies\" ? \"requestBody\" : kind.slice(0, -1);\n}\n\n/**\n * Whether a schema is an enum that `--enum` turns into a TypeScript enum. With `--root-types`\n * such schemas get no root alias, because the enum is already exported under that name.\n */\nexport function isEnumSchema(schema: unknown): boolean {\n  if (typeof schema !== \"object\" || schema === null || Array.isArray(schema)) {\n    return false;\n  }\n  const record = schema as Record<string, unknown>;\n  return (\n    \"enum\" in record &&\n    Array.isArray(record.enum) &&\n    (!(\"type\" in record) || record.type !== \"object\") &&\n    !(\"properties\" in record) &&\n    !(\"additionalProperties\" in record)\n  );\n}\n"],"names":[],"mappings":";;AAMO,MAAM,eAAA,GAAkB,OAAO,MAAA,CAAO;AAAA,EAC3C,SAAA;AAAA,EACA,WAAA;AAAA,EACA,YAAA;AAAA,EACA,eAAA;AAAA,EACA,SAAA;AAAA,EACA;AACF,CAAU;AAMH,MAAM,wBAAA,GAA2B,MAAA,CAAO,MAAA,CAAO,CAAC,0BAA0B,CAAU;AAYpF,SAAS,yBAAyB,IAAA,EAA6C;AACpF,EAAA,OAAO,SAAS,eAAA,GAAkB,aAAA,GAAgB,IAAA,CAAK,KAAA,CAAM,GAAG,EAAE,CAAA;AACpE;AAMO,SAAS,aAAa,MAAA,EAA0B;AACrD,EAAA,IAAI,OAAO,WAAW,QAAA,IAAY,MAAA,KAAW,QAAQ,KAAA,CAAM,OAAA,CAAQ,MAAM,CAAA,EAAG;AAC1E,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,MAAM,MAAA,GAAS,MAAA;AACf,EAAA,OACE,UAAU,MAAA,IACV,KAAA,CAAM,OAAA,CAAQ,MAAA,CAAO,IAAI,CAAA,KACxB,EAAE,MAAA,IAAU,MAAA,CAAA,IAAW,OAAO,IAAA,KAAS,QAAA,CAAA,IACxC,EAAE,YAAA,IAAgB,MAAA,CAAA,IAClB,EAAE,sBAAA,IAA0B,MAAA,CAAA;AAEhC;;"}

package/dist/domain/openapi/json-pointer.cjs

@@ -0,0 +1,31 @@
+'use strict';
+
+function parseRefPointer(ref) {
+  const [, pointer = ""] = ref.split("#/");
+  return pointer.split("/").map(unescapePointerSegment).filter((segment) => segment.length > 0);
+}
+function unescapePointerSegment(segment) {
+  return decodeURIComponent(segment.replaceAll("~1", "/").replaceAll("~0", "~"));
+}
+function escapePointerSegment(segment) {
+  return segment.replaceAll("~", "~0").replaceAll("/", "~1").replaceAll("%", "%25");
+}
+function createRef(parts) {
+  let ref = "#";
+  for (const part of parts) {
+    if (part === void 0 || part === null || part === "") {
+      continue;
+    }
+    const text = String(part);
+    const segments = parseRefPointer(text);
+    for (const segment of segments.length > 0 ? segments : [text]) {
+      ref += `/${escapePointerSegment(segment)}`;
+    }
+  }
+  return ref;
+}
+
+exports.createRef = createRef;
+exports.escapePointerSegment = escapePointerSegment;
+exports.parseRefPointer = parseRefPointer;
+//# sourceMappingURL=json-pointer.cjs.map

package/dist/domain/openapi/json-pointer.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-pointer.cjs","sources":["../../../src/domain/openapi/json-pointer.ts"],"sourcesContent":["/**\n * The JSON Pointer of a `$ref` as path segments, with the semantics of Redocly's `parseRef`, which\n * the original generator used: the part after the first `#/`, split at `/`, each segment unescaped\n * (`~1` → `/`, `~0` → `~`, then percent-decoding), and empty segments dropped.\n *\n * Throws URIError for a malformed percent escape, as the original does.\n */\nexport function parseRefPointer(ref: string): string[] {\n  const [, pointer = \"\"] = ref.split(\"#/\");\n  return pointer\n    .split(\"/\")\n    .map(unescapePointerSegment)\n    .filter((segment) => segment.length > 0);\n}\n\nfunction unescapePointerSegment(segment: string): string {\n  return decodeURIComponent(segment.replaceAll(\"~1\", \"/\").replaceAll(\"~0\", \"~\"));\n}\n\n/**\n * Escape one segment for a JSON Pointer in a `$ref` fragment: `~` → `~0`, `/` → `~1`, and `%` →\n * `%25`, because reading a pointer back percent-decodes it. The original did not escape `%`, so a\n * name like `50%` threw URIError and `a%2Fb` read back as `a/b` (upstream #2251, #2828).\n */\nexport function escapePointerSegment(segment: string): string {\n  return segment.replaceAll(\"~\", \"~0\").replaceAll(\"/\", \"~1\").replaceAll(\"%\", \"%25\");\n}\n\n/**\n * Join parts into a local `$ref` (the original `createRef`). Empty parts are skipped. A part that\n * is itself a `$ref` contributes its segments; any other part is one segment.\n */\nexport function createRef(parts: readonly (string | number | null | undefined)[]): string {\n  let ref = \"#\";\n  for (const part of parts) {\n    if (part === undefined || part === null || part === \"\") {\n      continue;\n    }\n    const text = String(part);\n    const segments = parseRefPointer(text);\n    for (const segment of segments.length > 0 ? segments : [text]) {\n      ref += `/${escapePointerSegment(segment)}`;\n    }\n  }\n  return ref;\n}\n"],"names":[],"mappings":";;AAOO,SAAS,gBAAgB,GAAA,EAAuB;AACrD,EAAA,MAAM,GAAG,OAAA,GAAU,EAAE,CAAA,GAAI,GAAA,CAAI,MAAM,IAAI,CAAA;AACvC,EAAA,OAAO,OAAA,CACJ,KAAA,CAAM,GAAG,CAAA,CACT,GAAA,CAAI,sBAAsB,CAAA,CAC1B,MAAA,CAAO,CAAC,OAAA,KAAY,OAAA,CAAQ,MAAA,GAAS,CAAC,CAAA;AAC3C;AAEA,SAAS,uBAAuB,OAAA,EAAyB;AACvD,EAAA,OAAO,kBAAA,CAAmB,QAAQ,UAAA,CAAW,IAAA,EAAM,GAAG,CAAA,CAAE,UAAA,CAAW,IAAA,EAAM,GAAG,CAAC,CAAA;AAC/E;AAOO,SAAS,qBAAqB,OAAA,EAAyB;AAC5D,EAAA,OAAO,OAAA,CAAQ,UAAA,CAAW,GAAA,EAAK,IAAI,CAAA,CAAE,UAAA,CAAW,GAAA,EAAK,IAAI,CAAA,CAAE,UAAA,CAAW,GAAA,EAAK,KAAK,CAAA;AAClF;AAMO,SAAS,UAAU,KAAA,EAAgE;AACxF,EAAA,IAAI,GAAA,GAAM,GAAA;AACV,EAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,IAAA,IAAI,IAAA,KAAS,MAAA,IAAa,IAAA,KAAS,IAAA,IAAQ,SAAS,EAAA,EAAI;AACtD,MAAA;AAAA,IACF;AACA,IAAA,MAAM,IAAA,GAAO,OAAO,IAAI,CAAA;AACxB,IAAA,MAAM,QAAA,GAAW,gBAAgB,IAAI,CAAA;AACrC,IAAA,KAAA,MAAW,WAAW,QAAA,CAAS,MAAA,GAAS,IAAI,QAAA,GAAW,CAAC,IAAI,CAAA,EAAG;AAC7D,MAAA,GAAA,IAAO,CAAA,CAAA,EAAI,oBAAA,CAAqB,OAAO,CAAC,CAAA,CAAA;AAAA,IAC1C;AAAA,EACF;AACA,EAAA,OAAO,GAAA;AACT;;;;"}

package/dist/domain/openapi/json-pointer.mjs

@@ -0,0 +1,27 @@
+function parseRefPointer(ref) {
+  const [, pointer = ""] = ref.split("#/");
+  return pointer.split("/").map(unescapePointerSegment).filter((segment) => segment.length > 0);
+}
+function unescapePointerSegment(segment) {
+  return decodeURIComponent(segment.replaceAll("~1", "/").replaceAll("~0", "~"));
+}
+function escapePointerSegment(segment) {
+  return segment.replaceAll("~", "~0").replaceAll("/", "~1").replaceAll("%", "%25");
+}
+function createRef(parts) {
+  let ref = "#";
+  for (const part of parts) {
+    if (part === void 0 || part === null || part === "") {
+      continue;
+    }
+    const text = String(part);
+    const segments = parseRefPointer(text);
+    for (const segment of segments.length > 0 ? segments : [text]) {
+      ref += `/${escapePointerSegment(segment)}`;
+    }
+  }
+  return ref;
+}
+
+export { createRef, escapePointerSegment, parseRefPointer };
+//# sourceMappingURL=json-pointer.mjs.map

package/dist/domain/openapi/json-pointer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-pointer.mjs","sources":["../../../src/domain/openapi/json-pointer.ts"],"sourcesContent":["/**\n * The JSON Pointer of a `$ref` as path segments, with the semantics of Redocly's `parseRef`, which\n * the original generator used: the part after the first `#/`, split at `/`, each segment unescaped\n * (`~1` → `/`, `~0` → `~`, then percent-decoding), and empty segments dropped.\n *\n * Throws URIError for a malformed percent escape, as the original does.\n */\nexport function parseRefPointer(ref: string): string[] {\n  const [, pointer = \"\"] = ref.split(\"#/\");\n  return pointer\n    .split(\"/\")\n    .map(unescapePointerSegment)\n    .filter((segment) => segment.length > 0);\n}\n\nfunction unescapePointerSegment(segment: string): string {\n  return decodeURIComponent(segment.replaceAll(\"~1\", \"/\").replaceAll(\"~0\", \"~\"));\n}\n\n/**\n * Escape one segment for a JSON Pointer in a `$ref` fragment: `~` → `~0`, `/` → `~1`, and `%` →\n * `%25`, because reading a pointer back percent-decodes it. The original did not escape `%`, so a\n * name like `50%` threw URIError and `a%2Fb` read back as `a/b` (upstream #2251, #2828).\n */\nexport function escapePointerSegment(segment: string): string {\n  return segment.replaceAll(\"~\", \"~0\").replaceAll(\"/\", \"~1\").replaceAll(\"%\", \"%25\");\n}\n\n/**\n * Join parts into a local `$ref` (the original `createRef`). Empty parts are skipped. A part that\n * is itself a `$ref` contributes its segments; any other part is one segment.\n */\nexport function createRef(parts: readonly (string | number | null | undefined)[]): string {\n  let ref = \"#\";\n  for (const part of parts) {\n    if (part === undefined || part === null || part === \"\") {\n      continue;\n    }\n    const text = String(part);\n    const segments = parseRefPointer(text);\n    for (const segment of segments.length > 0 ? segments : [text]) {\n      ref += `/${escapePointerSegment(segment)}`;\n    }\n  }\n  return ref;\n}\n"],"names":[],"mappings":"AAOO,SAAS,gBAAgB,GAAA,EAAuB;AACrD,EAAA,MAAM,GAAG,OAAA,GAAU,EAAE,CAAA,GAAI,GAAA,CAAI,MAAM,IAAI,CAAA;AACvC,EAAA,OAAO,OAAA,CACJ,KAAA,CAAM,GAAG,CAAA,CACT,GAAA,CAAI,sBAAsB,CAAA,CAC1B,MAAA,CAAO,CAAC,OAAA,KAAY,OAAA,CAAQ,MAAA,GAAS,CAAC,CAAA;AAC3C;AAEA,SAAS,uBAAuB,OAAA,EAAyB;AACvD,EAAA,OAAO,kBAAA,CAAmB,QAAQ,UAAA,CAAW,IAAA,EAAM,GAAG,CAAA,CAAE,UAAA,CAAW,IAAA,EAAM,GAAG,CAAC,CAAA;AAC/E;AAOO,SAAS,qBAAqB,OAAA,EAAyB;AAC5D,EAAA,OAAO,OAAA,CAAQ,UAAA,CAAW,GAAA,EAAK,IAAI,CAAA,CAAE,UAAA,CAAW,GAAA,EAAK,IAAI,CAAA,CAAE,UAAA,CAAW,GAAA,EAAK,KAAK,CAAA;AAClF;AAMO,SAAS,UAAU,KAAA,EAAgE;AACxF,EAAA,IAAI,GAAA,GAAM,GAAA;AACV,EAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,IAAA,IAAI,IAAA,KAAS,MAAA,IAAa,IAAA,KAAS,IAAA,IAAQ,SAAS,EAAA,EAAI;AACtD,MAAA;AAAA,IACF;AACA,IAAA,MAAM,IAAA,GAAO,OAAO,IAAI,CAAA;AACxB,IAAA,MAAM,QAAA,GAAW,gBAAgB,IAAI,CAAA;AACrC,IAAA,KAAA,MAAW,WAAW,QAAA,CAAS,MAAA,GAAS,IAAI,QAAA,GAAW,CAAC,IAAI,CAAA,EAAG;AAC7D,MAAA,GAAA,IAAO,CAAA,CAAA,EAAI,oBAAA,CAAqB,OAAO,CAAC,CAAA,CAAA;AAAA,IAC1C;AAAA,EACF;AACA,EAAA,OAAO,GAAA;AACT;;"}

package/dist/domain/openapi/media-type-object.cjs

@@ -0,0 +1,14 @@
+'use strict';
+
+const jsonPointer = require('./json-pointer.cjs');
+
+const COMPONENTS_SEGMENT = "components";
+const MEDIA_TYPES_COMPONENT_KIND = "mediaTypes";
+function isMediaTypeComponentRef(ref) {
+  const [root, kind] = jsonPointer.parseRefPointer(ref);
+  return ref.startsWith("#/") && root === COMPONENTS_SEGMENT && kind === MEDIA_TYPES_COMPONENT_KIND;
+}
+
+exports.MEDIA_TYPES_COMPONENT_KIND = MEDIA_TYPES_COMPONENT_KIND;
+exports.isMediaTypeComponentRef = isMediaTypeComponentRef;
+//# sourceMappingURL=media-type-object.cjs.map

package/dist/domain/openapi/media-type-object.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-type-object.cjs","sources":["../../../src/domain/openapi/media-type-object.ts"],"sourcesContent":["import { parseRefPointer } from \"./json-pointer.js\";\nimport type { ReferenceSchema, Schema } from \"./schema-object.js\";\n\n/** The parts of a Media Type Object the generator reads (OpenAPI 3.2 §4.8.14). */\nexport interface MediaTypeObject {\n  /** The complete content. */\n  readonly schema?: Schema;\n  /** Each item of a sequential media type such as `application/jsonl` (OpenAPI 3.2). */\n  readonly itemSchema?: Schema;\n}\n\n/** A `content` map: media type name to a Media Type Object or a `$ref` to one. */\nexport type ContentMap = Readonly<Record<string, MediaTypeObject | ReferenceSchema>>;\n\nconst COMPONENTS_SEGMENT = \"components\";\n/** The OpenAPI 3.2 component map of reusable Media Type Objects. */\nexport const MEDIA_TYPES_COMPONENT_KIND = \"mediaTypes\";\n\n/**\n * Whether a `content` entry's `$ref` points into `components.mediaTypes` (OpenAPI 3.2). Other\n * `$ref`s in `content` keep the output they had before 3.2 (ADR-020).\n */\nexport function isMediaTypeComponentRef(ref: string): boolean {\n  const [root, kind] = parseRefPointer(ref);\n  return ref.startsWith(\"#/\") && root === COMPONENTS_SEGMENT && kind === MEDIA_TYPES_COMPONENT_KIND;\n}\n"],"names":["parseRefPointer"],"mappings":";;;;AAcA,MAAM,kBAAA,GAAqB,YAAA;AAEpB,MAAM,0BAAA,GAA6B;AAMnC,SAAS,wBAAwB,GAAA,EAAsB;AAC5D,EAAA,MAAM,CAAC,IAAA,EAAM,IAAI,CAAA,GAAIA,4BAAgB,GAAG,CAAA;AACxC,EAAA,OAAO,IAAI,UAAA,CAAW,IAAI,CAAA,IAAK,IAAA,KAAS,sBAAsB,IAAA,KAAS,0BAAA;AACzE;;;"}

package/dist/domain/openapi/media-type-object.mjs

@@ -0,0 +1,11 @@
+import { parseRefPointer } from './json-pointer.mjs';
+
+const COMPONENTS_SEGMENT = "components";
+const MEDIA_TYPES_COMPONENT_KIND = "mediaTypes";
+function isMediaTypeComponentRef(ref) {
+  const [root, kind] = parseRefPointer(ref);
+  return ref.startsWith("#/") && root === COMPONENTS_SEGMENT && kind === MEDIA_TYPES_COMPONENT_KIND;
+}
+
+export { MEDIA_TYPES_COMPONENT_KIND, isMediaTypeComponentRef };
+//# sourceMappingURL=media-type-object.mjs.map

package/dist/domain/openapi/media-type-object.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-type-object.mjs","sources":["../../../src/domain/openapi/media-type-object.ts"],"sourcesContent":["import { parseRefPointer } from \"./json-pointer.js\";\nimport type { ReferenceSchema, Schema } from \"./schema-object.js\";\n\n/** The parts of a Media Type Object the generator reads (OpenAPI 3.2 §4.8.14). */\nexport interface MediaTypeObject {\n  /** The complete content. */\n  readonly schema?: Schema;\n  /** Each item of a sequential media type such as `application/jsonl` (OpenAPI 3.2). */\n  readonly itemSchema?: Schema;\n}\n\n/** A `content` map: media type name to a Media Type Object or a `$ref` to one. */\nexport type ContentMap = Readonly<Record<string, MediaTypeObject | ReferenceSchema>>;\n\nconst COMPONENTS_SEGMENT = \"components\";\n/** The OpenAPI 3.2 component map of reusable Media Type Objects. */\nexport const MEDIA_TYPES_COMPONENT_KIND = \"mediaTypes\";\n\n/**\n * Whether a `content` entry's `$ref` points into `components.mediaTypes` (OpenAPI 3.2). Other\n * `$ref`s in `content` keep the output they had before 3.2 (ADR-020).\n */\nexport function isMediaTypeComponentRef(ref: string): boolean {\n  const [root, kind] = parseRefPointer(ref);\n  return ref.startsWith(\"#/\") && root === COMPONENTS_SEGMENT && kind === MEDIA_TYPES_COMPONENT_KIND;\n}\n"],"names":[],"mappings":";;AAcA,MAAM,kBAAA,GAAqB,YAAA;AAEpB,MAAM,0BAAA,GAA6B;AAMnC,SAAS,wBAAwB,GAAA,EAAsB;AAC5D,EAAA,MAAM,CAAC,IAAA,EAAM,IAAI,CAAA,GAAI,gBAAgB,GAAG,CAAA;AACxC,EAAA,OAAO,IAAI,UAAA,CAAW,IAAI,CAAA,IAAK,IAAA,KAAS,sBAAsB,IAAA,KAAS,0BAAA;AACzE;;"}

package/dist/domain/openapi/parameter-object.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+const PARAMETER_LOCATIONS = Object.freeze([
+  "query",
+  "header",
+  "path",
+  "cookie"
+]);
+const QUERYSTRING_LOCATION = "querystring";
+
+exports.PARAMETER_LOCATIONS = PARAMETER_LOCATIONS;
+exports.QUERYSTRING_LOCATION = QUERYSTRING_LOCATION;
+//# sourceMappingURL=parameter-object.cjs.map

package/dist/domain/openapi/parameter-object.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter-object.cjs","sources":["../../../src/domain/openapi/parameter-object.ts"],"sourcesContent":["import type { ContentMap } from \"./media-type-object.js\";\nimport type { ReferenceSchema, Schema } from \"./schema-object.js\";\n\nexport type ParameterLocation = \"query\" | \"header\" | \"path\" | \"cookie\";\n\n/** Every parameter location, in the order the generated `parameters` type lists them. */\nexport const PARAMETER_LOCATIONS: readonly ParameterLocation[] = Object.freeze([\n  \"query\",\n  \"header\",\n  \"path\",\n  \"cookie\",\n]);\n\n/**\n * The OpenAPI 3.2 location of a parameter that is the whole query string, described by `content`.\n * Its type becomes the `query` member of `parameters` (ADR-020).\n */\nexport const QUERYSTRING_LOCATION = \"querystring\";\n\n/** The parts of a Parameter Object the generator reads (OpenAPI 3.2 §4.8.12). */\nexport interface ParameterObject {\n  readonly name: string;\n  readonly in: ParameterLocation | typeof QUERYSTRING_LOCATION;\n  readonly required?: boolean;\n  readonly deprecated?: boolean;\n  readonly schema?: Schema;\n  readonly content?: ContentMap;\n}\n\nexport type ParameterOrReference = ParameterObject | ReferenceSchema;\n"],"names":[],"mappings":";;AAMO,MAAM,mBAAA,GAAoD,OAAO,MAAA,CAAO;AAAA,EAC7E,OAAA;AAAA,EACA,QAAA;AAAA,EACA,MAAA;AAAA,EACA;AACF,CAAC;AAMM,MAAM,oBAAA,GAAuB;;;"}

package/dist/domain/openapi/parameter-object.mjs

@@ -0,0 +1,10 @@
+const PARAMETER_LOCATIONS = Object.freeze([
+  "query",
+  "header",
+  "path",
+  "cookie"
+]);
+const QUERYSTRING_LOCATION = "querystring";
+
+export { PARAMETER_LOCATIONS, QUERYSTRING_LOCATION };
+//# sourceMappingURL=parameter-object.mjs.map

package/dist/domain/openapi/parameter-object.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter-object.mjs","sources":["../../../src/domain/openapi/parameter-object.ts"],"sourcesContent":["import type { ContentMap } from \"./media-type-object.js\";\nimport type { ReferenceSchema, Schema } from \"./schema-object.js\";\n\nexport type ParameterLocation = \"query\" | \"header\" | \"path\" | \"cookie\";\n\n/** Every parameter location, in the order the generated `parameters` type lists them. */\nexport const PARAMETER_LOCATIONS: readonly ParameterLocation[] = Object.freeze([\n  \"query\",\n  \"header\",\n  \"path\",\n  \"cookie\",\n]);\n\n/**\n * The OpenAPI 3.2 location of a parameter that is the whole query string, described by `content`.\n * Its type becomes the `query` member of `parameters` (ADR-020).\n */\nexport const QUERYSTRING_LOCATION = \"querystring\";\n\n/** The parts of a Parameter Object the generator reads (OpenAPI 3.2 §4.8.12). */\nexport interface ParameterObject {\n  readonly name: string;\n  readonly in: ParameterLocation | typeof QUERYSTRING_LOCATION;\n  readonly required?: boolean;\n  readonly deprecated?: boolean;\n  readonly schema?: Schema;\n  readonly content?: ContentMap;\n}\n\nexport type ParameterOrReference = ParameterObject | ReferenceSchema;\n"],"names":[],"mappings":"AAMO,MAAM,mBAAA,GAAoD,OAAO,MAAA,CAAO;AAAA,EAC7E,OAAA;AAAA,EACA,QAAA;AAAA,EACA,MAAA;AAAA,EACA;AACF,CAAC;AAMM,MAAM,oBAAA,GAAuB;;"}

package/dist/domain/openapi/path-item-object.cjs

@@ -0,0 +1,35 @@
+'use strict';
+
+const HTTP_METHODS = Object.freeze([
+  "get",
+  "put",
+  "post",
+  "delete",
+  "options",
+  "head",
+  "patch",
+  "trace"
+]);
+const QUERY_METHOD = "query";
+const ADDITIONAL_OPERATIONS_KEY = "additionalOperations";
+function pathItemOperations(pathItem) {
+  const methods = [...HTTP_METHODS, QUERY_METHOD];
+  const fixed = methods.flatMap((method) => {
+    const operation = pathItem[method];
+    return operation ? [{ method, operation, segments: [method] }] : [];
+  });
+  const additional = Object.entries(pathItem.additionalOperations ?? {}).map(
+    ([method, operation]) => ({
+      method,
+      operation,
+      segments: [ADDITIONAL_OPERATIONS_KEY, method]
+    })
+  );
+  return [...fixed, ...additional];
+}
+
+exports.ADDITIONAL_OPERATIONS_KEY = ADDITIONAL_OPERATIONS_KEY;
+exports.HTTP_METHODS = HTTP_METHODS;
+exports.QUERY_METHOD = QUERY_METHOD;
+exports.pathItemOperations = pathItemOperations;
+//# sourceMappingURL=path-item-object.cjs.map

package/dist/domain/openapi/path-item-object.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-item-object.cjs","sources":["../../../src/domain/openapi/path-item-object.ts"],"sourcesContent":["import type { OperationObject } from \"./operation-object.js\";\nimport type { ParameterOrReference } from \"./parameter-object.js\";\nimport type { ReferenceSchema } from \"./schema-object.js\";\n\n/** The methods every generated path item lists, with `?: never` when the document has none. */\nexport type HttpMethod = \"get\" | \"put\" | \"post\" | \"delete\" | \"options\" | \"head\" | \"patch\" | \"trace\";\n\n/** The operation fields of a path item, in the order the generated types list them. */\nexport const HTTP_METHODS: readonly HttpMethod[] = Object.freeze([\n  \"get\",\n  \"put\",\n  \"post\",\n  \"delete\",\n  \"options\",\n  \"head\",\n  \"patch\",\n  \"trace\",\n]);\n\n/**\n * The OpenAPI 3.2 QUERY method. Its member is written only when the path item declares it, so\n * documents without it keep their output (ADR-020).\n */\nexport const QUERY_METHOD = \"query\";\n\n/** Every operation field of a path item. */\nexport type PathItemMethod = HttpMethod | typeof QUERY_METHOD;\n\n/** The OpenAPI 3.2 path item field for methods other than the fixed fields, by exact name. */\nexport const ADDITIONAL_OPERATIONS_KEY = \"additionalOperations\";\n\nexport type OperationEntry = OperationObject | ReferenceSchema;\n\n/** The parts of a Path Item Object the generator reads (OpenAPI 3.2 §4.8.9). */\nexport type PathItemObject = {\n  readonly parameters?: readonly ParameterOrReference[];\n  readonly additionalOperations?: Readonly<Record<string, OperationEntry>>;\n} & { readonly [method in PathItemMethod]?: OperationEntry };\n\n/** Path items by URL template (OpenAPI 3.1 §4.8.8); webhooks use the same shape by name. */\nexport type PathsObject = Readonly<Record<string, PathItemObject | ReferenceSchema>>;\n\n/** One operation of a path item and the method it is declared under. */\nexport interface PathItemOperation {\n  /** A fixed field (`get`, `query`, …) or an `additionalOperations` name (`SUBSCRIBE`). */\n  readonly method: string;\n  readonly operation: OperationEntry;\n  /** JSON Pointer segments from the path item to the operation. */\n  readonly segments: readonly string[];\n}\n\n/**\n * Every operation of a path item: the fixed methods in output order, then `query`, then\n * `additionalOperations` in document order.\n */\nexport function pathItemOperations(pathItem: PathItemObject): PathItemOperation[] {\n  const methods: readonly PathItemMethod[] = [...HTTP_METHODS, QUERY_METHOD];\n  const fixed = methods.flatMap((method) => {\n    const operation = pathItem[method];\n    return operation ? [{ method, operation, segments: [method] }] : [];\n  });\n  const additional = Object.entries(pathItem.additionalOperations ?? {}).map(\n    ([method, operation]) => ({\n      method,\n      operation,\n      segments: [ADDITIONAL_OPERATIONS_KEY, method],\n    }),\n  );\n  return [...fixed, ...additional];\n}\n"],"names":[],"mappings":";;AAQO,MAAM,YAAA,GAAsC,OAAO,MAAA,CAAO;AAAA,EAC/D,KAAA;AAAA,EACA,KAAA;AAAA,EACA,MAAA;AAAA,EACA,QAAA;AAAA,EACA,SAAA;AAAA,EACA,MAAA;AAAA,EACA,OAAA;AAAA,EACA;AACF,CAAC;AAMM,MAAM,YAAA,GAAe;AAMrB,MAAM,yBAAA,GAA4B;AA0BlC,SAAS,mBAAmB,QAAA,EAA+C;AAChF,EAAA,MAAM,OAAA,GAAqC,CAAC,GAAG,YAAA,EAAc,YAAY,CAAA;AACzE,EAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,OAAA,CAAQ,CAAC,MAAA,KAAW;AACxC,IAAA,MAAM,SAAA,GAAY,SAAS,MAAM,CAAA;AACjC,IAAA,OAAO,SAAA,GAAY,CAAC,EAAE,MAAA,EAAQ,SAAA,EAAW,QAAA,EAAU,CAAC,MAAM,CAAA,EAAG,CAAA,GAAI,EAAC;AAAA,EACpE,CAAC,CAAA;AACD,EAAA,MAAM,aAAa,MAAA,CAAO,OAAA,CAAQ,SAAS,oBAAA,IAAwB,EAAE,CAAA,CAAE,GAAA;AAAA,IACrE,CAAC,CAAC,MAAA,EAAQ,SAAS,CAAA,MAAO;AAAA,MACxB,MAAA;AAAA,MACA,SAAA;AAAA,MACA,QAAA,EAAU,CAAC,yBAAA,EAA2B,MAAM;AAAA,KAC9C;AAAA,GACF;AACA,EAAA,OAAO,CAAC,GAAG,KAAA,EAAO,GAAG,UAAU,CAAA;AACjC;;;;;"}

package/dist/domain/openapi/path-item-object.mjs

@@ -0,0 +1,30 @@
+const HTTP_METHODS = Object.freeze([
+  "get",
+  "put",
+  "post",
+  "delete",
+  "options",
+  "head",
+  "patch",
+  "trace"
+]);
+const QUERY_METHOD = "query";
+const ADDITIONAL_OPERATIONS_KEY = "additionalOperations";
+function pathItemOperations(pathItem) {
+  const methods = [...HTTP_METHODS, QUERY_METHOD];
+  const fixed = methods.flatMap((method) => {
+    const operation = pathItem[method];
+    return operation ? [{ method, operation, segments: [method] }] : [];
+  });
+  const additional = Object.entries(pathItem.additionalOperations ?? {}).map(
+    ([method, operation]) => ({
+      method,
+      operation,
+      segments: [ADDITIONAL_OPERATIONS_KEY, method]
+    })
+  );
+  return [...fixed, ...additional];
+}
+
+export { ADDITIONAL_OPERATIONS_KEY, HTTP_METHODS, QUERY_METHOD, pathItemOperations };
+//# sourceMappingURL=path-item-object.mjs.map

package/dist/domain/openapi/path-item-object.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-item-object.mjs","sources":["../../../src/domain/openapi/path-item-object.ts"],"sourcesContent":["import type { OperationObject } from \"./operation-object.js\";\nimport type { ParameterOrReference } from \"./parameter-object.js\";\nimport type { ReferenceSchema } from \"./schema-object.js\";\n\n/** The methods every generated path item lists, with `?: never` when the document has none. */\nexport type HttpMethod = \"get\" | \"put\" | \"post\" | \"delete\" | \"options\" | \"head\" | \"patch\" | \"trace\";\n\n/** The operation fields of a path item, in the order the generated types list them. */\nexport const HTTP_METHODS: readonly HttpMethod[] = Object.freeze([\n  \"get\",\n  \"put\",\n  \"post\",\n  \"delete\",\n  \"options\",\n  \"head\",\n  \"patch\",\n  \"trace\",\n]);\n\n/**\n * The OpenAPI 3.2 QUERY method. Its member is written only when the path item declares it, so\n * documents without it keep their output (ADR-020).\n */\nexport const QUERY_METHOD = \"query\";\n\n/** Every operation field of a path item. */\nexport type PathItemMethod = HttpMethod | typeof QUERY_METHOD;\n\n/** The OpenAPI 3.2 path item field for methods other than the fixed fields, by exact name. */\nexport const ADDITIONAL_OPERATIONS_KEY = \"additionalOperations\";\n\nexport type OperationEntry = OperationObject | ReferenceSchema;\n\n/** The parts of a Path Item Object the generator reads (OpenAPI 3.2 §4.8.9). */\nexport type PathItemObject = {\n  readonly parameters?: readonly ParameterOrReference[];\n  readonly additionalOperations?: Readonly<Record<string, OperationEntry>>;\n} & { readonly [method in PathItemMethod]?: OperationEntry };\n\n/** Path items by URL template (OpenAPI 3.1 §4.8.8); webhooks use the same shape by name. */\nexport type PathsObject = Readonly<Record<string, PathItemObject | ReferenceSchema>>;\n\n/** One operation of a path item and the method it is declared under. */\nexport interface PathItemOperation {\n  /** A fixed field (`get`, `query`, …) or an `additionalOperations` name (`SUBSCRIBE`). */\n  readonly method: string;\n  readonly operation: OperationEntry;\n  /** JSON Pointer segments from the path item to the operation. */\n  readonly segments: readonly string[];\n}\n\n/**\n * Every operation of a path item: the fixed methods in output order, then `query`, then\n * `additionalOperations` in document order.\n */\nexport function pathItemOperations(pathItem: PathItemObject): PathItemOperation[] {\n  const methods: readonly PathItemMethod[] = [...HTTP_METHODS, QUERY_METHOD];\n  const fixed = methods.flatMap((method) => {\n    const operation = pathItem[method];\n    return operation ? [{ method, operation, segments: [method] }] : [];\n  });\n  const additional = Object.entries(pathItem.additionalOperations ?? {}).map(\n    ([method, operation]) => ({\n      method,\n      operation,\n      segments: [ADDITIONAL_OPERATIONS_KEY, method],\n    }),\n  );\n  return [...fixed, ...additional];\n}\n"],"names":[],"mappings":"AAQO,MAAM,YAAA,GAAsC,OAAO,MAAA,CAAO;AAAA,EAC/D,KAAA;AAAA,EACA,KAAA;AAAA,EACA,MAAA;AAAA,EACA,QAAA;AAAA,EACA,SAAA;AAAA,EACA,MAAA;AAAA,EACA,OAAA;AAAA,EACA;AACF,CAAC;AAMM,MAAM,YAAA,GAAe;AAMrB,MAAM,yBAAA,GAA4B;AA0BlC,SAAS,mBAAmB,QAAA,EAA+C;AAChF,EAAA,MAAM,OAAA,GAAqC,CAAC,GAAG,YAAA,EAAc,YAAY,CAAA;AACzE,EAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,OAAA,CAAQ,CAAC,MAAA,KAAW;AACxC,IAAA,MAAM,SAAA,GAAY,SAAS,MAAM,CAAA;AACjC,IAAA,OAAO,SAAA,GAAY,CAAC,EAAE,MAAA,EAAQ,SAAA,EAAW,QAAA,EAAU,CAAC,MAAM,CAAA,EAAG,CAAA,GAAI,EAAC;AAAA,EACpE,CAAC,CAAA;AACD,EAAA,MAAM,aAAa,MAAA,CAAO,OAAA,CAAQ,SAAS,oBAAA,IAAwB,EAAE,CAAA,CAAE,GAAA;AAAA,IACrE,CAAC,CAAC,MAAA,EAAQ,SAAS,CAAA,MAAO;AAAA,MACxB,MAAA;AAAA,MACA,SAAA;AAAA,MACA,QAAA,EAAU,CAAC,yBAAA,EAA2B,MAAM;AAAA,KAC9C;AAAA,GACF;AACA,EAAA,OAAO,CAAC,GAAG,KAAA,EAAO,GAAG,UAAU,CAAA;AACjC;;"}