openapi-typesafe 0.0.0 → 1.0.0-rc.0

package/dist/application/transform/document/path-key-overlaps.cjs

@@ -0,0 +1,57 @@
+'use strict';
+
+const BOOLEAN_TEXTS = ["true", "false"];
+const SAMPLE_TEXTS = {
+  string: "",
+  number: "0",
+  boolean: "true"
+};
+function isNumberText(text) {
+  return text !== "" && Number.isFinite(Number(text));
+}
+function isPlaceholderText(type, text) {
+  if (type === "number") {
+    return isNumberText(text);
+  }
+  return type === "boolean" ? BOOLEAN_TEXTS.includes(text) : true;
+}
+function matchesFrom(text, start, parts, index) {
+  const part = parts[index];
+  if (part === void 0) {
+    return start === text.length;
+  }
+  if (part.kind === "text") {
+    return text.startsWith(part.text, start) && matchesFrom(text, start + part.text.length, parts, index + 1);
+  }
+  for (let end = start; end <= text.length; end += 1) {
+    if (isPlaceholderText(part.type, text.slice(start, end)) && matchesFrom(text, end, parts, index + 1)) {
+      return true;
+    }
+  }
+  return false;
+}
+function sampleOf(key) {
+  if (key.kind === "literal") {
+    return key.url;
+  }
+  return key.parts.map((part) => part.kind === "text" ? part.text : SAMPLE_TEXTS[part.type]).join("");
+}
+const EVERY_COVER_REJECTED = () => true;
+function coveringTemplateKeys(keys, isRejected = EVERY_COVER_REJECTED) {
+  const covering = /* @__PURE__ */ new Set();
+  keys.forEach((key, index) => {
+    if (key.kind !== "template") {
+      return;
+    }
+    const isCovering = keys.some(
+      (other, otherIndex) => otherIndex !== index && matchesFrom(sampleOf(other), 0, key.parts, 0) && isRejected(index, otherIndex)
+    );
+    if (isCovering) {
+      covering.add(index);
+    }
+  });
+  return covering;
+}
+
+exports.coveringTemplateKeys = coveringTemplateKeys;
+//# sourceMappingURL=path-key-overlaps.cjs.map

package/dist/application/transform/document/path-key-overlaps.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-key-overlaps.cjs","sources":["../../../../src/application/transform/document/path-key-overlaps.ts"],"sourcesContent":["/**\n * `--path-params-as-types` overlaps (roadmap R10.2, backlog 28). A path key with parameters is an\n * index signature over a template literal type, such as `` `/apps/${string}` ``. `${string}` also\n * matches `/`, so that signature covers `/apps/regions` and `` `/apps/${string}/restart` `` as\n * well, and TypeScript requires the covered keys' types to be assignable to its type (TS2411,\n * TS2413). These functions find the signatures that cover another key the checker rejects.\n */\n\n/** A placeholder of a template literal type, by the type it stands for. */\nexport type PathPlaceholder = \"string\" | \"number\" | \"boolean\";\n\n/** One part of a path key: text, or a placeholder. */\nexport type PathKeyPart =\n  | { readonly kind: \"text\"; readonly text: string }\n  | { readonly kind: \"placeholder\"; readonly type: PathPlaceholder };\n\n/** A path key: a URL written as a property, or a template literal type of an index signature. */\nexport type PathKey =\n  | { readonly kind: \"literal\"; readonly url: string }\n  | { readonly kind: \"template\"; readonly parts: readonly PathKeyPart[] };\n\nconst BOOLEAN_TEXTS: readonly string[] = [\"true\", \"false\"];\n\n/** The text one placeholder stands for in a sample of a template key. */\nconst SAMPLE_TEXTS: Readonly<Record<PathPlaceholder, string>> = {\n  string: \"\",\n  number: \"0\",\n  boolean: \"true\",\n};\n\n/** TypeScript's rule for `${number}`: a text that converts to a finite number. */\nfunction isNumberText(text: string): boolean {\n  return text !== \"\" && Number.isFinite(Number(text));\n}\n\nfunction isPlaceholderText(type: PathPlaceholder, text: string): boolean {\n  if (type === \"number\") {\n    return isNumberText(text);\n  }\n  return type === \"boolean\" ? BOOLEAN_TEXTS.includes(text) : true;\n}\n\n/** Whether `text` from `start` on is one of the strings the parts from `index` on describe. */\nfunction matchesFrom(\n  text: string,\n  start: number,\n  parts: readonly PathKeyPart[],\n  index: number,\n): boolean {\n  const part = parts[index];\n  if (part === undefined) {\n    return start === text.length;\n  }\n  if (part.kind === \"text\") {\n    return (\n      text.startsWith(part.text, start) &&\n      matchesFrom(text, start + part.text.length, parts, index + 1)\n    );\n  }\n  for (let end = start; end <= text.length; end += 1) {\n    if (\n      isPlaceholderText(part.type, text.slice(start, end)) &&\n      matchesFrom(text, end, parts, index + 1)\n    ) {\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * One string of the key. If a template key is covered, every string of it is, so a sample that is\n * not covered proves the key is not; a sample that is covered may over-report, which only moves a\n * signature that did not need it (the types stay the same, see `pathsObjectType`).\n */\nfunction sampleOf(key: PathKey): string {\n  if (key.kind === \"literal\") {\n    return key.url;\n  }\n  return key.parts\n    .map((part) => (part.kind === \"text\" ? part.text : SAMPLE_TEXTS[part.type]))\n    .join(\"\");\n}\n\n/** Whether TypeScript rejects the key at `covered` for the signature at `covering`. */\nexport type CoverRejection = (covering: number, covered: number) => boolean;\n\n/** Without type information every covered key counts. */\nconst EVERY_COVER_REJECTED: CoverRejection = () => true;\n\n/** The indexes of the template keys that cover another key of the list, where it is rejected. */\nexport function coveringTemplateKeys(\n  keys: readonly PathKey[],\n  isRejected: CoverRejection = EVERY_COVER_REJECTED,\n): ReadonlySet<number> {\n  const covering = new Set<number>();\n  keys.forEach((key, index) => {\n    if (key.kind !== \"template\") {\n      return;\n    }\n    const isCovering = keys.some(\n      (other, otherIndex) =>\n        otherIndex !== index &&\n        matchesFrom(sampleOf(other), 0, key.parts, 0) &&\n        isRejected(index, otherIndex),\n    );\n    if (isCovering) {\n      covering.add(index);\n    }\n  });\n  return covering;\n}\n"],"names":[],"mappings":";;AAqBA,MAAM,aAAA,GAAmC,CAAC,MAAA,EAAQ,OAAO,CAAA;AAGzD,MAAM,YAAA,GAA0D;AAAA,EAC9D,MAAA,EAAQ,EAAA;AAAA,EACR,MAAA,EAAQ,GAAA;AAAA,EACR,OAAA,EAAS;AACX,CAAA;AAGA,SAAS,aAAa,IAAA,EAAuB;AAC3C,EAAA,OAAO,SAAS,EAAA,IAAM,MAAA,CAAO,QAAA,CAAS,MAAA,CAAO,IAAI,CAAC,CAAA;AACpD;AAEA,SAAS,iBAAA,CAAkB,MAAuB,IAAA,EAAuB;AACvE,EAAA,IAAI,SAAS,QAAA,EAAU;AACrB,IAAA,OAAO,aAAa,IAAI,CAAA;AAAA,EAC1B;AACA,EAAA,OAAO,IAAA,KAAS,SAAA,GAAY,aAAA,CAAc,QAAA,CAAS,IAAI,CAAA,GAAI,IAAA;AAC7D;AAGA,SAAS,WAAA,CACP,IAAA,EACA,KAAA,EACA,KAAA,EACA,KAAA,EACS;AACT,EAAA,MAAM,IAAA,GAAO,MAAM,KAAK,CAAA;AACxB,EAAA,IAAI,SAAS,MAAA,EAAW;AACtB,IAAA,OAAO,UAAU,IAAA,CAAK,MAAA;AAAA,EACxB;AACA,EAAA,IAAI,IAAA,CAAK,SAAS,MAAA,EAAQ;AACxB,IAAA,OACE,IAAA,CAAK,UAAA,CAAW,IAAA,CAAK,IAAA,EAAM,KAAK,CAAA,IAChC,WAAA,CAAY,IAAA,EAAM,KAAA,GAAQ,IAAA,CAAK,IAAA,CAAK,MAAA,EAAQ,KAAA,EAAO,QAAQ,CAAC,CAAA;AAAA,EAEhE;AACA,EAAA,KAAA,IAAS,MAAM,KAAA,EAAO,GAAA,IAAO,IAAA,CAAK,MAAA,EAAQ,OAAO,CAAA,EAAG;AAClD,IAAA,IACE,iBAAA,CAAkB,IAAA,CAAK,IAAA,EAAM,IAAA,CAAK,MAAM,KAAA,EAAO,GAAG,CAAC,CAAA,IACnD,YAAY,IAAA,EAAM,GAAA,EAAK,KAAA,EAAO,KAAA,GAAQ,CAAC,CAAA,EACvC;AACA,MAAA,OAAO,IAAA;AAAA,IACT;AAAA,EACF;AACA,EAAA,OAAO,KAAA;AACT;AAOA,SAAS,SAAS,GAAA,EAAsB;AACtC,EAAA,IAAI,GAAA,CAAI,SAAS,SAAA,EAAW;AAC1B,IAAA,OAAO,GAAA,CAAI,GAAA;AAAA,EACb;AACA,EAAA,OAAO,IAAI,KAAA,CACR,GAAA,CAAI,CAAC,IAAA,KAAU,KAAK,IAAA,KAAS,MAAA,GAAS,IAAA,CAAK,IAAA,GAAO,aAAa,IAAA,CAAK,IAAI,CAAE,CAAA,CAC1E,KAAK,EAAE,CAAA;AACZ;AAMA,MAAM,uBAAuC,MAAM,IAAA;AAG5C,SAAS,oBAAA,CACd,IAAA,EACA,UAAA,GAA6B,oBAAA,EACR;AACrB,EAAA,MAAM,QAAA,uBAAe,GAAA,EAAY;AACjC,EAAA,IAAA,CAAK,OAAA,CAAQ,CAAC,GAAA,EAAK,KAAA,KAAU;AAC3B,IAAA,IAAI,GAAA,CAAI,SAAS,UAAA,EAAY;AAC3B,MAAA;AAAA,IACF;AACA,IAAA,MAAM,aAAa,IAAA,CAAK,IAAA;AAAA,MACtB,CAAC,KAAA,EAAO,UAAA,KACN,UAAA,KAAe,KAAA,IACf,YAAY,QAAA,CAAS,KAAK,CAAA,EAAG,CAAA,EAAG,IAAI,KAAA,EAAO,CAAC,CAAA,IAC5C,UAAA,CAAW,OAAO,UAAU;AAAA,KAChC;AACA,IAAA,IAAI,UAAA,EAAY;AACd,MAAA,QAAA,CAAS,IAAI,KAAK,CAAA;AAAA,IACpB;AAAA,EACF,CAAC,CAAA;AACD,EAAA,OAAO,QAAA;AACT;;"}

