Struct CloudClient 

pub struct CloudClient { /* private fields */ }

Cloud API client for sync operations.

Implementations

impl CloudClient

pub fn new() -> Self

Creates a new cloud client with the default URL.

pub fn with_url(base_url: &str) -> Self

Creates a new cloud client with a custom URL.

pub fn with_api_key(self, api_key: &str) -> Self

Sets the API key for authentication.

pub fn base_url(&self) -> &str

Returns the configured base URL.

pub fn status(&self) -> Result<SyncStatus, CloudError>

Gets the sync status from the cloud service.

Returns information about the user’s sync state including session count, storage usage, and last sync time.

pub fn push( &self, sessions: Vec<PushSession>, ) -> Result<PushResponse, CloudError>

Pushes sessions to the cloud service.

Uploads encrypted session data to the cloud. Session metadata is stored unencrypted for display purposes, while message content is encrypted.

pub fn pull( &self, since: Option<DateTime<Utc>>, ) -> Result<PullResponse, CloudError>

Pulls sessions from the cloud service.

Downloads sessions that have been modified since the given timestamp. Session message content is encrypted and must be decrypted by the caller.

pub fn get_salt(&self) -> Result<Option<String>, CloudError>

Gets the encryption salt from the cloud service.

Returns the base64-encoded salt if set, or None if not yet configured. Returns Ok(None) for 404 responses (salt not set), Err for other failures.

pub fn set_salt(&self, salt: &str) -> Result<(), CloudError>

Sets the encryption salt on the cloud service.

This should only be called once during initial setup. The server will reject attempts to overwrite an existing salt.

Trait Implementations

impl Default for CloudClient

fn default() -> Self

Returns the “default value” for a type.