[resolvers]: argument binding to delegate resolvers

dev/GraphQL.Dev.Reviews/Program.cs

@@ -1,8 +1,8 @@
 using GraphQL.Dev.Reviews;
 using Microsoft.AspNetCore.Builder;
 using Microsoft.Extensions.DependencyInjection;
+using Tanka.GraphQL.Dev.Reviews;
 using Tanka.GraphQL.Extensions.ApolloFederation;
-using Tanka.GraphQL.Language;
 using Tanka.GraphQL.Server;
 
 
@@ -13,14 +13,16 @@
 builder.Services.AddSingleton<ReviewsResolvers>();
 
 // configure services
-builder.AddTankaGraphQL3()
-    .AddOptions("reviews", options =>
+builder.AddTankaGraphQL()
+    .AddSchemaOptions("reviews", options =>
     {
         options.AddReviews();
 
         // add federation as last step
-        options.Configure<ReviewsReferenceResolvers>((schema, referenceResolvers) =>
+        options.Configure<ReviewsReferenceResolvers>((options, referenceResolvers) =>
         {
+            var schema = options.Builder;
+
             // federation should be added as last step so
             // that all entity types are correctly detected
             schema.AddSubgraph(new(referenceResolvers));
@@ -35,6 +37,6 @@
 app.UseWebSockets();
 
 // this uses the default pipeline
-app.MapTankaGraphQL3("/graphql", "reviews");
+app.MapTankaGraphQL("/graphql", "reviews");
 
 app.Run();

dev/GraphQL.Dev.Reviews/SchemaOptionsBuilderExtensions.cs

@@ -1,14 +1,17 @@
+using GraphQL.Dev.Reviews;
+using Microsoft.Extensions.Options;
 using Tanka.GraphQL.Server;
 
-namespace GraphQL.Dev.Reviews;
+namespace Tanka.GraphQL.Dev.Reviews;
 
 public static class SchemaOptionsBuilderExtensions
 {
-    public static SchemaOptionsBuilder AddReviews(this SchemaOptionsBuilder options)
+    public static OptionsBuilder<SchemaOptions> AddReviews(this OptionsBuilder<SchemaOptions> optionsBuilder)
     {
-        options.Configure<ReviewsResolvers>((schema, resolvers) =>
+        optionsBuilder.Configure<ReviewsResolvers>((options, resolvers) =>
         {
-            schema.Add("""
+            var builder = options.Builder;
+            builder.Add("""
                 type Review @key(fields: "id") {
                     id: ID!
                     body: String
@@ -28,9 +31,9 @@ type Product @key(fields: "upc") @extends {
                 }
                 """);
 
-            schema.Add(resolvers);
+            builder.Add(resolvers);
         });
 
-        return options;
+        return optionsBuilder;
     }
 }

dev/graphql.dev.chat.web/Program.cs

@@ -12,8 +12,8 @@
     json.SerializerOptions.DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull;
 });
 // configure services
-builder.AddTankaGraphQL3()
-    .AddOptions("chat", options => { options.Configure(schema => schema.AddChat()); })
+builder.AddTankaGraphQL()
+    .AddSchema("chat", schema => schema.AddChat())
     .AddHttp()
     .AddWebSockets();
 
@@ -25,6 +25,6 @@
 app.UseWebSockets();
 
 // this uses the default pipeline
-app.MapTankaGraphQL3("/graphql", "chat");
+app.MapTankaGraphQL("/graphql", "chat");
 
 app.Run();

docs/0-getting-started/04-server.md

@@ -6,7 +6,7 @@ required then you can implement your own server.
 
 > See also
 >
-> - [Server](xref://server:0-common.md)
+> - [Server](xref://server:00-index.md)
 
 
 ### Simple example with HTTP and websockets

docs/2-language/02-executable-doc.md

@@ -0,0 +1,11 @@
+## Executable Document
+
+Tanka GraphQL splits the GraphQL document into two parts: executable document and type system document.
+Executable document is the part of the document that is executed by the GraphQL server. Type system document 
+is the part of the document that is used to define the GraphQL schema.
+
+Here's the definition of executable document:
+
+```csharp
+#include::xref://src:graphql.language/Nodes/ExecutableDocument.cs
+```

docs/2-language/03-type-system-doc.md

@@ -0,0 +1,10 @@
+## Executable Document
+
+Type System Document is used to define the GraphQL schema. It is used by the
+GraphQL server to validate the query and to resolve the query.
+
+Here's the definition of type system document:
+
+```csharp
+#include::xref://src:graphql.language/Nodes/TypeSystem/TypeSystemDocument.cs
+```

docs/2-language/nav.md

@@ -1,2 +1,3 @@
-- [Language](xref://01-parser.md)
-- [Imports](xref://02-imports.md)
+- [Parser](xref://01-parser.md)
+- [Executable Document](xref://02-executable-doc.md)
+- [Type System Document](xref://03-type-system-doc.md)

docs/3-server/00-index.md

@@ -0,0 +1,14 @@
+## Tanka GraphQL Server
+
+Server provides a way to host GraphQL schema and execute queries against it. It runs on top
+of ASP.NET Core and has transports for HTTP and WebSockets.
+
+### Installation
+
+Server is available as a NuGet package:
+
+```csharp
+dotnet add package tanka.graphql.server
+```
+
+See features on the side for more information.

docs/3-server/05-features/00-list.md

@@ -0,0 +1,4 @@
+## Features
+
+Features are show by a sample projects. Samples shows how to use the feature with minimal code.
+Full source code of each sample is available at [GitHub](https://github.com/pekkah/tanka-graphql).

docs/3-server/05-features/01-http.md

@@ -0,0 +1,11 @@
+## Http and WebSockets
+
+This sample provides a basic HTTP and WebSockets server with GraphQL schema and query execution.
+It supports both GET and POST requests and uses WebSockets for subscriptions. 
+
+WebSockets transport uses the newer [graphql-ws](https://github.com/enisdenjo/graphql-ws/blob/master/PROTOCOL.md) protocol
+
+
+```csharp
+#include::xref://samples:GraphQL.Samples.Http/Program.cs
+```

docs/3-server/05-features/02-authorization.md

@@ -0,0 +1,9 @@
+## Authorization
+
+This sample supports both websockets and HTTP requests. It uses a simple cookie authentication
+to authenticate the user and then applies a authorization policy to the GraphQL endpoint.
+
+
+```csharp
+#include::xref://samples:GraphQL.Samples.Authorization/Program.cs
+```

docs/3-server/05-features/nav.md

@@ -0,0 +1,3 @@
+- [Features](xref://05-features/00-list.md)
+    - [Http and WebSockets](xref://05-features/01-http.md)
+    - [Authorization](xref://05-features/02-authorization.md)