miden-client-web 0.15.0

Web Client library that facilitates interaction with the Miden network
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

use js_export_macro::js_export;
#[cfg(feature = "browser")]
use wasm_bindgen::prelude::*;

use crate::platform::{JsErr, from_str_err};
use crate::{WebClient, js_error_with_context};

// Browser-specific settings methods that need serde_wasm_bindgen for JsValue serialization
#[cfg(feature = "browser")]
#[wasm_bindgen]
impl WebClient {
    /// Retrieves the setting value for `key`, or `None` if it hasn't been set.
    #[wasm_bindgen(js_name = "getSetting")]
    pub async fn get_setting(&self, key: String) -> Result<Option<JsValue>, JsValue> {
        let mut guard = self.get_mut_inner().await;
        let client = guard.as_mut().ok_or_else(|| JsValue::from_str("Client not initialized"))?;
        let result: Option<Vec<u8>> = client.get_setting(key).await.map_err(|err| {
            js_error_with_context(err, "failed to get setting value from the store")
        })?;
        let deserialized_result = result
            .map(|bytes| {
                serde_wasm_bindgen::to_value(&bytes).map_err(|err| {
                    js_error_with_context(err, "failed to deserialize setting value into a JsValue")
                })
            })
            .transpose()?;
        Ok(deserialized_result)
    }

    /// Sets a setting key-value in the store. It can then be retrieved using `get_setting`.
    #[wasm_bindgen(js_name = "setSetting")]
    pub async fn set_setting(&self, key: String, value: JsValue) -> Result<(), JsValue> {
        let value_bytes: Vec<u8> = serde_wasm_bindgen::from_value(value).map_err(|err| {
            js_error_with_context(err, "failed to serialize given value into bytes")
        })?;
        let mut guard = self.get_mut_inner().await;
        let client = guard.as_mut().ok_or_else(|| JsValue::from_str("Client not initialized"))?;
        client.set_setting(key, value_bytes).await.map_err(|err| {
            js_error_with_context(err, "failed to set setting value in the store")
        })?;
        Ok(())
    }
}

// Node.js-specific settings methods that use Vec<u8> directly
#[cfg(feature = "nodejs")]
#[napi_derive::napi]
impl WebClient {
    /// Retrieves the setting value for `key`, or `None` if it hasn't been set.
    #[napi(js_name = "getSetting")]
    pub async fn get_setting(&self, key: String) -> Result<Option<Vec<u8>>, JsErr> {
        let mut guard = self.get_mut_inner().await;
        let client = guard.as_mut().ok_or_else(|| from_str_err("Client not initialized"))?;
        client
            .get_setting(key)
            .await
            .map_err(|err| js_error_with_context(err, "failed to get setting value from the store"))
    }

    /// Sets a setting key-value in the store.
    #[napi(js_name = "setSetting")]
    pub async fn set_setting(&self, key: String, value: Vec<u8>) -> Result<(), JsErr> {
        let mut guard = self.get_mut_inner().await;
        let client = guard.as_mut().ok_or_else(|| from_str_err("Client not initialized"))?;
        client.set_setting(key, value).await.map_err(|err| {
            js_error_with_context(err, "failed to set setting value in the store")
        })?;
        Ok(())
    }
}

// Shared settings methods (identical logic for both platforms)
#[js_export]
impl WebClient {
    /// Deletes a setting key-value from the store.
    #[js_export(js_name = "removeSetting")]
    pub async fn remove_setting(&self, key: String) -> Result<(), JsErr> {
        let mut guard = self.get_mut_inner().await;
        let client = guard.as_mut().ok_or_else(|| from_str_err("Client not initialized"))?;
        client.remove_setting(key).await.map_err(|err| {
            js_error_with_context(err, "failed to delete setting value in the store")
        })?;
        Ok(())
    }

    /// Returns all the existing setting keys from the store.
    #[js_export(js_name = "listSettingKeys")]
    pub async fn list_setting_keys(&self) -> Result<Vec<String>, JsErr> {
        let mut guard = self.get_mut_inner().await;
        let client = guard.as_mut().ok_or_else(|| from_str_err("Client not initialized"))?;
        client
            .list_setting_keys()
            .await
            .map_err(|err| js_error_with_context(err, "failed to list setting keys in the store"))
    }
}