oino-extension 1.0.0

Guest SDK for Oino WASM component extensions (oino:extension@2.0.0)
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

//! Scoped key-value state (`global`, `workspace`, `session`).

use serde::Serialize;
use serde::de::DeserializeOwned;

use crate::Result;
use crate::bindings::oino::extension::kv as wk;
pub use crate::bindings::oino::extension::kv::Scope;

/// Raw bytes.
#[must_use]
pub fn get(scope: Scope, key: &str) -> Option<Vec<u8>> {
    wk::get(scope, key)
}
/// Stores bytes.
pub fn set(scope: Scope, key: &str, value: &[u8]) -> Result<()> {
    Ok(wk::set(scope, key, value)?)
}
/// Deletes a key.
pub fn delete(scope: Scope, key: &str) {
    wk::delete(scope, key);
}
/// Keys with `prefix`.
#[must_use]
pub fn keys(scope: Scope, prefix: &str) -> Vec<String> {
    wk::keys(scope, prefix)
}
/// Typed JSON read.
pub fn get_json<T: DeserializeOwned>(scope: Scope, key: &str) -> Result<Option<T>> {
    get(scope, key)
        .map(|b| serde_json::from_slice(&b).map_err(Into::into))
        .transpose()
}
/// Typed JSON write.
pub fn set_json(scope: Scope, key: &str, value: &impl Serialize) -> Result<()> {
    set(scope, key, &serde_json::to_vec(value)?)
}