For #55. Add GraphQL support

src/Examples/Definitions/API_GraphQL.yml

@@ -0,0 +1,16 @@
+version: 0.0.1 # Required
+apimServiceName: $(apimServiceName) # Required, must match name of an apim service deployed in the specified resource group
+
+apis:
+  - name: ApiG1
+    displayName: API G v1
+    graphQlSpec: https://swapi-graphql.azure-api.net/graphql
+    policy: $(apimBasePath)\Policies\ApiPolicy.xml
+    path: $(prefix)/g/api
+    serviceUrl: https://swapi-graphql.azure-api.net/graphql
+    protocols: https
+    subscriptionRequired: true
+    isCurrent: true
+    subscriptionKeyParameterNames:
+      header: ProviderKey
+      query: ProviderKey

src/apimtemplate/ApimEntities/Api/Schema/Document.cs

@@ -0,0 +1,13 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace Apim.DevOps.Toolkit.ApimEntities.Api.Schema
+{
+	public class Document
+	{
+		public string Value { get; set; }
+	}
+}

src/apimtemplate/ApimEntities/Api/Schema/SchemaApiProperties.cs

@@ -0,0 +1,14 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace Apim.DevOps.Toolkit.ApimEntities.Api.Schema
+{
+	public class SchemaApiProperties
+	{
+		public string ContentType { get; set; }
+		public Document Document { get; set; }
+	}
+}

src/apimtemplate/Core/ArmTemplates/ResourceCreators/ApiResourceCreator.cs

@@ -3,6 +3,7 @@
 using Apim.DevOps.Toolkit.ApimEntities.Api.Operation.Policy;
 using Apim.DevOps.Toolkit.ApimEntities.Api.Policy;
 using Apim.DevOps.Toolkit.ApimEntities.Api.Product;
+using Apim.DevOps.Toolkit.ApimEntities.Api.Schema;
 using Apim.DevOps.Toolkit.ApimEntities.Api.Tag;
 using Apim.DevOps.Toolkit.Core.DeploymentDefinitions;
 using Apim.DevOps.Toolkit.Core.DeploymentDefinitions.Entities;
@@ -42,6 +43,7 @@ public IEnumerable<ArmTemplateResource> Create(DeploymentDefinition deploymentDe
 			resources.AddRange(CreateProductApis(deploymentDefinition));
 			resources.AddRange(CreateTagApis(deploymentDefinition));
 			resources.AddRange(CreateApiDiagnostics(deploymentDefinition));
+			resources.AddRange(CreateGraphQlApiSchema(deploymentDefinition));
 
 			return resources;
 		}
@@ -176,6 +178,36 @@ private IEnumerable<ArmTemplateResource<ApiDiagnosticsProperties>> CreateApiDiag
 							.CreateResourcesIf(d => d.HasDiagnostics());
 		}
 