package/dist/application/transform/document/path-key-overlaps.mjs

@@ -0,0 +1,55 @@
+const BOOLEAN_TEXTS = ["true", "false"];
+const SAMPLE_TEXTS = {
+  string: "",
+  number: "0",
+  boolean: "true"
+};
+function isNumberText(text) {
+  return text !== "" && Number.isFinite(Number(text));
+}
+function isPlaceholderText(type, text) {
+  if (type === "number") {
+    return isNumberText(text);
+  }
+  return type === "boolean" ? BOOLEAN_TEXTS.includes(text) : true;
+}
+function matchesFrom(text, start, parts, index) {
+  const part = parts[index];
+  if (part === void 0) {
+    return start === text.length;
+  }
+  if (part.kind === "text") {
+    return text.startsWith(part.text, start) && matchesFrom(text, start + part.text.length, parts, index + 1);
+  }
+  for (let end = start; end <= text.length; end += 1) {
+    if (isPlaceholderText(part.type, text.slice(start, end)) && matchesFrom(text, end, parts, index + 1)) {
+      return true;
+    }
+  }
+  return false;
+}
+function sampleOf(key) {
+  if (key.kind === "literal") {
+    return key.url;
+  }
+  return key.parts.map((part) => part.kind === "text" ? part.text : SAMPLE_TEXTS[part.type]).join("");
+}
+const EVERY_COVER_REJECTED = () => true;
+function coveringTemplateKeys(keys, isRejected = EVERY_COVER_REJECTED) {
+  const covering = /* @__PURE__ */ new Set();
+  keys.forEach((key, index) => {
+    if (key.kind !== "template") {
+      return;
+    }
+    const isCovering = keys.some(
+      (other, otherIndex) => otherIndex !== index && matchesFrom(sampleOf(other), 0, key.parts, 0) && isRejected(index, otherIndex)
+    );
+    if (isCovering) {
+      covering.add(index);
+    }
+  });
+  return covering;
+}
+
+export { coveringTemplateKeys };
+//# sourceMappingURL=path-key-overlaps.mjs.map

