noosphere 0.16.1

A high-level package for dealing with accessing the Noosphere
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

use anyhow::Result;
use cid::Cid;

use crate::{platform::PlatformSphereChannel, wasm::SphereFs};
use noosphere_core::context::SphereCursor;
use wasm_bindgen::prelude::*;

#[wasm_bindgen]
/// A `SphereContext` is a view into all of a sphere's data, that also
/// encapsulates handles to local storage and a user's authority relative to the
/// sphere. If a user is appropriately authorized, they may use a
/// `SphereContext` to modify a sphere. Otherwise, they may only read a sphere's
/// publicly visible content.
pub struct SphereContext {
    #[wasm_bindgen(skip)]
    pub inner: PlatformSphereChannel,
}

#[wasm_bindgen]
impl SphereContext {
    #[wasm_bindgen]
    /// Get a `SphereFs` that gives you access to sphere content at the latest
    /// version of the sphere.
    pub async fn fs(&mut self) -> Result<SphereFs, String> {
        Ok(SphereFs {
            inner: SphereCursor::latest(self.inner.mutable().clone()),
        })
    }

    #[wasm_bindgen(js_name = "fsAt")]
    /// Get a `SphereFs` that gives you access to sphere content at the version
    /// specified. The version must be a base32
    /// [CID](https://docs.ipfs.tech/concepts/content-addressing/#identifier-formats)
    /// string.
    pub async fn fs_at(&mut self, version: String) -> Result<SphereFs, String> {
        let cid = Cid::try_from(version).map_err(|error| format!("{:?}", error))?;

        Ok(SphereFs {
            inner: SphereCursor::mounted_at(self.inner.mutable().clone(), &cid.into()),
        })
    }
}