notionrs 0.14.0

A Notion API client that provides type-safe request serialization and response deserialization
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125

pub mod search_database;
pub mod search_page;

pub use search_database::*;
pub use search_page::*;

use serde::{Deserialize, Serialize};

use notionrs_types::object::response::ListResponse;

#[derive(Debug, Default)]
pub struct SearchClient {
    /// The reqwest http client
    pub(crate) reqwest_client: reqwest::Client,

    pub(crate) body: SearchRequestBody,
}

#[derive(Debug, Serialize, Deserialize, Default)]
pub struct SearchRequestBody {
    #[serde(skip_serializing_if = "Option::is_none")]
    pub(crate) query: Option<String>,

    #[serde(skip_serializing_if = "Option::is_none")]
    pub(crate) filter: Option<notionrs_types::object::request::search::SearchFilter>,

    #[serde(skip_serializing_if = "Option::is_none")]
    pub(crate) sort: Option<notionrs_types::object::request::search::SearchSort>,

    #[serde(skip_serializing_if = "Option::is_none")]
    pub(crate) start_cursor: Option<String>,

    #[serde(skip_serializing_if = "Option::is_none")]
    pub(crate) page_size: Option<u32>,
}

impl SearchClient {
    pub async fn send(
        self,
    ) -> Result<
        ListResponse<notionrs_types::object::response::SearchResultItem>,
        crate::error::Error,
    > {
        let url = String::from("https://api.notion.com/v1/search");

        let request_body = serde_json::to_string(&self.body)?;

        let request = self
            .reqwest_client
            .post(url)
            .header("Content-Type", "application/json")
            .body(request_body);

        let response = request
            .send()
            .await
            .map_err(|e| crate::error::Error::Network(e.to_string()))?;

        if !response.status().is_success() {
            return Err(crate::error::Error::try_from_response_async(response).await);
        }

        let body = response
            .bytes()
            .await
            .map_err(|e| crate::error::Error::BodyParse(e.to_string()))?;

        let pages = serde_json::from_slice::<
            ListResponse<notionrs_types::object::response::SearchResultItem>,
        >(&body)?;

        Ok(pages)
    }

    pub fn query<T: AsRef<str>>(mut self, query: T) -> Self {
        self.body.query = Some(query.as_ref().to_string());
        self
    }

    /// The amount of data retrieved in one query.
    /// If not specified, the default is 100.
    /// When `fetch_all` is set to true, it will also be 100.
    pub fn page_size(mut self, page_size: u32) -> Self {
        self.body.page_size = Some(page_size);
        self
    }

    /// Specify the cursor position at the beginning. In the query result,
    /// there is a field called `next_cursor` through
    /// which information is passed at the end.
    pub fn start_cursor<T: AsRef<str>>(mut self, start_cursor: T) -> Self {
        self.body.start_cursor = Some(start_cursor.as_ref().to_string());
        self
    }

    pub fn sort_timestamp_asc(self) -> Self {
        self.sort(notionrs_types::object::request::search::SearchSort::asc())
    }

    pub fn sort_timestamp_desc(self) -> Self {
        self.sort(notionrs_types::object::request::search::SearchSort::desc())
    }

    /// Restricts search results to only database types.
    /// It is recommended to use the search_database method, which returns results that are not in an enum format.
    pub fn filter_database(self) -> Self {
        self.filter(notionrs_types::object::request::search::SearchFilter::database())
    }

    /// Restricts search results to only page types.
    /// It is recommended to use the search_page method, which returns results that are not in an enum format.
    pub fn filter_page(self) -> Self {
        self.filter(notionrs_types::object::request::search::SearchFilter::page())
    }

    fn filter(mut self, filter: notionrs_types::object::request::search::SearchFilter) -> Self {
        self.body.filter = Some(filter);
        self
    }

    fn sort(mut self, sort: notionrs_types::object::request::search::SearchSort) -> Self {
        self.body.sort = Some(sort);
        self
    }
}