package/dist/application/transform/document/path-key-overlaps.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-key-overlaps.mjs","sources":["../../../../src/application/transform/document/path-key-overlaps.ts"],"sourcesContent":["/**\n * `--path-params-as-types` overlaps (roadmap R10.2, backlog 28). A path key with parameters is an\n * index signature over a template literal type, such as `` `/apps/${string}` ``. `${string}` also\n * matches `/`, so that signature covers `/apps/regions` and `` `/apps/${string}/restart` `` as\n * well, and TypeScript requires the covered keys' types to be assignable to its type (TS2411,\n * TS2413). These functions find the signatures that cover another key the checker rejects.\n */\n\n/** A placeholder of a template literal type, by the type it stands for. */\nexport type PathPlaceholder = \"string\" | \"number\" | \"boolean\";\n\n/** One part of a path key: text, or a placeholder. */\nexport type PathKeyPart =\n  | { readonly kind: \"text\"; readonly text: string }\n  | { readonly kind: \"placeholder\"; readonly type: PathPlaceholder };\n\n/** A path key: a URL written as a property, or a template literal type of an index signature. */\nexport type PathKey =\n  | { readonly kind: \"literal\"; readonly url: string }\n  | { readonly kind: \"template\"; readonly parts: readonly PathKeyPart[] };\n\nconst BOOLEAN_TEXTS: readonly string[] = [\"true\", \"false\"];\n\n/** The text one placeholder stands for in a sample of a template key. */\nconst SAMPLE_TEXTS: Readonly<Record<PathPlaceholder, string>> = {\n  string: \"\",\n  number: \"0\",\n  boolean: \"true\",\n};\n\n/** TypeScript's rule for `${number}`: a text that converts to a finite number. */\nfunction isNumberText(text: string): boolean {\n  return text !== \"\" && Number.isFinite(Number(text));\n}\n\nfunction isPlaceholderText(type: PathPlaceholder, text: string): boolean {\n  if (type === \"number\") {\n    return isNumberText(text);\n  }\n  return type === \"boolean\" ? BOOLEAN_TEXTS.includes(text) : true;\n}\n\n/** Whether `text` from `start` on is one of the strings the parts from `index` on describe. */\nfunction matchesFrom(\n  text: string,\n  start: number,\n  parts: readonly PathKeyPart[],\n  index: number,\n): boolean {\n  const part = parts[index];\n  if (part === undefined) {\n    return start === text.length;\n  }\n  if (part.kind === \"text\") {\n    return (\n      text.startsWith(part.text, start) &&\n      matchesFrom(text, start + part.text.length, parts, index + 1)\n    );\n  }\n  for (let end = start; end <= text.length; end += 1) {\n    if (\n      isPlaceholderText(part.type, text.slice(start, end)) &&\n      matchesFrom(text, end, parts, index + 1)\n    ) {\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * One string of the key. If a template key is covered, every string of it is, so a sample that is\n * not covered proves the key is not; a sample that is covered may over-report, which only moves a\n * signature that did not need it (the types stay the same, see `pathsObjectType`).\n */\nfunction sampleOf(key: PathKey): string {\n  if (key.kind === \"literal\") {\n    return key.url;\n  }\n  return key.parts\n    .map((part) => (part.kind === \"text\" ? part.text : SAMPLE_TEXTS[part.type]))\n    .join(\"\");\n}\n\n/** Whether TypeScript rejects the key at `covered` for the signature at `covering`. */\nexport type CoverRejection = (covering: number, covered: number) => boolean;\n\n/** Without type information every covered key counts. */\nconst EVERY_COVER_REJECTED: CoverRejection = () => true;\n\n/** The indexes of the template keys that cover another key of the list, where it is rejected. */\nexport function coveringTemplateKeys(\n  keys: readonly PathKey[],\n  isRejected: CoverRejection = EVERY_COVER_REJECTED,\n): ReadonlySet<number> {\n  const covering = new Set<number>();\n  keys.forEach((key, index) => {\n    if (key.kind !== \"template\") {\n      return;\n    }\n    const isCovering = keys.some(\n      (other, otherIndex) =>\n        otherIndex !== index &&\n        matchesFrom(sampleOf(other), 0, key.parts, 0) &&\n        isRejected(index, otherIndex),\n    );\n    if (isCovering) {\n      covering.add(index);\n    }\n  });\n  return covering;\n}\n"],"names":[],"mappings":"AAqBA,MAAM,aAAA,GAAmC,CAAC,MAAA,EAAQ,OAAO,CAAA;AAGzD,MAAM,YAAA,GAA0D;AAAA,EAC9D,MAAA,EAAQ,EAAA;AAAA,EACR,MAAA,EAAQ,GAAA;AAAA,EACR,OAAA,EAAS;AACX,CAAA;AAGA,SAAS,aAAa,IAAA,EAAuB;AAC3C,EAAA,OAAO,SAAS,EAAA,IAAM,MAAA,CAAO,QAAA,CAAS,MAAA,CAAO,IAAI,CAAC,CAAA;AACpD;AAEA,SAAS,iBAAA,CAAkB,MAAuB,IAAA,EAAuB;AACvE,EAAA,IAAI,SAAS,QAAA,EAAU;AACrB,IAAA,OAAO,aAAa,IAAI,CAAA;AAAA,EAC1B;AACA,EAAA,OAAO,IAAA,KAAS,SAAA,GAAY,aAAA,CAAc,QAAA,CAAS,IAAI,CAAA,GAAI,IAAA;AAC7D;AAGA,SAAS,WAAA,CACP,IAAA,EACA,KAAA,EACA,KAAA,EACA,KAAA,EACS;AACT,EAAA,MAAM,IAAA,GAAO,MAAM,KAAK,CAAA;AACxB,EAAA,IAAI,SAAS,MAAA,EAAW;AACtB,IAAA,OAAO,UAAU,IAAA,CAAK,MAAA;AAAA,EACxB;AACA,EAAA,IAAI,IAAA,CAAK,SAAS,MAAA,EAAQ;AACxB,IAAA,OACE,IAAA,CAAK,UAAA,CAAW,IAAA,CAAK,IAAA,EAAM,KAAK,CAAA,IAChC,WAAA,CAAY,IAAA,EAAM,KAAA,GAAQ,IAAA,CAAK,IAAA,CAAK,MAAA,EAAQ,KAAA,EAAO,QAAQ,CAAC,CAAA;AAAA,EAEhE;AACA,EAAA,KAAA,IAAS,MAAM,KAAA,EAAO,GAAA,IAAO,IAAA,CAAK,MAAA,EAAQ,OAAO,CAAA,EAAG;AAClD,IAAA,IACE,iBAAA,CAAkB,IAAA,CAAK,IAAA,EAAM,IAAA,CAAK,MAAM,KAAA,EAAO,GAAG,CAAC,CAAA,IACnD,YAAY,IAAA,EAAM,GAAA,EAAK,KAAA,EAAO,KAAA,GAAQ,CAAC,CAAA,EACvC;AACA,MAAA,OAAO,IAAA;AAAA,IACT;AAAA,EACF;AACA,EAAA,OAAO,KAAA;AACT;AAOA,SAAS,SAAS,GAAA,EAAsB;AACtC,EAAA,IAAI,GAAA,CAAI,SAAS,SAAA,EAAW;AAC1B,IAAA,OAAO,GAAA,CAAI,GAAA;AAAA,EACb;AACA,EAAA,OAAO,IAAI,KAAA,CACR,GAAA,CAAI,CAAC,IAAA,KAAU,KAAK,IAAA,KAAS,MAAA,GAAS,IAAA,CAAK,IAAA,GAAO,aAAa,IAAA,CAAK,IAAI,CAAE,CAAA,CAC1E,KAAK,EAAE,CAAA;AACZ;AAMA,MAAM,uBAAuC,MAAM,IAAA;AAG5C,SAAS,oBAAA,CACd,IAAA,EACA,UAAA,GAA6B,oBAAA,EACR;AACrB,EAAA,MAAM,QAAA,uBAAe,GAAA,EAAY;AACjC,EAAA,IAAA,CAAK,OAAA,CAAQ,CAAC,GAAA,EAAK,KAAA,KAAU;AAC3B,IAAA,IAAI,GAAA,CAAI,SAAS,UAAA,EAAY;AAC3B,MAAA;AAAA,IACF;AACA,IAAA,MAAM,aAAa,IAAA,CAAK,IAAA;AAAA,MACtB,CAAC,KAAA,EAAO,UAAA,KACN,UAAA,KAAe,KAAA,IACf,YAAY,QAAA,CAAS,KAAK,CAAA,EAAG,CAAA,EAAG,IAAI,KAAA,EAAO,CAAC,CAAA,IAC5C,UAAA,CAAW,OAAO,UAAU;AAAA,KAChC;AACA,IAAA,IAAI,UAAA,EAAY;AACd,MAAA,QAAA,CAAS,IAAI,KAAK,CAAA;AAAA,IACpB;AAAA,EACF,CAAC,CAAA;AACD,EAAA,OAAO,QAAA;AACT;;"}

package/dist/application/transform/document/paths-enum.cjs

