aimux-provider-utils 0.1.0

Shared utilities for aimux provider implementations
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

//! URL utilities.

/// Remove a trailing slash from a URL string.
pub fn without_trailing_slash(url: &str) -> String {
    if let Some(stripped) = url.strip_suffix('/') {
        stripped.to_string()
    } else {
        url.to_string()
    }
}

/// Remove a trailing slash from an optional URL string, mirroring the TS
/// `withoutTrailingSlash(url: string | undefined)` signature: `None` in,
/// `None` out.
pub fn without_trailing_slash_opt(url: Option<&str>) -> Option<String> {
    url.map(without_trailing_slash)
}

/// Validate that a base URL is a valid HTTP(S) URL.
///
/// Parses the URL with the `url` crate and requires:
/// - scheme is `http` or `https`
/// - host is present (non-empty)
///
/// Userinfo (username/password) is permitted but not required — some
/// self-hosted endpoints use basic-auth credentials embedded in the URL.
pub fn validate_base_url(url: &str) -> Result<String, aimux_core::AiMuxError> {
    if url.is_empty() {
        return Err(aimux_core::AiMuxError::InvalidArgument(
            "base URL cannot be empty".to_string(),
        ));
    }
    let parsed = url::Url::parse(url)
        .map_err(|e| aimux_core::AiMuxError::InvalidArgument(format!("invalid base URL: {e}")))?;
    if !matches!(parsed.scheme(), "http" | "https") {
        return Err(aimux_core::AiMuxError::InvalidArgument(format!(
            "base URL must be http or https, got: {}",
            parsed.scheme()
        )));
    }
    if parsed.host_str().map(|h| h.is_empty()).unwrap_or(true) {
        return Err(aimux_core::AiMuxError::InvalidArgument(
            "base URL must have a host".to_string(),
        ));
    }
    Ok(without_trailing_slash(url))
}