sen-plugin-host 0.8.1

Wasm plugin host runtime for sen-rs CLI framework
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

//! WASI-specific error types
//!
//! Provides detailed error information for WASI configuration and sandbox violations.

use std::path::PathBuf;
use thiserror::Error;

/// Errors that can occur during WASI configuration
#[derive(Debug, Error)]
pub enum WasiError {
    /// Path validation failed
    #[error("Invalid path '{path}': {reason}")]
    InvalidPath { path: PathBuf, reason: String },

    /// Path escapes sandbox boundaries
    #[error("Path '{path}' escapes sandbox (resolved to '{resolved}')")]
    SandboxEscape { path: PathBuf, resolved: PathBuf },

    /// Path does not exist
    #[error("Path does not exist: {0}")]
    PathNotFound(PathBuf),

    /// Path is not a directory (for fs access)
    #[error("Path is not a directory: {0}")]
    NotADirectory(PathBuf),

    /// Environment variable not found
    #[error("Environment variable not found: {0}")]
    EnvNotFound(String),

    /// Environment variable pattern invalid
    #[error("Invalid environment variable pattern: {0}")]
    InvalidEnvPattern(String),

    /// WASI context creation failed
    #[error("Failed to create WASI context: {0}")]
    ContextCreation(String),

    /// Preopened directory configuration failed
    #[error("Failed to preopen directory '{path}': {source}")]
    PreopenFailed {
        path: PathBuf,
        #[source]
        source: std::io::Error,
    },

    /// Symlink resolution failed
    #[error("Failed to resolve symlink '{path}': {source}")]
    SymlinkResolution {
        path: PathBuf,
        #[source]
        source: std::io::Error,
    },

    /// Working directory not set
    #[error("Working directory must be set for relative path resolution")]
    WorkingDirectoryNotSet,

    /// Capability not supported
    #[error("Capability not supported: {0}")]
    UnsupportedCapability(String),
}

impl WasiError {
    /// Create an invalid path error
    pub fn invalid_path(path: impl Into<PathBuf>, reason: impl Into<String>) -> Self {
        Self::InvalidPath {
            path: path.into(),
            reason: reason.into(),
        }
    }

    /// Create a sandbox escape error
    pub fn sandbox_escape(path: impl Into<PathBuf>, resolved: impl Into<PathBuf>) -> Self {
        Self::SandboxEscape {
            path: path.into(),
            resolved: resolved.into(),
        }
    }

    /// Check if this is a security-related error
    pub fn is_security_violation(&self) -> bool {
        matches!(self, Self::SandboxEscape { .. } | Self::InvalidPath { .. })
    }
}