Add media types (#5779)

* Add media types to specification

They come from the rest-api-spec.

* Support mediaType

* Fix lint

* Fix compiler lint

* Use string values for enums

* Take advantage of the AST and use enums text values

* Fix linter

* Run make spec-format-fix

* Add recursive enum parsing to handle meta members

* Add const to highlight enum target name

* Remove support for composite enums

* Add more media types

---------

Co-authored-by: Laurent Saint-Félix <laurent.saintfelix@elastic.co>
(cherry picked from commit 8260d40)

# Conflicts:
#	output/schema/schema.json
#	specification/_global/rank_eval/RankEvalRequest.ts
#	specification/_global/terms_enum/TermsEnumRequest.ts
#	specification/cat/circuit_breaker/CatCircuitBreakerRequest.ts
#	specification/cluster/reroute/ClusterRerouteRequest.ts
#	specification/cluster/state/ClusterStateRequest.ts
#	specification/indices/add_block/IndicesAddBlockRequest.ts
#	specification/indices/data_streams_stats/IndicesDataStreamsStatsRequest.ts
#	specification/indices/delete_sample_configuration/IndicesDeleteSampleConfigurationRequest.ts
#	specification/indices/get_all_sample_configuration/IndicesGetAllSampleConfigurationRequest.ts
#	specification/indices/get_sample/GetRandomSampleRequest.ts
#	specification/indices/get_sample_configuration/IndicesGetSampleConfigurationRequest.ts
#	specification/indices/get_sample_stats/GetRandomSampleStatsRequest.ts
#	specification/indices/put_sample_configuration/IndicesPutSampleConfigurationRequest.ts
#	specification/indices/remove_block/IndicesRemoveBlockRequest.ts
#	specification/indices/stats/IndicesStatsRequest.ts
#	specification/inference/put_openshift_ai/PutOpenShiftAiRequest.ts
#	specification/inference/rerank/RerankRequest.ts
#	specification/ingest/put_pipeline/PutPipelineRequest.ts
#	specification/nodes/info/NodesInfoRequest.ts
#	specification/nodes/stats/NodesStatsRequest.ts
#	specification/nodes/usage/NodesUsageRequest.ts
#	specification/project/tags/TagsRequest.ts
#	specification/security/clear_cached_privileges/SecurityClearCachedPrivilegesRequest.ts
#	specification/snapshot/delete/SnapshotDeleteRequest.ts

Author: pquentin

compiler/src/index.ts

@@ -25,7 +25,6 @@ import validateRestSpec from './steps/validate-rest-spec'
 import addInfo from './steps/add-info'
 import addDescription from './steps/add-description'
 import validateModel from './steps/validate-model'
-import addContentType from './steps/add-content-type'
 import readDefinitionValidation from './steps/read-definition-validation'
 import addDeprecation from './steps/add-deprecation'
 import ExamplesProcessor from './steps/add-examples'
@@ -73,7 +72,6 @@ compiler
   .generateModel()
   .step(addInfo)
   .step(addDeprecation)
-  .step(addContentType)
   .step(readDefinitionValidation)
   .step(validateRestSpec)
   .step(addDescription)

compiler/src/model/build-model.ts

@@ -53,7 +53,8 @@ import {
   verifyUniqueness,
   parseJsDocTags,
   deepEqual,
-  sourceLocation, sortTypeDefinitions, parseDeprecation
+  sourceLocation, sortTypeDefinitions, parseDeprecation,
+  mediaTypeToStringArray
 } from './utils'
 
 const jsonSpec = buildJsonSpec()
@@ -143,11 +144,11 @@ export function compileSpecification (endpointMappings: Record<string, model.End
 
   // Visit all class, interface, enum and type alias definitions
   for (const declaration of declarations.classes) {
-    model.types.push(compileClassOrInterfaceDeclaration(declaration, endpointMappings, declarations.classes))
+    model.types.push(compileClassOrInterfaceDeclaration(declaration, endpointMappings, declarations.classes, declarations.enums))
   }
 
   for (const declaration of declarations.interfaces) {
-    model.types.push(compileClassOrInterfaceDeclaration(declaration, endpointMappings, declarations.classes))
+    model.types.push(compileClassOrInterfaceDeclaration(declaration, endpointMappings, declarations.classes, declarations.enums))
   }
 
   for (const declaration of declarations.enums) {
@@ -164,7 +165,7 @@ export function compileSpecification (endpointMappings: Record<string, model.End
   return model
 }
 
-function compileClassOrInterfaceDeclaration (declaration: ClassDeclaration | InterfaceDeclaration, mappings: Record<string, model.Endpoint>, allClasses: ClassDeclaration[]): model.Request | model.Response | model.Interface {
+function compileClassOrInterfaceDeclaration (declaration: ClassDeclaration | InterfaceDeclaration, mappings: Record<string, model.Endpoint>, allClasses: ClassDeclaration[], allEnums: EnumDeclaration[]): model.Request | model.Response | model.Interface | model.Enum {
   const name = declaration.getName()
   assert(declaration, name != null, 'Anonymous definitions should not exists')
 
@@ -234,6 +235,14 @@ function compileClassOrInterfaceDeclaration (declaration: ClassDeclaration | Int
           assert(member, property.properties.length > 0, 'There is no need to declare an empty object path_parts, just remove the path_parts declaration.')
           pathMember = member
           type.path = property.properties
+        } else if (name === 'request_media_type' || name === 'response_media_type') {
+          // add those property to requestMediaType and responseMediaType of the endpoint
+          const mediaType = (member as PropertySignature).getStructure().type as string
+          if (name === 'request_media_type') {
+            mapping.requestMediaType = mediaTypeToStringArray(mediaType, allEnums)
+          } else if (name === 'response_media_type') {
+            mapping.responseMediaType = mediaTypeToStringArray(mediaType, allEnums)
+          }
         } else if (name === 'query_parameters') {
           const property = visitRequestOrResponseProperty(member)
           assert(member, property.properties.length > 0, 'There is no need to declare an empty object query_parameters, just remove the query_parameters declaration.')

compiler/src/model/utils.ts

@@ -1506,3 +1506,24 @@ export function sortTypeDefinitions (types: model.TypeDefinition[]): void {
     return 0
   })
 }
+
+export function mediaTypeToStringArray (mediaType: string, allEnums: EnumDeclaration[]): string[] {
+  const mediaTypeEnumName = 'MediaType'
+  const mediaTypeEnum = allEnums.find(e => e.getName() === mediaTypeEnumName)
+
+  // Handle strings separated by a pipe and return multiple media types
+  let enumTypeList: string[]
+  if (mediaType.includes('|')) {
+    enumTypeList = mediaType.split('|').map(mt => mt.trim())
+  } else {
+    enumTypeList = [mediaType.trim()]
+  }
+
+  const mediaTypeList: string[] = []
+  for (const enumType of enumTypeList) {
+    const memberName = enumType.split('.').pop()
+    const value = mediaTypeEnum?.getMembers().find(m => m.getName() === memberName)?.getValue() as string
+    mediaTypeList.push(value)
+  }
+  return mediaTypeList
+}