@@ -0,0 +1,75 @@
+'use strict';
+
+const pathItemObject = require('../../../domain/openapi/path-item-object.cjs');
+const enumNaming = require('../footer/enum-naming.cjs');
+const numberedNames = require('../numbered-names.cjs');
+
+const PARAMETER_SEGMENT_RE = /^(?:{(.+)}|:(.+))$/;
+const INVALID_KEY_PART_RE = /{.*}|:.*|[^a-zA-Z\d_]+/;
+const API_PATHS_NAME = "ApiPaths";
+const METHODS = /* @__PURE__ */ new Set([...pathItemObject.HTTP_METHODS, pathItemObject.QUERY_METHOD]);
+function keyFromUrl(method, url) {
+  return `${method}${url}`.split("/").map((part) => {
+    const capitalized = part.charAt(0).toUpperCase() + part.slice(1);
+    return capitalized.replace(INVALID_KEY_PART_RE, "");
+  }).join("");
+}
+function parameterWord(name) {
+  return name.split(/[^a-zA-Z\d]+/).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join("");
+}
+function keyWithParameters(method, url) {
+  const parts = url.split("/").map((part) => {
+    const parameter = PARAMETER_SEGMENT_RE.exec(part);
+    const name = parameter?.[1] ?? parameter?.[2];
+    return name === void 0 ? part : `By${parameterWord(name)}`;
+  });
+  return keyFromUrl(method, parts.join("/"));
+}
+function pathItemEntries(pathItem) {
+  return Object.entries(pathItem).flatMap(([key, value]) => {
+    if (key === pathItemObject.ADDITIONAL_OPERATIONS_KEY) {
+      return typeof value === "object" && value !== null ? Object.entries(value) : [];
+    }
+    return METHODS.has(key) ? [[key, value]] : [];
+  });
+}
+function pathOperations(paths) {
+  return Object.entries(paths).flatMap(
+    ([url, pathItem]) => pathItemEntries(pathItem).map(([method, operation]) => {
+      const operationId = operation.operationId || void 0;
+      return { url, method, operationId };
+    })
+  );
+}
+function countOf(names) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const name of names) {
+    counts.set(name, (counts.get(name) ?? 0) + 1);
+  }
+  return counts;
+}
+function uniqueNames(operations) {
+  const keys = operations.map((op) => op.operationId ?? keyFromUrl(op.method, op.url));
+  const counts = countOf(keys);
+  const named = operations.map((op, index) => {
+    const isCollidingUrlKey = op.operationId === void 0 && (counts.get(keys[index]) ?? 0) > 1;
+    return isCollidingUrlKey ? keyWithParameters(op.method, op.url) : keys[index];
+  });
+  return numberedNames.withNumberedRepeats(named, (name, count) => `${name}${count}`);
+}
+function apiPathsEnum(paths) {
+  const operations = pathOperations(paths);
+  const names = uniqueNames(operations);
+  return {
+    values: operations.map((operation) => operation.url),
+    metadata: names.map((name) => ({ name, description: void 0 }))
+  };
+}
+function apiPathsEnumDeclaration(paths) {
+  const naming = new enumNaming.EnumNaming();
+  return enumNaming.enumDeclaration(naming.enumName(API_PATHS_NAME), apiPathsEnum(paths), naming);
+}
+
+exports.apiPathsEnum = apiPathsEnum;
+exports.apiPathsEnumDeclaration = apiPathsEnumDeclaration;
+//# sourceMappingURL=paths-enum.cjs.map

package/dist/application/transform/document/paths-enum.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths-enum.cjs","sources":["../../../../src/application/transform/document/paths-enum.ts"],"sourcesContent":["import type { IrEnumDeclaration } from \"../../../domain/ir/nodes.js\";\nimport type { OperationObject } from \"../../../domain/openapi/operation-object.js\";\nimport {\n  ADDITIONAL_OPERATIONS_KEY,\n  HTTP_METHODS,\n  type PathItemMethod,\n  type PathsObject,\n  QUERY_METHOD,\n} from \"../../../domain/openapi/path-item-object.js\";\nimport { EnumNaming, enumDeclaration } from \"../footer/enum-naming.js\";\nimport { withNumberedRepeats } from \"../numbered-names.js\";\nimport type { EnumMemberMetadata } from \"../schema/schema-context.js\";\n\n/** A path segment that is one parameter: `{user_id}` or `:user_id`. */\nconst PARAMETER_SEGMENT_RE = /^(?:{(.+)}|:(.+))$/;\n/** Characters not allowed in an enum key, or a `{param}` / `:param` part (first match only). */\nconst INVALID_KEY_PART_RE = /{.*}|:.*|[^a-zA-Z\\d_]+/;\nconst API_PATHS_NAME = \"ApiPaths\";\nconst METHODS: ReadonlySet<string> = new Set<PathItemMethod>([...HTTP_METHODS, QUERY_METHOD]);\n\n/** The members of the `ApiPaths` enum (`--make-paths-enum`). */\nexport interface ApiPathsEnum {\n  readonly values: readonly string[];\n  readonly metadata: readonly EnumMemberMetadata[];\n}\n\n/** `getUsersById` style key from the method and URL, when the operation has no ID. */\nfunction keyFromUrl(method: string, url: string): string {\n  return `${method}${url}`\n    .split(\"/\")\n    .map((part) => {\n      const capitalized = part.charAt(0).toUpperCase() + part.slice(1);\n      return capitalized.replace(INVALID_KEY_PART_RE, \"\");\n    })\n    .join(\"\");\n}\n\n/** `user_id` and `order-id` as `UserId` and `OrderId`. */\nfunction parameterWord(name: string): string {\n  return name\n    .split(/[^a-zA-Z\\d]+/)\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n    .join(\"\");\n}\n\n/** The key with parameters named, `GetUserByUserId`, for keys that collide without them. */\nfunction keyWithParameters(method: string, url: string): string {\n  const parts = url.split(\"/\").map((part) => {\n    const parameter = PARAMETER_SEGMENT_RE.exec(part);\n    const name = parameter?.[1] ?? parameter?.[2];\n    return name === undefined ? part : `By${parameterWord(name)}`;\n  });\n  return keyFromUrl(method, parts.join(\"/\"));\n}\n\ninterface PathOperation {\n  readonly url: string;\n  readonly method: string;\n  readonly operationId: string | undefined;\n}\n\n/**\n * The operations of one path item in document order; `additionalOperations` (OpenAPI 3.2) adds\n * its methods where the key stands.\n */\nfunction pathItemEntries(pathItem: object): [string, unknown][] {\n  return Object.entries(pathItem).flatMap(([key, value]): [string, unknown][] => {\n    if (key === ADDITIONAL_OPERATIONS_KEY) {\n      return typeof value === \"object\" && value !== null ? Object.entries(value) : [];\n    }\n    return METHODS.has(key) ? [[key, value]] : [];\n  });\n}\n\nfunction pathOperations(paths: PathsObject): PathOperation[] {\n  return Object.entries(paths).flatMap(([url, pathItem]) =>\n    pathItemEntries(pathItem).map(([method, operation]) => {\n      const operationId = (operation as OperationObject).operationId || undefined;\n      return { url, method, operationId };\n    }),\n  );\n}\n\nfunction countOf(names: readonly string[]): Map<string, number> {\n  const counts = new Map<string, number>();\n  for (const name of names) {\n    counts.set(name, (counts.get(name) ?? 0) + 1);\n  }\n  return counts;\n}\n\n/**\n * Names that are unique, so the enum compiles (upstream #2194). A URL key that collides names\n * its parameters; a name that still collides gets 2, 3… after its first use.\n */\nfunction uniqueNames(operations: readonly PathOperation[]): string[] {\n  const keys = operations.map((op) => op.operationId ?? keyFromUrl(op.method, op.url));\n  const counts = countOf(keys);\n  const named = operations.map((op, index) => {\n    const isCollidingUrlKey =\n      op.operationId === undefined && (counts.get(keys[index] as string) ?? 0) > 1;\n    return isCollidingUrlKey ? keyWithParameters(op.method, op.url) : (keys[index] as string);\n  });\n  return withNumberedRepeats(named, (name, count) => `${name}${count}`);\n}\n\n/**\n * One enum member per operation: the URL as the value, the operation ID (or a key built from the\n * method and URL) as the name. Paths are in document order; `--alphabetize` does not apply.\n */\nexport function apiPathsEnum(paths: PathsObject): ApiPathsEnum {\n  const operations = pathOperations(paths);\n  const names = uniqueNames(operations);\n  return {\n    values: operations.map((operation) => operation.url),\n    metadata: names.map((name) => ({ name, description: undefined })),\n  };\n}\n\n/**\n * The `ApiPaths` enum declaration. Its own naming state is equivalent to the run's: the name is a\n * valid identifier, and member names only reset the state, never read it.\n */\nexport function apiPathsEnumDeclaration(paths: PathsObject): IrEnumDeclaration {\n  const naming = new EnumNaming();\n  return enumDeclaration(naming.enumName(API_PATHS_NAME), apiPathsEnum(paths), naming);\n}\n"],"names":["HTTP_METHODS","QUERY_METHOD","ADDITIONAL_OPERATIONS_KEY","withNumberedRepeats","EnumNaming","enumDeclaration"],"mappings":"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"}

