Add support to fetch comments

Author: KoditkarVedant

Src/Notion.Client/Api/ApiEndpoints.cs

@@ -61,5 +61,10 @@ public static class SearchApiUrls
         {
             public static string Search() => "/v1/search";
         }
+
+        public static class CommentsApiUrls
+        {
+            public static string Retrieve() => "/v1/comments";
+        }
     }
 }

Src/Notion.Client/Api/Comments/CommentsClient.cs

@@ -0,0 +1,12 @@
+namespace Notion.Client
+{
+    public partial class CommentsClient : ICommentsClient
+    {
+        private readonly IRestClient _client;
+
+        public CommentsClient(IRestClient restClient)
+        {
+            _client = restClient;
+        }
+    }
+}

Src/Notion.Client/Api/Comments/ICommentsClient.cs

@@ -0,0 +1,14 @@
+using System.Threading.Tasks;
+
+namespace Notion.Client
+{
+    public interface ICommentsClient
+    {
+        /// <summary>
+        /// Retrieves a list of un-resolved Comment objects from a page or block.
+        /// </summary>
+        /// <param name="retrieveCommentsParameters">Retrieve comments parameters</param>
+        /// <returns><see cref="RetrieveCommentsResponse"/></returns>
+        Task<RetrieveCommentsResponse> Retrieve(RetrieveCommentsParameters retrieveCommentsParameters);
+    }
+}

Src/Notion.Client/Api/Comments/Retrieve/CommentsClient.cs

@@ -0,0 +1,25 @@
+using System.Collections.Generic;
+using System.Threading.Tasks;
+
+namespace Notion.Client
+{
+    public partial class CommentsClient
+    {
+        public async Task<RetrieveCommentsResponse> Retrieve(RetrieveCommentsParameters parameters)
+        {
+            var qp = (IRetrieveCommentsQueryParameters)parameters;
+
+            var queryParams = new Dictionary<string, string>()
+            {
+                { "block_id", qp.BlockId },
+                { "start_cursor", qp.StartCursor },
+                { "page_size", qp.PageSize.ToString() },
+            };
+
+            return await _client.GetAsync<RetrieveCommentsResponse>(
+                ApiEndpoints.CommentsApiUrls.Retrieve(),
+                queryParams
+            );
+        }
+    }
+}

Src/Notion.Client/Api/Comments/Retrieve/Request/IRetrieveCommentsQueryParameters.cs

@@ -0,0 +1,10 @@
+using Newtonsoft.Json;
+
+namespace Notion.Client
+{
+    public interface IRetrieveCommentsQueryParameters : IPaginationParameters
+    {
+        [JsonProperty("block_id")]
+        string BlockId { get; set; }
+    }
+}

Src/Notion.Client/Api/Comments/Retrieve/Request/RetrieveCommentsParameters.cs

@@ -0,0 +1,9 @@
+namespace Notion.Client
+{
+    public class RetrieveCommentsParameters : IRetrieveCommentsQueryParameters
+    {
+        public string BlockId { get; set; }
+        public string StartCursor { get; set; }
+        public int? PageSize { get; set; }
+    }
+}

Src/Notion.Client/Api/Comments/Retrieve/Response/Comment.cs

@@ -0,0 +1,31 @@
+using System;
+using System.Collections.Generic;
+using Newtonsoft.Json;
+
+namespace Notion.Client
+{
+    public class Comment : IObject
+    {
+        public string Id { get; set; }
+
+        public ObjectType Object => ObjectType.Comment;
+
+        [JsonProperty("parent")]
+        public ICommentParent Parent { get; set; }
+
+        [JsonProperty("discussion_id")]
+        public string DiscussionId { get; set; }
+
+        [JsonProperty("rich_text")]
+        public IEnumerable<RichTextBase> RichText { get; set; }
+
+        [JsonProperty("created_by")]
+        public PartialUser CreatedBy { get; set; }
+
+        [JsonProperty("created_time")]
+        public DateTime CreatedTime { get; set; }
+
+        [JsonProperty("last_edited_time")]
+        public DateTime LastEditedTime { get; set; }
+    }
+}

Src/Notion.Client/Api/Comments/Retrieve/Response/Comments.cs

@@ -0,0 +1,14 @@
+using System.Collections.Generic;
+using Newtonsoft.Json;
+
+namespace Notion.Client
+{
+    public class RetrieveCommentsResponse : PaginatedList<Comment>
+    {
+        [JsonProperty("type")]
+        public string Type { get; set; }
+
+        [JsonProperty("comment")]
+        public Dictionary<string, object> Comment { get; set; }
+    }
+}

Src/Notion.Client/Api/Comments/Retrieve/Response/ICommentParent.cs

@@ -0,0 +1,12 @@
+using JsonSubTypes;
+using Newtonsoft.Json;
+
+namespace Notion.Client
+{
+    [JsonConverter(typeof(JsonSubtypes), "type")]
+    [JsonSubtypes.KnownSubType(typeof(PageParent), ParentType.PageId)]
+    [JsonSubtypes.KnownSubType(typeof(BlockParent), ParentType.BlockId)]
+    public interface ICommentParent
+    {
+    }
+}

Src/Notion.Client/Models/ObjectType.cs

@@ -15,5 +15,8 @@ public enum ObjectType
 
         [EnumMember(Value = "user")]
         User,
+
+        [EnumMember(Value = "comment")]
+        Comment,
     }
 }