cc-lb-runtime-wasmtime 0.1.3

Wasmtime-based plugin runtime for cc-lb. Host-side wasm plugin admission + dispatch.
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

//! Runtime-owned identity keys for loaded plugin slots.

use serde::{Deserialize, Serialize};

/// Sentinel principal id used for proxy-wide global plugin slots.
///
/// Kept as a runtime-local copy that must stay byte-identical to
/// `cc_lb_domain::GLOBAL_PRINCIPAL`, so this published crate does not take a
/// normal dependency on the unpublished `cc-lb-domain` crate.
pub const GLOBAL_PRINCIPAL: &str = "__global__";

/// Composite key identifying a loaded plugin slot per principal × plugin name.
#[derive(Clone, Debug, Eq, Hash, PartialEq, Serialize, Deserialize)]
pub struct RuntimeSlotKey {
    /// Principal id this slot is bound to, or [`GLOBAL_PRINCIPAL`] for
    /// proxy-wide globals.
    pub principal: String,
    /// Stable plugin name.
    pub plugin: String,
}

impl RuntimeSlotKey {
    /// Build a per-principal runtime slot key.
    pub fn new(principal: impl Into<String>, plugin: impl Into<String>) -> Self {
        Self {
            principal: principal.into(),
            plugin: plugin.into(),
        }
    }

    /// Build a proxy-wide global runtime slot key.
    pub fn global(plugin: impl Into<String>) -> Self {
        Self::new(GLOBAL_PRINCIPAL, plugin)
    }
}