package/dist/application/transform/document/paths-enum.mjs

@@ -0,0 +1,72 @@
+import { HTTP_METHODS, QUERY_METHOD, ADDITIONAL_OPERATIONS_KEY } from '../../../domain/openapi/path-item-object.mjs';
+import { enumDeclaration, EnumNaming } from '../footer/enum-naming.mjs';
+import { withNumberedRepeats } from '../numbered-names.mjs';
+
+const PARAMETER_SEGMENT_RE = /^(?:{(.+)}|:(.+))$/;
+const INVALID_KEY_PART_RE = /{.*}|:.*|[^a-zA-Z\d_]+/;
+const API_PATHS_NAME = "ApiPaths";
+const METHODS = /* @__PURE__ */ new Set([...HTTP_METHODS, QUERY_METHOD]);
+function keyFromUrl(method, url) {
+  return `${method}${url}`.split("/").map((part) => {
+    const capitalized = part.charAt(0).toUpperCase() + part.slice(1);
+    return capitalized.replace(INVALID_KEY_PART_RE, "");
+  }).join("");
+}
+function parameterWord(name) {
+  return name.split(/[^a-zA-Z\d]+/).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join("");
+}
+function keyWithParameters(method, url) {
+  const parts = url.split("/").map((part) => {
+    const parameter = PARAMETER_SEGMENT_RE.exec(part);
+    const name = parameter?.[1] ?? parameter?.[2];
+    return name === void 0 ? part : `By${parameterWord(name)}`;
+  });
+  return keyFromUrl(method, parts.join("/"));
+}
+function pathItemEntries(pathItem) {
+  return Object.entries(pathItem).flatMap(([key, value]) => {
+    if (key === ADDITIONAL_OPERATIONS_KEY) {
+      return typeof value === "object" && value !== null ? Object.entries(value) : [];
+    }
+    return METHODS.has(key) ? [[key, value]] : [];
+  });
+}
+function pathOperations(paths) {
+  return Object.entries(paths).flatMap(
+    ([url, pathItem]) => pathItemEntries(pathItem).map(([method, operation]) => {
+      const operationId = operation.operationId || void 0;
+      return { url, method, operationId };
+    })
+  );
+}
+function countOf(names) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const name of names) {
+    counts.set(name, (counts.get(name) ?? 0) + 1);
+  }
+  return counts;
+}
+function uniqueNames(operations) {
+  const keys = operations.map((op) => op.operationId ?? keyFromUrl(op.method, op.url));
+  const counts = countOf(keys);
+  const named = operations.map((op, index) => {
+    const isCollidingUrlKey = op.operationId === void 0 && (counts.get(keys[index]) ?? 0) > 1;
+    return isCollidingUrlKey ? keyWithParameters(op.method, op.url) : keys[index];
+  });
+  return withNumberedRepeats(named, (name, count) => `${name}${count}`);
+}
+function apiPathsEnum(paths) {
+  const operations = pathOperations(paths);
+  const names = uniqueNames(operations);
+  return {
+    values: operations.map((operation) => operation.url),
+    metadata: names.map((name) => ({ name, description: void 0 }))
+  };
+}
+function apiPathsEnumDeclaration(paths) {
+  const naming = new EnumNaming();
+  return enumDeclaration(naming.enumName(API_PATHS_NAME), apiPathsEnum(paths), naming);
+}
+
+export { apiPathsEnum, apiPathsEnumDeclaration };
+//# sourceMappingURL=paths-enum.mjs.map

package/dist/application/transform/document/paths-enum.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths-enum.mjs","sources":["../../../../src/application/transform/document/paths-enum.ts"],"sourcesContent":["import type { IrEnumDeclaration } from \"../../../domain/ir/nodes.js\";\nimport type { OperationObject } from \"../../../domain/openapi/operation-object.js\";\nimport {\n  ADDITIONAL_OPERATIONS_KEY,\n  HTTP_METHODS,\n  type PathItemMethod,\n  type PathsObject,\n  QUERY_METHOD,\n} from \"../../../domain/openapi/path-item-object.js\";\nimport { EnumNaming, enumDeclaration } from \"../footer/enum-naming.js\";\nimport { withNumberedRepeats } from \"../numbered-names.js\";\nimport type { EnumMemberMetadata } from \"../schema/schema-context.js\";\n\n/** A path segment that is one parameter: `{user_id}` or `:user_id`. */\nconst PARAMETER_SEGMENT_RE = /^(?:{(.+)}|:(.+))$/;\n/** Characters not allowed in an enum key, or a `{param}` / `:param` part (first match only). */\nconst INVALID_KEY_PART_RE = /{.*}|:.*|[^a-zA-Z\\d_]+/;\nconst API_PATHS_NAME = \"ApiPaths\";\nconst METHODS: ReadonlySet<string> = new Set<PathItemMethod>([...HTTP_METHODS, QUERY_METHOD]);\n\n/** The members of the `ApiPaths` enum (`--make-paths-enum`). */\nexport interface ApiPathsEnum {\n  readonly values: readonly string[];\n  readonly metadata: readonly EnumMemberMetadata[];\n}\n\n/** `getUsersById` style key from the method and URL, when the operation has no ID. */\nfunction keyFromUrl(method: string, url: string): string {\n  return `${method}${url}`\n    .split(\"/\")\n    .map((part) => {\n      const capitalized = part.charAt(0).toUpperCase() + part.slice(1);\n      return capitalized.replace(INVALID_KEY_PART_RE, \"\");\n    })\n    .join(\"\");\n}\n\n/** `user_id` and `order-id` as `UserId` and `OrderId`. */\nfunction parameterWord(name: string): string {\n  return name\n    .split(/[^a-zA-Z\\d]+/)\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n    .join(\"\");\n}\n\n/** The key with parameters named, `GetUserByUserId`, for keys that collide without them. */\nfunction keyWithParameters(method: string, url: string): string {\n  const parts = url.split(\"/\").map((part) => {\n    const parameter = PARAMETER_SEGMENT_RE.exec(part);\n    const name = parameter?.[1] ?? parameter?.[2];\n    return name === undefined ? part : `By${parameterWord(name)}`;\n  });\n  return keyFromUrl(method, parts.join(\"/\"));\n}\n\ninterface PathOperation {\n  readonly url: string;\n  readonly method: string;\n  readonly operationId: string | undefined;\n}\n\n/**\n * The operations of one path item in document order; `additionalOperations` (OpenAPI 3.2) adds\n * its methods where the key stands.\n */\nfunction pathItemEntries(pathItem: object): [string, unknown][] {\n  return Object.entries(pathItem).flatMap(([key, value]): [string, unknown][] => {\n    if (key === ADDITIONAL_OPERATIONS_KEY) {\n      return typeof value === \"object\" && value !== null ? Object.entries(value) : [];\n    }\n    return METHODS.has(key) ? [[key, value]] : [];\n  });\n}\n\nfunction pathOperations(paths: PathsObject): PathOperation[] {\n  return Object.entries(paths).flatMap(([url, pathItem]) =>\n    pathItemEntries(pathItem).map(([method, operation]) => {\n      const operationId = (operation as OperationObject).operationId || undefined;\n      return { url, method, operationId };\n    }),\n  );\n}\n\nfunction countOf(names: readonly string[]): Map<string, number> {\n  const counts = new Map<string, number>();\n  for (const name of names) {\n    counts.set(name, (counts.get(name) ?? 0) + 1);\n  }\n  return counts;\n}\n\n/**\n * Names that are unique, so the enum compiles (upstream #2194). A URL key that collides names\n * its parameters; a name that still collides gets 2, 3… after its first use.\n */\nfunction uniqueNames(operations: readonly PathOperation[]): string[] {\n  const keys = operations.map((op) => op.operationId ?? keyFromUrl(op.method, op.url));\n  const counts = countOf(keys);\n  const named = operations.map((op, index) => {\n    const isCollidingUrlKey =\n      op.operationId === undefined && (counts.get(keys[index] as string) ?? 0) > 1;\n    return isCollidingUrlKey ? keyWithParameters(op.method, op.url) : (keys[index] as string);\n  });\n  return withNumberedRepeats(named, (name, count) => `${name}${count}`);\n}\n\n/**\n * One enum member per operation: the URL as the value, the operation ID (or a key built from the\n * method and URL) as the name. Paths are in document order; `--alphabetize` does not apply.\n */\nexport function apiPathsEnum(paths: PathsObject): ApiPathsEnum {\n  const operations = pathOperations(paths);\n  const names = uniqueNames(operations);\n  return {\n    values: operations.map((operation) => operation.url),\n    metadata: names.map((name) => ({ name, description: undefined })),\n  };\n}\n\n/**\n * The `ApiPaths` enum declaration. Its own naming state is equivalent to the run's: the name is a\n * valid identifier, and member names only reset the state, never read it.\n */\nexport function apiPathsEnumDeclaration(paths: PathsObject): IrEnumDeclaration {\n  const naming = new EnumNaming();\n  return enumDeclaration(naming.enumName(API_PATHS_NAME), apiPathsEnum(paths), naming);\n}\n"],"names":[],"mappings":"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"}

