Skip to main content

qualia_core_db/q42/app_manifest/
error.rs

1//! Errors for portable application manifest validation and codec.
2
3use std::fmt;
4
5#[derive(Debug, Clone, PartialEq, Eq)]
6pub enum AppManifestError {
7    MissingAppId,
8    MissingVersion,
9    MissingAuthor,
10    MissingStateSchema,
11    EmptyEntries,
12    InvalidMagic,
13    UnsupportedVersion,
14    Truncated,
15    Oversize,
16    InvalidUtf8,
17    UnknownPermission,
18    PermissionEscalation,
19    PathTraversal,
20    AbsolutePath,
21    InvalidProjection,
22    InvalidDigest,
23    MissingIntegrity,
24}
25
26impl fmt::Display for AppManifestError {
27    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
28        match self {
29            Self::MissingAppId => write!(f, "app id is required"),
30            Self::MissingVersion => write!(f, "app version is required"),
31            Self::MissingAuthor => write!(f, "app author is required"),
32            Self::MissingStateSchema => write!(f, "state schema id is required"),
33            Self::EmptyEntries => write!(f, "at least one entry projection is required"),
34            Self::InvalidMagic => write!(f, "invalid portable app manifest magic"),
35            Self::UnsupportedVersion => write!(f, "unsupported portable app manifest version"),
36            Self::Truncated => write!(f, "truncated portable app manifest"),
37            Self::Oversize => write!(f, "portable app manifest exceeds size budget"),
38            Self::InvalidUtf8 => write!(f, "invalid UTF-8 in portable app manifest"),
39            Self::UnknownPermission => write!(f, "unknown permission intent fails closed"),
40            Self::PermissionEscalation => {
41                write!(f, "permission intent exceeds grant ceiling")
42            }
43            Self::PathTraversal => {
44                write!(f, "package-relative path contains traversal or escape")
45            }
46            Self::AbsolutePath => write!(f, "absolute or drive-rooted paths are forbidden"),
47            Self::InvalidProjection => write!(f, "unknown entry projection kind"),
48            Self::InvalidDigest => write!(f, "integrity digest is all-zero or malformed"),
49            Self::MissingIntegrity => write!(f, "package integrity digest is required"),
50        }
51    }
52}
53
54impl std::error::Error for AppManifestError {}