openapi-typesafe 1.0.0-rc.4 → 1.0.0-rc.6

package/dist/application/transform/document/path-template-refs.cjs

@@ -0,0 +1,80 @@
+'use strict';
+
+const constructors = require('../../../domain/ir/constructors.cjs');
+const documentEntries = require('../document-entries.cjs');
+const helperTypes = require('../helper-types.cjs');
+const pathTemplateKey = require('./path-template-key.cjs');
+const paths = require('./paths.cjs');
+
+const PATHS_TYPE_NAME = "paths";
+function templateIndexText(url, parts, takenUrls) {
+  const keys = pathTemplateKey.booleanExpandedKeys(parts).map(paths.pathKeyOf).filter((key) => paths.isUntakenKey(url, key, takenUrls));
+  const texts = keys.map(
+    (key) => key.kind === "literal" ? JSON.stringify(key.url) : pathTemplateKey.templateText(key.parts)
+  );
+  return texts.length === 0 ? void 0 : texts.join(" | ");
+}
+function unmatchedTemplateKeys(paths, context) {
+  const keys = /* @__PURE__ */ new Map();
+  if (!context.options.pathParamsAsTypes || typeof paths !== "object" || paths === null) {
+    return keys;
+  }
+  const takenUrls = new Set(Object.keys(paths));
+  for (const [url, pathItem] of documentEntries.documentEntries(paths, context.options)) {
+    if (!pathItem || typeof pathItem !== "object" || "$ref" in pathItem || !url.includes("{")) {
+      continue;
+    }
+    const parts = pathTemplateKey.pathTemplateParts(url, pathItem, context);
+    const index = parts === null ? void 0 : templateIndexText(url, parts, takenUrls);
+    const isUnmatched = parts?.some(
+      (part) => part.kind === "placeholder" && part.type !== "string"
+    );
+    if (isUnmatched && index !== void 0) {
+      keys.set(url, index);
+    }
+  }
+  return keys;
+}
+function isNode(value) {
+  return typeof value === "object" && value !== null;
+}
+function isBarePathsReference(node) {
+  const reference = node;
+  return reference?.kind === "reference" && reference.name === PATHS_TYPE_NAME && reference.typeArguments?.length === 0;
+}
+function isPathsRoot(node) {
+  const reference = node;
+  const typeArguments = reference?.typeArguments;
+  const isDeepRoot = reference?.kind === "reference" && reference.name === helperTypes.HELPER_TYPES.flattenedDeepRequired.name && typeArguments?.length === 1 && isBarePathsReference(typeArguments[0]);
+  return isDeepRoot || isBarePathsReference(node);
+}
+function pathsIndexUrl(node) {
+  const index = node.index;
+  const isPathsIndex = node.kind === "indexedAccess" && isPathsRoot(node.object) && index?.kind === "stringLiteral";
+  return isPathsIndex ? index.value : void 0;
+}
+function rewrittenNode(value, keys) {
+  if (Array.isArray(value)) {
+    return value.map((item) => rewrittenNode(item, keys));
+  }
+  if (!isNode(value)) {
+    return value;
+  }
+  const template = keys.get(pathsIndexUrl(value) ?? "");
+  if (template !== void 0) {
+    return { ...value, index: constructors.irRaw(template) };
+  }
+  return Object.fromEntries(
+    Object.entries(value).map(([key, child]) => [
+      key,
+      key === "origin" ? child : rewrittenNode(child, keys)
+    ])
+  );
+}
+function withTemplatePathRefs(declarations, keys) {
+  return keys.size === 0 ? [...declarations] : rewrittenNode(declarations, keys);
+}
+
+exports.unmatchedTemplateKeys = unmatchedTemplateKeys;
+exports.withTemplatePathRefs = withTemplatePathRefs;
+//# sourceMappingURL=path-template-refs.cjs.map

