oxide_core 0.4.0

Rust engine primitives for Oxide (store, snapshot streams, error model, optional persistence).
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

use std::path::Path;

#[cfg(all(target_arch = "wasm32", target_os = "unknown"))]
use base64::Engine as _;

// Target-specific persistence backends.
//
// Why: Oxide supports native/WASI and browser WASM with a single persistence API.
// How: Choose an implementation via `cfg` and keep the higher-level worker/codec
// logic backend-agnostic.
#[cfg(not(all(target_arch = "wasm32", target_os = "unknown")))]
pub(crate) fn try_read_bytes(path: &Path) -> Option<Vec<u8>> {
    std::fs::read(path).ok()
}

#[cfg(not(all(target_arch = "wasm32", target_os = "unknown")))]
pub(crate) fn try_write_bytes_atomic(path: &Path, bytes: &[u8]) {
    let _ = write_bytes_atomic(path, bytes);
}

#[cfg(not(all(target_arch = "wasm32", target_os = "unknown")))]
fn write_bytes_atomic(path: &Path, bytes: &[u8]) -> std::io::Result<()> {
    if let Some(parent) = path.parent() {
        std::fs::create_dir_all(parent)?;
    }

    let tmp_path = path.with_extension("tmp");
    std::fs::write(&tmp_path, bytes)?;
    std::fs::rename(tmp_path, path)?;
    Ok(())
}

#[cfg(all(target_arch = "wasm32", target_os = "unknown"))]
pub(crate) fn try_read_bytes(path: &Path) -> Option<Vec<u8>> {
    let storage = web_sys::window()?.local_storage().ok()??;
    let key = path.to_string_lossy();
    let encoded = storage.get_item(&key).ok()??;
    base64::engine::general_purpose::STANDARD
        .decode(encoded.as_bytes())
        .ok()
}

#[cfg(all(target_arch = "wasm32", target_os = "unknown"))]
pub(crate) fn try_write_bytes_atomic(path: &Path, bytes: &[u8]) {
    let Some(window) = web_sys::window() else {
        return;
    };
    let Ok(Some(storage)) = window.local_storage() else {
        return;
    };

    let key = path.to_string_lossy();
    let encoded = base64::engine::general_purpose::STANDARD.encode(bytes);
    let _ = storage.set_item(&key, &encoded);
}