Add graphql extension methods for dtos (#13)

Author: kudchikarsk

Directory.Build.props

@@ -1,5 +1,5 @@
 <Project>
   <PropertyGroup>
-    <Version>1.2.0</Version>
+    <Version>1.2.1</Version>
   </PropertyGroup>
 </Project>

index.md

@@ -9,7 +9,7 @@ Welcome to BytLabs Backend Packages documentation. This collection of .NET libra
 ## Quick Navigation
 
 - [Getting Started](docs/getting-started.md)
-- [API Documentation](api/index.md)
+- [API Documentation](api/BytLabs.Api.md)
 - [Introduction](docs/introduction.md)
 
 ## Key Features

src/BytLabs.Api/BytLabs.Api.Graphql/RequestExecutorBuilderExtension.cs

@@ -34,6 +34,21 @@ public static IRequestExecutorBuilder AddCommandType<TCommand>(this IRequestExec
             return requestExecutorBuilder;
         }
 
+        /// <summary>
+        /// Adds a DTO (Data Transfer Object) type to the GraphQL schema.
+        /// </summary>
+        /// <typeparam name="T">The DTO type to add.</typeparam>
+        /// <param name="requestExecutorBuilder">The GraphQL request executor builder.</param>
+        /// <returns>The configured request executor builder with added DTO type.</returns>
+        /// <remarks>
+        /// This method registers a DTO type using the <see cref="DtoType{T}"/> wrapper to expose it in the GraphQL schema.
+        /// </remarks>
+        public static IRequestExecutorBuilder AddDtoType<T>(this IRequestExecutorBuilder requestExecutorBuilder)
+        {
+            return requestExecutorBuilder
+                .AddType<DtoType<T>>();
+        }
+
         /// <summary>
         /// Adds custom error types to the GraphQL schema.
         /// </summary>

src/BytLabs.Api/BytLabs.Api.Graphql/Types/AggregateType.cs

@@ -2,8 +2,17 @@
 
 namespace BytLabs.Api.Graphql.Types
 {
+    /// <summary>
+    /// Base GraphQL type for aggregate root entities.
+    /// </summary>
+    /// <typeparam name="TAggregate">The aggregate root type</typeparam>
+    /// <typeparam name="TId">The type of the aggregate's identifier</typeparam>
     public class AggregateType<TAggregate, TId> : ObjectType<TAggregate> where TAggregate : IAggregateRoot<TId>
     {
+        /// <summary>
+        /// Configures the GraphQL type descriptor for the aggregate.
+        /// </summary>
+        /// <param name="descriptor">The descriptor to configure</param>
         protected override void Configure(IObjectTypeDescriptor<TAggregate> descriptor)
         {
             descriptor.Ignore(a => a.DomainEvents);

src/BytLabs.Api/BytLabs.Api.Graphql/Types/DtoFilterInputType.cs

@@ -0,0 +1,21 @@
+using HotChocolate.Data.Filters;
+
+namespace BytLabs.Api.Graphql
+{
+    /// <summary>
+    /// Base GraphQL filter input type for DTOs.
+    /// </summary>
+    /// <typeparam name="T">The DTO type to create filters for</typeparam>
+    public class DtoFilterInputType<T> : FilterInputType<T>
+    {
+        /// <summary>
+        /// Configures the filter input type descriptor.
+        /// </summary>
+        /// <param name="descriptor">The descriptor to configure</param>
+        protected override void Configure(IFilterInputTypeDescriptor<T> descriptor)
+        {
+            base.Configure(descriptor);
+            descriptor.Name(typeof(T).Name.Replace("Dto", "") + "FilterInput");
+        }
+    }
+}

src/BytLabs.Api/BytLabs.Api.Graphql/Types/DtoSortInputType.cs

@@ -0,0 +1,21 @@
+using HotChocolate.Data.Sorting;
+
+namespace BytLabs.Api.Graphql
+{
+    /// <summary>
+    /// Base GraphQL sort input type for DTOs.
+    /// </summary>
+    /// <typeparam name="T">The DTO type to create sorting for</typeparam>
+    public class DtoSortInputType<T> : SortInputType<T>
+    {
+        /// <summary>
+        /// Configures the sort input type descriptor.
+        /// </summary>
+        /// <param name="descriptor">The descriptor to configure</param>
+        protected override void Configure(ISortInputTypeDescriptor<T> descriptor)
+        {
+            base.Configure(descriptor);
+            descriptor.Name(typeof(T).Name.Replace("Dto", "") + "SortInput");
+        }
+    }
+}

src/BytLabs.Api/BytLabs.Api.Graphql/Types/DtoType.cs

@@ -0,0 +1,19 @@
+namespace BytLabs.Api.Graphql
+{
+    /// <summary>
+    /// Base GraphQL type for DTOs.
+    /// </summary>
+    /// <typeparam name="T">The DTO type to create a GraphQL type for</typeparam>
+    public class DtoType<T> : ObjectType<T>
+    {
+        /// <summary>
+        /// Configures the GraphQL type descriptor for the DTO.
+        /// </summary>
+        /// <param name="descriptor">The descriptor to configure</param>
+        protected override void Configure(IObjectTypeDescriptor<T> descriptor)
+        {
+            descriptor.Name(typeof(T).Name.Replace("Dto", ""));
+            descriptor.BindFieldsImplicitly();
+        }
+    }
+}