diff options
| author | tv <tv@krebsco.de> | 2026-11-16 19:38:26 +0000 |
|---|---|---|
| committer | tv <tv@krebsco.de> | 2026-11-16 21:25:23 +0100 |
| commit | 3fccc4f6859cf0b4d93e7d166142e1ab9255723f (patch) | |
| tree | 7a76c8bfe5b186ec063feb8e454de583f0c87ff5 /src/document | |
| parent | 69d2aace79eb61d800afa3a0779cfe3a9dfe1039 (diff) | |
access: what a change of a swarm holding a store writes
Every node judges a change of a swarm holding a store by what it writes, at its history
(`docs/store.md`, What a change writes), in place of rules by path: `access::holding`.
It writes events, each at `_continuum/events/<ID>` the bytes whose SHA-256 that is, no
larger than the fold allows (the federation's 256 KiB), at a key held nowhere at the
change's history; and its node's entry, with the member list's map where there is none.
Everything else is refused, as closed: values outside `_continuum`, the policy, the
swarm's ID, users, bans, the topology, remakes and their acks. Nothing deletes or
replaces an event. A change names its node; the genesis change's writer names none, so
no change under it is taken but the genesis change.
In a swarm not holding a store, a change writing a policy naming one is refused: a swarm
holds a store from its genesis change, or not at all.
The inspector tells a put of bytes apart (`Action::PutBytes`), with the bytes, for the
events' check. All of it behind the `federation` feature.
Diffstat (limited to 'src/document')
| -rw-r--r-- | src/document/events.rs | 10 | ||||
| -rw-r--r-- | src/document/inspect.rs | 5 |
2 files changed, 15 insertions, 0 deletions
diff --git a/src/document/events.rs b/src/document/events.rs index 7b0fe5e..2b3a7e0 100644 --- a/src/document/events.rs +++ b/src/document/events.rs @@ -117,6 +117,16 @@ pub(crate) fn is_genesis(change: &Change, fold: &str, id: &Id) -> bool { root.is_some_and(|root| genesis(fold, &root).hash() == change.hash()) } +/// Puts `bytes` at the event `id`, held there or not, as no change of a node puts an +/// event: for tests of what a change may write. +#[cfg(test)] +pub(crate) fn put_held(doc: &mut super::Transaction<'_>, id: &Id, bytes: &[u8]) { + use automerge::transaction::Transactable; + let events = events_map(doc).expect("the events' map"); + doc.put(&events, id.to_string(), ScalarValue::Bytes(bytes.to_vec())) + .expect("a put"); +} + #[cfg(test)] mod tests { use super::*; diff --git a/src/document/inspect.rs b/src/document/inspect.rs index ffdf536..350b69c 100644 --- a/src/document/inspect.rs +++ b/src/document/inspect.rs @@ -36,6 +36,8 @@ pub(crate) enum Action { MakeMap, /// Puts a string there. PutString(String), + /// Puts bytes there. + PutBytes(Vec<u8>), /// Deletes what is there. Delete, /// Changes what is there, a list or text it is in (`Place::in_list`). @@ -198,6 +200,9 @@ impl<'a> Inspector<'a> { OpType::Put(automerge::ScalarValue::Str(text)) => { Action::PutString(text.to_string()) } + OpType::Put(automerge::ScalarValue::Bytes(bytes)) => { + Action::PutBytes(bytes.clone()) + } OpType::Delete => Action::Delete, _ => Action::Other, }, |
