Merge pull request #311 from notion-dotnet/310-add-support-for-comments-api

Add support for Comments API

Author: KoditkarVedant

Src/Notion.Client/Api/ApiEndpoints.cs

@@ -61,5 +61,12 @@ public static class SearchApiUrls
         {
             public static string Search() => "/v1/search";
         }
+
+        public static class CommentsApiUrls
+        {
+            public static string Retrieve() => "/v1/comments";
+
+            public static string Create() => "/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/Create/CommentsClient.cs

@@ -0,0 +1,17 @@
+using System.Threading.Tasks;
+
+namespace Notion.Client
+{
+    public partial class CommentsClient
+    {
+        public async Task<CreateCommentResponse> Create(CreateCommentParameters parameters)
+        {
+            var body = (ICreateCommentsBodyParameters)parameters;
+
+            return await _client.PostAsync<CreateCommentResponse>(
+                ApiEndpoints.CommentsApiUrls.Create(),
+                body
+            );
+        }
+    }
+}

Src/Notion.Client/Api/Comments/Create/Request/CreateCommentParameters.cs

@@ -0,0 +1,48 @@
+using System.Collections.Generic;
+using Newtonsoft.Json;
+
+namespace Notion.Client
+{
+    public interface ICreateCommentsBodyParameters
+    {
+        [JsonProperty("rich_text")]
+        public IEnumerable<RichTextBaseInput> RichText { get; set; }
+    }
+
+    public interface ICreateDiscussionCommentBodyParameters : ICreateCommentsBodyParameters
+    {
+        [JsonProperty("discussion_id")]
+        public string DiscussionId { get; set; }
+    }
+
+    public interface ICreatePageCommentBodyParameters : ICreateCommentsBodyParameters
+    {
+        [JsonProperty("parent")]
+        public ParentPageInput Parent { get; set; }
+    }
+
+    public class CreateCommentParameters : ICreateDiscussionCommentBodyParameters, ICreatePageCommentBodyParameters
+    {
+        public string DiscussionId { get; set; }
+        public IEnumerable<RichTextBaseInput> RichText { get; set; }
+        public ParentPageInput Parent { get; set; }
+
+        public static CreateCommentParameters CreatePageComment(ParentPageInput parent, IEnumerable<RichTextBaseInput> richText)
+        {
+            return new CreateCommentParameters
+            {
+                Parent = parent,
+                RichText = richText
+            };
+        }
+
+        public static CreateCommentParameters CreateDiscussionComment(string discussionId, IEnumerable<RichTextBaseInput> richText)
+        {
+            return new CreateCommentParameters
+            {
+                DiscussionId = discussionId,
+                RichText = richText
+            };
+        }
+    }
+}

Src/Notion.Client/Api/Comments/Create/Response/CreateCommentResponse.cs

@@ -0,0 +1,6 @@
+namespace Notion.Client
+{
+    public class CreateCommentResponse : Comment
+    {
+    }
+}

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

@@ -0,0 +1,16 @@
+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);
+
+        Task<CreateCommentResponse> Create(CreateCommentParameters createCommentParameters);
+    }
+}

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; }
+    }
+}