olai-uc-storage-proxy 0.0.2

Same-origin Unity Catalog storage byte-proxy based on governed Volumes.
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

//! The `storageAccess` capability helper.
//!
//! Kept as a tiny, pure module so both the server's capabilities endpoint and any
//! other consumer agree on the announced posture string without duplicating the
//! `"direct"` / `"proxy"` literals.

use crate::backend::ProxyCapabilities;

/// Posture announced when the proxy surface is not mounted: the browser reads/writes
/// storage directly (today's behavior).
pub const STORAGE_ACCESS_DIRECT: &str = "direct";

/// Posture announced when the proxy surface is mounted: the browser routes storage
/// bytes through the same-origin proxy.
pub const STORAGE_ACCESS_PROXY: &str = "proxy";

/// The `storageAccess` string for a set of capabilities.
pub fn storage_access(caps: ProxyCapabilities) -> &'static str {
    if caps.enabled {
        STORAGE_ACCESS_PROXY
    } else {
        STORAGE_ACCESS_DIRECT
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn posture_reflects_enabled() {
        assert_eq!(
            storage_access(ProxyCapabilities { enabled: false }),
            "direct"
        );
        assert_eq!(storage_access(ProxyCapabilities { enabled: true }), "proxy");
    }
}