khive-pack-template 0.5.0

Reference template for new khive packs (ADR-023 §8). Copy this crate to get a working pack scaffold.
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

//! Verb handlers for the template pack.

use serde_json::{json, Value};

use khive_runtime::{KhiveRuntime, NamespaceToken, RuntimeError};

/// `template.my_verb` — example verb demonstrating parameter validation.
///
/// Accepts `{ "name": "<string>" }` and returns `{ "ok": true, "name": "<string>" }`.
/// Returns an error when `name` is absent or not a non-empty string.
/// See `crates/khive-pack-template/docs/api/pack-scaffold.md`.
pub(crate) async fn handle_my_verb(
    _runtime: &KhiveRuntime,
    _token: &NamespaceToken,
    params: Value,
) -> Result<Value, RuntimeError> {
    let name = params
        .get("name")
        .and_then(Value::as_str)
        .filter(|s| !s.is_empty())
        .ok_or_else(|| {
            RuntimeError::InvalidInput(
                "template.my_verb requires a non-empty string field \"name\"".to_string(),
            )
        })?;

    Ok(json!({ "ok": true, "name": name }))
}