package/dist/application/transform/document/paths.cjs

@@ -0,0 +1,127 @@
+'use strict';
+
+const constructors = require('../../../domain/ir/constructors.cjs');
+const propertyName = require('../../../domain/ir/property-name.cjs');
+const rawTextEscapes = require('../../../domain/ir/raw-text-escapes.cjs');
+const jsonPointer = require('../../../domain/openapi/json-pointer.cjs');
+const pathItemObject = require('../../../domain/openapi/path-item-object.cjs');
+const documentEntries = require('../document-entries.cjs');
+const refType = require('../ref-type.cjs');
+const documentMember = require('./document-member.cjs');
+const pathItem = require('./path-item.cjs');
+const pathItemConflicts = require('./path-item-conflicts.cjs');
+const pathKeyOverlaps = require('./path-key-overlaps.cjs');
+
+const PATH_PARAMETER_RE = /\{[^}]+\}/g;
+const PLACEHOLDERS = /* @__PURE__ */ new Map([
+  ["number", "number"],
+  ["integer", "number"],
+  ["boolean", "boolean"]
+]);
+const STRING_PLACEHOLDER = "string";
+function placeholderText(type) {
+  return `\${${type}}`;
+}
+function resolvedParameter(parameter, context) {
+  return "$ref" in parameter && parameter.$ref ? context.refs.resolve(parameter.$ref) : parameter;
+}
+function addPathParameters(parameters, byName, context) {
+  for (const parameter of parameters) {
+    const resolved = resolvedParameter(parameter, context);
+    if (resolved && resolved.in === "path") {
+      byName.set(resolved.name, resolved);
+    }
+  }
+}
+function pathParameters(pathItem, context) {
+  const byName = /* @__PURE__ */ new Map();
+  addPathParameters(pathItem.parameters ?? [], byName, context);
+  for (const { operation: entry } of pathItemObject.pathItemOperations(pathItem)) {
+    const operation = entry.$ref ? context.refs.resolve(entry.$ref) : entry;
+    addPathParameters(operation?.parameters ?? [], byName, context);
+  }
+  return byName;
+}
+function pathTemplateParts(url, pathItem, context) {
+  const matches = url.match(PATH_PARAMETER_RE);
+  if (!matches) {
+    return null;
+  }
+  const parameters = pathParameters(pathItem, context);
+  const placeholders = matches.map((match) => {
+    const schema = parameters.get(match.slice(1, -1))?.schema;
+    return PLACEHOLDERS.get(schema?.type) ?? STRING_PLACEHOLDER;
+  });
+  return url.split(PATH_PARAMETER_RE).flatMap((text, index) => {
+    const type = placeholders[index];
+    const textPart = { kind: "text", text };
+    return type === void 0 ? [textPart] : [textPart, { kind: "placeholder", type }];
+  });
+}
+function templateText(parts) {
+  const text = parts.map(
+    (part) => part.kind === "text" ? rawTextEscapes.escapeTemplateText(part.text) : placeholderText(part.type)
+  ).join("");
+  return `\`${text}\``;
+}
+function pathItemMember(url, pathItem$1, context) {
+  const isReadonly = context.options.immutable;
+  const type = pathItem.pathItemType(pathItem$1, { path: jsonPointer.createRef(["paths", url]) }, context);
+  const parts = context.options.pathParamsAsTypes && url.includes("{") ? pathTemplateParts(url, pathItem$1, context) : null;
+  if (parts === null) {
+    const member2 = constructors.irProperty(propertyName.toPropertyName(url), type, { isReadonly });
+    return { member: member2, key: literalKey(url), type };
+  }
+  const member = {
+    kind: "indexSignature",
+    parameterName: "path",
+    parameterType: constructors.irRaw(templateText(parts)),
+    type,
+    isReadonly,
+    comments: []
+  };
+  return { member, key: { kind: "template", parts }, type };
+}
+function literalKey(url) {
+  return { kind: "literal", url };
+}
+function pathsObjectType(paths) {
+  const covering = pathKeyOverlaps.coveringTemplateKeys(
+    paths.map(({ key }) => key),
+    (coveringIndex, coveredIndex) => {
+      const coveringPath = paths[coveringIndex];
+      const coveredPath = paths[coveredIndex];
+      return coveringPath !== void 0 && coveredPath !== void 0 && pathItemConflicts.isCoveredPathItemRejected(coveredPath.type, coveringPath.type);
+    }
+  );
+  if (covering.size === 0) {
+    return constructors.irObject(paths.map(({ member }) => member));
+  }
+  const rest = paths.filter((_, index) => !covering.has(index)).map(({ member }) => member);
+  const own = paths.filter((_, index) => covering.has(index)).map(({ member }) => constructors.irObject([member]));
+  return constructors.irIntersection([constructors.irObject(rest), ...own]);
+}
+function pathsType(paths, context) {
+  const members = [];
+  for (const [url, pathItem] of documentEntries.documentEntries(paths, context.options)) {
+    if (!pathItem || typeof pathItem !== "object") {
+      continue;
+    }
+    if ("$ref" in pathItem) {
+      const options = { isReadonly: context.options.immutable };
+      const member = documentMember.documentMember(url, refType.refType(pathItem.$ref), pathItem, options);
+      members.push({ member, key: literalKey(url), type: member.type });
+      continue;
+    }
+    const startedAt = context.diagnostics.now();
+    const path = pathItemMember(url, pathItem, context);
+    members.push(path);
+    if (path.member.kind === "property") {
+      context.diagnostics.debug(`Transformed path "${url}"`, context.diagnostics.now() - startedAt);
+    }
+  }
+  return pathsObjectType(members);
+}
+
+exports.pathsType = pathsType;
+//# sourceMappingURL=paths.cjs.map

