babelforce-manager-sdk 0.42.3

Rust SDK for the babelforce manager APIs — auth, user & agent management, call reporting, metrics, and task automations.
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

use std::path::PathBuf;
use std::sync::Arc;

use crate::error::{map_manager_err, ManagerError};
use crate::gen::manager::apis::configuration::Configuration;
use crate::gen::manager::apis::{manager_api, phonebook_entry_api as api};
use crate::gen::manager::models;
use crate::http::collect_all;
use crate::retry::{with_retry, RetryPolicy};

/// Phonebook entries — `/api/v2/phonebook`.
pub struct PhonebookResource {
    pub(crate) cfg: Arc<Configuration>,
    pub(crate) retry: RetryPolicy,
}

impl PhonebookResource {
    /// List all phonebook entries (auto-paginated).
    pub async fn list_all(&self) -> Result<Vec<models::PhonebookEntry>, ManagerError> {
        collect_all(&self.retry, map_manager_err, |page| async move {
            let r = api::list_phonebook_entrys(self.cfg.as_ref(), Some(page), None).await?;
            Ok((r.items, r.pagination.pages, r.pagination.current))
        })
        .await
    }

    /// Create a phonebook entry.
    pub async fn create(
        &self,
        body: models::RestCreatePhonebookEntry,
    ) -> Result<models::PhonebookEntryItemResponse, ManagerError> {
        with_retry(&self.retry, false, || {
            api::create_phonebook_entry(self.cfg.as_ref(), body.clone())
        })
        .await
        .map_err(map_manager_err)
    }

    /// Get a phonebook entry by id.
    pub async fn get(&self, id: &str) -> Result<models::PhonebookEntryItemResponse, ManagerError> {
        with_retry(&self.retry, true, || {
            api::get_phonebook_entry(self.cfg.as_ref(), id)
        })
        .await
        .map_err(map_manager_err)
    }

    /// Update a phonebook entry.
    pub async fn update(
        &self,
        id: &str,
        body: models::RestUpdatePhonebookEntry,
    ) -> Result<models::PhonebookEntryItemResponse, ManagerError> {
        with_retry(&self.retry, false, || {
            api::update_phonebook_entry(self.cfg.as_ref(), id, body.clone())
        })
        .await
        .map_err(map_manager_err)
    }

    /// Delete a phonebook entry.
    pub async fn delete(&self, id: &str) -> Result<(), ManagerError> {
        with_retry(&self.retry, false, || {
            api::delete_phonebook_entry(self.cfg.as_ref(), id)
        })
        .await
        .map_err(map_manager_err)?;
        Ok(())
    }

    /// Download all phonebook entries as CSV text.
    pub async fn download(&self) -> Result<String, ManagerError> {
        with_retry(&self.retry, true, || {
            manager_api::download_phonebook_entries(self.cfg.as_ref())
        })
        .await
        .map_err(map_manager_err)
    }

    /// Bulk-upload phonebook entries from a CSV file. `overwrite` replaces existing entries.
    pub async fn upload(&self, file: PathBuf, overwrite: bool) -> Result<(), ManagerError> {
        with_retry(&self.retry, false, || {
            manager_api::upload_phonebook_entries(self.cfg.as_ref(), file.clone(), Some(overwrite))
        })
        .await
        .map_err(map_manager_err)?;
        Ok(())
    }

    /// Bulk-delete phonebook entries by id.
    pub async fn bulk_delete(
        &self,
        ids: Vec<String>,
    ) -> Result<models::DefaultV2MessageResponse, ManagerError> {
        let ids = ids
            .iter()
            .map(|id| {
                uuid::Uuid::parse_str(id)
                    .map_err(|e| ManagerError::InvalidArgument(format!("ids: {e}")))
            })
            .collect::<Result<Vec<_>, _>>()?;
        let body = models::BulkIdsRequest { ids };
        with_retry(&self.retry, false, || {
            manager_api::bulk_delete_phonebook_entries(self.cfg.as_ref(), body.clone())
        })
        .await
        .map_err(map_manager_err)
    }
}