+		/// <summary>
+		/// Api schemas currently only added if GraphQL schema file is specified in deployment definition.
+		/// </summary>
+		/// <param name="deploymentDefinition"></param>
+		/// <returns></returns>
+		private IEnumerable<ArmTemplateResource<SchemaApiProperties>> CreateGraphQlApiSchema(DeploymentDefinition deploymentDefinition)
+		{
+			return new ArmTemplateResourceCreator<ApiDeploymentDefinition, SchemaApiProperties>(_mapper)
+							.ForDeploymentDefinitions(deploymentDefinition.Apis)
+							.UseResourceCreator(apiDeploymentDefinition =>
+							{
+								var templateResource = new ArmTemplateResource<SchemaApiProperties>(
+									$"{apiDeploymentDefinition.Name}/graphql",
+									$"[concat(parameters('ApimServiceName'), '/{apiDeploymentDefinition.Name}/graphql')]",
+									ResourceType.ApiSchema,
+									new SchemaApiProperties
+									{
+										ContentType = "application/vnd.ms-azure-apim.graphql.schema",
+										Document = new Document
+										{
+											Value = new GraphQlSpecReader(apiDeploymentDefinition.GraphQlSpec).GetFileContent().Result
+										}
+									},
+									new string[] { $"[resourceId('{ResourceType.Api}', parameters('ApimServiceName'), '{apiDeploymentDefinition.Name}')]" });
+
+								return new List<ArmTemplateResource<SchemaApiProperties>> { templateResource };
+							})
+							.CreateResourcesIf(d => !d.GraphQlSpec.IsUri(out _), true); // create only if graphQL spec is a file
+		}
+
 		private IEnumerable<ArmTemplateResource<ApiProperties>> CreateApis(DeploymentDefinition deploymentDefinition)
 		{
 			return new ArmTemplateResourceCreator<ApiDeploymentDefinition, ApiProperties>(_mapper)

src/apimtemplate/Core/Constants/GraphQlFormat.cs

@@ -0,0 +1,10 @@
+namespace Apim.DevOps.Toolkit.Core.Infrastructure.Constants
+{
+  public static class GraphQlFormat
+  {
+	/// <summary>
+	/// The GraphQL API endpoint hosted on a publicly accessible internet address.
+	/// </summary>
+	public static readonly string GraphQlLink = "graphql-link";
+  }
+}

src/apimtemplate/Core/DeploymentDefinitions/Entities/ApiDeploymentDefinition.cs

@@ -17,10 +17,15 @@ public class ApiDeploymentDefinition: EntityDeploymentDefinition
 		public string Name { get; set; }
 
 		/// <summary>
-		/// local path or url to policy
+		/// local path or url to OpenAPI specification
 		/// </summary>
 		public string OpenApiSpec { get; set; }
 
+		/// <summary>
+		/// local path or url to GraphQL API specification
+		/// </summary>
+		public string GraphQlSpec { get; set; }
+
 		/// <summary>
 		/// local path or url to policy
 		/// </summary>

src/apimtemplate/Core/DeploymentDefinitions/Validation/DeploymentDefinitionValidator.cs

@@ -110,9 +110,13 @@ private bool ValidateApis(DeploymentDefinition deploymentDefinition)
 				{
 					throw new ArgumentException("API name is required");
 				}
-				if (api.OpenApiSpec == null)
+				if (api.OpenApiSpec == null && api.GraphQlSpec == null)
 				{
-					throw new ArgumentException("Open API Spec is required");
+					throw new ArgumentException("Open API Spec or Graph QL Endpoint is required");
+				}
+				if (api.OpenApiSpec != null && api.GraphQlSpec != null)
+				{
+					throw new ArgumentException("Specifying both Open API Spec and Graph QL Endpoint is not allowed");
 				}
 				if (api.Path == null)
 				{

src/apimtemplate/Core/Infrastructure/GraphQlSpecReader.cs

@@ -0,0 +1,41 @@
+using Apim.DevOps.Toolkit.Core.Infrastructure.Constants;
+using Apim.DevOps.Toolkit.Extensions;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace Apim.DevOps.Toolkit.Core.Infrastructure
+{
+	public class GraphQlSpecReader
+	{
+		private readonly FileReader _fileReader = new();
+		private string _graphQlFilePath;
+		public GraphQlSpecReader(string graphQlFilePath)
+		{
+			_graphQlFilePath = graphQlFilePath;
+		}
+
+		/// <summary>
+		/// If the GraphQL spec is a file, return null, we'll import it as a 'apis/schemas' resource type.
+		/// </summary>
+		public string GetGraphQlFormat()
+		{
+			return _graphQlFilePath.IsUri(out _) ? GraphQlFormat.GraphQlLink : null;
+		}
+
+		/// <summary>
+		/// If the GraphQL spec is a file, return null, we'll import it as a 'apis/schemas' resource type.
+		/// </summary>
+		public string GetValue()
+		{
+			return _graphQlFilePath.IsUri(out _) ? _graphQlFilePath : null;
+		}
+
+		public async Task<string> GetFileContent()
+		{
+			return await _fileReader.RetrieveFileContentsAsync(_graphQlFilePath);
+		}
+	}
+}

src/apimtemplate/Core/Mapping/ApiMapper.cs

@@ -13,8 +13,10 @@ public void Map(IMapperConfigurationExpression cfg)
 		{
 			cfg.CreateMap<ApiDeploymentDefinition, ApiProperties>()
 				.ForMember(dst => dst.Path, opt => opt.MapFrom(src => src.Path.Replace("//", "/").TrimStart(new[] { '/' })))
-				.ForMember(dst => dst.Format, opt => opt.MapFrom(src => new OpenApiSpecReader(src.OpenApiSpec).GetOpenApiFormat().Result))
-				.ForMember(dst => dst.Value, opt => opt.MapFrom(src => new OpenApiSpecReader(src.OpenApiSpec).GetValue().Result))
+				.ForMember(dst => dst.Format, opt => opt.MapFrom(
+					src => src.GraphQlSpec != null ? new GraphQlSpecReader(src.GraphQlSpec).GetGraphQlFormat() : new OpenApiSpecReader(src.OpenApiSpec).GetOpenApiFormat().Result))
+				.ForMember(dst => dst.Value, opt => opt.MapFrom(
+					src => src.GraphQlSpec != null ? new GraphQlSpecReader(src.GraphQlSpec).GetValue() : new OpenApiSpecReader(src.OpenApiSpec).GetValue().Result))
 				.ForMember(dst => dst.Protocols, opt => opt.MapFrom(src => src.Protocols.GetItems(new[] { "https" })))
 				.ForMember(dst => dst.ApiVersionSetId, opt => opt.MapFrom(src => string.IsNullOrEmpty(src.ApiVersionSetId) ? null : $"[resourceId('{ResourceType.ApiVersionSet}', parameters('ApimServiceName'), '{src.ApiVersionSetId}')]"));