gestalt-sdk 0.0.1-alpha.12

Rust SDK scaffolding and generated protocol bindings for Gestalt executable providers
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
126
127
128

use std::collections::BTreeMap;
use std::convert::Infallible;

use tonic::codegen::async_trait;

use crate::catalog::Catalog;
use crate::error::{Error, Result};

#[derive(Clone, Debug, Default, Eq, PartialEq)]
pub struct Subject {
    pub id: String,
    pub kind: String,
    pub display_name: String,
    pub auth_source: String,
}

#[derive(Clone, Debug, Default, Eq, PartialEq)]
pub struct Credential {
    pub mode: String,
    pub subject_id: String,
    pub connection: String,
    pub instance: String,
}

#[derive(Clone, Debug, Default, Eq, PartialEq)]
pub struct Access {
    pub policy: String,
    pub role: String,
}

#[derive(Clone, Debug, Default, Eq, PartialEq)]
pub struct Request {
    pub token: String,
    pub connection_params: BTreeMap<String, String>,
    pub subject: Subject,
    pub credential: Credential,
    pub access: Access,
}

impl Request {
    pub fn connection_param(&self, name: &str) -> Option<&str> {
        self.connection_params.get(name).map(String::as_str)
    }
}

#[derive(Clone, Debug, Eq, PartialEq)]
pub struct Response<T> {
    pub status: Option<u16>,
    pub body: T,
}

impl<T> Response<T> {
    pub fn new(status: u16, body: T) -> Self {
        Self {
            status: Some(status),
            body,
        }
    }
}

pub fn ok<T>(body: T) -> Response<T> {
    Response::new(200, body)
}

pub trait IntoResponse<T> {
    fn into_response(self) -> Response<T>;
}

impl<T> IntoResponse<T> for Response<T> {
    fn into_response(self) -> Response<T> {
        self
    }
}

impl<T> IntoResponse<T> for T {
    fn into_response(self) -> Response<T> {
        ok(self)
    }
}

#[derive(Clone, Debug, Default, Eq, PartialEq)]
pub struct RuntimeMetadata {
    pub name: String,
    pub display_name: String,
    pub description: String,
    pub version: String,
}

#[async_trait]
pub trait Provider: Send + Sync + 'static {
    async fn configure(
        &self,
        _name: &str,
        _config: serde_json::Map<String, serde_json::Value>,
    ) -> Result<()> {
        Ok(())
    }

    fn metadata(&self) -> Option<RuntimeMetadata> {
        None
    }

    fn warnings(&self) -> Vec<String> {
        Vec::new()
    }

    async fn health_check(&self) -> Result<()> {
        Ok(())
    }

    fn supports_session_catalog(&self) -> bool {
        false
    }

    async fn catalog_for_request(&self, _request: &Request) -> Result<Option<Catalog>> {
        Ok(None)
    }

    async fn close(&self) -> Result<()> {
        Ok(())
    }
}

impl From<Infallible> for Error {
    fn from(_value: Infallible) -> Self {
        Error::internal("unreachable infallible error")
    }
}