- Updated for HotChocolate v12 support!

- All Unit Tests passing!
- Enhanced StarWars Demo for testing/validating with v12 for additional manual tests.
- Validated functionality of BananaCakePop GraphQL IDE Web App as well as functionality via Insomnia (third party IDE).
- With this major update, I'm now correctly calling the GraphQL IDE "Banana Cake Pop" instead of "Playground" (which is the Old IDE).
- GraphQL IDE naming is now updated consistently to be called BananaCakePop (new IDE from v11) in code, comments, and Readme; updated Readme sample code also.
- Deprecated as obsolete the old EnablePlaygroundWebApp option which will be removed in future release; but remains in place and supported at this time for easier upgrade/transition of projects using the AzureFunctionsProxy.
- Updated Nuget version notes and version to correllate to v12.0.0 release and push to Nuget!

Author: cajuncoding

GraphQL.AzureFunctionsProxy.Tests/GraphQLSdlAndPlaygroundTests.cs

@@ -11,7 +11,7 @@
 namespace GraphQL.AzureFunctionsProxy.Tests
 {
     [TestClass]
-    public class GraphQLSdlAndPlaygroundTests : AzureFunctionGraphQLTestBase
+    public class GraphQLSdlAndBananaCakePopTests : AzureFunctionGraphQLTestBase
     {
         [TestMethod]
         public async Task TestSDLRetrieval()

GraphQL.AzureFunctionsProxy.sln.DotSettings

@@ -1,4 +1,5 @@
 <wpf:ResourceDictionary xml:space="preserve" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:s="clr-namespace:System;assembly=mscorlib" xmlns:ss="urn:shemas-jetbrains-com:settings-storage-xaml" xmlns:wpf="http://schemas.microsoft.com/winfx/2006/xaml/presentation">
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=QL/@EntryIndexedValue">QL</s:String>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=GRAPHQL/@EntryIndexedValue">True</s:Boolean>
-	<s:Boolean x:Key="/Default/UserDictionary/Words/=Serverless/@EntryIndexedValue">True</s:Boolean></wpf:ResourceDictionary>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Serverless/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Starship/@EntryIndexedValue">True</s:Boolean></wpf:ResourceDictionary>

GraphQL.AzureFunctionsProxy/GraphQL.AzureFunctionsProxy.csproj

@@ -2,21 +2,27 @@
 
   <PropertyGroup>
     <TargetFramework>netcoreapp3.1</TargetFramework>
-    <Version>11.3.8.1</Version>
+    <Version>12.0.0.1</Version>
     <Authors>BBernard / CajunCoding</Authors>
     <Company>CajunCoding</Company>
-    <Description>This is a extension package for HotChocolate GraphQL framework to enable execution within AzureFunctions using the new v11 API. Provides very easy integration with Azure Functions with maximum support for out-of-the-box HotChocolate functionality.</Description>
+    <Description>This is a extension package for HotChocolate GraphQL framework to enable execution within AzureFunctions V1 using the new v12 API. Provides very easy integration with Azure Functions with maximum support for out-of-the-box HotChocolate functionality.</Description>
     <PackageLicenseExpression>MIT</PackageLicenseExpression>
     <PackageProjectUrl>https://github.com/cajuncoding/HotChocolate.AzureFunctionsProxy</PackageProjectUrl>
     <RepositoryUrl>https://github.com/cajuncoding/HotChocolate.AzureFunctionsProxy</RepositoryUrl>
     <PackageTags>graphql, graph-ql, hotchocolate, azure, functions, serverless</PackageTags>
-    <PackageReleaseNotes>- Bumped to HC v11.3.8
-- Update Nuget package for deployment of latest (last) version compatible with v11; v12 is being released today (09/28/2021)
+    <PackageReleaseNotes>- Fully updated for new Hot Chocolate v12 released today (09/28/2021) with no significant breaking changes.
+- Corrected GraphQL IDE naming to now be "Banana Cake Pop" instead of incorrrectly calling it "Playground" (the old IDE).
+- Original option EnablePlaygroundWebApp is now deprecated as obsolete and will be removed in a future release; use EnableBananaCakePop instead.
+- Default route is now /graphql/bcp/ instead of /graphql/playground.
+- Otherwise there are no other breaking changes other than IDE route path.
 
 Prior Releases Notes:
+- Bumped to HC v11.3.8
+- Update Nuget package for deployment of latest (last) version compatible with v11; v12 is being released today (09/28/2021)
 - Bumped to HC v11.0.7
 - Added support for download of the Schema (?SDL)
-- Added support for functioning Playground (when configured correctly in the Azure Function HttpTrigger &amp; Route Binding)- Added ConfigureAwait(false) to all awaits for performance.
+- Added support for functioning GraphQL IDE (when configured correctly in the Azure Function HttpTrigger &amp; Route Binding)
+- Added ConfigureAwait(false) to all awaits for performance.
 - Bumped to HC v11.0.4
 - Bump to HotChocolate v11.0.1 which now resolves a bug that we helped identify with interfaces in the initial release of v11.0.0.
 - Updated to support namespace changes in HotChocolate v11 rc.03 with synced version here as v11.0.0.3. Bumped HotChocolate version to v11-rc.03. 
@@ -32,8 +38,8 @@ Prior Releases Notes:
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="HotChocolate.AspNetCore" Version="11.3.8" />
-    <PackageReference Include="HotChocolate.Data" Version="11.3.8" />
+    <PackageReference Include="HotChocolate.AspNetCore" Version="12.0.0" />
+    <PackageReference Include="HotChocolate.Data" Version="12.0.0" />
   </ItemGroup>
 
 </Project>

GraphQL.AzureFunctionsProxy/GraphQLAzureFunctionsConfigOptions.cs

@@ -8,7 +8,16 @@ public class GraphQLAzureFunctionsConfigOptions
     {
         public string AzureFunctionsRoutePath { get; set; } = "/api/graphql";
         public bool EnableSchemaDefinitionDownload { get; set; } = true;
-        public bool EnablePlaygroundWebApp { get; set; } = true;
+
+        [Obsolete("Use EnableBananaCakePop property instead; this will be removed in future updates.")]
+        public bool EnablePlaygroundWebApp
+        {
+            get => EnableBananaCakePop;
+            set => EnableBananaCakePop = value;
+        }
+
+        public bool EnableBananaCakePop { get; set; } = true;
+
         public bool EnableGETRequests { get; set; } = true;
     }
 }

GraphQL.AzureFunctionsProxy/GraphQLAzureFunctionsMiddlewareProxy.cs

@@ -82,7 +82,7 @@ private MiddlewareBase ConfigureMiddlewareChainOfResponsibility()
             //BBernard - Initialize the middleware proxy and pipeline with support for both Http GET & POST processing...
             //NOTE: Middleware uses the Pipeline Pattern (e.g. Chain Of Responsibility), therefore
             //  we adapt that here to manually build up the key middleware handlers for Http Get & Http Post processing.
-            //NOTE: Other key features such as Schema download and the Playground (Banana Cake Pop Dynamic UI) are all
+            //NOTE: Other key features such as Schema download and the GraphQL IDE (Banana Cake Pop Dynamic UI) are all
             //      delivered by other Middleware also.
             //NOTE: Middleware MUST be configured in the correct order of dependency to support the functionality and
             //          the chain of responsibility is executed inside-out; or last registered middleware will run first and
@@ -109,7 +109,7 @@ private MiddlewareBase ConfigureMiddlewareChainOfResponsibility()
                 this.MiddlewareProxyDelegate = (httpContext) => httpGetMiddlewareShim.InvokeAsync(httpContext);
             }
 
