Add support for Append Block Children api ✨

Author: KoditkarVedant

Src/Notion.Client/Api/ApiEndpoints.cs

@@ -18,6 +18,7 @@ public static class UsersApiUrls
         public static class BlocksApiUrls
         {
             public static string RetrieveChildren(string blockId) => $"/v1/blocks/{blockId}/children";
+            public static string AppendChildren(string blockId) => $"/v1/blocks/{blockId}/children";
         }
     }
 }

Src/Notion.Client/Api/Blocks/BlocksClient.cs

@@ -8,6 +8,7 @@ namespace Notion.Client
     public interface IBlocksClient
     {
         Task<PaginatedList<BlockBase>> RetrieveChildrenAsync(string blockId, BlockRetrieveChildrenParameters parameters = null);
+        Task<BlockBase> AppendChildrenAsync(string blockId, BlocksAppendChildrenParameters parameters = null);
     }
 
     public class BlocksClient : IBlocksClient
@@ -38,6 +39,20 @@ public async Task<PaginatedList<BlockBase>> RetrieveChildrenAsync(string blockId
 
             return await _client.GetAsync<PaginatedList<BlockBase>>(url, queryParams);
         }
+
+        public async Task<BlockBase> AppendChildrenAsync(string blockId, BlocksAppendChildrenParameters parameters = null)
+        {
+            if (string.IsNullOrWhiteSpace(blockId))
+            {
+                throw new ArgumentNullException(nameof(blockId));
+            }
+
+            var url = BlocksApiUrls.AppendChildren(blockId);
+
+            var body = (IBlocksAppendChildrenBodyParameters)parameters;
+
+            return await _client.PatchAsync<BlockBase>(url, body);
+        }
     }
 
     public interface IBlockRetrieveChildrenQueryParameters : IPaginationParameters
@@ -53,4 +68,16 @@ public class BlockRetrieveChildrenParameters : IBlockRetrieveChildrenParameters
         public string StartCursor { get; set; }
         public string PageSize { get; set; }
     }
+
+
+    // TODO: need an input version of Block
+    public interface IBlocksAppendChildrenBodyParameters
+    {
+        IEnumerable<BlockBase> Children { get; set; }
+    }
+
+    public class BlocksAppendChildrenParameters : IBlocksAppendChildrenBodyParameters
+    {
+        public IEnumerable<BlockBase> Children { get; set; }
+    }
 }

Src/Notion.Client/Models/Block.cs

@@ -23,7 +23,7 @@ public class BlockBase
         public string Id { get; set; }
 
         [JsonConverter(typeof(StringEnumConverter))]
-        public BlockType Type { get; set; }
+        public virtual BlockType Type { get; set; }
 
         [JsonProperty("created_time")]
         public string CreatedTime { get; set; }
