wyrd-client 0.3.0

Shared Wyrd client: transport, authentication, and composed client capabilities.
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

//! Latest Active Card resolution.

use crate::WyrdClient;
use wyrd_spec::envelope::CardKind;
use wyrd_spec::ids::{CardName, SpaceName};
use wyrd_spec::reference::CardRef;
use wyrd_spec::registry::GetCardResponse;

use super::card_ref_from_card;
use crate::cards::error::RegistryEngineError;

/// Resolve the latest Active version to an exact Card reference.
///
/// # Errors
///
/// Returns the transport error or structured server refusal for the lookup,
/// and the reference errors of [`card_ref_from_card`] when the returned Card
/// lacks a resolved version or space.
///
/// # Cancellation
///
/// The lookup is read-only; cancelling abandons the request.
pub(crate) async fn resolve_latest(
    client: &WyrdClient,
    kind: CardKind,
    space: SpaceName,
    name: CardName,
) -> Result<CardRef, RegistryEngineError> {
    let path = format!(
        "/v1/cards/{}/{}/{}/latest",
        urlencoding::encode(kind.wire_name()),
        urlencoding::encode(space.as_str()),
        urlencoding::encode(name.as_str()),
    );
    let response: GetCardResponse = client
        .http
        .request_json(reqwest::Method::GET, &path, None::<&()>)
        .await?;
    card_ref_from_card(&response.card)
}