ci: adds TS annotations augmentations

Signed-off-by: Vincent Biret <[email protected]>

Author: baywet

.azure-pipelines/generation-pipeline.yml

@@ -159,6 +159,7 @@ variables:
   cleanOpenAPIFileBetaOutputPath: '$(Build.SourcesDirectory)/msgraph-metadata/openapi/beta/'
   cleanMetadataFileV1OutputPath: '$(Build.SourcesDirectory)/msgraph-metadata/clean_v10_metadata/'
   cleanMetadataFileBetaOutputPath: '$(Build.SourcesDirectory)/msgraph-metadata/clean_beta_metadata/'
+  metadataTypeSpecAnnotationsSource: '$(Build.SourcesDirectory)/msgraph-metadata/additions/'
   cleanMetadataFolderBeta: 'clean_beta_metadata'
   cleanMetadataFolderV1: 'clean_v10_metadata'
   cleanOpenAPIFolderBeta: 'clean_beta_openapi'
@@ -218,6 +219,7 @@ stages:
         cleanMetadataFile: $(cleanMetadataFileV1)
         cleanMetadataFolder: $(cleanMetadataFolderV1)
         cleanMetadataFileWithAnnotations: $(cleanMetadataFileWithAnnotationsV1)
+        metadataTypeSpecAnnotationsSource: $(metadataTypeSpecAnnotationsSource)
 
 # Same description as stage_v1_metadata
 - stage: stage_beta_metadata
@@ -236,6 +238,7 @@ stages:
         cleanMetadataFile: $(cleanMetadataFileBeta)
         cleanMetadataFolder: $(cleanMetadataFolderBeta)
         cleanMetadataFileWithAnnotations: $(cleanMetadataFileWithAnnotationsBeta)
+        metadataTypeSpecAnnotationsSource: $(metadataTypeSpecAnnotationsSource)
 
 - stage: stage_v1_openapi
   dependsOn: stage_v1_metadata

.azure-pipelines/generation-templates/capture-metadata.yml

@@ -22,6 +22,18 @@ parameters:
 - name: 'cleanMetadataFileWithAnnotations'
   type: string
   default: $(cleanMetadataFileWithAnnotationsV1)
+- name: 'metadataTypeSpecAnnotationsSource'
+  type: string
+  default: $(metadataTypeSpecAnnotationsSource)
+- name: 'metadataTypeSpecAnnotationsOutputDir'
+  type: string
+  default: 'tsp-output'
+- name: metadataAnnotationsCopyScriptPath
+  type: string
+  default: '$(metadataTypeSpecAnnotationsSource)/../scripts/copy-annotations-to-csdl.ps1'
+
+variables:
+  sanitizedEndpoint: $[replace(parameters['endpoint'], '/', ''))]
 
 steps:
 
@@ -57,6 +69,23 @@ steps:
   parameters:
     version: '8.x'
 
+# required for TypeSpec
+- task: UseNode@1
+  inputs:
+    versionSpec: '22.x'
+    checkLatest: true
+
+- pwsh: 'npm install -g @typespec/compiler typescript'
+  displayName: 'install TypeSpec and TypeScript globally'
+
+- pwsh: 'npm ci'
+  displayName: 'install TypeSpec dependencies'
+  workingDirectory: '$(metadataTypeSpecAnnotationsSource)'
+
+- pwsh: 'tsc compile .'
+  displayName: 'compile TypeSpec annotations'
+  workingDirectory: '$(metadataTypeSpecAnnotationsSource)'
+
 ## Only run if the previous step was successful
 - pwsh: '$(scriptsDirectory)/run-typewriter-clean-metadata.ps1'
   env:
@@ -70,6 +99,8 @@ steps:
     endpointVersion: ${{ parameters.endpoint }}
   displayName: 'run Typewriter to clean ${{ parameters.endpoint }} metadata'
 
+- pwsh: '$(metadataAnnotationsCopyScriptPath) -targetCsdlPath "$(Build.SourcesDirectory)/msgraph-metadata/clean_$(sanitizedEndpoint)_metadata/cleanMetadataWithDescriptions${{ parameters.endpoint }}.xml" -sourceCsdlDirectoryPath "$(metadataTypeSpecAnnotationsSource)/$(metadataTypeSpecAnnotationsOutputDir)"'
+
   ## Only run if the previous step was successful
 - pwsh: '$(scriptsDirectory)/run-typewriter-clean-metadata.ps1'
   env:
@@ -85,6 +116,8 @@ steps:
     OutputMetadataFileName: 'cleanMetadataWithDescriptionsAndAnnotations'
   displayName: 'run Typewriter to clean ${{ parameters.endpoint }} metadata and keep capability annotations'
 
+- pwsh: '$(metadataAnnotationsCopyScriptPath) -targetCsdlPath "$(Build.SourcesDirectory)/msgraph-metadata/clean_$(sanitizedEndpoint)_metadata/cleanMetadataWithDescriptionsAndAnnotations${{ parameters.endpoint }}.xml" -sourceCsdlDirectoryPath "$(metadataTypeSpecAnnotationsSource)/$(metadataTypeSpecAnnotationsOutputDir)"'
+
   ## Only run if the previous step was successful
 - pwsh: '$(scriptsDirectory)/run-typewriter-clean-metadata.ps1'
   env:
@@ -101,6 +134,9 @@ steps:
     OutputMetadataFileName: 'cleanMetadataWithDescriptionsAndAnnotationsAndErrors'
   displayName: 'run Typewriter to clean ${{ parameters.endpoint }} metadata and keep capability annotations and include error information'
 
+- pwsh: '$(metadataAnnotationsCopyScriptPath) -targetCsdlPath "$(Build.SourcesDirectory)/msgraph-metadata/clean_$(sanitizedEndpoint)_metadata/cleanMetadataWithDescriptionsAndAnnotationsAndErrors${{ parameters.endpoint }}.xml" -sourceCsdlDirectoryPath "$(metadataTypeSpecAnnotationsSource)/$(metadataTypeSpecAnnotationsOutputDir)"'
+
+
 # publish metadata as an artifact
 - task: CopyFiles@2
   inputs: