facet_msgpack/
error.rs

1//! Error types for MsgPack Tier-2 JIT parsing.
2
3use core::fmt;
4
5/// MsgPack parsing error.
6#[derive(Debug, Clone)]
7pub struct MsgPackError {
8    /// Error code from JIT
9    pub code: i32,
10    /// Position in input where error occurred
11    pub pos: usize,
12    /// Human-readable message
13    pub message: String,
14}
15
16impl fmt::Display for MsgPackError {
17    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
18        write!(f, "{} at position {}", self.message, self.pos)
19    }
20}
21
22impl std::error::Error for MsgPackError {}
23
24/// MsgPack JIT error codes.
25pub mod codes {
26    /// Unexpected end of input
27    pub const UNEXPECTED_EOF: i32 = -100;
28    /// Invalid type tag for expected bool
29    pub const EXPECTED_BOOL: i32 = -101;
30    /// Invalid type tag for expected array
31    pub const EXPECTED_ARRAY: i32 = -102;
32    /// Invalid type tag for expected bin/bytes
33    pub const EXPECTED_BIN: i32 = -103;
34    /// Invalid type tag for expected integer
35    pub const EXPECTED_INT: i32 = -104;
36    /// Integer value doesn't fit in target type
37    pub const INT_OVERFLOW: i32 = -105;
38    /// Array/bin count doesn't fit in usize
39    pub const COUNT_OVERFLOW: i32 = -106;
40    /// Sequence underflow (decrement when remaining is 0)
41    pub const SEQ_UNDERFLOW: i32 = -107;
42    /// Unsupported operation (triggers fallback)
43    pub const UNSUPPORTED: i32 = -1;
44}
45
46impl MsgPackError {
47    /// Create an error from a JIT error code and position.
48    pub fn from_code(code: i32, pos: usize) -> Self {
49        let message = match code {
50            codes::UNEXPECTED_EOF => "unexpected end of input".to_string(),
51            codes::EXPECTED_BOOL => "expected bool (0xC2 or 0xC3)".to_string(),
52            codes::EXPECTED_ARRAY => "expected array tag (fixarray/array16/array32)".to_string(),
53            codes::EXPECTED_BIN => "expected bin tag (bin8/bin16/bin32)".to_string(),
54            codes::EXPECTED_INT => "expected integer tag".to_string(),
55            codes::INT_OVERFLOW => "integer value overflows target type".to_string(),
56            codes::COUNT_OVERFLOW => "count too large for platform".to_string(),
57            codes::SEQ_UNDERFLOW => "sequence underflow (internal error)".to_string(),
58            codes::UNSUPPORTED => "unsupported operation".to_string(),
59            _ => format!("unknown error code {}", code),
60        };
61        Self { code, pos, message }
62    }
63}
facet_msgpack/error.rs

facet_msgpack/
error.rs
