khive-runtime 0.11.0

Composable Service API: entity/note CRUD, graph traversal, hybrid search, curation.
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

//! Shared UUID-or-prefix resolution for pack handlers.

use uuid::Uuid;

use crate::error::{RuntimeError, RuntimeResult};
use crate::runtime::{KhiveRuntime, NamespaceToken};

impl KhiveRuntime {
    /// Parse a full UUID or resolve a compact hexadecimal prefix in the caller's
    /// primary namespace, using the same lookup policy as [`Self::resolve_prefix`].
    ///
    /// A parseable full UUID is returned without a lookup or an existence,
    /// liveness or authorization check. Otherwise input must contain at least
    /// eight ASCII hexadecimal characters with no separators or whitespace.
    /// Missing prefixes and invalid shapes return distinct `InvalidInput` errors;
    /// lookup storage and ambiguity errors propagate unchanged.
    pub async fn resolve_uuid_or_prefix(
        &self,
        token: &NamespaceToken,
        s: &str,
    ) -> RuntimeResult<Uuid> {
        if let Ok(uuid) = s.parse::<Uuid>() {
            return Ok(uuid);
        }
        if s.len() >= 8 && s.chars().all(|c| c.is_ascii_hexdigit()) {
            return match self.resolve_prefix(token, s).await? {
                Some(uuid) => Ok(uuid),
                None => Err(RuntimeError::InvalidInput(format!(
                    "no record matches prefix: {s:?}"
                ))),
            };
        }
        Err(RuntimeError::InvalidInput(format!(
            "invalid UUID (expected full UUID or 8+ hex prefix): {s:?}"
        )))
    }
}