package/dist/application/transform/document/paths.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.cjs","sources":["../../../../src/application/transform/document/paths.ts"],"sourcesContent":["import { irIntersection, irObject, irProperty, irRaw } from \"../../../domain/ir/constructors.js\";\nimport type { IrMember, IrType } from \"../../../domain/ir/nodes.js\";\nimport { toPropertyName } from \"../../../domain/ir/property-name.js\";\nimport { escapeTemplateText } from \"../../../domain/ir/raw-text-escapes.js\";\nimport { createRef } from \"../../../domain/openapi/json-pointer.js\";\nimport type { OperationObject } from \"../../../domain/openapi/operation-object.js\";\nimport type {\n  ParameterObject,\n  ParameterOrReference,\n} from \"../../../domain/openapi/parameter-object.js\";\nimport {\n  type PathItemObject,\n  type PathsObject,\n  pathItemOperations,\n} from \"../../../domain/openapi/path-item-object.js\";\nimport type { ReferenceSchema, SchemaObject } from \"../../../domain/openapi/schema-object.js\";\nimport { documentEntries } from \"../document-entries.js\";\nimport { refType } from \"../ref-type.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport { documentMember } from \"./document-member.js\";\nimport { pathItemType } from \"./path-item.js\";\nimport { isCoveredPathItemRejected } from \"./path-item-conflicts.js\";\nimport {\n  coveringTemplateKeys,\n  type PathKey,\n  type PathKeyPart,\n  type PathPlaceholder,\n} from \"./path-key-overlaps.js\";\n\nconst PATH_PARAMETER_RE = /\\{[^}]+\\}/g;\n\n/** Placeholders by parameter schema type; anything else is a string placeholder. */\nconst PLACEHOLDERS: ReadonlyMap<unknown, PathPlaceholder> = new Map([\n  [\"number\", \"number\"],\n  [\"integer\", \"number\"],\n  [\"boolean\", \"boolean\"],\n]);\nconst STRING_PLACEHOLDER: PathPlaceholder = \"string\";\n\n/** `${type}`: the text of a template literal type placeholder. */\nfunction placeholderText(type: PathPlaceholder): string {\n  return `\\${${type}}`;\n}\n\nfunction resolvedParameter(\n  parameter: ParameterOrReference,\n  context: TransformContext,\n): ParameterObject | undefined {\n  return \"$ref\" in parameter && parameter.$ref\n    ? (context.refs.resolve(parameter.$ref) as ParameterObject | undefined)\n    : (parameter as ParameterObject);\n}\n\nfunction addPathParameters(\n  parameters: readonly ParameterOrReference[],\n  byName: Map<string, ParameterObject>,\n  context: TransformContext,\n): void {\n  for (const parameter of parameters) {\n    const resolved = resolvedParameter(parameter, context);\n    if (resolved && resolved.in === \"path\") {\n      byName.set(resolved.name, resolved);\n    }\n  }\n}\n\n/** Path parameters of the path item and of its operations; later definitions win. */\nfunction pathParameters(\n  pathItem: PathItemObject,\n  context: TransformContext,\n): Map<string, ParameterObject> {\n  const byName = new Map<string, ParameterObject>();\n  addPathParameters(pathItem.parameters ?? [], byName, context);\n  for (const { operation: entry } of pathItemOperations(pathItem)) {\n    const operation = (entry as ReferenceSchema).$ref\n      ? (context.refs.resolve((entry as ReferenceSchema).$ref) as OperationObject | undefined)\n      : (entry as OperationObject);\n    addPathParameters(operation?.parameters ?? [], byName, context);\n  }\n  return byName;\n}\n\n/**\n * `--path-params-as-types`: the URL as template parts, each `{name}` replaced by a placeholder for\n * its parameter's type. Null when the URL has no complete `{…}` placeholder.\n */\nfunction pathTemplateParts(\n  url: string,\n  pathItem: PathItemObject,\n  context: TransformContext,\n): PathKeyPart[] | null {\n  const matches = url.match(PATH_PARAMETER_RE);\n  if (!matches) {\n    return null;\n  }\n  const parameters = pathParameters(pathItem, context);\n  const placeholders = matches.map((match) => {\n    const schema = parameters.get(match.slice(1, -1))?.schema as SchemaObject | undefined;\n    return PLACEHOLDERS.get(schema?.type) ?? STRING_PLACEHOLDER;\n  });\n  return url.split(PATH_PARAMETER_RE).flatMap((text, index): PathKeyPart[] => {\n    const type = placeholders[index];\n    const textPart: PathKeyPart = { kind: \"text\", text };\n    return type === undefined ? [textPart] : [textPart, { kind: \"placeholder\", type }];\n  });\n}\n\n/**\n * The template literal type of the parts. The original escaped only backticks: a backslash or\n * `${` in the URL could end the literal or open a placeholder, and add code to the generated file\n * (intentional fix). So the text parts are escaped.\n */\nfunction templateText(parts: readonly PathKeyPart[]): string {\n  const text = parts\n    .map((part) =>\n      part.kind === \"text\" ? escapeTemplateText(part.text) : placeholderText(part.type),\n    )\n    .join(\"\");\n  return `\\`${text}\\``;\n}\n\n/** A path's member, its key and its path item type for the overlap check. */\ninterface PathMember {\n  readonly member: IrMember;\n  readonly key: PathKey;\n  readonly type: IrType;\n}\n\nfunction pathItemMember(\n  url: string,\n  pathItem: PathItemObject,\n  context: TransformContext,\n): PathMember {\n  const isReadonly = context.options.immutable;\n  const type = pathItemType(pathItem, { path: createRef([\"paths\", url]) }, context);\n  const parts =\n    context.options.pathParamsAsTypes && url.includes(\"{\")\n      ? pathTemplateParts(url, pathItem, context)\n      : null;\n  if (parts === null) {\n    const member = irProperty(toPropertyName(url), type, { isReadonly });\n    return { member, key: literalKey(url), type };\n  }\n  const member: IrMember = {\n    kind: \"indexSignature\",\n    parameterName: \"path\",\n    parameterType: irRaw(templateText(parts)),\n    type,\n    isReadonly,\n    comments: [],\n  };\n  return { member, key: { kind: \"template\", parts }, type };\n}\n\nfunction literalKey(url: string): PathKey {\n  return { kind: \"literal\", url };\n}\n\n/**\n * The members as one object type. When an index signature covers another key, TypeScript checks\n * the covered key's type against it. Where that check surely fails (TS2411, TS2413), each such\n * signature gets an object of its own in an intersection: an intersection does not check its parts\n * against each other, and every key has the type it had in the one object. Output that compiles\n * keeps the one object.\n */\nfunction pathsObjectType(paths: readonly PathMember[]): IrType {\n  const covering = coveringTemplateKeys(\n    paths.map(({ key }) => key),\n    (coveringIndex, coveredIndex) => {\n      const coveringPath = paths[coveringIndex];\n      const coveredPath = paths[coveredIndex];\n      return (\n        coveringPath !== undefined &&\n        coveredPath !== undefined &&\n        isCoveredPathItemRejected(coveredPath.type, coveringPath.type)\n      );\n    },\n  );\n  if (covering.size === 0) {\n    return irObject(paths.map(({ member }) => member));\n  }\n  const rest = paths.filter((_, index) => !covering.has(index)).map(({ member }) => member);\n  const own = paths\n    .filter((_, index) => covering.has(index))\n    .map(({ member }) => irObject([member]));\n  return irIntersection([irObject(rest), ...own]);\n}\n\n/** The `paths` interface body (OpenAPI 3.1 §4.8.8): one member per path, by URL. */\nexport function pathsType(paths: PathsObject, context: TransformContext): IrType {\n  const members: PathMember[] = [];\n  for (const [url, pathItem] of documentEntries(paths, context.options)) {\n    if (!pathItem || typeof pathItem !== \"object\") {\n      continue;\n    }\n    if (\"$ref\" in pathItem) {\n      const options = { isReadonly: context.options.immutable };\n      const member = documentMember(url, refType(pathItem.$ref), pathItem, options);\n      members.push({ member, key: literalKey(url), type: member.type });\n      continue;\n    }\n    const startedAt = context.diagnostics.now();\n    const path = pathItemMember(url, pathItem, context);\n    members.push(path);\n    // The original reports only paths written as properties.\n    if (path.member.kind === \"property\") {\n      context.diagnostics.debug(`Transformed path \"${url}\"`, context.diagnostics.now() - startedAt);\n    }\n  }\n  return pathsObjectType(members);\n}\n"],"names":["pathItemOperations","escapeTemplateText","pathItem","pathItemType","createRef","member","irProperty","toPropertyName","irRaw","coveringTemplateKeys","isCoveredPathItemRejected","irObject","irIntersection","documentEntries","documentMember","refType"],"mappings":"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"}

