feat: mock chat store implementation

This commit is contained in:
kaichaosun 2026-03-27 21:40:29 +08:00
parent c4566bb7ce
commit 7b61afd7f8
No known key found for this signature in database
GPG Key ID: 223E0F992F4F03BF
4 changed files with 222 additions and 31 deletions

View File

@ -11,6 +11,7 @@ use crate::{
inbox::Inbox, inbox::Inbox,
proto::{EncryptedPayload, EnvelopeV1, Message}, proto::{EncryptedPayload, EnvelopeV1, Message},
storage::ChatStorage, storage::ChatStorage,
store::{ChatStore, ConversationKind, ConversationMeta},
types::{AddressedEnvelope, ContentData}, types::{AddressedEnvelope, ContentData},
}; };
@ -19,19 +20,23 @@ pub use crate::inbox::Introduction;
// This is the main entry point to the conversations api. // This is the main entry point to the conversations api.
// Ctx manages lifetimes of objects to process and generate payloads. // Ctx manages lifetimes of objects to process and generate payloads.
pub struct Context { pub struct Context<T: ChatStore> {
_identity: Rc<Identity>, _identity: Rc<Identity>,
inbox: Inbox, inbox: Inbox,
storage: ChatStorage, storage: T,
ratchet_storage: RatchetStorage, ratchet_storage: RatchetStorage,
} }
impl Context { impl<T: ChatStore> Context<T> {
/// Opens or creates a Context with the given storage configuration. /// Opens or creates a Context with the given storage configuration.
/// ///
/// If an identity exists in storage, it will be restored. /// If an identity exists in storage, it will be restored.
/// Otherwise, a new identity will be created with the given name and saved. /// Otherwise, a new identity will be created with the given name and saved.
pub fn open(name: impl Into<String>, config: StorageConfig) -> Result<Self, ChatError> { pub fn open(
name: impl Into<String>,
config: StorageConfig,
store: T,
) -> Result<Self, ChatError> {
let mut storage = ChatStorage::new(config.clone())?; let mut storage = ChatStorage::new(config.clone())?;
let ratchet_storage = RatchetStorage::from_config(config)?; let ratchet_storage = RatchetStorage::from_config(config)?;
let name = name.into(); let name = name.into();
@ -51,7 +56,7 @@ impl Context {
Ok(Self { Ok(Self {
_identity: identity, _identity: identity,
inbox, inbox,
storage, storage: store,
ratchet_storage, ratchet_storage,
}) })
} }
@ -59,8 +64,9 @@ impl Context {
/// Creates a new in-memory Context (for testing). /// Creates a new in-memory Context (for testing).
/// ///
/// Uses in-memory SQLite database. Each call creates a new isolated database. /// Uses in-memory SQLite database. Each call creates a new isolated database.
pub fn new_with_name(name: impl Into<String>) -> Self { pub fn new_with_name(name: impl Into<String>, chat_store: T) -> Self {
Self::open(name, StorageConfig::InMemory).expect("in-memory storage should not fail") Self::open(name, StorageConfig::InMemory, chat_store)
.expect("in-memory storage should not fail")
} }
pub fn installation_name(&self) -> &str { pub fn installation_name(&self) -> &str {
@ -175,11 +181,14 @@ impl Context {
.load_conversation(convo_id)? .load_conversation(convo_id)?
.ok_or_else(|| ChatError::NoConvo(convo_id.into()))?; .ok_or_else(|| ChatError::NoConvo(convo_id.into()))?;
if record.convo_type != "private_v1" { match record.kind {
return Err(ChatError::BadBundleValue(format!( ConversationKind::PrivateV1 => {}
"unsupported conversation type: {}", ConversationKind::Unknown(_) => {
record.convo_type return Err(ChatError::BadBundleValue(format!(
))); "unsupported conversation type: {}",
record.kind.as_str()
)));
}
} }
let dr_state: RatchetState = self.ratchet_storage.load(&record.local_convo_id)?; let dr_state: RatchetState = self.ratchet_storage.load(&record.local_convo_id)?;
@ -193,21 +202,126 @@ impl Context {
/// Persists a conversation's metadata and ratchet state to DB. /// Persists a conversation's metadata and ratchet state to DB.
fn persist_convo(&mut self, convo: &dyn Convo) -> ConversationIdOwned { fn persist_convo(&mut self, convo: &dyn Convo) -> ConversationIdOwned {
let _ = self let convo_info = ConversationMeta {
.storage local_convo_id: convo.id().to_string(),
.save_conversation(convo.id(), &convo.remote_id(), convo.convo_type()); remote_convo_id: convo.remote_id(),
kind: convo.convo_type().into(),
};
let _ = self.storage.save_conversation(&convo_info);
let _ = convo.save_ratchet_state(&mut self.ratchet_storage); let _ = convo.save_ratchet_state(&mut self.ratchet_storage);
Arc::from(convo.id()) Arc::from(convo.id())
} }
} }
#[cfg(test)]
mod mock {
use crypto::PrivateKey;
use storage::StorageError;
use crate::store::{ConversationStore, EphemeralKeyStore, IdentityStore};
use super::*;
use std::collections::HashMap;
use std::sync::Mutex;
// Simple in-memory implementation of ChatStore for tests.
// Adjust the methods to match the exact trait definition in `crate::store::ChatStore`.
#[derive(Default)]
pub struct MockChatStore {
identity: Option<Identity>,
conversations: Mutex<HashMap<String, ConversationMeta>>,
ephemeral_keys: Mutex<HashMap<String, PrivateKey>>,
}
impl IdentityStore for MockChatStore {
fn load_identity(&self) -> Result<Option<Identity>, StorageError> {
Ok(self.identity.clone())
}
fn save_identity(&mut self, identity: &Identity) -> Result<(), StorageError> {
self.identity = Some(identity.clone());
Ok(())
}
}
impl EphemeralKeyStore for MockChatStore {
fn load_ephemeral_key(&self, key_hex: &str) -> Result<Option<PrivateKey>, StorageError> {
Ok(self.ephemeral_keys.lock().unwrap().get(key_hex).cloned())
}
fn save_ephemeral_key(
&mut self,
key_hex: &str,
private_key: &PrivateKey,
) -> Result<(), StorageError> {
self.ephemeral_keys
.lock()
.unwrap()
.insert(key_hex.to_string(), private_key.clone());
Ok(())
}
fn remove_ephemeral_key(&mut self, key_hex: &str) -> Result<(), StorageError> {
self.ephemeral_keys.lock().unwrap().remove(key_hex);
Ok(())
}
}
impl ConversationStore for MockChatStore {
fn save_conversation(&mut self, meta: &ConversationMeta) -> Result<(), StorageError> {
self.conversations
.lock()
.unwrap()
.insert(meta.local_convo_id.clone(), meta.clone());
Ok(())
}
fn load_conversation(
&self,
local_convo_id: &str,
) -> Result<Option<ConversationMeta>, StorageError> {
Ok(self
.conversations
.lock()
.unwrap()
.get(local_convo_id)
.cloned())
}
fn remove_conversation(&mut self, local_convo_id: &str) -> Result<(), StorageError> {
self.conversations.lock().unwrap().remove(local_convo_id);
Ok(())
}
fn load_conversations(&self) -> Result<Vec<ConversationMeta>, StorageError> {
Ok(self
.conversations
.lock()
.unwrap()
.values()
.cloned()
.collect())
}
fn has_conversation(&self, local_convo_id: &str) -> Result<bool, StorageError> {
Ok(self
.conversations
.lock()
.unwrap()
.contains_key(local_convo_id))
}
}
}
#[cfg(test)] #[cfg(test)]
mod tests { mod tests {
use crate::{context::mock::MockChatStore, store::ConversationStore};
use super::*; use super::*;
fn send_and_verify( fn send_and_verify(
sender: &mut Context, sender: &mut Context<MockChatStore>,
receiver: &mut Context, receiver: &mut Context<MockChatStore>,
convo_id: ConversationId, convo_id: ConversationId,
content: &[u8], content: &[u8],
) { ) {
@ -223,8 +337,8 @@ mod tests {
#[test] #[test]
fn ctx_integration() { fn ctx_integration() {
let mut saro = Context::new_with_name("saro"); let mut saro = Context::new_with_name("saro", MockChatStore::default());
let mut raya = Context::new_with_name("raya"); let mut raya = Context::new_with_name("raya", MockChatStore::default());
// Raya creates intro bundle and sends to Saro // Raya creates intro bundle and sends to Saro
let bundle = raya.create_intro_bundle().unwrap(); let bundle = raya.create_intro_bundle().unwrap();
@ -265,12 +379,12 @@ mod tests {
.to_string(); .to_string();
let config = StorageConfig::File(db_path); let config = StorageConfig::File(db_path);
let ctx1 = Context::open("alice", config.clone()).unwrap(); let ctx1 = Context::open("alice", config.clone(), MockChatStore::default()).unwrap();
let pubkey1 = ctx1._identity.public_key(); let pubkey1 = ctx1._identity.public_key();
let name1 = ctx1.installation_name().to_string(); let name1 = ctx1.installation_name().to_string();
drop(ctx1); drop(ctx1);
let ctx2 = Context::open("alice", config).unwrap(); let ctx2 = Context::open("alice", config, MockChatStore::default()).unwrap();
let pubkey2 = ctx2._identity.public_key(); let pubkey2 = ctx2._identity.public_key();
let name2 = ctx2.installation_name().to_string(); let name2 = ctx2.installation_name().to_string();
@ -288,14 +402,14 @@ mod tests {
.to_string(); .to_string();
let config = StorageConfig::File(db_path); let config = StorageConfig::File(db_path);
let mut ctx1 = Context::open("alice", config.clone()).unwrap(); let mut ctx1 = Context::open("alice", config.clone(), MockChatStore::default()).unwrap();
let bundle1 = ctx1.create_intro_bundle().unwrap(); let bundle1 = ctx1.create_intro_bundle().unwrap();
drop(ctx1); drop(ctx1);
let mut ctx2 = Context::open("alice", config.clone()).unwrap(); let mut ctx2 = Context::open("alice", config.clone(), MockChatStore::default()).unwrap();
let intro = Introduction::try_from(bundle1.as_slice()).unwrap(); let intro = Introduction::try_from(bundle1.as_slice()).unwrap();
let mut bob = Context::new_with_name("bob"); let mut bob = Context::new_with_name("bob", MockChatStore::default());
let (_, payloads) = bob.create_private_convo(&intro, b"hello after restart"); let (_, payloads) = bob.create_private_convo(&intro, b"hello after restart");
let payload = payloads.first().unwrap(); let payload = payloads.first().unwrap();
@ -317,8 +431,8 @@ mod tests {
.to_string(); .to_string();
let config = StorageConfig::File(db_path); let config = StorageConfig::File(db_path);
let mut alice = Context::open("alice", config.clone()).unwrap(); let mut alice = Context::open("alice", config.clone(), MockChatStore::default()).unwrap();
let mut bob = Context::new_with_name("bob"); let mut bob = Context::new_with_name("bob", MockChatStore::default());
let bundle = alice.create_intro_bundle().unwrap(); let bundle = alice.create_intro_bundle().unwrap();
let intro = Introduction::try_from(bundle.as_slice()).unwrap(); let intro = Introduction::try_from(bundle.as_slice()).unwrap();
@ -330,10 +444,10 @@ mod tests {
let convos = alice.storage.load_conversations().unwrap(); let convos = alice.storage.load_conversations().unwrap();
assert_eq!(convos.len(), 1); assert_eq!(convos.len(), 1);
assert_eq!(convos[0].convo_type, "private_v1"); assert_eq!(convos[0].kind.as_str(), "private_v1");
drop(alice); drop(alice);
let alice2 = Context::open("alice", config).unwrap(); let alice2 = Context::open("alice", config, MockChatStore::default()).unwrap();
let convos = alice2.storage.load_conversations().unwrap(); let convos = alice2.storage.load_conversations().unwrap();
assert_eq!(convos.len(), 1, "conversation metadata should persist"); assert_eq!(convos.len(), 1, "conversation metadata should persist");
} }
@ -349,8 +463,8 @@ mod tests {
let config = StorageConfig::File(db_path); let config = StorageConfig::File(db_path);
// Alice and Bob establish a conversation // Alice and Bob establish a conversation
let mut alice = Context::open("alice", config.clone()).unwrap(); let mut alice = Context::open("alice", config.clone(), MockChatStore::default()).unwrap();
let mut bob = Context::new_with_name("bob"); let mut bob = Context::new_with_name("bob", MockChatStore::default());
let bundle = alice.create_intro_bundle().unwrap(); let bundle = alice.create_intro_bundle().unwrap();
let intro = Introduction::try_from(bundle.as_slice()).unwrap(); let intro = Introduction::try_from(bundle.as_slice()).unwrap();
@ -371,7 +485,7 @@ mod tests {
// Drop Alice and reopen - conversation should survive // Drop Alice and reopen - conversation should survive
drop(alice); drop(alice);
let mut alice2 = Context::open("alice", config).unwrap(); let mut alice2 = Context::open("alice", config, MockChatStore::default()).unwrap();
// Verify conversation was restored // Verify conversation was restored
let convo_ids = alice2.list_conversations().unwrap(); let convo_ids = alice2.list_conversations().unwrap();

View File

@ -2,6 +2,7 @@ use std::fmt;
use crate::crypto::{PrivateKey, PublicKey}; use crate::crypto::{PrivateKey, PublicKey};
#[derive(Clone)]
pub struct Identity { pub struct Identity {
name: String, name: String,
secret: PrivateKey, secret: PrivateKey,

View File

@ -7,6 +7,7 @@ mod identity;
mod inbox; mod inbox;
mod proto; mod proto;
mod storage; mod storage;
mod store;
mod types; mod types;
mod utils; mod utils;

View File

@ -0,0 +1,75 @@
use crypto::PrivateKey;
use storage::StorageError;
use crate::identity::Identity;
/// Persistence operations for installation identity data.
pub trait IdentityStore {
/// Loads the stored identity if one exists.
fn load_identity(&self) -> Result<Option<Identity>, StorageError>;
/// Persists the installation identity.
fn save_identity(&mut self, identity: &Identity) -> Result<(), StorageError>;
}
pub trait EphemeralKeyStore {
fn save_ephemeral_key(
&mut self,
public_key_hex: &str,
private_key: &PrivateKey,
) -> Result<(), StorageError>;
fn load_ephemeral_key(&self, public_key_hex: &str) -> Result<Option<PrivateKey>, StorageError>;
fn remove_ephemeral_key(&mut self, public_key_hex: &str) -> Result<(), StorageError>;
}
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum ConversationKind {
PrivateV1,
Unknown(String),
}
impl ConversationKind {
pub fn as_str(&self) -> &str {
match self {
Self::PrivateV1 => "private_v1",
Self::Unknown(value) => value.as_str(),
}
}
}
impl From<&str> for ConversationKind {
fn from(value: &str) -> Self {
match value {
"private_v1" => Self::PrivateV1,
other => Self::Unknown(other.to_string()),
}
}
}
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct ConversationMeta {
pub local_convo_id: String,
pub remote_convo_id: String,
pub kind: ConversationKind,
}
pub trait ConversationStore {
fn save_conversation(&mut self, meta: &ConversationMeta) -> Result<(), StorageError>;
fn load_conversation(
&self,
local_convo_id: &str,
) -> Result<Option<ConversationMeta>, StorageError>;
fn remove_conversation(&mut self, local_convo_id: &str) -> Result<(), StorageError>;
fn load_conversations(&self) -> Result<Vec<ConversationMeta>, StorageError>;
fn has_conversation(&self, local_convo_id: &str) -> Result<bool, StorageError>;
}
pub trait ChatStore: IdentityStore + EphemeralKeyStore + ConversationStore {}
impl<T> ChatStore for T where T: IdentityStore + EphemeralKeyStore + ConversationStore {}