feat: Paging improvements and ergonomics

src/models.rs

@@ -167,6 +167,17 @@ pub struct Properties {
     pub properties: HashMap<String, PropertyValue>,
 }
 
+impl Properties {
+    pub fn title(&self) -> Option<String> {
+        self.properties.values().find_map(|p| match p {
+            PropertyValue::Title { title, .. } => {
+                Some(title.into_iter().map(|t| t.plain_text()).collect())
+            }
+            _ => None,
+        })
+    }
+}
+
 #[derive(Serialize, Deserialize, Debug, Eq, PartialEq, Clone)]
 pub struct Page {
     pub id: PageId,
@@ -180,6 +191,12 @@ pub struct Page {
     pub parent: Parent,
 }
 
+impl Page {
+    pub fn title(&self) -> Option<String> {
+        self.properties.title()
+    }
+}
+
 #[derive(Serialize, Deserialize, Debug, Eq, PartialEq, Clone)]
 pub struct BlockCommon {
     pub id: BlockId,

src/models/paging.rs

@@ -13,5 +13,5 @@ pub struct Paging {
 }
 
 pub trait Pageable {
-    fn start_from(self, starting_point: Paging) -> Self;
+    fn start_from(self, starting_point: Option<PagingCursor>) -> Self;
 }

src/models/properties.rs

@@ -263,7 +263,7 @@ pub enum PropertyValue {
     /// <https://developers.notion.com/reference/page#number-property-values>
     Number {
         id: PropertyId,
-        number: Number,
+        number: Option<Number>,
     },
     /// <https://developers.notion.com/reference/page#select-property-values>
     Select {
@@ -276,7 +276,7 @@ pub enum PropertyValue {
     },
     Date {
         id: PropertyId,
-        date: DateValue,
+        date: Option<DateValue>,
     },
     /// <https://developers.notion.com/reference/page#formula-property-values>
     Formula {
@@ -290,7 +290,7 @@ pub enum PropertyValue {
     },
     Rollup {
         id: PropertyId,
-        relation: Rollup,
+        relation: Option<Rollup>,
     },
     People {
         id: PropertyId,
@@ -310,7 +310,7 @@ pub enum PropertyValue {
     },
     Email {
         id: PropertyId,
-        email: String,
+        email: Option<String>,
     },
     PhoneNumber {
         id: PropertyId,

src/models/properties/tests.rs

@@ -26,3 +26,9 @@ fn parse_select_property() {
     let _property: PropertyValue =
         serde_json::from_str(include_str!("tests/select_property.json")).unwrap();
 }
+
+#[test]
+fn parse_text_property_with_link() {
+    let _property: PropertyValue =
+        serde_json::from_str(include_str!("tests/text_with_link.json")).unwrap();
+}

src/models/properties/tests/text_with_link.json

@@ -0,0 +1,25 @@
+{
+  "id": "6BZi",
+  "type": "rich_text",
+  "rich_text": [
+    {
+      "type": "text",
+      "text": {
+        "content": "https://notion.so/",
+        "link": {
+          "url": "https://notion.so/"
+        }
+      },
+      "annotations": {
+        "bold": false,
+        "italic": false,
+        "strikethrough": false,
+        "underline": false,
+        "code": false,
+        "color": "default"
+      },
+      "plain_text": "https://notion.so/",
+      "href": "https://notion.so/"
+    }
+  ]
+}

src/models/search.rs

@@ -1,5 +1,5 @@
 use crate::ids::{PageId, UserId};
-use crate::models::paging::{Pageable, Paging};
+use crate::models::paging::{Pageable, Paging, PagingCursor};
 use crate::models::Number;
 use chrono::{DateTime, Utc};
 use serde::ser::SerializeMap;
@@ -301,9 +301,12 @@ pub struct DatabaseQuery {
 }
 
 impl Pageable for DatabaseQuery {
-    fn start_from(self, starting_point: Paging) -> Self {
+    fn start_from(self, starting_point: Option<PagingCursor>) -> Self {
         DatabaseQuery {
-            paging: Some(starting_point),
+            paging: Some(Paging {
+                start_cursor: starting_point,
+                page_size: self.paging.and_then(|p| p.page_size),
+            }),
             ..self
         }
     }

src/models/text.rs

@@ -45,15 +45,15 @@ pub struct RichTextCommon {
     pub annotations: Option<Annotations>,
 }
 
-#[derive(Serialize, Deserialize, Debug, Eq, PartialEq)]
+#[derive(Serialize, Deserialize, Debug, Eq, PartialEq, Clone)]
 pub struct Link {
     pub url: String,
 }
 
 #[derive(Serialize, Deserialize, Debug, Eq, PartialEq, Clone)]
 pub struct Text {
     pub content: String,
-    pub link: Option<String>,
+    pub link: Option<Link>,
 }
 
 /// Rich text objects contain data for displaying formatted text, mentions, and equations.