✨ Adds page creation via API

- Adds new class for created page
- Adds new PagesClient to NotionClient
- Adds new API endpoint
- Renames Page to RetrievedPage

Author: asevos

Src/Notion.Client/Api/ApiEndpoints.cs

@@ -20,5 +20,10 @@ public static class BlocksApiUrls
             public static string RetrieveChildren(string blockId) => $"/v1/blocks/{blockId}/children";
             public static string AppendChildren(string blockId) => $"/v1/blocks/{blockId}/children";
         }
+
+        public static class PagesApiUrls
+        {
+            public static string Create() => $"/v1/pages";
+        }
     }
 }

Src/Notion.Client/Api/Databases/DatabasesClient.cs

@@ -31,11 +31,11 @@ public async Task<PaginatedList<Database>> ListAsync(DatabasesListParameters dat
             return await _client.GetAsync<PaginatedList<Database>>(DatabasesApiUrls.List(), queryParams);
         }
 
-        public async Task<PaginatedList<Page>> QueryAsync(string databaseId, DatabasesQueryParameters databasesQueryParameters)
+        public async Task<PaginatedList<RetrievedPage>> QueryAsync(string databaseId, DatabasesQueryParameters databasesQueryParameters)
         {
             var body = (IDatabaseQueryBodyParameters)databasesQueryParameters;
 
-            return await _client.PostAsync<PaginatedList<Page>>(DatabasesApiUrls.Query(databaseId), body);
+            return await _client.PostAsync<PaginatedList<RetrievedPage>>(DatabasesApiUrls.Query(databaseId), body);
         }
     }
 }

Src/Notion.Client/Api/Databases/IDatabasesClient.cs

@@ -5,7 +5,7 @@ namespace Notion.Client
     public interface IDatabasesClient
     {
         Task<Database> RetrieveAsync(string databaseId);
-        Task<PaginatedList<Page>> QueryAsync(string databaseId, DatabasesQueryParameters databasesQueryParameters);
+        Task<PaginatedList<RetrievedPage>> QueryAsync(string databaseId, DatabasesQueryParameters databasesQueryParameters);
         Task<PaginatedList<Database>> ListAsync(DatabasesListParameters databasesListParameters = null);
     }
 }

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

@@ -0,0 +1,9 @@
+using System.Threading.Tasks;
+
+namespace Notion.Client
+{
+    public interface IPagesClient
+    {
+        Task<RetrievedPage> CreateAsync(CreatedPage page);
+    }
+}

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

@@ -0,0 +1,21 @@
+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<RetrievedPage> CreateAsync(CreatedPage page)
+        {
+            return await _client.PostAsync<RetrievedPage>(PagesApiUrls.Create(), page);
+        }
+    }
+
+}

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

@@ -0,0 +1,37 @@
+using System.Collections.Generic;
+using System.Runtime.Serialization;
+
+namespace Notion.Client
+{
+    [DataContract]
+    public class CreatedPage
+    {
+        public CreatedPage(Parent parent)
+        {
+            Parent = parent;
+            Properties = new Dictionary<string, PropertyValue>();
+            Children = new List<Block>();
+        }
+
+        [DataMember]
+        private Parent Parent;
+
+        [DataMember]
+        private Dictionary<string, PropertyValue> Properties;
+
+        [DataMember]
+        private List<Block> Children;
+
+        public CreatedPage AddProperty(string nameOrId, PropertyValue value)
+        {
+            Properties[nameOrId] = value;
+            return this;
+        }
+
+        public CreatedPage AddPageContent(Block block)
+        {
+            Children.Add(block);
+            return this;
+        }
+    }
+}

Src/Notion.Client/Models/Page/Page.cs renamed to Src/Notion.Client/Models/Page/RetrievedPage.cs

@@ -4,7 +4,7 @@
 
 namespace Notion.Client
 {
-    public class Page
+    public class RetrievedPage
     {
         public string Object => "page";
         public string Id { get; set; }

Src/Notion.Client/NotionClient.cs

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