-            if (Options.EnablePlaygroundWebApp)
+            if (Options.EnableBananaCakePop)
             {
                 var toolStaticFileMiddlewareShim = new ToolStaticFileMiddleware(
                     this.MiddlewareProxyDelegate,
@@ -119,10 +119,8 @@ private MiddlewareBase ConfigureMiddlewareChainOfResponsibility()
                 this.MiddlewareProxyDelegate = (httpContext) => toolStaticFileMiddlewareShim.Invoke(httpContext);
 
                 var toolOptionsFileMiddlewareShim = new ToolOptionsFileMiddleware(
+                    //New for v12 The Constructor for this Middleware is simplified and no longer requires the injection of GraphQL dependencies because it's simply a File Handler for BCP
                     this.MiddlewareProxyDelegate,
-                    this.ExecutorResolver,
-                    this.ResultSerializer,
-                    this.SchemaName,
                     this.RoutePath
                 );
                 this.MiddlewareProxyDelegate = (httpContext) => toolOptionsFileMiddlewareShim.Invoke(httpContext);
@@ -141,7 +139,9 @@ private MiddlewareBase ConfigureMiddlewareChainOfResponsibility()
                     this.MiddlewareProxyDelegate,
                     this.ExecutorResolver,
                     this.ResultSerializer,
-                    this.SchemaName
+                    this.SchemaName,
+                    //New v12 parameter set to Integrated to enable integrated/default functionality (compatible with v11 behavior).
+                    MiddlewareRoutingType.Integrated
                 );
                 this.MiddlewareProxyDelegate = (httpContext) => httpGetSchemaMiddlewareShim.InvokeAsync(httpContext);
             }
