♻️ Some renaming

- Renamed page classes
- Made created page class propeties public

Author: asevos

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<RetrievedPage>> QueryAsync(string databaseId, DatabasesQueryParameters databasesQueryParameters)
+        public async Task<PaginatedList<Page>> QueryAsync(string databaseId, DatabasesQueryParameters databasesQueryParameters)
         {
             var body = (IDatabaseQueryBodyParameters)databasesQueryParameters;
 
-            return await _client.PostAsync<PaginatedList<RetrievedPage>>(DatabasesApiUrls.Query(databaseId), body);
+            return await _client.PostAsync<PaginatedList<Page>>(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<RetrievedPage>> QueryAsync(string databaseId, DatabasesQueryParameters databasesQueryParameters);
+        Task<PaginatedList<Page>> QueryAsync(string databaseId, DatabasesQueryParameters databasesQueryParameters);
         Task<PaginatedList<Database>> ListAsync(DatabasesListParameters databasesListParameters = null);
     }
 }

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

@@ -5,10 +5,10 @@ namespace Notion.Client
 {
     public interface IPagesClient
     {
-        Task<RetrievedPage> CreateAsync(CreatedPage page);
-        Task<RetrievedPage> RetrieveAsync(string pageId);
+        Task<Page> CreateAsync(NewPage page);
+        Task<Page> RetrieveAsync(string pageId);
 
-        Task<RetrievedPage> UpdatePropertiesAsync(
+        Task<Page> UpdatePropertiesAsync(
             string pageId,
             IDictionary<string, PropertyValue> updatedProperties
         );

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

@@ -13,25 +13,25 @@ public PagesClient(IRestClient client)
             _client = client;
         }
 
-        public async Task<RetrievedPage> CreateAsync(CreatedPage page)
+        public async Task<Page> CreateAsync(NewPage page)
         {
-            return await _client.PostAsync<RetrievedPage>(PagesApiUrls.Create(), page);
+            return await _client.PostAsync<Page>(PagesApiUrls.Create(), page);
         }
 
-        public async Task<RetrievedPage> RetrieveAsync(string pageId)
+        public async Task<Page> RetrieveAsync(string pageId)
         {
             var url = PagesApiUrls.Retrieve(pageId);
-            return await _client.GetAsync<RetrievedPage>(url);
+            return await _client.GetAsync<Page>(url);
         }
 
-        public async Task<RetrievedPage> UpdatePropertiesAsync(
+        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<RetrievedPage>(url, body);
+            return await _client.PatchAsync<Page>(url, body);
         }
 
         private class UpdatePropertiesParameters

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

@@ -0,0 +1,46 @@
+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/Models/Page/NewPage.cs

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