Skip to main content

qualia_app_contract/
error.rs

1//! Error types for portable application contracts.
2
3use thiserror::Error;
4
5/// Error type for application contract validation and serialization.
6#[derive(Debug, Error, PartialEq, Eq, Clone)]
7pub enum ContractError {
8    #[error("command ID cannot be empty")]
9    EmptyCommandId,
10
11    #[error("invalid command ID format '{0}': must follow '<app-id>::<upstream-id>' with valid ASCII identifiers")]
12    InvalidCommandIdFormat(String),
13
14    #[error("app ID cannot be empty")]
15    EmptyAppId,
16
17    #[error("JS-unsafe numeric conversion: integer {0} exceeds JavaScript MAX_SAFE_INTEGER (9007199254740991); must use decimal string representation")]
18    JsUnsafeNumericConversion(u64),
19
20    #[error("invalid decimal u64 string '{0}'")]
21    InvalidDecimalU64(String),
22
23    #[error("non-finite coordinate detected: {0}")]
24    NonFiniteCoordinate(String),
25
26    #[error("malformed schema or parameters: {0}")]
27    MalformedParams(String),
28
29    #[error("duplicate command alias '{0}'")]
30    DuplicateAlias(String),
31
32    #[error("invalid identifier: {0}")]
33    InvalidIdentifier(String),
34
35    #[error("interactive gestures unsupported: {0}")]
36    GesturesUnsupported(String),
37
38    #[error("unsupported target kind '{0}' for command '{1}'")]
39    UnsupportedTarget(String, String),
40
41    #[error("oversized payload: size {size} bytes exceeds limit {limit} bytes")]
42    OversizedPayload { size: usize, limit: usize },
43
44    #[error("unknown schema or contract version: {0}")]
45    UnknownVersion(u32),
46
47    #[error("unknown effect name: '{0}'")]
48    UnknownEffect(String),
49
50    #[error("duplicate command ID registered: '{0}'")]
51    DuplicateCommandId(String),
52
53    #[error("serialization or deserialization error: {0}")]
54    Serialization(String),
55}