Merge branch 'main' into feature/add-support-for-search-apis

Author: KoditkarVedant

Src/Notion.Client/Api/ApiEndpoints.cs

@@ -21,6 +21,13 @@ public static class BlocksApiUrls
             public static string AppendChildren(string blockId) => $"/v1/blocks/{blockId}/children";
         }
 
+        public static class PagesApiUrls
+        {
+            public static string Create() => $"/v1/pages";
+            public static string Retrieve(string pageId) => $"/v1/pages/{pageId}";
+            public static string UpdateProperties(string pageId) => $"/v1/pages/{pageId}";
+        }
+
         public static class SearchApiUrls
         {
             public static string Search() => "/v1/search";

Src/Notion.Client/Api/Pages/IPagesClient.cs

@@ -0,0 +1,16 @@
+using System.Collections.Generic;
+using System.Threading.Tasks;
+
+namespace Notion.Client
+{
+    public interface IPagesClient
+    {
+        Task<Page> CreateAsync(NewPage page);
+        Task<Page> RetrieveAsync(string pageId);
+
+        Task<Page> UpdatePropertiesAsync(
+            string pageId,
+            IDictionary<string, PropertyValue> updatedProperties
+        );
+    }
+}

Src/Notion.Client/Api/Pages/PagesClient.cs

@@ -0,0 +1,42 @@
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using static Notion.Client.ApiEndpoints;
+
+namespace Notion.Client
+{
+    public class PagesClient : IPagesClient
+    {
+        private readonly IRestClient _client;
+
+        public PagesClient(IRestClient client)
+        {
+            _client = client;
+        }
+
+        public async Task<Page> CreateAsync(NewPage page)
+        {
+            return await _client.PostAsync<Page>(PagesApiUrls.Create(), page);
+        }
+
+        public async Task<Page> RetrieveAsync(string pageId)
+        {
+            var url = PagesApiUrls.Retrieve(pageId);
+            return await _client.GetAsync<Page>(url);
+        }
+
+        public async Task<Page> UpdatePropertiesAsync(
+            string pageId,
+            IDictionary<string, PropertyValue> updatedProperties)
+        {
+            var url = PagesApiUrls.UpdateProperties(pageId);
+            var body = new UpdatePropertiesParameters { Properties = updatedProperties };
+
+            return await _client.PatchAsync<Page>(url, body);
+        }
+
+        private class UpdatePropertiesParameters
+        {
+            public IDictionary<string, PropertyValue> Properties { get; set; }
+        }
+    }
+}

Src/Notion.Client/Models/Page/NewPage.cs

@@ -0,0 +1,45 @@
+using System.Collections.Generic;
+
+namespace Notion.Client
+{
+    public class NewPage
+    {
+        /// <summary>
+        /// Constructor without arguments: added for class initializations using class literals.
+        /// </summary>
+        public NewPage()
+        {
+            Properties = new Dictionary<string, PropertyValue>();
+            Children = new List<Block>();
+        }
+
+        /// <summary>
+        /// Constructor that adds required <c>Parent</c> property. Used when you don't want to
+        /// assign properties in separate operations.
+        /// </summary>
+        public NewPage(Parent parent)
+        {
+            Parent = parent;
+            Properties = new Dictionary<string, PropertyValue>();
+            Children = new List<Block>();
+        }
+
+        public Parent Parent { get; set; }
+
+        public Dictionary<string, PropertyValue> Properties { get; set; }
+
+        public List<Block> Children { get; set; }
+
+        public NewPage AddProperty(string nameOrId, PropertyValue value)
+        {
+            Properties[nameOrId] = value;
+            return this;
+        }
+
+        public NewPage AddPageContent(Block block)
+        {
+            Children.Add(block);
+            return this;
+        }
+    }
+}

Src/Notion.Client/NotionClient.cs

@@ -4,6 +4,7 @@ public interface INotionClient
     {
         IUsersClient Users { get; }
         IDatabasesClient Databases { get; }
+        IPagesClient Pages { get; }
         ISearchClient Search { get; }
     }
 
@@ -14,11 +15,13 @@ public NotionClient(ClientOptions options)
             var restClient = new RestClient(options);
             Users = new UsersClient(restClient);
             Databases = new DatabasesClient(restClient);
+            Pages = new PagesClient(restClient);
             Search = new SearchClient(restClient);
         }
 
         public IUsersClient Users { get; }
         public IDatabasesClient Databases { get; }
+        public IPagesClient Pages { get; }
         public ISearchClient Search { get; }
     }
 }