pubky-homeserver 0.9.2

Pubky core's homeserver.
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

/// The problem we have is that we need to cover 4 cases of webdav paths:
///
/// - `WebdavPath` = Basically a regular absolute filesystem path like `/home/shacollision/test.txt`. This is used in the internal `file_service` as this should not be tied to the `/pub` requirement.
/// - `WebDavPathPub` = A WebdavPath that must start with `/pub/`. This is the current homeserver requirement.
/// - `EntryPath` = A WebdavPath that starts with a public key.
/// - `WebdavPathPubAxum` = A webdav path without the leading `/` because axum delivers the path param without the slash.
///
/// One reason we can't just exclusively use the `Entrypath` and need to use `WebDavPath(Axum)` is because sometimes, the public key comes from the `pubky-host` instead of the url.
///
/// # How to fix it
/// ## `pubky-host`
/// We need to stop using the pubky-host hack. Instead the api should look like this:
/// `https://qtnyghnq9swketdtj9drc7rs5pfnxhs61gq4jwd317ezdegcrbco/dav/qtnyghnq9swketdtj9drc7rs5pfnxhs61gq4jwd317ezdegcrbco/pub/test.txt`
/// The public key is duplicated in this example. This way, even though the domain name changes (in the browser for example or through a redirect), the path is still valid
/// This solves the need for nginx hacks and simplifies the homeserver code.
///
/// It also allows to pick the homeserver where you want the data from.
/// For example, `userA` has his data saved on `homeserverA` and mirrored to `homeserverB`.
/// - `https://{homeserverA}/dav/{userA}/pub/test.txt`
/// - `https://{homeserverB}/dav/{userA}/pub/test.txt`
///
/// pubky-host is a terrible hack. One should not use the domain name as data.
///
/// ## Get rid of `/pub` requirement
/// This needs more research especially in consideration with Cryptrees. I see a future where "permissions" are set on an individual folder level and not forced on top level folders. TBD though.
/// via: https://github.com/pubky/pubky-core/pull/145#discussion_r2149297326
///
mod entry_path;
mod entry_path_pub;
mod webdav_path;
mod webdav_path_pub;
mod webdav_path_pub_axum;

pub use entry_path::EntryPath;
pub use entry_path_pub::EntryPathPub;
pub use webdav_path::WebDavPath;
pub use webdav_path_pub_axum::WebDavPathPubAxum;