surmux 0.2.0

极简 SurrealDB WebSocket 客户端 — 单连接 JSON-RPC 多路复用, 极简依赖
Documentation
//! 结构化错误类型.
//!
//! 覆盖连接、认证、查询、序列化等所有错误场景.

use thiserror::Error;

/// SurrealDB 客户端统一错误类型.
#[derive(Error, Debug)]
pub enum SurrealError {
    /// 连接失败 (WebSocket 握手失败, 服务器不可达等).
    #[error("连接失败: {0}")]
    ConnectionFailed(String),

    /// 连接已断开 (断线时未完成的请求返回此错误).
    #[error("连接已断开")]
    ConnectionLost,

    /// 认证失败 (signin / authenticate 返回错误).
    #[error("认证失败: {0}")]
    AuthFailed(String),

    /// SurrealDB 查询执行失败.
    ///
    /// 包含服务端返回的错误信息 (code + message).
    #[error("查询失败 [{code}]: {message}")]
    QueryFailed { code: i64, message: String },

    /// 查询未返回期望的结果 (如 one() 期望单行但返回空).
    #[error("查询无结果")]
    NoResult,

    /// JSON 序列化/反序列化失败.
    #[error("序列化失败: {0}")]
    SerializationFailed(#[from] serde_json::Error),

    /// 超时 (连接超时, 查询超时等).
    #[error("操作超时: {0}")]
    Timeout(String),

    /// 重连失败 (已达最大重试次数).
    #[error("重连失败: {0}")]
    ReconnectFailed(String),

    /// 请求通道已关闭 (客户端已 drop, 无法发送新请求).
    #[error("客户端已关闭")]
    ClientClosed,

    /// 配置错误.
    #[error("配置错误: {0}")]
    Config(String),

    /// CBOR 解码失败 (typed path 反序列化出错).
    #[error("CBOR 解码失败: {0}")]
    CborDecodeFailed(String),
}

/// Result 类型别名.
pub type SurrealResult<T> = Result<T, SurrealError>;