package/dist/application/transform/document/path-template-refs.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-template-refs.cjs","sources":["../../../../src/application/transform/document/path-template-refs.ts"],"sourcesContent":["import { irRaw } from \"../../../domain/ir/constructors.js\";\nimport type { IrDeclaration } from \"../../../domain/ir/nodes.js\";\nimport type { PathsObject } from \"../../../domain/openapi/path-item-object.js\";\nimport { documentEntries } from \"../document-entries.js\";\nimport { HELPER_TYPES } from \"../helper-types.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport type { PathKeyPart } from \"./path-key-overlaps.js\";\nimport { booleanExpandedKeys, pathTemplateParts, templateText } from \"./path-template-key.js\";\nimport { isUntakenKey, pathKeyOf } from \"./paths.js\";\n\n/**\n * `--path-params-as-types` and `$ref`s into a templated path. Such a path is an index signature\n * of `paths` (`` [path: `/pets/${number}`] ``), so `paths[\"/pets/{id}\"]`, the type of a `$ref`\n * to it, names no key: `{id}` is no number (TS2339). The reference indexes `paths` by the\n * template instead, which reaches the signature; so does the type of an `--enum-values` array,\n * which indexes `FlattenedDeepRequired<paths>`. With only `${string}` placeholders the URL\n * itself matches the template and the output compiles, so it stays as it is.\n */\n\nconst PATHS_TYPE_NAME = \"paths\";\n\n/**\n * The index of a templated path: the union of the keys it is written with. A `${boolean}` key the\n * document's own path took (`/flags/true` next to `/flags/{enabled}`) is left out, so the index\n * names only this path's members. Undefined when every key was taken: the path has no member.\n */\nfunction templateIndexText(url: string, parts: readonly PathKeyPart[], takenUrls: Set<string>) {\n  const keys = booleanExpandedKeys(parts)\n    .map(pathKeyOf)\n    .filter((key) => isUntakenKey(url, key, takenUrls));\n  const texts = keys.map((key) =>\n    key.kind === \"literal\" ? JSON.stringify(key.url) : templateText(key.parts),\n  );\n  return texts.length === 0 ? undefined : texts.join(\" | \");\n}\n\n/** The index of each templated path whose URL does not match its keys, by URL. */\nexport function unmatchedTemplateKeys(\n  paths: PathsObject | null | undefined,\n  context: TransformContext,\n): ReadonlyMap<string, string> {\n  const keys = new Map<string, string>();\n  // A document may hold any value as `paths`; one that is no object has no paths.\n  if (!context.options.pathParamsAsTypes || typeof paths !== \"object\" || paths === null) {\n    return keys;\n  }\n  // The same walk as `pathMembers`, so a URL is taken by the same path as there.\n  const takenUrls = new Set(Object.keys(paths));\n  for (const [url, pathItem] of documentEntries(paths, context.options)) {\n    if (!pathItem || typeof pathItem !== \"object\" || \"$ref\" in pathItem || !url.includes(\"{\")) {\n      continue;\n    }\n    const parts = pathTemplateParts(url, pathItem, context);\n    const index = parts === null ? undefined : templateIndexText(url, parts, takenUrls);\n    const isUnmatched = parts?.some(\n      (part) => part.kind === \"placeholder\" && part.type !== \"string\",\n    );\n    if (isUnmatched && index !== undefined) {\n      keys.set(url, index);\n    }\n  }\n  return keys;\n}\n\nfunction isNode(value: unknown): value is Readonly<Record<string, unknown>> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction isBarePathsReference(node: unknown): boolean {\n  const reference = node as Readonly<Record<string, unknown>> | undefined;\n  return (\n    reference?.kind === \"reference\" &&\n    reference.name === PATHS_TYPE_NAME &&\n    (reference.typeArguments as readonly unknown[] | undefined)?.length === 0\n  );\n}\n\n/**\n * The `paths` root as a `$ref` or an `--enum-values` array indexes it: `paths`, or\n * `FlattenedDeepRequired<paths>` (`rootType`), whose mapped keys are those of `paths`.\n */\nfunction isPathsRoot(node: unknown): boolean {\n  const reference = node as Readonly<Record<string, unknown>> | undefined;\n  const typeArguments = reference?.typeArguments as readonly unknown[] | undefined;\n  const isDeepRoot =\n    reference?.kind === \"reference\" &&\n    reference.name === HELPER_TYPES.flattenedDeepRequired.name &&\n    typeArguments?.length === 1 &&\n    isBarePathsReference(typeArguments[0]);\n  return isDeepRoot || isBarePathsReference(node);\n}\n\n/** `paths[\"<url>\"]`: an index of the `paths` root by a string literal. */\nfunction pathsIndexUrl(node: Readonly<Record<string, unknown>>): string | undefined {\n  const index = node.index as Readonly<Record<string, unknown>> | undefined;\n  const isPathsIndex =\n    node.kind === \"indexedAccess\" && isPathsRoot(node.object) && index?.kind === \"stringLiteral\";\n  return isPathsIndex ? (index.value as string) : undefined;\n}\n\nfunction rewrittenNode(value: unknown, keys: ReadonlyMap<string, string>): unknown {\n  if (Array.isArray(value)) {\n    return value.map((item) => rewrittenNode(item, keys));\n  }\n  if (!isNode(value)) {\n    return value;\n  }\n  const template = keys.get(pathsIndexUrl(value) ?? \"\");\n  if (template !== undefined) {\n    return { ...value, index: irRaw(template) };\n  }\n  // `origin` holds the compiler node a raw type was printed from; it is not IR.\n  return Object.fromEntries(\n    Object.entries(value).map(([key, child]) => [\n      key,\n      key === \"origin\" ? child : rewrittenNode(child, keys),\n    ]),\n  );\n}\n\n/** The declarations with each `paths[\"<url>\"]` of an unmatched template indexed by it. */\nexport function withTemplatePathRefs<T extends IrDeclaration>(\n  declarations: readonly T[],\n  keys: ReadonlyMap<string, string>,\n): T[] {\n  return keys.size === 0 ? [...declarations] : (rewrittenNode(declarations, keys) as T[]);\n}\n"],"names":["booleanExpandedKeys","pathKeyOf","isUntakenKey","templateText","documentEntries","pathTemplateParts","HELPER_TYPES","irRaw"],"mappings":"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"}

package/dist/application/transform/document/path-template-refs.mjs

@@ -0,0 +1,77 @@
+import { irRaw } from '../../../domain/ir/constructors.mjs';
+import { documentEntries } from '../document-entries.mjs';
+import { HELPER_TYPES } from '../helper-types.mjs';
+import { pathTemplateParts, booleanExpandedKeys, templateText } from './path-template-key.mjs';
+import { pathKeyOf, isUntakenKey } from './paths.mjs';
+
+const PATHS_TYPE_NAME = "paths";
+function templateIndexText(url, parts, takenUrls) {
+  const keys = booleanExpandedKeys(parts).map(pathKeyOf).filter((key) => isUntakenKey(url, key, takenUrls));
+  const texts = keys.map(
+    (key) => key.kind === "literal" ? JSON.stringify(key.url) : templateText(key.parts)
+  );
+  return texts.length === 0 ? void 0 : texts.join(" | ");
+}
+function unmatchedTemplateKeys(paths, context) {
+  const keys = /* @__PURE__ */ new Map();
+  if (!context.options.pathParamsAsTypes || typeof paths !== "object" || paths === null) {
+    return keys;
+  }
+  const takenUrls = new Set(Object.keys(paths));
+  for (const [url, pathItem] of documentEntries(paths, context.options)) {
+    if (!pathItem || typeof pathItem !== "object" || "$ref" in pathItem || !url.includes("{")) {
+      continue;
+    }
+    const parts = pathTemplateParts(url, pathItem, context);
+    const index = parts === null ? void 0 : templateIndexText(url, parts, takenUrls);
+    const isUnmatched = parts?.some(
+      (part) => part.kind === "placeholder" && part.type !== "string"
+    );
+    if (isUnmatched && index !== void 0) {
+      keys.set(url, index);
+    }
+  }
+  return keys;
+}
+function isNode(value) {
+  return typeof value === "object" && value !== null;
+}
+function isBarePathsReference(node) {
+  const reference = node;
+  return reference?.kind === "reference" && reference.name === PATHS_TYPE_NAME && reference.typeArguments?.length === 0;
+}
+function isPathsRoot(node) {
+  const reference = node;
+  const typeArguments = reference?.typeArguments;
+  const isDeepRoot = reference?.kind === "reference" && reference.name === HELPER_TYPES.flattenedDeepRequired.name && typeArguments?.length === 1 && isBarePathsReference(typeArguments[0]);
+  return isDeepRoot || isBarePathsReference(node);
+}
+function pathsIndexUrl(node) {
+  const index = node.index;
+  const isPathsIndex = node.kind === "indexedAccess" && isPathsRoot(node.object) && index?.kind === "stringLiteral";
+  return isPathsIndex ? index.value : void 0;
+}
+function rewrittenNode(value, keys) {
+  if (Array.isArray(value)) {
+    return value.map((item) => rewrittenNode(item, keys));
+  }
+  if (!isNode(value)) {
+    return value;
+  }
+  const template = keys.get(pathsIndexUrl(value) ?? "");
+  if (template !== void 0) {
+    return { ...value, index: irRaw(template) };
+  }
+  return Object.fromEntries(
+    Object.entries(value).map(([key, child]) => [
+      key,
+      key === "origin" ? child : rewrittenNode(child, keys)
+    ])
+  );
+}
+function withTemplatePathRefs(declarations, keys) {
+  return keys.size === 0 ? [...declarations] : rewrittenNode(declarations, keys);
+}
+
+export { unmatchedTemplateKeys, withTemplatePathRefs };
+//# sourceMappingURL=path-template-refs.mjs.map