@@ -175,7 +175,7 @@ public virtual Task InvokeAsync(HttpContext httpContext)
 
         /// <summary>
         /// Internal helper to retrieve the current Error handler needed for Error processing.
-        /// Matches logic used by existing HttpPostMiddlware.
+        /// Matches logic used by existing HttpPostMiddleware.
         /// </summary>
         /// <returns></returns>
         public virtual async Task<IErrorHandler> GetErrorHandlerAsync(CancellationToken cancellationToken)
@@ -192,7 +192,7 @@ public virtual async Task<IErrorHandler> GetErrorHandlerAsync(CancellationToken
         /// Borrowed this code to make error handling easier for writing errors to the Response
         /// in the same way that the existing Http Get/Post Middleware does.
         /// 
-        /// NOTE: Attempted to inherit from HttpPostMiddlware to expose existing method, but due to
+        /// NOTE: Attempted to inherit from HttpPostMiddleware to expose existing method, but due to
         ///   constructor chaining order of processing and next() pipeline references being private in
         ///   the base class, it wasn't effectively possible without resorting to brute-force reflection,
         ///   so we duplicate some small amount of code here to provide the same Write logic for writing

PureCodeFirst-AzureFunctions-v11/Characters/ICharacter.cs

@@ -10,16 +10,6 @@ namespace StarWars.Characters
     [InterfaceType(Name = "Character")]
     public interface ICharacter : ISearchResult
     {
-        /// <summary>
-        /// The unique identifier for the character.
-        /// </summary>
-        int Id { get; }
-
-        /// <summary>
-        /// The name of the character.
-        /// </summary>
-        string Name { get; }
-
         /// <summary>
         /// The ids of the character's friends.
         /// </summary>

PureCodeFirst-AzureFunctions-v11/Characters/ISearchResult.cs

@@ -2,8 +2,17 @@
 
 namespace StarWars.Characters
 {
-    [UnionType(Name = "SearchResult")]
+    [InterfaceType(Name = "SearchResult")]
     public interface ISearchResult
     {
+        /// <summary>
+        /// The unique identifier for the character.
+        /// </summary>
+        int Id { get; }
+
+        /// <summary>
+        /// The name of the character.
+        /// </summary>
+        string Name { get; }
     }
 }

PureCodeFirst-AzureFunctions-v11/GraphQLPlaygroundEndpoint.cs renamed to PureCodeFirst-AzureFunctions-v11/GraphQLBananaCakePopIDEEndpoint.cs

@@ -18,30 +18,30 @@ namespace StarWars.AzureFunctions
     /// NOTE: This class is not marked as static so that .Net Core DI handles injecting
     ///         the Executor Proxy for us.
     /// </summary>
-    public class GraphQLPlaygroundEndpoint
+    public class GraphQLBananaCakePopEndpoint
     {
         private readonly IGraphQLAzureFunctionsExecutorProxy _graphQLExecutorProxy;
 
-        public GraphQLPlaygroundEndpoint(IGraphQLAzureFunctionsExecutorProxy graphQLExecutorProxy)
+        public GraphQLBananaCakePopEndpoint(IGraphQLAzureFunctionsExecutorProxy graphQLExecutorProxy)
         {
             _graphQLExecutorProxy = graphQLExecutorProxy;
         }
 
-        [FunctionName(nameof(GraphQLPlaygroundEndpoint))]
+        [FunctionName(nameof(GraphQLBananaCakePopEndpoint))]
         public async Task<IActionResult> Run(
-            [HttpTrigger(AuthorizationLevel.Anonymous, "get", Route = "graphql/playground/{*path}")] HttpRequest req,
+            [HttpTrigger(AuthorizationLevel.Anonymous, "get", Route = "graphql/bcp/{*path}")] HttpRequest req,
             ILogger logger,
             CancellationToken cancellationToken
         )
         {
             logger.LogInformation("C# GraphQL Request processing via Serverless AzureFunctions...");
 
             //SECURE this endpoint against actual Data Queries
-            //  This is useful for exposing the playground anonymously, but keeping the actual GraphQL data endpoint
+            //  This is useful for exposing the GraphQL IDE (Banana Cake Pop) anonymously, but keeping the actual GraphQL data endpoint
             //  secured with AzureFunction token security and/or other authorization approach.
             if (HttpMethods.IsPost(req.Method) || (HttpMethods.IsGet(req.Method) && !string.IsNullOrWhiteSpace(req.Query["query"])))
             {
-                return new BadRequestErrorMessageResult("POST or GET GraphQL queries are invalid for the Playground endpoint.");
+                return new BadRequestErrorMessageResult("POST or GET GraphQL queries are invalid for the GraphQL IDE endpoint.");
             }
 
             return await _graphQLExecutorProxy.ExecuteFunctionsQueryAsync(

PureCodeFirst-AzureFunctions-v11/Repositories/CharacterRepository.cs

@@ -45,17 +45,15 @@ public ICharacter GetHero(Episode episode)
         public IEnumerable<ISearchResult> Search(string text)
         {
             IEnumerable<ICharacter> filteredCharacters = _characters.Values
-                .Where(t => t.Name.Contains(text,
-                    StringComparison.OrdinalIgnoreCase));
+                .Where(t => t.Name.Contains(text, StringComparison.OrdinalIgnoreCase));
 
             foreach (ICharacter character in filteredCharacters)
             {
                 yield return character;
             }
 
             IEnumerable<Starship> filteredStarships = _starships.Values
-                .Where(t => t.Name.Contains(text,
-                    StringComparison.OrdinalIgnoreCase));
+                .Where(t => t.Name.Contains(text, StringComparison.OrdinalIgnoreCase));
 
             foreach (Starship starship in filteredStarships)
             {

PureCodeFirst-AzureFunctions-v11/Startup.cs

@@ -58,7 +58,7 @@ public override void Configure(IFunctionsHostBuilder builder)
                 //The Path must match the exact routing path that the Azure Function HttpTrigger is bound to.
                 //NOTE: ThIs includes the /api/ prefix unless it was specifically removed or changed in the host.json file.
                 //NOTE: THe default value is `/api/graphql`, but it's being done here to illustrate how to set the value.
-                options.AzureFunctionsRoutePath = "/api/graphql/playground";
+                options.AzureFunctionsRoutePath = "/api/graphql/bcp";
             });
         }
     }