Function resolve_identity

atomic-cli/src/commands/client.rs:462–521

Resolve a flexible identity reference to a UUID. Accepts: - A UUID string (passed through directly) - An email address (contains `@` — resolved via server) - An identity name (resolved via server) # Errors Returns [`CliError::Internal`] with an actionable message when the identifier cannot be resolved (e.g. no matching identity on the server).

(client: &StorageClient, identifier: &str)

/// Returns [`CliError::Internal`] with an actionable message when the
/// identifier cannot be resolved (e.g. no matching identity on the server).
pub async fn resolve_identity(client: &StorageClient, identifier: &str) -> CliResult<uuid::Uuid> {
    // 1. Try parsing as UUID first — zero network calls.
    if let Ok(id) = uuid::Uuid::parse_str(identifier) {
        return Ok(id);
    }

    // 2. If it contains @, treat as email.
    if identifier.contains('@') {
        let info = client
            .resolve_identity_by_email(identifier)
            .await
            .map_err(|e| {
                if e.is_not_found() {
                    CliError::Internal(anyhow::anyhow!(
                        "No identity found with email '{}'.\n  \
                         The user must register first: atomic identity register <server-url>",
                        identifier
                    ))
                } else {
                    CliError::RemoteError {
                        message: e.to_string(),
                        url: None,
                    }
                }
            })?;
        log::debug!(
            "Resolved email '{}' → {} ({})",
            identifier,
            info.id,
            info.name
        );
        return Ok(info.id);
    }

    // 3. Otherwise, treat as identity name.
    let info = client
        .resolve_identity_by_name(identifier)
        .await
        .map_err(|e| {
            if e.is_not_found() {
                CliError::Internal(anyhow::anyhow!(
                    "No identity found with name '{}'.\n  \
                     The user must register first: atomic identity register <server-url>",
                    identifier
                ))
            } else {
                CliError::RemoteError {
                    message: e.to_string(),
                    url: None,
                }
            }
        })?;
    log::debug!(
        "Resolved name '{}' → {} ({})",
        identifier,
        info.id,
        info.name
    );