durable-actors 0.2.5

Standalone regional durable-object control plane, host, and durability runtime
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

use anyhow::Result;
use async_trait::async_trait;
use bytes::Bytes;

#[derive(Clone, Debug, PartialEq, Eq)]
pub enum StateWrite {
    Written,
    AlreadyExists,
    Replicated,
}

#[async_trait]
pub trait StateTransport: Send + Sync {
    async fn read(&self, signed_url: &str) -> Result<Bytes>;
    async fn write(&self, signed_url: &str, bytes: Vec<u8>) -> Result<StateWrite>;
}

#[async_trait]
pub trait SnapshotWriter: Send + Sync {
    async fn write_snapshot(
        &self,
        plan: &crate::storage::WritePlan,
        bytes: Vec<u8>,
    ) -> Result<StateWrite>;
}

#[derive(Clone, Default)]
pub struct GrpcStateTransport {
    channels: crate::grpc::transport::Channels,
}

impl GrpcStateTransport {
    pub fn new() -> Self {
        Self::default()
    }

    pub(crate) async fn capability(
        &self,
        url: &str,
    ) -> Result<(tonic::transport::Channel, String)> {
        self.channels.capability(url).await
    }
}

#[async_trait]
impl StateTransport for GrpcStateTransport {
    async fn read(&self, signed_url: &str) -> Result<Bytes> {
        let (channel, token) = self.capability(signed_url).await?;
        let response = storage_client(channel)
            .read(crate::grpc::transport::request(
                crate::grpc::proto::Empty {},
                &token,
            )?)
            .await?;
        Ok(Bytes::from(response.into_inner().data))
    }

    async fn write(&self, signed_url: &str, bytes: Vec<u8>) -> Result<StateWrite> {
        let (channel, token) = self.capability(signed_url).await?;
        let response = storage_client(channel)
            .write(crate::grpc::transport::request(
                crate::grpc::proto::SnapshotData { data: bytes },
                &token,
            )?)
            .await?;
        Ok(if response.into_inner().already_exists {
            StateWrite::AlreadyExists
        } else {
            StateWrite::Written
        })
    }
}

fn storage_client(
    channel: tonic::transport::Channel,
) -> crate::grpc::proto::snapshot_service_client::SnapshotServiceClient<tonic::transport::Channel> {
    crate::grpc::proto::snapshot_service_client::SnapshotServiceClient::new(channel)
        .max_decoding_message_size(crate::grpc::transport::MAX_STORAGE_MESSAGE_BYTES)
        .max_encoding_message_size(crate::grpc::transport::MAX_STORAGE_MESSAGE_BYTES)
}

#[cfg(test)]
#[path = "../tests/unit/state_transport.rs"]
mod tests;