lighty-core 26.5.6

Core utilities for Lighty Launcher
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
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132

use thiserror::Error;

/// Errors related to operating system and architecture detection
#[derive(Debug, Error)]
pub enum SystemError {
    #[error("Unsupported operating system")]
    UnsupportedOS,

    #[error("Unsupported architecture")]
    UnsupportedArchitecture,

    #[error("IO error: {0}")]
    Io(#[from] std::io::Error),
}

/// Errors related to file extraction (ZIP and tar.gz)
#[derive(Debug, Error)]
pub enum ExtractError {
    #[error("Invalid ZIP entry at index {index}")]
    ZipEntryNotFound { index: usize },

    #[error("Path has no parent directory")]
    InvalidPath,

    #[error("Absolute paths not allowed: {path}")]
    AbsolutePath { path: String },

    #[error("Path traversal detected: {path} escapes base directory")]
    PathTraversal { path: String },

    #[error("File too large: {size} bytes (max: {max})")]
    FileTooLarge { size: u64, max: u64 },

    #[error("ZIP error: {0}")]
    Zip(#[from] async_zip::error::ZipError),

    #[error("TAR error: {0}")]
    Tar(#[from] std::io::Error),
}

/// Errors related to HTTP downloads
#[derive(Debug, Error)]
pub enum DownloadError {
    #[error("HTTP request failed: {0}")]
    Http(#[from] reqwest::Error),

    #[error("IO error: {0}")]
    Io(#[from] std::io::Error),
}

/// Type alias for System operations results
pub type SystemResult<T> = Result<T, SystemError>;

/// Type alias for extraction operations results
pub type ExtractResult<T> = Result<T, ExtractError>;

/// Errors related to application state initialization
#[derive(Debug, Error)]
pub enum AppStateError {
    #[error("AppState::init() has already been called")]
    AlreadyInitialized,

    #[error("AppState::init() has not been called yet — call it once at startup")]
    NotInitialized,

    #[error("Platform doesn't expose a standard {0} directory")]
    MissingPlatformDir(&'static str),
}

/// Type alias for download operations results
pub type DownloadResult<T> = Result<T, DownloadError>;

/// Type alias for app state operations results
pub type AppStateResult<T> = Result<T, AppStateError>;

/// Errors returned by every loader / mods query operation.
#[derive(Error, Debug)]
pub enum QueryError {
    #[error("Network error: {0}")]
    Network(#[from] reqwest::Error),

    #[error("JSON parsing error: {0}")]
    JsonParsing(#[from] serde_json::Error),

    #[error("IO error: {0}")]
    Io(#[from] std::io::Error),

    #[error("Version '{version}' not found in manifest")]
    VersionNotFound { version: String },

    #[error("Missing field '{field}' in manifest data")]
    MissingField { field: String },

    #[error("Assets fetch error: failed to fetch assets from URL '{url}'")]
    AssetsFetch { url: String },

    #[error("Conversion error: {message}")]
    Conversion { message: String },

    #[error("Archive corrupted ({context}): {reason}")]
    ArchiveCorrupted { context: String, reason: String },

    #[error("Unsupported {what}: expected {expected}, found {found}")]
    UnsupportedFormat {
        what: String,
        expected: String,
        found: String,
    },

    #[error("Unsupported loader: {0}")]
    UnsupportedLoader(String),

    #[error("Invalid metadata format")]
    InvalidMetadata,

    #[error("Mod not found on {provider}: {id}")]
    ModNotFound { provider: &'static str, id: String },

    #[error("Mod {id} on {provider} has no version compatible with Minecraft {mc} + loader {loader}")]
    ModIncompatible {
        provider: &'static str,
        id: String,
        mc: String,
        loader: String,
    },

    #[error("Mod {id} on CurseForge disallows third-party distribution; download manually from the project page")]
    ModDistributionForbidden { id: String },
}

/// Type alias for query operations results.
pub type QueryResult<T> = Result<T, QueryError>;