wayfinder-core 0.1.0

Client, cache, search, and rendering for Archives of Nethys Pathfinder 2e / Starfinder 2e data
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

//! The crate's error type.
//!
//! Public APIs return [`Result`]/[`enum@Error`] so downstream code can match on
//! specific failure modes. Binaries (the `wf` CLI, the MCP server) still use
//! `anyhow` and absorb these via `?`; only the library exposes typed errors.

use thiserror::Error;

/// An error from querying, caching, or parsing Archives of Nethys data.
#[derive(Debug, Error)]
pub enum Error {
    /// The HTTP request to Archives of Nethys failed (network, TLS, timeout).
    #[error("HTTP error talking to Archives of Nethys: {0}")]
    Http(#[from] reqwest::Error),

    /// Archives of Nethys returned a non-success HTTP status.
    #[error("Archives of Nethys returned HTTP {status}")]
    HttpStatus {
        /// The HTTP status code returned.
        status: u16,
    },

    /// A response could not be deserialized into the expected shape.
    #[error("failed to parse Archives of Nethys response: {0}")]
    Parse(#[from] serde_json::Error),

    /// A response was valid JSON but missing an expected field.
    #[error("unexpected Archives of Nethys response: {0}")]
    UnexpectedResponse(String),

    /// The local SQLite document cache failed.
    #[error("cache error: {0}")]
    Cache(#[from] rusqlite::Error),
}

/// Convenience alias for results from this crate.
pub type Result<T, E = Error> = std::result::Result<T, E>;