babelforce-manager-sdk 0.46.0

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

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

/// Logs — the request audit log (`/api/v2/audit/request`) and the live log (`/api/v2/logs`).
pub struct LogsResource {
    pub(crate) cfg: SharedCfg<Configuration>,
    pub(crate) retry: RetryPolicy,
}

impl LogsResource {
    /// Collect every audit-log entry across pages.
    pub async fn audit_all(&self) -> Result<Vec<models::AuditLog>, ManagerError> {
        let cfg = self.cfg.get().await?;
        let cfg = cfg.as_ref();
        collect_all(&self.retry, map_manager_err, |page| async move {
            let r = api::list_audit_logs(cfg, None, None, None, Some(page), None, None, None, None)
                .await?;
            Ok((
                r.items,
                r.pagination.pages.unwrap_or(1),
                r.pagination.current.unwrap_or(1),
            ))
        })
        .await
    }

    /// Read the live log.
    pub async fn live(&self) -> Result<Vec<models::LiveLog>, ManagerError> {
        let cfg = self.cfg.get().await?;
        let cfg = cfg.as_ref();
        let resp = with_retry(&self.retry, true, || api::list_live_logs(cfg, None))
            .await
            .map_err(map_manager_err)?;
        Ok(resp.items)
    }

    /// Enable live logging.
    pub async fn enable_live(&self) -> Result<models::DefaultV2MessageResponse, ManagerError> {
        let cfg = self.cfg.get().await?;
        let cfg = cfg.as_ref();
        with_retry(&self.retry, false, || api::enable_live_logging(cfg))
            .await
            .map_err(map_manager_err)
    }

    /// Disable live logging.
    pub async fn disable_live(&self) -> Result<models::DefaultV2MessageResponse, ManagerError> {
        let cfg = self.cfg.get().await?;
        let cfg = cfg.as_ref();
        with_retry(&self.retry, false, || api::disable_live_logging(cfg))
            .await
            .map_err(map_manager_err)
    }

    /// Write a single entry to the live log.
    pub async fn write(
        &self,
        body: models::WriteLogRequest,
    ) -> Result<models::GenericItemResponse, ManagerError> {
        let cfg = self.cfg.get().await?;
        let cfg = cfg.as_ref();
        with_retry(&self.retry, false, || api::write_log(cfg, body.clone()))
            .await
            .map_err(map_manager_err)
    }
}