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

package/dist/application/transform/document/path-item.cjs

@@ -15,7 +15,7 @@ const HASH_RE = /#/g;
 function operationKeyOf(operationId) {
   return operationId.replace(HASH_RE, "/");
 }
-function isIncluded(operation, context) {
+function isIncludedOperation(operation, context) {
   if (!operation) {
     return false;
   }
@@ -41,7 +41,7 @@ function operationMember({ name, operation, path }, pathItem, location, context)
 }
 function methodMember(method, pathItem, location, context) {
   const operation = pathItem[method];
-  if (!isIncluded(operation, context)) {
+  if (!isIncludedOperation(operation, context)) {
     const isReadonly = context.options.immutable;
     return constructors.irProperty(propertyName.toPropertyName(method), constructors.irKeyword("never"), { isOptional: true, isReadonly });
   }
@@ -50,7 +50,7 @@ function methodMember(method, pathItem, location, context) {
 }
 function additionalOperationsMember(pathItem, location, context) {
   const entries = documentEntries.documentEntries(pathItem.additionalOperations ?? {}, context.options);
-  const members = entries.filter(([, operation]) => isIncluded(operation, context)).map(([method, operation]) => {
+  const members = entries.filter(([, operation]) => isIncludedOperation(operation, context)).map(([method, operation]) => {
     const path = jsonPointer.appendPointer(location.path, [pathItemObject.ADDITIONAL_OPERATIONS_KEY, method]);
     return operationMember({ name: method, operation, path }, pathItem, location, context);
   });
@@ -74,6 +74,7 @@ function pathItemType(pathItem, location, context) {
   return constructors.irObject(members);
 }
 
+exports.isIncludedOperation = isIncludedOperation;
 exports.operationKeyOf = operationKeyOf;
 exports.pathItemType = pathItemType;
 //# sourceMappingURL=path-item.cjs.map

package/dist/application/transform/document/path-item.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"path-item.cjs","sources":["../../../../src/application/transform/document/path-item.ts"],"sourcesContent":["import { irKeyword, irObject, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrMember, IrPropertySignature, 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 { OperationObject } from \"../../../domain/openapi/operation-object.js\";\nimport {\n  ADDITIONAL_OPERATIONS_KEY,\n  HTTP_METHODS,\n  type OperationEntry,\n  type PathItemMethod,\n  type PathItemObject,\n  QUERY_METHOD,\n} from \"../../../domain/openapi/path-item-object.js\";\nimport { documentEntries } from \"../document-entries.js\";\nimport { refType } from \"../ref-type.js\";\nimport type { SchemaLocation } from \"../schema/schema-context.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport { documentMember } from \"./document-member.js\";\nimport { operationMembers } from \"./operation.js\";\nimport { mergedParameters } from \"./parameter-entries.js\";\nimport { parametersMember } from \"./parameters.js\";\n\n/** Redocly reads `#` in an operation ID as a pointer, so it is replaced (upstream issue #1542). */\nconst HASH_RE = /#/g;\n\n/** The `operations` key an `operationId` asks for, before a repeated one gets a number. */\nexport function operationKeyOf(operationId: string): string {\n  return operationId.replace(HASH_RE, \"/\");\n}\n\n/** Whether the method has an operation, not removed by `--exclude-deprecated`. */\nfunction isIncluded(\n  operation: OperationEntry | undefined,\n  context: TransformContext,\n): operation is OperationEntry {\n  if (!operation) {\n    return false;\n  }\n  const resolved =\n    \"$ref\" in operation\n      ? (context.refs.resolve(operation.$ref) as OperationObject | undefined)\n      : operation;\n  return !(context.options.excludeDeprecated && resolved?.deprecated);\n}\n\n/**\n * An operation with an `operationId` goes into the `operations` interface and is referenced from\n * the path item; others are written inline.\n */\nfunction operationType(\n  pathItem: PathItemObject,\n  operation: OperationObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrType {\n  const merged = { ...operation, parameters: mergedParameters(pathItem, operation, context.refs) };\n  if (!operation.operationId) {\n    return irObject(operationMembers(merged, location, context));\n  }\n  const operationId = context.footer.operationKey(operationKeyOf(operation.operationId));\n  context.footer.addOperation(() =>\n    irProperty(toPropertyName(operationId), irObject(operationMembers(merged, location, context)), {\n      isReadonly: context.options.immutable,\n    }),\n  );\n  return refType(appendPointer(ROOT_POINTER, [\"operations\", operationId]));\n}\n\n/** An included operation, the member name it gets and its location below the path item. */\ninterface DeclaredOperation {\n  readonly name: string;\n  readonly operation: OperationEntry;\n  readonly path: string;\n}\n\nfunction operationMember(\n  { name, operation, path }: DeclaredOperation,\n  pathItem: PathItemObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const type =\n    \"$ref\" in operation\n      ? refType(operation.$ref)\n      : operationType(pathItem, operation, { ...location, path }, context);\n  return documentMember(name, type, operation, { isReadonly: context.options.immutable });\n}\n\n/** A method member: the operation, or `?: never` when there is none or it is excluded. */\nfunction methodMember(\n  method: PathItemMethod,\n  pathItem: PathItemObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const operation = pathItem[method];\n  if (!isIncluded(operation, context)) {\n    const isReadonly = context.options.immutable;\n    return irProperty(toPropertyName(method), irKeyword(\"never\"), { isOptional: true, isReadonly });\n  }\n  const path = appendPointer(location.path, [method]);\n  return operationMember({ name: method, operation, path }, pathItem, location, context);\n}\n\n/**\n * `additionalOperations` (OpenAPI 3.2): the included operations keyed by their exact method name,\n * or null when the path item has none left.\n */\nfunction additionalOperationsMember(\n  pathItem: PathItemObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature | null {\n  const entries = documentEntries(pathItem.additionalOperations ?? {}, context.options);\n  const members = entries\n    .filter(([, operation]) => isIncluded(operation, context))\n    .map(([method, operation]) => {\n      const path = appendPointer(location.path, [ADDITIONAL_OPERATIONS_KEY, method]);\n      return operationMember({ name: method, operation, path }, pathItem, location, context);\n    });\n  return members.length > 0\n    ? irProperty(toPropertyName(ADDITIONAL_OPERATIONS_KEY), irObject(members), {\n        isReadonly: context.options.immutable,\n      })\n    : null;\n}\n\n/**\n * A path item (OpenAPI 3.2 §4.8.9): its `parameters`, one member per HTTP method, then `query` and\n * `additionalOperations` when the path item declares them (ADR-020).\n */\nexport function pathItemType(\n  pathItem: PathItemObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrType {\n  const parametersLocation = { ...location, path: appendPointer(location.path, [\"parameters\"]) };\n  const members: IrMember[] = [\n    parametersMember(pathItem.parameters ?? [], parametersLocation, context),\n    ...HTTP_METHODS.map((method) => methodMember(method, pathItem, location, context)),\n  ];\n  if (pathItem[QUERY_METHOD] !== undefined) {\n    members.push(methodMember(QUERY_METHOD, pathItem, location, context));\n  }\n  const additionalOperations = additionalOperationsMember(pathItem, location, context);\n  if (additionalOperations) {\n    members.push(additionalOperations);\n  }\n  return irObject(members);\n}\n"],"names":["operation","mergedParameters","irObject","operationMembers","irProperty","toPropertyName","refType","appendPointer","ROOT_POINTER","documentMember","irKeyword","documentEntries","ADDITIONAL_OPERATIONS_KEY","parametersMember","HTTP_METHODS","QUERY_METHOD"],"mappings":"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"}
+{"version":3,"file":"path-item.cjs","sources":["../../../../src/application/transform/document/path-item.ts"],"sourcesContent":["import { irKeyword, irObject, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrMember, IrPropertySignature, 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 { OperationObject } from \"../../../domain/openapi/operation-object.js\";\nimport {\n  ADDITIONAL_OPERATIONS_KEY,\n  HTTP_METHODS,\n  type OperationEntry,\n  type PathItemMethod,\n  type PathItemObject,\n  QUERY_METHOD,\n} from \"../../../domain/openapi/path-item-object.js\";\nimport { documentEntries } from \"../document-entries.js\";\nimport { refType } from \"../ref-type.js\";\nimport type { SchemaLocation } from \"../schema/schema-context.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport { documentMember } from \"./document-member.js\";\nimport { operationMembers } from \"./operation.js\";\nimport { mergedParameters } from \"./parameter-entries.js\";\nimport { parametersMember } from \"./parameters.js\";\n\n/** Redocly reads `#` in an operation ID as a pointer, so it is replaced (upstream issue #1542). */\nconst HASH_RE = /#/g;\n\n/** The `operations` key an `operationId` asks for, before a repeated one gets a number. */\nexport function operationKeyOf(operationId: string): string {\n  return operationId.replace(HASH_RE, \"/\");\n}\n\n/** Whether the method has an operation, not removed by `--exclude-deprecated`. */\nexport function isIncludedOperation(\n  operation: OperationEntry | undefined,\n  context: TransformContext,\n): operation is OperationEntry {\n  if (!operation) {\n    return false;\n  }\n  const resolved =\n    \"$ref\" in operation\n      ? (context.refs.resolve(operation.$ref) as OperationObject | undefined)\n      : operation;\n  return !(context.options.excludeDeprecated && resolved?.deprecated);\n}\n\n/**\n * An operation with an `operationId` goes into the `operations` interface and is referenced from\n * the path item; others are written inline.\n */\nfunction operationType(\n  pathItem: PathItemObject,\n  operation: OperationObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrType {\n  const merged = { ...operation, parameters: mergedParameters(pathItem, operation, context.refs) };\n  if (!operation.operationId) {\n    return irObject(operationMembers(merged, location, context));\n  }\n  const operationId = context.footer.operationKey(operationKeyOf(operation.operationId));\n  context.footer.addOperation(() =>\n    irProperty(toPropertyName(operationId), irObject(operationMembers(merged, location, context)), {\n      isReadonly: context.options.immutable,\n    }),\n  );\n  return refType(appendPointer(ROOT_POINTER, [\"operations\", operationId]));\n}\n\n/** An included operation, the member name it gets and its location below the path item. */\ninterface DeclaredOperation {\n  readonly name: string;\n  readonly operation: OperationEntry;\n  readonly path: string;\n}\n\nfunction operationMember(\n  { name, operation, path }: DeclaredOperation,\n  pathItem: PathItemObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const type =\n    \"$ref\" in operation\n      ? refType(operation.$ref)\n      : operationType(pathItem, operation, { ...location, path }, context);\n  return documentMember(name, type, operation, { isReadonly: context.options.immutable });\n}\n\n/** A method member: the operation, or `?: never` when there is none or it is excluded. */\nfunction methodMember(\n  method: PathItemMethod,\n  pathItem: PathItemObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const operation = pathItem[method];\n  if (!isIncludedOperation(operation, context)) {\n    const isReadonly = context.options.immutable;\n    return irProperty(toPropertyName(method), irKeyword(\"never\"), { isOptional: true, isReadonly });\n  }\n  const path = appendPointer(location.path, [method]);\n  return operationMember({ name: method, operation, path }, pathItem, location, context);\n}\n\n/**\n * `additionalOperations` (OpenAPI 3.2): the included operations keyed by their exact method name,\n * or null when the path item has none left.\n */\nfunction additionalOperationsMember(\n  pathItem: PathItemObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature | null {\n  const entries = documentEntries(pathItem.additionalOperations ?? {}, context.options);\n  const members = entries\n    .filter(([, operation]) => isIncludedOperation(operation, context))\n    .map(([method, operation]) => {\n      const path = appendPointer(location.path, [ADDITIONAL_OPERATIONS_KEY, method]);\n      return operationMember({ name: method, operation, path }, pathItem, location, context);\n    });\n  return members.length > 0\n    ? irProperty(toPropertyName(ADDITIONAL_OPERATIONS_KEY), irObject(members), {\n        isReadonly: context.options.immutable,\n      })\n    : null;\n}\n\n/**\n * A path item (OpenAPI 3.2 §4.8.9): its `parameters`, one member per HTTP method, then `query` and\n * `additionalOperations` when the path item declares them (ADR-020).\n */\nexport function pathItemType(\n  pathItem: PathItemObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrType {\n  const parametersLocation = { ...location, path: appendPointer(location.path, [\"parameters\"]) };\n  const members: IrMember[] = [\n    parametersMember(pathItem.parameters ?? [], parametersLocation, context),\n    ...HTTP_METHODS.map((method) => methodMember(method, pathItem, location, context)),\n  ];\n  if (pathItem[QUERY_METHOD] !== undefined) {\n    members.push(methodMember(QUERY_METHOD, pathItem, location, context));\n  }\n  const additionalOperations = additionalOperationsMember(pathItem, location, context);\n  if (additionalOperations) {\n    members.push(additionalOperations);\n  }\n  return irObject(members);\n}\n"],"names":["operation","mergedParameters","irObject","operationMembers","irProperty","toPropertyName","refType","appendPointer","ROOT_POINTER","documentMember","irKeyword","documentEntries","ADDITIONAL_OPERATIONS_KEY","parametersMember","HTTP_METHODS","QUERY_METHOD"],"mappings":"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"}

package/dist/application/transform/document/path-item.mjs

@@ -13,7 +13,7 @@ const HASH_RE = /#/g;
 function operationKeyOf(operationId) {
   return operationId.replace(HASH_RE, "/");
 }
-function isIncluded(operation, context) {
+function isIncludedOperation(operation, context) {
   if (!operation) {
     return false;
   }
@@ -39,7 +39,7 @@ function operationMember({ name, operation, path }, pathItem, location, context)
 }
 function methodMember(method, pathItem, location, context) {
   const operation = pathItem[method];
-  if (!isIncluded(operation, context)) {
+  if (!isIncludedOperation(operation, context)) {
     const isReadonly = context.options.immutable;
     return irProperty(toPropertyName(method), irKeyword("never"), { isOptional: true, isReadonly });
   }
@@ -48,7 +48,7 @@ function methodMember(method, pathItem, location, context) {
 }
 function additionalOperationsMember(pathItem, location, context) {
   const entries = documentEntries(pathItem.additionalOperations ?? {}, context.options);
-  const members = entries.filter(([, operation]) => isIncluded(operation, context)).map(([method, operation]) => {
+  const members = entries.filter(([, operation]) => isIncludedOperation(operation, context)).map(([method, operation]) => {
     const path = appendPointer(location.path, [ADDITIONAL_OPERATIONS_KEY, method]);
     return operationMember({ name: method, operation, path }, pathItem, location, context);
   });
@@ -72,5 +72,5 @@ function pathItemType(pathItem, location, context) {
   return irObject(members);
 }
 
-export { operationKeyOf, pathItemType };
+export { isIncludedOperation, operationKeyOf, pathItemType };
 //# sourceMappingURL=path-item.mjs.map

package/dist/application/transform/document/path-item.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"path-item.mjs","sources":["../../../../src/application/transform/document/path-item.ts"],"sourcesContent":["import { irKeyword, irObject, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrMember, IrPropertySignature, 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 { OperationObject } from \"../../../domain/openapi/operation-object.js\";\nimport {\n  ADDITIONAL_OPERATIONS_KEY,\n  HTTP_METHODS,\n  type OperationEntry,\n  type PathItemMethod,\n  type PathItemObject,\n  QUERY_METHOD,\n} from \"../../../domain/openapi/path-item-object.js\";\nimport { documentEntries } from \"../document-entries.js\";\nimport { refType } from \"../ref-type.js\";\nimport type { SchemaLocation } from \"../schema/schema-context.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport { documentMember } from \"./document-member.js\";\nimport { operationMembers } from \"./operation.js\";\nimport { mergedParameters } from \"./parameter-entries.js\";\nimport { parametersMember } from \"./parameters.js\";\n\n/** Redocly reads `#` in an operation ID as a pointer, so it is replaced (upstream issue #1542). */\nconst HASH_RE = /#/g;\n\n/** The `operations` key an `operationId` asks for, before a repeated one gets a number. */\nexport function operationKeyOf(operationId: string): string {\n  return operationId.replace(HASH_RE, \"/\");\n}\n\n/** Whether the method has an operation, not removed by `--exclude-deprecated`. */\nfunction isIncluded(\n  operation: OperationEntry | undefined,\n  context: TransformContext,\n): operation is OperationEntry {\n  if (!operation) {\n    return false;\n  }\n  const resolved =\n    \"$ref\" in operation\n      ? (context.refs.resolve(operation.$ref) as OperationObject | undefined)\n      : operation;\n  return !(context.options.excludeDeprecated && resolved?.deprecated);\n}\n\n/**\n * An operation with an `operationId` goes into the `operations` interface and is referenced from\n * the path item; others are written inline.\n */\nfunction operationType(\n  pathItem: PathItemObject,\n  operation: OperationObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrType {\n  const merged = { ...operation, parameters: mergedParameters(pathItem, operation, context.refs) };\n  if (!operation.operationId) {\n    return irObject(operationMembers(merged, location, context));\n  }\n  const operationId = context.footer.operationKey(operationKeyOf(operation.operationId));\n  context.footer.addOperation(() =>\n    irProperty(toPropertyName(operationId), irObject(operationMembers(merged, location, context)), {\n      isReadonly: context.options.immutable,\n    }),\n  );\n  return refType(appendPointer(ROOT_POINTER, [\"operations\", operationId]));\n}\n\n/** An included operation, the member name it gets and its location below the path item. */\ninterface DeclaredOperation {\n  readonly name: string;\n  readonly operation: OperationEntry;\n  readonly path: string;\n}\n\nfunction operationMember(\n  { name, operation, path }: DeclaredOperation,\n  pathItem: PathItemObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const type =\n    \"$ref\" in operation\n      ? refType(operation.$ref)\n      : operationType(pathItem, operation, { ...location, path }, context);\n  return documentMember(name, type, operation, { isReadonly: context.options.immutable });\n}\n\n/** A method member: the operation, or `?: never` when there is none or it is excluded. */\nfunction methodMember(\n  method: PathItemMethod,\n  pathItem: PathItemObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const operation = pathItem[method];\n  if (!isIncluded(operation, context)) {\n    const isReadonly = context.options.immutable;\n    return irProperty(toPropertyName(method), irKeyword(\"never\"), { isOptional: true, isReadonly });\n  }\n  const path = appendPointer(location.path, [method]);\n  return operationMember({ name: method, operation, path }, pathItem, location, context);\n}\n\n/**\n * `additionalOperations` (OpenAPI 3.2): the included operations keyed by their exact method name,\n * or null when the path item has none left.\n */\nfunction additionalOperationsMember(\n  pathItem: PathItemObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature | null {\n  const entries = documentEntries(pathItem.additionalOperations ?? {}, context.options);\n  const members = entries\n    .filter(([, operation]) => isIncluded(operation, context))\n    .map(([method, operation]) => {\n      const path = appendPointer(location.path, [ADDITIONAL_OPERATIONS_KEY, method]);\n      return operationMember({ name: method, operation, path }, pathItem, location, context);\n    });\n  return members.length > 0\n    ? irProperty(toPropertyName(ADDITIONAL_OPERATIONS_KEY), irObject(members), {\n        isReadonly: context.options.immutable,\n      })\n    : null;\n}\n\n/**\n * A path item (OpenAPI 3.2 §4.8.9): its `parameters`, one member per HTTP method, then `query` and\n * `additionalOperations` when the path item declares them (ADR-020).\n */\nexport function pathItemType(\n  pathItem: PathItemObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrType {\n  const parametersLocation = { ...location, path: appendPointer(location.path, [\"parameters\"]) };\n  const members: IrMember[] = [\n    parametersMember(pathItem.parameters ?? [], parametersLocation, context),\n    ...HTTP_METHODS.map((method) => methodMember(method, pathItem, location, context)),\n  ];\n  if (pathItem[QUERY_METHOD] !== undefined) {\n    members.push(methodMember(QUERY_METHOD, pathItem, location, context));\n  }\n  const additionalOperations = additionalOperationsMember(pathItem, location, context);\n  if (additionalOperations) {\n    members.push(additionalOperations);\n  }\n  return irObject(members);\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"path-item.mjs","sources":["../../../../src/application/transform/document/path-item.ts"],"sourcesContent":["import { irKeyword, irObject, irProperty } from \"../../../domain/ir/constructors.js\";\nimport type { IrMember, IrPropertySignature, 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 { OperationObject } from \"../../../domain/openapi/operation-object.js\";\nimport {\n  ADDITIONAL_OPERATIONS_KEY,\n  HTTP_METHODS,\n  type OperationEntry,\n  type PathItemMethod,\n  type PathItemObject,\n  QUERY_METHOD,\n} from \"../../../domain/openapi/path-item-object.js\";\nimport { documentEntries } from \"../document-entries.js\";\nimport { refType } from \"../ref-type.js\";\nimport type { SchemaLocation } from \"../schema/schema-context.js\";\nimport type { TransformContext } from \"../transform-context.js\";\nimport { documentMember } from \"./document-member.js\";\nimport { operationMembers } from \"./operation.js\";\nimport { mergedParameters } from \"./parameter-entries.js\";\nimport { parametersMember } from \"./parameters.js\";\n\n/** Redocly reads `#` in an operation ID as a pointer, so it is replaced (upstream issue #1542). */\nconst HASH_RE = /#/g;\n\n/** The `operations` key an `operationId` asks for, before a repeated one gets a number. */\nexport function operationKeyOf(operationId: string): string {\n  return operationId.replace(HASH_RE, \"/\");\n}\n\n/** Whether the method has an operation, not removed by `--exclude-deprecated`. */\nexport function isIncludedOperation(\n  operation: OperationEntry | undefined,\n  context: TransformContext,\n): operation is OperationEntry {\n  if (!operation) {\n    return false;\n  }\n  const resolved =\n    \"$ref\" in operation\n      ? (context.refs.resolve(operation.$ref) as OperationObject | undefined)\n      : operation;\n  return !(context.options.excludeDeprecated && resolved?.deprecated);\n}\n\n/**\n * An operation with an `operationId` goes into the `operations` interface and is referenced from\n * the path item; others are written inline.\n */\nfunction operationType(\n  pathItem: PathItemObject,\n  operation: OperationObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrType {\n  const merged = { ...operation, parameters: mergedParameters(pathItem, operation, context.refs) };\n  if (!operation.operationId) {\n    return irObject(operationMembers(merged, location, context));\n  }\n  const operationId = context.footer.operationKey(operationKeyOf(operation.operationId));\n  context.footer.addOperation(() =>\n    irProperty(toPropertyName(operationId), irObject(operationMembers(merged, location, context)), {\n      isReadonly: context.options.immutable,\n    }),\n  );\n  return refType(appendPointer(ROOT_POINTER, [\"operations\", operationId]));\n}\n\n/** An included operation, the member name it gets and its location below the path item. */\ninterface DeclaredOperation {\n  readonly name: string;\n  readonly operation: OperationEntry;\n  readonly path: string;\n}\n\nfunction operationMember(\n  { name, operation, path }: DeclaredOperation,\n  pathItem: PathItemObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const type =\n    \"$ref\" in operation\n      ? refType(operation.$ref)\n      : operationType(pathItem, operation, { ...location, path }, context);\n  return documentMember(name, type, operation, { isReadonly: context.options.immutable });\n}\n\n/** A method member: the operation, or `?: never` when there is none or it is excluded. */\nfunction methodMember(\n  method: PathItemMethod,\n  pathItem: PathItemObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature {\n  const operation = pathItem[method];\n  if (!isIncludedOperation(operation, context)) {\n    const isReadonly = context.options.immutable;\n    return irProperty(toPropertyName(method), irKeyword(\"never\"), { isOptional: true, isReadonly });\n  }\n  const path = appendPointer(location.path, [method]);\n  return operationMember({ name: method, operation, path }, pathItem, location, context);\n}\n\n/**\n * `additionalOperations` (OpenAPI 3.2): the included operations keyed by their exact method name,\n * or null when the path item has none left.\n */\nfunction additionalOperationsMember(\n  pathItem: PathItemObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrPropertySignature | null {\n  const entries = documentEntries(pathItem.additionalOperations ?? {}, context.options);\n  const members = entries\n    .filter(([, operation]) => isIncludedOperation(operation, context))\n    .map(([method, operation]) => {\n      const path = appendPointer(location.path, [ADDITIONAL_OPERATIONS_KEY, method]);\n      return operationMember({ name: method, operation, path }, pathItem, location, context);\n    });\n  return members.length > 0\n    ? irProperty(toPropertyName(ADDITIONAL_OPERATIONS_KEY), irObject(members), {\n        isReadonly: context.options.immutable,\n      })\n    : null;\n}\n\n/**\n * A path item (OpenAPI 3.2 §4.8.9): its `parameters`, one member per HTTP method, then `query` and\n * `additionalOperations` when the path item declares them (ADR-020).\n */\nexport function pathItemType(\n  pathItem: PathItemObject,\n  location: SchemaLocation,\n  context: TransformContext,\n): IrType {\n  const parametersLocation = { ...location, path: appendPointer(location.path, [\"parameters\"]) };\n  const members: IrMember[] = [\n    parametersMember(pathItem.parameters ?? [], parametersLocation, context),\n    ...HTTP_METHODS.map((method) => methodMember(method, pathItem, location, context)),\n  ];\n  if (pathItem[QUERY_METHOD] !== undefined) {\n    members.push(methodMember(QUERY_METHOD, pathItem, location, context));\n  }\n  const additionalOperations = additionalOperationsMember(pathItem, location, context);\n  if (additionalOperations) {\n    members.push(additionalOperations);\n  }\n  return irObject(members);\n}\n"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,84 @@
+'use strict';
+
+const rawTextEscapes = require('../../../domain/ir/raw-text-escapes.cjs');
+const pathItemObject = require('../../../domain/openapi/path-item-object.cjs');
+const outputFixes = require('../../../domain/output-fixes.cjs');
+const pathTemplateReplace = require('./path-template-replace.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 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 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 }];
+  });
+}
+function pathTemplateParts(url, pathItem, context) {
+  const found = url.match(PATH_PARAMETER_RE);
+  if (!found) {
+    return null;
+  }
+  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);
+}
+function templateText(parts) {
+  const text = parts.map(
+    (part) => part.kind === "text" ? rawTextEscapes.escapeTemplateText(part.text) : pathTemplateReplace.placeholderText(part.type)
+  ).join("");
+  return `\`${text}\``;
+}
+const BOOLEAN_TEXTS = ["true", "false"];
+const isBooleanPlaceholder = (part) => part.kind === "placeholder" && part.type === "boolean";
+function booleanExpandedKeys(parts) {
+  const isBooleanOnly = parts.every((part) => part.kind === "text" || isBooleanPlaceholder(part));
+  if (!isBooleanOnly) {
+    return [[...parts]];
+  }
+  return parts.reduce(
+    (keys, part) => {
+      const choices = isBooleanPlaceholder(part) ? BOOLEAN_TEXTS.map((text) => ({ kind: "text", text })) : [part];
+      return keys.flatMap((key) => choices.map((choice) => [...key, choice]));
+    },
+    [[]]
+  );
+}
+function plainUrlOf(parts) {
+  const texts = parts.map((part) => part.kind === "text" ? part.text : null);
+  return texts.includes(null) ? null : texts.join("");
+}
+
+exports.booleanExpandedKeys = booleanExpandedKeys;
+exports.pathTemplateParts = pathTemplateParts;
+exports.plainUrlOf = plainUrlOf;
+exports.templateText = templateText;
+//# sourceMappingURL=path-template-key.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"path-template-key.cjs","sources":["../../../../src/application/transform/document/path-template-key.ts"],"sourcesContent":["import { escapeTemplateText } from \"../../../domain/ir/raw-text-escapes.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  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 type { TransformContext } from \"../transform-context.js\";\nimport type { PathKeyPart, PathPlaceholder } from \"./path-key-overlaps.js\";\nimport {\n  type PathParameterMatch,\n  placeholderText,\n  replacedTemplateParts,\n} from \"./path-template-replace.js\";\n\n/** The `--path-params-as-types` key of a path: its URL with a placeholder per parameter. */\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 */\nexport function 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 */\nexport function 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\nconst BOOLEAN_TEXTS = [\"true\", \"false\"] as const;\n\nconst isBooleanPlaceholder = (part: PathKeyPart): boolean =>\n  part.kind === \"placeholder\" && part.type === \"boolean\";\n\n/**\n * The keys of a template whose only placeholders are `${boolean}`, with each written as `true`\n * and as `false`. Such a template is a union of literals, and an index signature takes none\n * (TS1337), so the original's `` [path: `/flags/${boolean}`] `` did not compile. A path with n\n * boolean parameters gets 2ⁿ plain URLs (`/flags/true`), all with the same path item type. Next to\n * another placeholder the template is a pattern, a valid signature that admits the same URLs, so\n * those parts stay one key.\n */\nexport function booleanExpandedKeys(parts: readonly PathKeyPart[]): PathKeyPart[][] {\n  const isBooleanOnly = parts.every((part) => part.kind === \"text\" || isBooleanPlaceholder(part));\n  if (!isBooleanOnly) {\n    return [[...parts]];\n  }\n  return parts.reduce<PathKeyPart[][]>(\n    (keys, part) => {\n      const choices: readonly PathKeyPart[] = isBooleanPlaceholder(part)\n        ? BOOLEAN_TEXTS.map((text) => ({ kind: \"text\", text }))\n        : [part];\n      return keys.flatMap((key) => choices.map((choice) => [...key, choice]));\n    },\n    [[]],\n  );\n}\n\n/** The URL of parts without placeholders; null when one is left. */\nexport function plainUrlOf(parts: readonly PathKeyPart[]): string | null {\n  const texts = parts.map((part) => (part.kind === \"text\" ? part.text : null));\n  return texts.includes(null) ? null : texts.join(\"\");\n}\n"],"names":["pathItemOperations","FIX","replacedTemplateParts","escapeTemplateText","placeholderText"],"mappings":"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"}

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

@@ -0,0 +1,79 @@
+import { escapeTemplateText } from '../../../domain/ir/raw-text-escapes.mjs';
+import { pathItemOperations } from '../../../domain/openapi/path-item-object.mjs';
+import { FIX } from '../../../domain/output-fixes.mjs';
+import { replacedTemplateParts, placeholderText } from './path-template-replace.mjs';
+
+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 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 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 }];
+  });
+}
+function pathTemplateParts(url, pathItem, context) {
+  const found = url.match(PATH_PARAMETER_RE);
+  if (!found) {
+    return null;
+  }
+  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(FIX.PATH_PARAM_TYPE_NAMES) ? splitTemplateParts(url, matches) : replacedTemplateParts(url, matches);
+}
+function templateText(parts) {
+  const text = parts.map(
+    (part) => part.kind === "text" ? escapeTemplateText(part.text) : placeholderText(part.type)
+  ).join("");
+  return `\`${text}\``;
+}
+const BOOLEAN_TEXTS = ["true", "false"];
+const isBooleanPlaceholder = (part) => part.kind === "placeholder" && part.type === "boolean";
+function booleanExpandedKeys(parts) {
+  const isBooleanOnly = parts.every((part) => part.kind === "text" || isBooleanPlaceholder(part));
+  if (!isBooleanOnly) {
+    return [[...parts]];
+  }
+  return parts.reduce(
+    (keys, part) => {
+      const choices = isBooleanPlaceholder(part) ? BOOLEAN_TEXTS.map((text) => ({ kind: "text", text })) : [part];
+      return keys.flatMap((key) => choices.map((choice) => [...key, choice]));
+    },
+    [[]]
+  );
+}
+function plainUrlOf(parts) {
+  const texts = parts.map((part) => part.kind === "text" ? part.text : null);
+  return texts.includes(null) ? null : texts.join("");
+}
+
+export { booleanExpandedKeys, pathTemplateParts, plainUrlOf, templateText };
+//# sourceMappingURL=path-template-key.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"path-template-key.mjs","sources":["../../../../src/application/transform/document/path-template-key.ts"],"sourcesContent":["import { escapeTemplateText } from \"../../../domain/ir/raw-text-escapes.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  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 type { TransformContext } from \"../transform-context.js\";\nimport type { PathKeyPart, PathPlaceholder } from \"./path-key-overlaps.js\";\nimport {\n  type PathParameterMatch,\n  placeholderText,\n  replacedTemplateParts,\n} from \"./path-template-replace.js\";\n\n/** The `--path-params-as-types` key of a path: its URL with a placeholder per parameter. */\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 */\nexport function 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 */\nexport function 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\nconst BOOLEAN_TEXTS = [\"true\", \"false\"] as const;\n\nconst isBooleanPlaceholder = (part: PathKeyPart): boolean =>\n  part.kind === \"placeholder\" && part.type === \"boolean\";\n\n/**\n * The keys of a template whose only placeholders are `${boolean}`, with each written as `true`\n * and as `false`. Such a template is a union of literals, and an index signature takes none\n * (TS1337), so the original's `` [path: `/flags/${boolean}`] `` did not compile. A path with n\n * boolean parameters gets 2ⁿ plain URLs (`/flags/true`), all with the same path item type. Next to\n * another placeholder the template is a pattern, a valid signature that admits the same URLs, so\n * those parts stay one key.\n */\nexport function booleanExpandedKeys(parts: readonly PathKeyPart[]): PathKeyPart[][] {\n  const isBooleanOnly = parts.every((part) => part.kind === \"text\" || isBooleanPlaceholder(part));\n  if (!isBooleanOnly) {\n    return [[...parts]];\n  }\n  return parts.reduce<PathKeyPart[][]>(\n    (keys, part) => {\n      const choices: readonly PathKeyPart[] = isBooleanPlaceholder(part)\n        ? BOOLEAN_TEXTS.map((text) => ({ kind: \"text\", text }))\n        : [part];\n      return keys.flatMap((key) => choices.map((choice) => [...key, choice]));\n    },\n    [[]],\n  );\n}\n\n/** The URL of parts without placeholders; null when one is left. */\nexport function plainUrlOf(parts: readonly PathKeyPart[]): string | null {\n  const texts = parts.map((part) => (part.kind === \"text\" ? part.text : null));\n  return texts.includes(null) ? null : texts.join(\"\");\n}\n"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,70 @@
+'use strict';
+
+const constructors = require('../../../domain/ir/constructors.cjs');
+const documentEntries = require('../document-entries.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 pathsIndexUrl(node) {
+  const object = node.object;
+  const index = node.index;
+  const isPathsIndex = node.kind === "indexedAccess" && object?.kind === "reference" && object.name === PATHS_TYPE_NAME && object.typeArguments?.length === 0 && 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 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. 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\n/** `paths[\"<url>\"]`: an index of the `paths` root by a string literal. */\nfunction pathsIndexUrl(node: Readonly<Record<string, unknown>>): string | undefined {\n  const object = node.object as Readonly<Record<string, unknown>> | undefined;\n  const index = node.index as Readonly<Record<string, unknown>> | undefined;\n  const isPathsIndex =\n    node.kind === \"indexedAccess\" &&\n    object?.kind === \"reference\" &&\n    object.name === PATHS_TYPE_NAME &&\n    (object.typeArguments as readonly unknown[] | undefined)?.length === 0 &&\n    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","irRaw"],"mappings":"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"}

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

@@ -0,0 +1,67 @@
+import { irRaw } from '../../../domain/ir/constructors.mjs';
+import { documentEntries } from '../document-entries.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 pathsIndexUrl(node) {
+  const object = node.object;
+  const index = node.index;
+  const isPathsIndex = node.kind === "indexedAccess" && object?.kind === "reference" && object.name === PATHS_TYPE_NAME && object.typeArguments?.length === 0 && 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 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. 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\n/** `paths[\"<url>\"]`: an index of the `paths` root by a string literal. */\nfunction pathsIndexUrl(node: Readonly<Record<string, unknown>>): string | undefined {\n  const object = node.object as Readonly<Record<string, unknown>> | undefined;\n  const index = node.index as Readonly<Record<string, unknown>> | undefined;\n  const isPathsIndex =\n    node.kind === \"indexedAccess\" &&\n    object?.kind === \"reference\" &&\n    object.name === PATHS_TYPE_NAME &&\n    (object.typeArguments as readonly unknown[] | undefined)?.length === 0 &&\n    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;