helix-im 0.1.1

基于 Helix Core 的确定性 MessageV3 IM 业务模块
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
45
46
47
48
49

//! IM 业务域错误

use thiserror::Error;

/// IM 业务域错误。
///
/// ## MIN-2 修复：删除双向 From 套娃
///
/// 原 `ImError::Core(#[from] CoreError)` + `CoreError::ModuleError{ source: Box<dyn Error> }`
/// 形成双向 From 路径（ImError → CoreError → ImError），可产生无限嵌套错误链。
///
/// 修复：删除 `ImError::Core` 及其 `#[from]` 自动实现。
/// 依赖方向应单向：helix-core 不依赖 helix-im，helix-im 的错误不应反持 CoreError。
/// IM 内部错误通过 `CoreError::ModuleError { source: Box<dyn Error> }` 向上传播，
/// 但 IM 自身不持有 CoreError（避免循环持有）。
///
/// 若需要包装外部错误，在 `module.rs` 的 `handle` 方法中显式 map_err 到 CoreError。
#[derive(Debug, Clone, Error)]
pub enum ImError {
    #[error("parse error: {0}")]
    Parse(String),

    #[error("unsupported websocket action: {0}")]
    UnsupportedWsAction(String),

    #[error("duplicate websocket action handler: {0}")]
    DuplicateWsAction(String),

    #[error("invalid websocket handler registration: registered {registered}, handler {handler}")]
    InvalidWsHandlerRegistration { registered: String, handler: String },

    #[error("incomplete websocket handler registry: expected {expected}, got {actual}")]
    IncompleteWsHandlerRegistry { expected: usize, actual: usize },

    #[error("invalid websocket frame: {0}")]
    InvalidWsFrame(String),

    #[error("invalid seq: expected {expected}, got {got}")]
    InvalidSeq { expected: u64, got: u64 },

    #[error("unknown channel: {0}")]
    UnknownChannel(u64),

    #[error("unknown correlation: {0}")]
    UnknownCorrelation(u64),

    #[error("serialize error: {0}")]
    Serialize(String),
}