package/dist/application/transform/document/path-template-refs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-template-refs.mjs","sources":["../../../../src/application/transform/document/path-template-refs.ts"],"sourcesContent":["import { irRaw } from \"../../../domain/ir/constructors.js\";\nimport type { IrDeclaration } from \"../../../domain/ir/nodes.js\";\nimport type { PathsObject } from \"../../../domain/openapi/path-item-object.js\";\nimport { documentEntries } from \"../document-entries.js\";\nimport { HELPER_TYPES } from \"../helper-types.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport type { PathKeyPart } from \"./path-key-overlaps.js\";\nimport { booleanExpandedKeys, pathTemplateParts, templateText } from \"./path-template-key.js\";\nimport { isUntakenKey, pathKeyOf } from \"./paths.js\";\n\n/**\n * `--path-params-as-types` and `$ref`s into a templated path. Such a path is an index signature\n * of `paths` (`` [path: `/pets/${number}`] ``), so `paths[\"/pets/{id}\"]`, the type of a `$ref`\n * to it, names no key: `{id}` is no number (TS2339). The reference indexes `paths` by the\n * template instead, which reaches the signature; so does the type of an `--enum-values` array,\n * which indexes `FlattenedDeepRequired<paths>`. With only `${string}` placeholders the URL\n * itself matches the template and the output compiles, so it stays as it is.\n */\n\nconst PATHS_TYPE_NAME = \"paths\";\n\n/**\n * The index of a templated path: the union of the keys it is written with. A `${boolean}` key the\n * document's own path took (`/flags/true` next to `/flags/{enabled}`) is left out, so the index\n * names only this path's members. Undefined when every key was taken: the path has no member.\n */\nfunction templateIndexText(url: string, parts: readonly PathKeyPart[], takenUrls: Set<string>) {\n  const keys = booleanExpandedKeys(parts)\n    .map(pathKeyOf)\n    .filter((key) => isUntakenKey(url, key, takenUrls));\n  const texts = keys.map((key) =>\n    key.kind === \"literal\" ? JSON.stringify(key.url) : templateText(key.parts),\n  );\n  return texts.length === 0 ? undefined : texts.join(\" | \");\n}\n\n/** The index of each templated path whose URL does not match its keys, by URL. */\nexport function unmatchedTemplateKeys(\n  paths: PathsObject | null | undefined,\n  context: TransformContext,\n): ReadonlyMap<string, string> {\n  const keys = new Map<string, string>();\n  // A document may hold any value as `paths`; one that is no object has no paths.\n  if (!context.options.pathParamsAsTypes || typeof paths !== \"object\" || paths === null) {\n    return keys;\n  }\n  // The same walk as `pathMembers`, so a URL is taken by the same path as there.\n  const takenUrls = new Set(Object.keys(paths));\n  for (const [url, pathItem] of documentEntries(paths, context.options)) {\n    if (!pathItem || typeof pathItem !== \"object\" || \"$ref\" in pathItem || !url.includes(\"{\")) {\n      continue;\n    }\n    const parts = pathTemplateParts(url, pathItem, context);\n    const index = parts === null ? undefined : templateIndexText(url, parts, takenUrls);\n    const isUnmatched = parts?.some(\n      (part) => part.kind === \"placeholder\" && part.type !== \"string\",\n    );\n    if (isUnmatched && index !== undefined) {\n      keys.set(url, index);\n    }\n  }\n  return keys;\n}\n\nfunction isNode(value: unknown): value is Readonly<Record<string, unknown>> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction isBarePathsReference(node: unknown): boolean {\n  const reference = node as Readonly<Record<string, unknown>> | undefined;\n  return (\n    reference?.kind === \"reference\" &&\n    reference.name === PATHS_TYPE_NAME &&\n    (reference.typeArguments as readonly unknown[] | undefined)?.length === 0\n  );\n}\n\n/**\n * The `paths` root as a `$ref` or an `--enum-values` array indexes it: `paths`, or\n * `FlattenedDeepRequired<paths>` (`rootType`), whose mapped keys are those of `paths`.\n */\nfunction isPathsRoot(node: unknown): boolean {\n  const reference = node as Readonly<Record<string, unknown>> | undefined;\n  const typeArguments = reference?.typeArguments as readonly unknown[] | undefined;\n  const isDeepRoot =\n    reference?.kind === \"reference\" &&\n    reference.name === HELPER_TYPES.flattenedDeepRequired.name &&\n    typeArguments?.length === 1 &&\n    isBarePathsReference(typeArguments[0]);\n  return isDeepRoot || isBarePathsReference(node);\n}\n\n/** `paths[\"<url>\"]`: an index of the `paths` root by a string literal. */\nfunction pathsIndexUrl(node: Readonly<Record<string, unknown>>): string | undefined {\n  const index = node.index as Readonly<Record<string, unknown>> | undefined;\n  const isPathsIndex =\n    node.kind === \"indexedAccess\" && isPathsRoot(node.object) && index?.kind === \"stringLiteral\";\n  return isPathsIndex ? (index.value as string) : undefined;\n}\n\nfunction rewrittenNode(value: unknown, keys: ReadonlyMap<string, string>): unknown {\n  if (Array.isArray(value)) {\n    return value.map((item) => rewrittenNode(item, keys));\n  }\n  if (!isNode(value)) {\n    return value;\n  }\n  const template = keys.get(pathsIndexUrl(value) ?? \"\");\n  if (template !== undefined) {\n    return { ...value, index: irRaw(template) };\n  }\n  // `origin` holds the compiler node a raw type was printed from; it is not IR.\n  return Object.fromEntries(\n    Object.entries(value).map(([key, child]) => [\n      key,\n      key === \"origin\" ? child : rewrittenNode(child, keys),\n    ]),\n  );\n}\n\n/** The declarations with each `paths[\"<url>\"]` of an unmatched template indexed by it. */\nexport function withTemplatePathRefs<T extends IrDeclaration>(\n  declarations: readonly T[],\n  keys: ReadonlyMap<string, string>,\n): T[] {\n  return keys.size === 0 ? [...declarations] : (rewrittenNode(declarations, keys) as T[]);\n}\n"],"names":[],"mappings":"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"}

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

@@ -33,9 +33,10 @@ function pathItemEntries(pathItem) {
     return METHODS.has(key) ? [[key, value]] : [];
   });
 }
