triblespace-core 0.41.1

The triblespace core implementation.
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
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

use crate::inline::Encodes;
use anybytes::Bytes;

use crate::blob::Blob;
use crate::blob::BlobEncoding;
use crate::id::ExclusiveId;
use crate::id::Id;
use crate::id_hex;
use crate::macros::entity;
use crate::metadata;
use crate::metadata::MetaDescribe;
use crate::trible::Fragment;

/// A blob encoding for WebAssembly bytecode.
///
/// This schema is intended for sandboxed helper modules such as value formatters
/// (see `metadata::value_formatter`).
pub struct WasmCode;

impl BlobEncoding for WasmCode {}

impl MetaDescribe for WasmCode {
    fn describe() -> Fragment {
        let id: Id = id_hex!("DEE50FAD0CFFA4F8FD542DD18D9B7E52");
        entity! {
            ExclusiveId::force_ref(&id) @
                metadata::name: "wasmcode",
                metadata::description: "WebAssembly bytecode blob for sandboxed helper modules. The modules are expected to be deterministic and import-free, intended for small utilities such as value formatters.\n\nUse when a schema references a formatter via metadata::value_formatter or similar tooling and you want portable, sandboxed code alongside the data. Avoid large or stateful modules; keep the bytecode focused on pure formatting or validation tasks.",
                metadata::tag: metadata::KIND_BLOB_ENCODING,
        }
    }
}

impl Encodes<Bytes> for WasmCode
where crate::inline::encodings::hash::Handle<WasmCode>: crate::inline::InlineEncoding,
{
    type Output = Blob<WasmCode>;
    fn encode(source: Bytes) -> Blob<WasmCode> {
        Blob::new(source)
    }
}

impl Encodes<Vec<u8>> for WasmCode
where crate::inline::encodings::hash::Handle<WasmCode>: crate::inline::InlineEncoding,
{
    type Output = Blob<WasmCode>;
    fn encode(source: Vec<u8>) -> Blob<WasmCode> {
        Blob::new(Bytes::from_source(source))
    }
}

impl Encodes<&[u8]> for WasmCode
where crate::inline::encodings::hash::Handle<WasmCode>: crate::inline::InlineEncoding,
{
    type Output = Blob<WasmCode>;
    fn encode(source: &[u8]) -> Blob<WasmCode> {
        Blob::new(Bytes::from_source(source.to_vec()))
    }
}

#[cfg(feature = "wasm")]
/// Runtime support for executing [`WasmCode`] modules.
pub mod runtime;