crust_core 1.0.3

Core library to download, install and launch Minecraft (versions, assets, libraries, Java runtime, mod loaders)
Documentation
use base64::Engine;
use base64::engine::general_purpose::URL_SAFE_NO_PAD;

#[derive(Debug, thiserror::Error)]
pub enum Error {
    #[error("token does not have three dot-separated segments")]
    Malformed,
    #[error("payload is not valid base64url: {0}")]
    Base64(#[from] base64::DecodeError),
    #[error("payload is not valid JSON: {0}")]
    Json(#[from] serde_json::Error),
}

pub fn decode_claims(token: &str) -> Result<serde_json::Value, Error> {
    let mut segments = token.split('.');
    let (Some(_header), Some(payload), Some(_signature), None) = (
        segments.next(),
        segments.next(),
        segments.next(),
        segments.next(),
    ) else {
        return Err(Error::Malformed);
    };
    let bytes = URL_SAFE_NO_PAD.decode(payload.trim_end_matches('='))?;
    Ok(serde_json::from_slice(&bytes)?)
}

pub fn string_claim(token: &str, claim: &str) -> Option<String> {
    decode_claims(token)
        .ok()?
        .get(claim)?
        .as_str()
        .map(str::to_owned)
}

#[cfg(test)]
mod tests {
    use super::*;

    fn build(payload: &str) -> String {
        format!("h.{}.s", URL_SAFE_NO_PAD.encode(payload))
    }

    #[test]
    fn decodes_payload() {
        let token = build(r#"{"xuid":"2535436228373764","exp":1765466158}"#);
        let claims = decode_claims(&token).unwrap();
        assert_eq!(claims["exp"], 1765466158);
        assert_eq!(
            string_claim(&token, "xuid").as_deref(),
            Some("2535436228373764")
        );
    }

    #[test]
    fn rejects_malformed_token() {
        assert!(matches!(decode_claims("a.b"), Err(Error::Malformed)));
        assert!(matches!(decode_claims("a.b.c.d"), Err(Error::Malformed)));
    }

    #[test]
    fn missing_claim_is_none() {
        let token = build(r#"{"sub":"x"}"#);
        assert_eq!(string_claim(&token, "xuid"), None);
    }
}