barbacane-wasm 0.7.0

WASM plugin runtime for Barbacane API gateway
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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101

//! Error types for the WASM runtime.

use thiserror::Error;

/// Errors that can occur in the WASM runtime.
#[derive(Debug, Error)]
pub enum WasmError {
    /// Failed to create the WASM engine.
    #[error("failed to create WASM engine: {0}")]
    EngineCreation(String),

    /// Failed to compile a WASM module.
    #[error("failed to compile WASM module: {0}")]
    Compilation(String),

    /// Failed to instantiate a WASM module.
    #[error("failed to instantiate WASM module: {0}")]
    Instantiation(String),

    /// WASM execution trapped.
    #[error("WASM execution trapped: {0}")]
    Trap(String),

    /// WASM execution timed out.
    #[error("WASM execution timed out after {0}ms")]
    Timeout(u64),

    /// WASM memory limit exceeded.
    #[error("WASM memory limit exceeded: requested {requested} bytes, limit {limit} bytes")]
    MemoryLimitExceeded { requested: usize, limit: usize },

    /// Missing required export.
    #[error("missing required WASM export: {0}")]
    MissingExport(String),

    /// Invalid export signature.
    #[error("invalid export signature for '{name}': expected {expected}, got {actual}")]
    InvalidExportSignature {
        name: String,
        expected: String,
        actual: String,
    },

    /// Undeclared host function import.
    #[error("plugin imports undeclared host function: {0}")]
    UndeclaredImport(String),

    /// Unknown capability.
    #[error("unknown capability: {0}")]
    UnknownCapability(String),

    /// Plugin manifest parsing failed.
    #[error("failed to parse plugin manifest: {0}")]
    ManifestParse(String),

    /// Plugin manifest validation failed.
    #[error("invalid plugin manifest: {0}")]
    ManifestValidation(String),

    /// Config schema parsing failed.
    #[error("failed to parse config schema: {0}")]
    SchemaParse(String),

    /// Config validation failed.
    #[error("config validation failed: {0}")]
    ConfigValidation(String),

    /// Plugin initialization failed.
    #[error("plugin initialization failed: {0}")]
    InitFailed(String),

    /// Invalid return code from plugin.
    #[error("invalid return code from plugin: {0}")]
    InvalidReturnCode(i32),

    /// Failed to serialize/deserialize data.
    #[error("serialization error: {0}")]
    Serialization(String),

    /// I/O error.
    #[error("I/O error: {0}")]
    Io(#[from] std::io::Error),
}

impl From<wasmtime::Error> for WasmError {
    fn from(err: wasmtime::Error) -> Self {
        WasmError::Compilation(err.to_string())
    }
}

impl From<serde_json::Error> for WasmError {
    fn from(err: serde_json::Error) -> Self {
        WasmError::Serialization(err.to_string())
    }
}

impl From<toml::de::Error> for WasmError {
    fn from(err: toml::de::Error) -> Self {
        WasmError::ManifestParse(err.to_string())
    }
}