@@ -40,6 +40,8 @@ public class BlockBase
 
     public class ParagraphBlock : BlockBase
     {
+        public override BlockType Type => BlockType.Paragraph;
+
         public ParagraphClass Paragraph { get; set; }
 
         public class ParagraphClass
@@ -51,6 +53,8 @@ public class ParagraphClass
 
     public class HeadingOneBlock : BlockBase
     {
+        public override BlockType Type => BlockType.Heading_1;
+
         [JsonProperty("heading_1")]
         public HeadingOneClass Heading_1 { get; set; }
 
@@ -64,6 +68,8 @@ public class HeadingOneClass
 
     public class HeadingTwoBlock : BlockBase
     {
+        public override BlockType Type => BlockType.Heading_2;
+
         [JsonProperty("heading_2")]
         public HeadingTwoClass Heading_2 { get; set; }
 
@@ -77,6 +83,8 @@ public class HeadingTwoClass
 
     public class HeadingThreeeBlock : BlockBase
     {
+        public override BlockType Type => BlockType.Heading_3;
+
         [JsonProperty("heading_3")]
         public HeadingThreeClass Heading_3 { get; set; }
 
@@ -90,6 +98,8 @@ public class HeadingThreeClass
 
     public class BulletedListItemBlock : BlockBase
     {
+        public override BlockType Type => BlockType.BulletedListItem;
+
         [JsonProperty("bulleted_list_item")]
         public BulletedListItemClass BulletedListItem { get; set; }
 
@@ -103,6 +113,8 @@ public class BulletedListItemClass
     public class NumberedListItemBlock : BlockBase
     {
 
+        public override BlockType Type => BlockType.NumberedListItem;
+
         [JsonProperty("numbered_list_item")]
         public NumberedListItemClass NumberedListItem { get; set; }
 
@@ -115,6 +127,8 @@ public class NumberedListItemClass
 
     public class ToDoBlock : BlockBase
     {
+        public override BlockType Type => BlockType.ToDo;
+
         [JsonProperty("to_do")]
         public ToDoClass ToDo { get; set; }
 
@@ -131,6 +145,8 @@ public class ToDoClass
 
     public class ToggleBlock : BlockBase
     {
+        public override BlockType Type => BlockType.Toggle;
+
         public ToggleClass Toggle { get; set; }
 
         public class ToggleClass
@@ -142,6 +158,8 @@ public class ToggleClass
 
     public class ChildPageBlock : BlockBase
     {
+        public override BlockType Type => BlockType.ChildPage;
+
 
         [JsonProperty("child_page")]
         public ChildPageClass ChildPage { get; set; }
@@ -154,6 +172,7 @@ public class ChildPageClass
 
     public class UnsupportedBlock : BlockBase
     {
+        public override BlockType Type => BlockType.Unsupported;
     }
 
     public enum BlockType

Src/Notion.Client/RestClient.cs

@@ -6,6 +6,7 @@
 using System.Threading;
 using System.Threading.Tasks;
 using Newtonsoft.Json;
+using Newtonsoft.Json.Serialization;
 using Notion.Client.Extensions;
 using Notion.Client.http;
 
@@ -27,6 +28,14 @@ Task<T> PostAsync<T>(
             IDictionary<string, string> headers = null,
             JsonSerializerSettings serializerSettings = null,
             CancellationToken cancellationToken = default);
+
+        Task<T> PatchAsync<T>(
+            string uri,
+            object body,
+            IDictionary<string, string> queryParams = null,
+            IDictionary<string, string> headers = null,
+            JsonSerializerSettings serializerSettings = null,
+            CancellationToken cancellationToken = default);
     }
 
     public class RestClient : IRestClient
@@ -36,7 +45,11 @@ public class RestClient : IRestClient
 
         private readonly JsonSerializerSettings defaultSerializerSettings = new JsonSerializerSettings
         {
-            NullValueHandling = NullValueHandling.Ignore
+            NullValueHandling = NullValueHandling.Ignore,
+            ContractResolver = new DefaultContractResolver
+            {
+                NamingStrategy = new CamelCaseNamingStrategy()
+            }
         };
 
         public RestClient(ClientOptions options)
@@ -139,6 +152,34 @@ void AttachContent(HttpRequestMessage httpRequest)
             throw new NotionApiException(response.StatusCode, message);
         }
 
+        public async Task<T> PatchAsync<T>(string uri, object body, IDictionary<string, string> queryParams = null, IDictionary<string, string> headers = null, JsonSerializerSettings serializerSettings = null, CancellationToken cancellationToken = default)
+        {
+            EnsureHttpClient();
+
+            void AttachContent(HttpRequestMessage httpRequest)
+            {
+                var serializedBody = JsonConvert.SerializeObject(body, defaultSerializerSettings);
+                httpRequest.Content = new StringContent(serializedBody, Encoding.UTF8, "application/json");
+            }
+
+            string requestUri = queryParams == null ? uri : QueryHelpers.AddQueryString(uri, queryParams);
+
+            var response = await SendAsync(requestUri, new HttpMethod("PATCH"), headers, AttachContent, cancellationToken: cancellationToken);
+
+            if (response.IsSuccessStatusCode)
+            {
+                return await response.ParseStreamAsync<T>(serializerSettings);
+            }
+
+            var message = !string.IsNullOrWhiteSpace(response.ReasonPhrase)
+                    ? response.ReasonPhrase
+                    : await response.Content.ReadAsStringAsync();
+
+            var errorMessage = await response.Content.ReadAsStringAsync();
+
+            throw new NotionApiException(response.StatusCode, message);
+        }
+
         private HttpClient EnsureHttpClient()
         {
             if (_httpClient == null)

Test/Notion.UnitTests/BlocksClientTests.cs

@@ -1,3 +1,4 @@
+using System.Collections.Generic;
 using System.Threading.Tasks;
 using Notion.Client;
 using Xunit;
@@ -18,14 +19,47 @@ public BlocksClientTests()
             _client = new BlocksClient(new RestClient(options));
         }
 
-        [Fact(Skip ="Dev only")]
+        [Fact(Skip = "Dev only")]
         public async Task RetrieveBlockChildren()
         {
             string blockId = "3c357473-a281-49a4-88c0-10d2b245a589";
-            
+
             var children = await _client.RetrieveChildrenAsync(blockId, new BlockRetrieveChildrenParameters());
 
             Assert.NotNull(children);
         }
+
+        [Fact(Skip = "Dev only")]
+        public async Task AppendBlockChildren()
+        {
+            string blockId = "3c357473-a281-49a4-88c0-10d2b245a589";
+
+            var parameters = new BlocksAppendChildrenParameters()
+            {
+                Children = new List<BlockBase>
+                {
+                    new HeadingTwoBlock()
+                    {
+                        Heading_2 = new HeadingTwoBlock.HeadingTwoClass
+                        {
+                            Text = new List<RichTextBase>
+                            {
+                                new RichTextText
+                                {
+                                    Text = new Text
+                                    {
+                                        Content = "Lacinato kale"
+                                    }
+                                }
+                            }
+                        }
+                    }
+                }
+            };
+
+            var block = await _client.AppendChildrenAsync(blockId, parameters);
+
+            Assert.NotNull(block);
+        }
     }
 }