syncweb-core 0.1.1-alpha.3

delay-tolerant web surfing
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
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

use serde::{Deserialize, Serialize};

/// Content lifecycle stage.
///
/// The default is [`Published`](Self::Published) so that collections that
/// do not opt into editorial flows behave identically to the pre-editorial
/// behaviour.
#[derive(Copy, Clone, Debug, Default, Eq, PartialEq, Hash, Serialize, Deserialize)]
#[non_exhaustive]
pub enum EditorialState {
    /// Local-only, not yet shared.
    Draft,
    /// Shared for review, not yet approved.
    Proposed,
    /// Actively being reviewed.
    InReview,
    /// Reviewers have requested changes.
    ChangesRequested,
    /// Reviewers have approved.
    Approved,
    /// Publicly available — pinned and announced.
    /// This is the default state (backward-compatible).
    #[default]
    Published,
    /// Deprecated but kept for reference.
    Archived,
    /// Published then pulled (tombstone entry remains).
    Retracted,
}

impl EditorialState {
    /// Whether the content is considered finalised and visible to general
    /// consumers.
    #[must_use]
    pub const fn is_published(self) -> bool {
        matches!(self, Self::Published)
    }

    /// Whether the content is available for public consumption (published or
    /// archived).
    #[must_use]
    pub const fn is_public(self) -> bool {
        matches!(self, Self::Published | Self::Archived)
    }

    /// Whether the state is part of the pre-publication review pipeline.
    #[must_use]
    pub const fn is_pre_publication(self) -> bool {
        matches!(
            self,
            Self::Draft | Self::Proposed | Self::InReview | Self::ChangesRequested | Self::Approved
        )
    }

    /// Whether the content has been withdrawn (retracted).
    #[must_use]
    pub const fn is_withdrawn(self) -> bool {
        matches!(self, Self::Retracted)
    }

    /// Check whether a transition from `self` to `target` is a valid editorial
    /// workflow step.
    ///
    /// Content that enters the editorial pipeline at `Draft` must go through
    /// review (`Proposed → InReview → Approved`) before being published.
    /// Retracted content must complete the full review cycle again before
    /// re-publishing — `Draft → Published` is not permitted.
    #[must_use]
    pub const fn can_transition_to(self, target: Self) -> bool {
        use EditorialState as S;
        matches!(
            (self, target),
            (S::Draft | S::Approved, S::Proposed)
                | (S::Proposed, S::InReview | S::Draft)
                | (S::InReview, S::ChangesRequested | S::Approved)
                | (S::ChangesRequested, S::Proposed | S::Draft)
                | (S::Approved | S::Archived, S::Published)
                | (S::Published, S::Archived | S::Retracted)
                | (S::Retracted, S::Draft)
        )
    }
}