package/dist/application/transform/document/paths.mjs

@@ -0,0 +1,125 @@
+import { irProperty, irRaw, irObject, irIntersection } from '../../../domain/ir/constructors.mjs';
+import { toPropertyName } from '../../../domain/ir/property-name.mjs';
+import { escapeTemplateText } from '../../../domain/ir/raw-text-escapes.mjs';
+import { createRef } from '../../../domain/openapi/json-pointer.mjs';
+import { pathItemOperations } from '../../../domain/openapi/path-item-object.mjs';
+import { documentEntries } from '../document-entries.mjs';
+import { refType } from '../ref-type.mjs';
+import { documentMember } from './document-member.mjs';
+import { pathItemType } from './path-item.mjs';
+import { isCoveredPathItemRejected } from './path-item-conflicts.mjs';
+import { coveringTemplateKeys } from './path-key-overlaps.mjs';
+
+const PATH_PARAMETER_RE = /\{[^}]+\}/g;
+const PLACEHOLDERS = /* @__PURE__ */ new Map([
+  ["number", "number"],
+  ["integer", "number"],
+  ["boolean", "boolean"]
+]);
+const STRING_PLACEHOLDER = "string";
+function placeholderText(type) {
+  return `\${${type}}`;
+}
+function resolvedParameter(parameter, context) {
+  return "$ref" in parameter && parameter.$ref ? context.refs.resolve(parameter.$ref) : parameter;
+}
+function addPathParameters(parameters, byName, context) {
+  for (const parameter of parameters) {
+    const resolved = resolvedParameter(parameter, context);
+    if (resolved && resolved.in === "path") {
+      byName.set(resolved.name, resolved);
+    }
+  }
+}
+function pathParameters(pathItem, context) {
+  const byName = /* @__PURE__ */ new Map();
+  addPathParameters(pathItem.parameters ?? [], byName, context);
+  for (const { operation: entry } of pathItemOperations(pathItem)) {
+    const operation = entry.$ref ? context.refs.resolve(entry.$ref) : entry;
+    addPathParameters(operation?.parameters ?? [], byName, context);
+  }
+  return byName;
+}
+function pathTemplateParts(url, pathItem, context) {
+  const matches = url.match(PATH_PARAMETER_RE);
+  if (!matches) {
+    return null;
+  }
+  const parameters = pathParameters(pathItem, context);
+  const placeholders = matches.map((match) => {
+    const schema = parameters.get(match.slice(1, -1))?.schema;
+    return PLACEHOLDERS.get(schema?.type) ?? STRING_PLACEHOLDER;
+  });
+  return url.split(PATH_PARAMETER_RE).flatMap((text, index) => {
+    const type = placeholders[index];
+    const textPart = { kind: "text", text };
+    return type === void 0 ? [textPart] : [textPart, { kind: "placeholder", type }];
+  });
+}
+function templateText(parts) {
+  const text = parts.map(
+    (part) => part.kind === "text" ? escapeTemplateText(part.text) : placeholderText(part.type)
+  ).join("");
+  return `\`${text}\``;
+}
+function pathItemMember(url, pathItem, context) {
+  const isReadonly = context.options.immutable;
+  const type = pathItemType(pathItem, { path: createRef(["paths", url]) }, context);
+  const parts = context.options.pathParamsAsTypes && url.includes("{") ? pathTemplateParts(url, pathItem, context) : null;
+  if (parts === null) {
+    const member2 = irProperty(toPropertyName(url), type, { isReadonly });
+    return { member: member2, key: literalKey(url), type };
+  }
+  const member = {
+    kind: "indexSignature",
+    parameterName: "path",
+    parameterType: irRaw(templateText(parts)),
+    type,
+    isReadonly,
+    comments: []
+  };
+  return { member, key: { kind: "template", parts }, type };
+}
+function literalKey(url) {
+  return { kind: "literal", url };
+}
+function pathsObjectType(paths) {
+  const covering = coveringTemplateKeys(
+    paths.map(({ key }) => key),
+    (coveringIndex, coveredIndex) => {
+      const coveringPath = paths[coveringIndex];
+      const coveredPath = paths[coveredIndex];
+      return coveringPath !== void 0 && coveredPath !== void 0 && isCoveredPathItemRejected(coveredPath.type, coveringPath.type);
+    }
+  );
+  if (covering.size === 0) {
+    return irObject(paths.map(({ member }) => member));
+  }
+  const rest = paths.filter((_, index) => !covering.has(index)).map(({ member }) => member);
+  const own = paths.filter((_, index) => covering.has(index)).map(({ member }) => irObject([member]));
+  return irIntersection([irObject(rest), ...own]);
+}
+function pathsType(paths, context) {
+  const members = [];
+  for (const [url, pathItem] of documentEntries(paths, context.options)) {
+    if (!pathItem || typeof pathItem !== "object") {
+      continue;
+    }
+    if ("$ref" in pathItem) {
+      const options = { isReadonly: context.options.immutable };
+      const member = documentMember(url, refType(pathItem.$ref), pathItem, options);
+      members.push({ member, key: literalKey(url), type: member.type });
+      continue;
+    }
+    const startedAt = context.diagnostics.now();
+    const path = pathItemMember(url, pathItem, context);
+    members.push(path);
+    if (path.member.kind === "property") {
+      context.diagnostics.debug(`Transformed path "${url}"`, context.diagnostics.now() - startedAt);
+    }
+  }
+  return pathsObjectType(members);
+}
+
+export { pathsType };
+//# sourceMappingURL=paths.mjs.map