-function pathOperations(paths) {
+const INCLUDES_EVERY_OPERATION = () => true;
+function pathOperations(paths, isIncluded) {
   return Object.entries(paths).flatMap(
-    ([url, pathItem]) => pathItemEntries(pathItem).map(([method, operation]) => {
+    ([url, pathItem]) => pathItemEntries(pathItem).filter(([, operation]) => isIncluded(operation)).map(([method, operation]) => {
       const operationId = operation.operationId || void 0;
       return { url, method, operationId };
     })
@@ -57,17 +58,17 @@ function uniqueNames(operations) {
   });
   return numberedNames.withNumberedRepeats(named, (name, count) => `${name}${count}`);
 }
-function apiPathsEnum(paths) {
-  const operations = pathOperations(paths);
+function apiPathsEnum(paths, isIncluded = INCLUDES_EVERY_OPERATION) {
+  const operations = pathOperations(paths, isIncluded);
   const names = uniqueNames(operations);
   return {
     values: operations.map((operation) => operation.url),
     metadata: names.map((name) => ({ name, description: void 0 }))
   };
 }
-function apiPathsEnumDeclaration(paths) {
+function apiPathsEnumDeclaration(paths, isIncluded = INCLUDES_EVERY_OPERATION) {
   const naming = new enumNaming.EnumNaming();
-  return enumNaming.enumDeclaration(naming.enumName(API_PATHS_NAME), apiPathsEnum(paths), naming);
+  return enumNaming.enumDeclaration(naming.enumName(API_PATHS_NAME), apiPathsEnum(paths, isIncluded), naming);
 }
 
 exports.API_PATHS_NAME = API_PATHS_NAME;

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

@@ -1 +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_]+/;\nexport const 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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"}
+{"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 OperationEntry,\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_]+/;\nexport const 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\n/** Which operations get a member; the generator leaves out those `--exclude-deprecated` drops. */\nexport type OperationFilter = (operation: OperationEntry) => boolean;\n\nconst INCLUDES_EVERY_OPERATION: OperationFilter = () => true;\n\nfunction pathOperations(paths: PathsObject, isIncluded: OperationFilter): PathOperation[] {\n  return Object.entries(paths).flatMap(([url, pathItem]) =>\n    pathItemEntries(pathItem)\n      .filter(([, operation]) => isIncluded(operation as OperationEntry))\n      .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(\n  paths: PathsObject,\n  isIncluded: OperationFilter = INCLUDES_EVERY_OPERATION,\n): ApiPathsEnum {\n  const operations = pathOperations(paths, isIncluded);\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(\n  paths: PathsObject,\n  isIncluded: OperationFilter = INCLUDES_EVERY_OPERATION,\n): IrEnumDeclaration {\n  const naming = new EnumNaming();\n  return enumDeclaration(naming.enumName(API_PATHS_NAME), apiPathsEnum(paths, isIncluded), 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

@@ -31,9 +31,10 @@ function pathItemEntries(pathItem) {
     return METHODS.has(key) ? [[key, value]] : [];
   });
 }
-function pathOperations(paths) {
+const INCLUDES_EVERY_OPERATION = () => true;
+function pathOperations(paths, isIncluded) {
   return Object.entries(paths).flatMap(
-    ([url, pathItem]) => pathItemEntries(pathItem).map(([method, operation]) => {
+    ([url, pathItem]) => pathItemEntries(pathItem).filter(([, operation]) => isIncluded(operation)).map(([method, operation]) => {
       const operationId = operation.operationId || void 0;
       return { url, method, operationId };
     })
@@ -55,17 +56,17 @@ function uniqueNames(operations) {
   });
   return withNumberedRepeats(named, (name, count) => `${name}${count}`);
 }
-function apiPathsEnum(paths) {
-  const operations = pathOperations(paths);
+function apiPathsEnum(paths, isIncluded = INCLUDES_EVERY_OPERATION) {
+  const operations = pathOperations(paths, isIncluded);
   const names = uniqueNames(operations);
   return {
     values: operations.map((operation) => operation.url),
     metadata: names.map((name) => ({ name, description: void 0 }))
   };
 }
-function apiPathsEnumDeclaration(paths) {
+function apiPathsEnumDeclaration(paths, isIncluded = INCLUDES_EVERY_OPERATION) {
   const naming = new EnumNaming();
-  return enumDeclaration(naming.enumName(API_PATHS_NAME), apiPathsEnum(paths), naming);
+  return enumDeclaration(naming.enumName(API_PATHS_NAME), apiPathsEnum(paths, isIncluded), naming);
 }
 
 export { API_PATHS_NAME, apiPathsEnum, apiPathsEnumDeclaration };

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

@@ -1 +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_]+/;\nexport const 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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"}
+{"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 OperationEntry,\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_]+/;\nexport const 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\n/** Which operations get a member; the generator leaves out those `--exclude-deprecated` drops. */\nexport type OperationFilter = (operation: OperationEntry) => boolean;\n\nconst INCLUDES_EVERY_OPERATION: OperationFilter = () => true;\n\nfunction pathOperations(paths: PathsObject, isIncluded: OperationFilter): PathOperation[] {\n  return Object.entries(paths).flatMap(([url, pathItem]) =>\n    pathItemEntries(pathItem)\n      .filter(([, operation]) => isIncluded(operation as OperationEntry))\n      .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(\n  paths: PathsObject,\n  isIncluded: OperationFilter = INCLUDES_EVERY_OPERATION,\n): ApiPathsEnum {\n  const operations = pathOperations(paths, isIncluded);\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(\n  paths: PathsObject,\n  isIncluded: OperationFilter = INCLUDES_EVERY_OPERATION,\n): IrEnumDeclaration {\n  const naming = new EnumNaming();\n  return enumDeclaration(naming.enumName(API_PATHS_NAME), apiPathsEnum(paths, isIncluded), naming);\n}\n"],"names":[],"mappings":";;;;AAeA,MAAM,oBAAA,GAAuB,oBAAA;AAE7B,MAAM,mBAAA,GAAsB,wBAAA;AACrB,MAAM,cAAA,GAAiB;AAC9B,MAAM,0BAA+B,IAAI,GAAA,CAAoB,CAAC,GAAG,YAAA,EAAc,YAAY,CAAC,CAAA;AAS5F,SAAS,UAAA,CAAW,QAAgB,GAAA,EAAqB;AACvD,EAAA,OAAO,CAAA,EAAG,MAAM,CAAA,EAAG,GAAG,CAAA,CAAA,CACnB,MAAM,GAAG,CAAA,CACT,GAAA,CAAI,CAAC,IAAA,KAAS;AACb,IAAA,MAAM,WAAA,GAAc,KAAK,MAAA,CAAO,CAAC,EAAE,WAAA,EAAY,GAAI,IAAA,CAAK,KAAA,CAAM,CAAC,CAAA;AAC/D,IAAA,OAAO,WAAA,CAAY,OAAA,CAAQ,mBAAA,EAAqB,EAAE,CAAA;AAAA,EACpD,CAAC,CAAA,CACA,IAAA,CAAK,EAAE,CAAA;AACZ;AAGA,SAAS,cAAc,IAAA,EAAsB;AAC3C,EAAA,OAAO,KACJ,KAAA,CAAM,cAAc,EACpB,GAAA,CAAI,CAAC,SAAS,IAAA,CAAK,MAAA,CAAO,CAAC,CAAA,CAAE,WAAA,KAAgB,IAAA,CAAK,KAAA,CAAM,CAAC,CAAC,CAAA,CAC1D,KAAK,EAAE,CAAA;AACZ;AAGA,SAAS,iBAAA,CAAkB,QAAgB,GAAA,EAAqB;AAC9D,EAAA,MAAM,QAAQ,GAAA,CAAI,KAAA,CAAM,GAAG,CAAA,CAAE,GAAA,CAAI,CAAC,IAAA,KAAS;AACzC,IAAA,MAAM,SAAA,GAAY,oBAAA,CAAqB,IAAA,CAAK,IAAI,CAAA;AAChD,IAAA,MAAM,IAAA,GAAO,SAAA,GAAY,CAAC,CAAA,IAAK,YAAY,CAAC,CAAA;AAC5C,IAAA,OAAO,SAAS,MAAA,GAAY,IAAA,GAAO,CAAA,EAAA,EAAK,aAAA,CAAc,IAAI,CAAC,CAAA,CAAA;AAAA,EAC7D,CAAC,CAAA;AACD,EAAA,OAAO,UAAA,CAAW,MAAA,EAAQ,KAAA,CAAM,IAAA,CAAK,GAAG,CAAC,CAAA;AAC3C;AAYA,SAAS,gBAAgB,QAAA,EAAuC;AAC9D,EAAA,OAAO,MAAA,CAAO,QAAQ,QAAQ,CAAA,CAAE,QAAQ,CAAC,CAAC,GAAA,EAAK,KAAK,CAAA,KAA2B;AAC7E,IAAA,IAAI,QAAQ,yBAAA,EAA2B;AACrC,MAAA,OAAO,OAAO,UAAU,QAAA,IAAY,KAAA,KAAU,OAAO,MAAA,CAAO,OAAA,CAAQ,KAAK,CAAA,GAAI,EAAC;AAAA,IAChF;AACA,IAAA,OAAO,OAAA,CAAQ,GAAA,CAAI,GAAG,CAAA,GAAI,CAAC,CAAC,GAAA,EAAK,KAAK,CAAC,CAAA,GAAI,EAAC;AAAA,EAC9C,CAAC,CAAA;AACH;AAKA,MAAM,2BAA4C,MAAM,IAAA;AAExD,SAAS,cAAA,CAAe,OAAoB,UAAA,EAA8C;AACxF,EAAA,OAAO,MAAA,CAAO,OAAA,CAAQ,KAAK,CAAA,CAAE,OAAA;AAAA,IAAQ,CAAC,CAAC,GAAA,EAAK,QAAQ,MAClD,eAAA,CAAgB,QAAQ,CAAA,CACrB,MAAA,CAAO,CAAC,GAAG,SAAS,CAAA,KAAM,UAAA,CAAW,SAA2B,CAAC,CAAA,CACjE,IAAI,CAAC,CAAC,MAAA,EAAQ,SAAS,CAAA,KAAM;AAC5B,MAAA,MAAM,WAAA,GAAe,UAA8B,WAAA,IAAe,MAAA;AAClE,MAAA,OAAO,EAAE,GAAA,EAAK,MAAA,EAAQ,WAAA,EAAY;AAAA,IACpC,CAAC;AAAA,GACL;AACF;AAEA,SAAS,QAAQ,KAAA,EAA+C;AAC9D,EAAA,MAAM,MAAA,uBAAa,GAAA,EAAoB;AACvC,EAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,IAAA,MAAA,CAAO,IAAI,IAAA,EAAA,CAAO,MAAA,CAAO,IAAI,IAAI,CAAA,IAAK,KAAK,CAAC,CAAA;AAAA,EAC9C;AACA,EAAA,OAAO,MAAA;AACT;AAMA,SAAS,YAAY,UAAA,EAAgD;AACnE,EAAA,MAAM,IAAA,GAAO,UAAA,CAAW,GAAA,CAAI,CAAC,EAAA,KAAO,EAAA,CAAG,WAAA,IAAe,UAAA,CAAW,EAAA,CAAG,MAAA,EAAQ,EAAA,CAAG,GAAG,CAAC,CAAA;AACnF,EAAA,MAAM,MAAA,GAAS,QAAQ,IAAI,CAAA;AAC3B,EAAA,MAAM,KAAA,GAAQ,UAAA,CAAW,GAAA,CAAI,CAAC,IAAI,KAAA,KAAU;AAC1C,IAAA,MAAM,iBAAA,GACJ,EAAA,CAAG,WAAA,KAAgB,MAAA,IAAA,CAAc,MAAA,CAAO,IAAI,IAAA,CAAK,KAAK,CAAW,CAAA,IAAK,CAAA,IAAK,CAAA;AAC7E,IAAA,OAAO,iBAAA,GAAoB,kBAAkB,EAAA,CAAG,MAAA,EAAQ,GAAG,GAAG,CAAA,GAAK,KAAK,KAAK,CAAA;AAAA,EAC/E,CAAC,CAAA;AACD,EAAA,OAAO,mBAAA,CAAoB,OAAO,CAAC,IAAA,EAAM,UAAU,CAAA,EAAG,IAAI,CAAA,EAAG,KAAK,CAAA,CAAE,CAAA;AACtE;AAMO,SAAS,YAAA,CACd,KAAA,EACA,UAAA,GAA8B,wBAAA,EAChB;AACd,EAAA,MAAM,UAAA,GAAa,cAAA,CAAe,KAAA,EAAO,UAAU,CAAA;AACnD,EAAA,MAAM,KAAA,GAAQ,YAAY,UAAU,CAAA;AACpC,EAAA,OAAO;AAAA,IACL,QAAQ,UAAA,CAAW,GAAA,CAAI,CAAC,SAAA,KAAc,UAAU,GAAG,CAAA;AAAA,IACnD,QAAA,EAAU,MAAM,GAAA,CAAI,CAAC,UAAU,EAAE,IAAA,EAAM,WAAA,EAAa,MAAA,EAAU,CAAE;AAAA,GAClE;AACF;AAMO,SAAS,uBAAA,CACd,KAAA,EACA,UAAA,GAA8B,wBAAA,EACX;AACnB,EAAA,MAAM,MAAA,GAAS,IAAI,UAAA,EAAW;AAC9B,EAAA,OAAO,eAAA,CAAgB,OAAO,QAAA,CAAS,cAAc,GAAG,YAAA,CAAa,KAAA,EAAO,UAAU,CAAA,EAAG,MAAM,CAAA;AACjG;;"}

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

@@ -2,92 +2,61 @@
 
 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 outputFixes = require('../../../domain/output-fixes.cjs');
 const documentEntries = require('../document-entries.cjs');
 const refType = require('../ref-type.cjs');
 const declaredTypes = require('./declared-types.cjs');
 const documentMember = require('./document-member.cjs');
 const pathItem = require('./path-item.cjs');
 const pathKeyOverlaps = require('./path-key-overlaps.cjs');
-const pathTemplateReplace = require('./path-template-replace.cjs');
+const pathTemplateKey = require('./path-template-key.cjs');
 const typeAssignability = require('./type-assignability.cjs');
 
-const PATH_PARAMETER_RE = /\{[^{}]+\}/g;
-const PLACEHOLDERS = /* @__PURE__ */ new Map([
-  ["number", "number"],
-  ["integer", "number"],
-  ["boolean", "boolean"]
-]);
-const STRING_PLACEHOLDER = "string";
-function resolvedParameter(parameter, context) {
-  return "$ref" in parameter && parameter.$ref ? context.refs.resolve(parameter.$ref) : parameter;
+function pathKeyOf(parts) {
+  const plainUrl = pathTemplateKey.plainUrlOf(parts);
+  return plainUrl === null ? { kind: "template", parts } : literalKey(plainUrl);
 }
-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);
+function keyMember(url, parts, type, isReadonly) {
+  const key = pathKeyOf(parts);
+  if (key.kind === "literal") {
+    const member2 = constructors.irProperty(propertyName.toPropertyName(key.url), type, { isReadonly });
+    return { url, member: member2, key, type };
   }
-  return byName;
-}
-function splitTemplateParts(url, matches) {
-  return url.split(PATH_PARAMETER_RE).flatMap((text, index) => {
-    const type = matches[index]?.type;
-    const textPart = { kind: "text", text };
-    return type === void 0 ? [textPart] : [textPart, { kind: "placeholder", type }];
-  });
+  const member = {
+    kind: "indexSignature",
+    parameterName: "path",
+    parameterType: constructors.irRaw(pathTemplateKey.templateText(parts)),
+    type,
+    isReadonly,
+    comments: []
+  };
+  return { url, member, key, type };
 }
-function pathTemplateParts(url, pathItem, context) {
-  const found = url.match(PATH_PARAMETER_RE);
-  if (!found) {
-    return null;
+function isUntakenKey(url, key, takenUrls) {
+  const isExpandedUrl = key.kind === "literal" && key.url !== url;
+  if (!isExpandedUrl) {
+    return true;
   }
-  const parameters = pathParameters(pathItem, context);
-  const matches = found.map((match) => {
-    const schema = parameters.get(match.slice(1, -1))?.schema;
-    return { match, type: PLACEHOLDERS.get(schema?.type) ?? STRING_PLACEHOLDER };
-  });
-  return context.options.fixes.has(outputFixes.FIX.PATH_PARAM_TYPE_NAMES) ? splitTemplateParts(url, matches) : pathTemplateReplace.replacedTemplateParts(url, matches);
+  const isTaken = takenUrls.has(key.url);
+  takenUrls.add(key.url);
+  return !isTaken;
 }
-function templateText(parts) {
-  const text = parts.map(
-    (part) => part.kind === "text" ? rawTextEscapes.escapeTemplateText(part.text) : pathTemplateReplace.placeholderText(part.type)
-  ).join("");
-  return `\`${text}\``;
+function withoutTakenUrls(url, members, takenUrls) {
+  return members.filter(({ key }) => isUntakenKey(url, key, takenUrls));
 }
-function pathItemMember(url, pathItem$1, context) {
+function pathItemMembers(url, pathItem$1, context) {
   const isReadonly = context.options.immutable;
   const type = pathItem.pathItemType(
     pathItem$1,
     { path: jsonPointer.appendPointer(jsonPointer.ROOT_POINTER, ["paths", url]) },
     context
   );
-  const parts = context.options.pathParamsAsTypes && url.includes("{") ? pathTemplateParts(url, pathItem$1, context) : null;
+  const parts = context.options.pathParamsAsTypes && url.includes("{") ? pathTemplateKey.pathTemplateParts(url, pathItem$1, context) : null;
   if (parts === null) {
-    const member2 = constructors.irProperty(propertyName.toPropertyName(url), type, { isReadonly });
-    return { url, member: member2, key: literalKey(url), type };
+    const member = constructors.irProperty(propertyName.toPropertyName(url), type, { isReadonly });
+    return [{ url, member, key: literalKey(url), type }];
   }
-  const member = {
-    kind: "indexSignature",
-    parameterName: "path",
-    parameterType: constructors.irRaw(templateText(parts)),
-    type,
-    isReadonly,
-    comments: []
-  };
-  return { url, member, key: { kind: "template", parts }, type };
+  return pathTemplateKey.booleanExpandedKeys(parts).map((key) => keyMember(url, key, type, isReadonly));
 }
 function literalKey(url) {
   return { kind: "literal", url };
@@ -128,6 +97,7 @@ function pathsObjectType(paths, lookup = declaredTypes.NO_DECLARED_TYPES) {
 }
 function pathMembers(paths, context) {
   const members = [];
+  const takenUrls = new Set(Object.keys(paths));
   for (const [url, pathItem] of documentEntries.documentEntries(paths, context.options)) {
     if (!pathItem || typeof pathItem !== "object") {
       continue;
@@ -139,9 +109,9 @@ function pathMembers(paths, context) {
       continue;
     }
     const startedAt = context.diagnostics.now();
-    const path = pathItemMember(url, pathItem, context);
-    members.push(path);
-    if (path.member.kind === "property") {
+    const pathMembersOfUrl = pathItemMembers(url, pathItem, context);
+    members.push(...withoutTakenUrls(url, pathMembersOfUrl, takenUrls));
+    if (pathMembersOfUrl[0]?.key.kind === "literal" && pathMembersOfUrl[0].key.url === url) {
       context.diagnostics.debug(`Transformed path "${url}"`, context.diagnostics.now() - startedAt);
     }
   }
@@ -151,6 +121,8 @@ function pathsType(paths, context) {
   return pathsObjectType(pathMembers(paths, context));
 }
 
+exports.isUntakenKey = isUntakenKey;
+exports.pathKeyOf = pathKeyOf;
 exports.pathMembers = pathMembers;
 exports.pathsObjectType = pathsObjectType;
 exports.pathsType = pathsType;

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

@@ -1 +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 { appendPointer, ROOT_POINTER } 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 { FIX } from \"../../../domain/output-fixes.js\";\nimport { documentEntries } from \"../document-entries.js\";\nimport { refType } from \"../ref-type.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport { type DeclaredTypeLookup, NO_DECLARED_TYPES } from \"./declared-types.js\";\nimport { documentMember } from \"./document-member.js\";\nimport { pathItemType } from \"./path-item.js\";\nimport {\n  type CoverRejection,\n  coveringTemplateKeys,\n  type PathKey,\n  type PathKeyPart,\n  type PathPlaceholder,\n} from \"./path-key-overlaps.js\";\nimport {\n  type PathParameterMatch,\n  placeholderText,\n  replacedTemplateParts,\n} from \"./path-template-replace.js\";\nimport { assignabilityProof } from \"./type-assignability.js\";\n\n/** `[^{}]` keeps the scan linear: `[^}]` retried from every `{` of a long run of them. */\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\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/** Each `{name}` of the URL and its own placeholder, from the URL split at the matches. */\nfunction splitTemplateParts(url: string, matches: readonly PathParameterMatch[]): PathKeyPart[] {\n  return url.split(PATH_PARAMETER_RE).flatMap((text, index): PathKeyPart[] => {\n    const type = matches[index]?.type;\n    const textPart: PathKeyPart = { kind: \"text\", text };\n    return type === undefined ? [textPart] : [textPart, { kind: \"placeholder\", type }];\n  });\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, the way the original replaces them unless the `path-param-type-names` fix\n * is on (see `replacedTemplateParts`). 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 found = url.match(PATH_PARAMETER_RE);\n  if (!found) {\n    return null;\n  }\n  const parameters = pathParameters(pathItem, context);\n  const matches = found.map((match): PathParameterMatch => {\n    const schema = parameters.get(match.slice(1, -1))?.schema as SchemaObject | undefined;\n    return { match, type: PLACEHOLDERS.get(schema?.type) ?? STRING_PLACEHOLDER };\n  });\n  return context.options.fixes.has(FIX.PATH_PARAM_TYPE_NAMES)\n    ? splitTemplateParts(url, matches)\n    : replacedTemplateParts(url, matches);\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. */\nexport interface PathMember {\n  readonly url: string;\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(\n    pathItem,\n    { path: appendPointer(ROOT_POINTER, [\"paths\", url]) },\n    context,\n  );\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 { url, 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 { url, member, key: { kind: \"template\", parts }, type };\n}\n\nfunction literalKey(url: string): PathKey {\n  return { kind: \"literal\", url };\n}\n\nconst PATHS_TYPE_NAME = \"paths\";\n\n/** The URL of `paths[\"/apps/{id}\"]`, or null for any other type. */\nfunction pathsIndexOf(type: IrType): string | null {\n  if (type.kind !== \"indexedAccess\" || type.index.kind !== \"stringLiteral\") {\n    return null;\n  }\n  const { object } = type;\n  const isPaths =\n    object.kind === \"reference\" &&\n    object.name === PATHS_TYPE_NAME &&\n    object.typeArguments.length === 0;\n  return isPaths ? type.index.value : null;\n}\n\n/**\n * The lookup, and `paths[\"/apps/{id}\"]` as that path's item. The declarations cannot read it: a\n * templated path is no property of `paths`, and TypeScript finds it through the signature.\n */\nfunction withPathItems(\n  paths: readonly PathMember[],\n  lookup: DeclaredTypeLookup,\n): DeclaredTypeLookup {\n  const byUrl = new Map(paths.map((path) => [path.url, path.type]));\n  return (type) => {\n    const url = pathsIndexOf(type);\n    return (url === null ? undefined : byUrl.get(url)) ?? lookup(type);\n  };\n}\n\n/**\n * The rejection of a covered path item: only one proven not assignable to the signature's type\n * counts (ADR-028). A pair the proof cannot decide keeps the original output, which may well\n * compile (`Record<string, never>` fits `{ [key: string]: unknown }`).\n */\nfunction rejectionOf(paths: readonly PathMember[], lookup: DeclaredTypeLookup): CoverRejection {\n  const relate = assignabilityProof(withPathItems(paths, lookup));\n  return (coveringIndex, coveredIndex) => {\n    const coveringPath = paths[coveringIndex];\n    const coveredPath = paths[coveredIndex];\n    return (\n      coveringPath !== undefined &&\n      coveredPath !== undefined &&\n      relate(coveredPath.type, coveringPath.type) === \"rejected\"\n    );\n  };\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. The lookup reads the types that path items reference; without it, a\n * reference decides nothing.\n */\nexport function pathsObjectType(\n  paths: readonly PathMember[],\n  lookup: DeclaredTypeLookup = NO_DECLARED_TYPES,\n): IrType {\n  const keys = paths.map(({ key }) => key);\n  const covering = coveringTemplateKeys(keys, rejectionOf(paths, lookup));\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 members of the `paths` interface (OpenAPI 3.1 §4.8.8): one per path, by URL. */\nexport function pathMembers(paths: PathsObject, context: TransformContext): PathMember[] {\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({ url, 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 members;\n}\n\n/**\n * The `paths` interface body, with only the path items' own types for the overlap check. The\n * document transform checks the overlaps again once the referenced types are declared.\n */\nexport function pathsType(paths: PathsObject, context: TransformContext): IrType {\n  return pathsObjectType(pathMembers(paths, context));\n}\n"],"names":["pathItemOperations","FIX","replacedTemplateParts","escapeTemplateText","placeholderText","pathItem","pathItemType","appendPointer","ROOT_POINTER","member","irProperty","toPropertyName","irRaw","assignabilityProof","NO_DECLARED_TYPES","coveringTemplateKeys","irObject","irIntersection","documentEntries","documentMember","refType"],"mappings":"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"}
+{"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 { appendPointer, ROOT_POINTER } from \"../../../domain/openapi/json-pointer.js\";\nimport type { PathItemObject, PathsObject } from \"../../../domain/openapi/path-item-object.js\";\nimport { documentEntries } from \"../document-entries.js\";\nimport { refType } from \"../ref-type.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport { type DeclaredTypeLookup, NO_DECLARED_TYPES } from \"./declared-types.js\";\nimport { documentMember } from \"./document-member.js\";\nimport { pathItemType } from \"./path-item.js\";\nimport {\n  type CoverRejection,\n  coveringTemplateKeys,\n  type PathKey,\n  type PathKeyPart,\n} from \"./path-key-overlaps.js\";\nimport {\n  booleanExpandedKeys,\n  pathTemplateParts,\n  plainUrlOf,\n  templateText,\n} from \"./path-template-key.js\";\nimport { assignabilityProof } from \"./type-assignability.js\";\n\n/** A path's member, its key and its path item type for the overlap check. */\nexport interface PathMember {\n  readonly url: string;\n  readonly member: IrMember;\n  readonly key: PathKey;\n  readonly type: IrType;\n}\n\n/** The key of the parts: a plain URL, or a template with placeholders left. */\nexport function pathKeyOf(parts: readonly PathKeyPart[]): PathKey {\n  const plainUrl = plainUrlOf(parts);\n  return plainUrl === null ? { kind: \"template\", parts } : literalKey(plainUrl);\n}\n\n/** The member of one key of a path: a property for a plain URL, else an index signature. */\nfunction keyMember(url: string, parts: readonly PathKeyPart[], type: IrType, isReadonly: boolean) {\n  const key = pathKeyOf(parts);\n  if (key.kind === \"literal\") {\n    const member = irProperty(toPropertyName(key.url), type, { isReadonly });\n    return { url, member, key, 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 { url, member, key, type };\n}\n\n/**\n * Whether a key of the path at `url` is written. A URL that `${boolean}` keys give is not when it\n * is taken already: by a path of the document, which OpenAPI matches before a template (Paths\n * Object), or by the keys of an earlier path. A property written twice does not compile (TS2300).\n * `takenUrls` starts with the document's URLs and gets each expanded URL, in document order.\n */\nexport function isUntakenKey(url: string, key: PathKey, takenUrls: Set<string>): boolean {\n  const isExpandedUrl = key.kind === \"literal\" && key.url !== url;\n  if (!isExpandedUrl) {\n    return true;\n  }\n  const isTaken = takenUrls.has(key.url);\n  takenUrls.add(key.url);\n  return !isTaken;\n}\n\nfunction withoutTakenUrls(url: string, members: readonly PathMember[], takenUrls: Set<string>) {\n  return members.filter(({ key }) => isUntakenKey(url, key, takenUrls));\n}\n\n/** The members of a path: one, or one per key of its `${boolean}` placeholders. */\nfunction pathItemMembers(\n  url: string,\n  pathItem: PathItemObject,\n  context: TransformContext,\n): PathMember[] {\n  const isReadonly = context.options.immutable;\n  const type = pathItemType(\n    pathItem,\n    { path: appendPointer(ROOT_POINTER, [\"paths\", url]) },\n    context,\n  );\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 [{ url, member, key: literalKey(url), type }];\n  }\n  return booleanExpandedKeys(parts).map((key) => keyMember(url, key, type, isReadonly));\n}\n\nfunction literalKey(url: string): PathKey {\n  return { kind: \"literal\", url };\n}\n\nconst PATHS_TYPE_NAME = \"paths\";\n\n/** The URL of `paths[\"/apps/{id}\"]`, or null for any other type. */\nfunction pathsIndexOf(type: IrType): string | null {\n  if (type.kind !== \"indexedAccess\" || type.index.kind !== \"stringLiteral\") {\n    return null;\n  }\n  const { object } = type;\n  const isPaths =\n    object.kind === \"reference\" &&\n    object.name === PATHS_TYPE_NAME &&\n    object.typeArguments.length === 0;\n  return isPaths ? type.index.value : null;\n}\n\n/**\n * The lookup, and `paths[\"/apps/{id}\"]` as that path's item. The declarations cannot read it: a\n * templated path is no property of `paths`, and TypeScript finds it through the signature.\n */\nfunction withPathItems(\n  paths: readonly PathMember[],\n  lookup: DeclaredTypeLookup,\n): DeclaredTypeLookup {\n  const byUrl = new Map(paths.map((path) => [path.url, path.type]));\n  return (type) => {\n    const url = pathsIndexOf(type);\n    return (url === null ? undefined : byUrl.get(url)) ?? lookup(type);\n  };\n}\n\n/**\n * The rejection of a covered path item: only one proven not assignable to the signature's type\n * counts (ADR-028). A pair the proof cannot decide keeps the original output, which may well\n * compile (`Record<string, never>` fits `{ [key: string]: unknown }`).\n */\nfunction rejectionOf(paths: readonly PathMember[], lookup: DeclaredTypeLookup): CoverRejection {\n  const relate = assignabilityProof(withPathItems(paths, lookup));\n  return (coveringIndex, coveredIndex) => {\n    const coveringPath = paths[coveringIndex];\n    const coveredPath = paths[coveredIndex];\n    return (\n      coveringPath !== undefined &&\n      coveredPath !== undefined &&\n      relate(coveredPath.type, coveringPath.type) === \"rejected\"\n    );\n  };\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. The lookup reads the types that path items reference; without it, a\n * reference decides nothing.\n */\nexport function pathsObjectType(\n  paths: readonly PathMember[],\n  lookup: DeclaredTypeLookup = NO_DECLARED_TYPES,\n): IrType {\n  const keys = paths.map(({ key }) => key);\n  const covering = coveringTemplateKeys(keys, rejectionOf(paths, lookup));\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 members of the `paths` interface (OpenAPI 3.1 §4.8.8): one per path, by URL. */\nexport function pathMembers(paths: PathsObject, context: TransformContext): PathMember[] {\n  const members: PathMember[] = [];\n  const takenUrls = new Set(Object.keys(paths));\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({ url, member, key: literalKey(url), type: member.type });\n      continue;\n    }\n    const startedAt = context.diagnostics.now();\n    const pathMembersOfUrl = pathItemMembers(url, pathItem, context);\n    members.push(...withoutTakenUrls(url, pathMembersOfUrl, takenUrls));\n    // The original reports only paths written as properties.\n    if (pathMembersOfUrl[0]?.key.kind === \"literal\" && pathMembersOfUrl[0].key.url === url) {\n      context.diagnostics.debug(`Transformed path \"${url}\"`, context.diagnostics.now() - startedAt);\n    }\n  }\n  return members;\n}\n\n/**\n * The `paths` interface body, with only the path items' own types for the overlap check. The\n * document transform checks the overlaps again once the referenced types are declared.\n */\nexport function pathsType(paths: PathsObject, context: TransformContext): IrType {\n  return pathsObjectType(pathMembers(paths, context));\n}\n"],"names":["plainUrlOf","member","irProperty","toPropertyName","irRaw","templateText","pathItem","pathItemType","appendPointer","ROOT_POINTER","pathTemplateParts","booleanExpandedKeys","assignabilityProof","NO_DECLARED_TYPES","coveringTemplateKeys","irObject","irIntersection","documentEntries","documentMember","refType"],"mappings":"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"}