awaken-server 0.6.0

Multi-protocol HTTP server with SSE, mailbox, and protocol adapters for Awaken
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

use awaken_server_contract::AuditAction;
use axum::http::HeaderMap;
use serde_json::Value;

use super::{ConfigNamespace, ConfigService};

impl ConfigService {
    /// Emit an audit event if an audit logger is configured.
    ///
    /// Best-effort: the call is fire-and-forget (matching the `AuditLogger::emit` contract).
    pub(super) async fn emit_audit(
        &self,
        action: AuditAction,
        namespace: ConfigNamespace,
        id: &str,
        before: Option<Value>,
        after: Option<Value>,
        headers: &HeaderMap,
    ) {
        self.emit_audit_with_suffix(action, namespace, id, "", before, after, headers)
            .await;
    }

    #[allow(clippy::too_many_arguments)]
    pub(super) async fn emit_audit_with_suffix(
        &self,
        action: AuditAction,
        namespace: ConfigNamespace,
        id: &str,
        suffix: &str,
        before: Option<Value>,
        after: Option<Value>,
        headers: &HeaderMap,
    ) {
        self.emit_audit_with_suffix_in_namespace(
            action,
            namespace.as_str(),
            id,
            suffix,
            before,
            after,
            headers,
        )
        .await;
    }

    #[allow(clippy::too_many_arguments)]
    pub(super) async fn emit_audit_with_suffix_in_namespace(
        &self,
        action: AuditAction,
        namespace: &str,
        id: &str,
        suffix: &str,
        before: Option<Value>,
        after: Option<Value>,
        headers: &HeaderMap,
    ) {
        let Some(audit) = &self.audit else {
            return;
        };
        let resource = if suffix.is_empty() {
            format!("{namespace}/{id}")
        } else {
            format!("{namespace}/{id}/{suffix}")
        };
        audit.emit(action, &resource, before, after, headers).await;
    }

    #[allow(clippy::too_many_arguments)]
    pub(super) async fn emit_audit_apply_failed(
        &self,
        namespace: ConfigNamespace,
        id: &str,
        suffix: &str,
        before: Option<Value>,
        after: Option<Value>,
        error_msg: String,
        headers: &HeaderMap,
    ) {
        self.emit_audit_apply_failed_in_namespace(
            namespace.as_str(),
            id,
            suffix,
            before,
            after,
            error_msg,
            headers,
        )
        .await;
    }

    #[allow(clippy::too_many_arguments)]
    pub(super) async fn emit_audit_apply_failed_in_namespace(
        &self,
        namespace: &str,
        id: &str,
        suffix: &str,
        before: Option<Value>,
        after: Option<Value>,
        error_msg: String,
        headers: &HeaderMap,
    ) {
        let Some(audit) = &self.audit else {
            return;
        };
        let resource = if suffix.is_empty() {
            format!("{namespace}/{id}")
        } else {
            format!("{namespace}/{id}/{suffix}")
        };
        audit
            .emit_apply_failed(&resource, before, after, error_msg, headers)
            .await;
    }
}