oxide-mirror 0.3.0

Local, event-sourced data mirror for Rust Oxide. Pulls deltas from API sources, resolves conflicts with pluggable strategies, persists everything to SQLite, and exposes a SQL query interface for agent cross-service reasoning.
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

//! Error type for `oxide-mirror`.

use thiserror::Error;

/// All errors produced by the mirror.
#[derive(Debug, Error)]
pub enum MirrorError {
    /// Underlying SQLite / sqlx error.
    #[error("sqlite error: {0}")]
    Sql(#[from] sqlx::Error),

    /// JSON (de)serialization failed.
    #[error("json error: {0}")]
    Json(#[from] serde_json::Error),

    /// The `query` API rejected the supplied SQL because it is not a
    /// read-only `SELECT` / `WITH` / `PRAGMA` statement.
    #[error("read-only query rejected: {0}")]
    QueryNotReadOnly(String),

    /// A source returned a delta for a resource that has not been
    /// pre-registered with the store.
    #[error("unknown resource `{resource}` (register it via `MirrorStore::register_resource`)")]
    UnknownResource {
        /// Resource name that was not registered.
        resource: String,
    },

    /// A source was requested by id but is not registered with the
    /// [`Syncer`](crate::sync::Syncer).
    #[error("unknown source `{0}`")]
    UnknownSource(String),

    /// Wrapped `oxide-k` kernel error (bus / registry).
    #[error("kernel error: {0}")]
    Kernel(#[from] oxide_k::KernelError),

    /// Anything else.
    #[error(transparent)]
    Other(#[from] anyhow::Error),
}

/// Convenience alias.
pub type Result<T> = std::result::Result<T, MirrorError>;