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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
/// Subscription lifecycle states.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum SubscriptionState {
/// Initial state before any SUBSCRIBE message is sent.
Idle,
/// SUBSCRIBE has been sent; awaiting OK or ERROR.
Subscribing,
/// Subscription is accepted and data may be flowing.
Active,
/// Subscription has ended (error, unsubscribe, or subscribe done).
Done,
}
/// Errors that can occur during subscription state transitions.
#[derive(Debug, thiserror::Error, PartialEq, Eq)]
pub enum SubscriptionError {
/// An event was received that is not valid for the current state.
#[error("invalid transition from {from:?} on event {event}")]
InvalidTransition {
/// The state the machine was in when the invalid event arrived.
from: SubscriptionState,
/// The name of the event that was rejected.
event: String,
},
}
/// Pure state machine for a MoQT subscription (draft-12).
/// Transitions: Idle → Subscribing → Active → Done.
pub struct SubscriptionStateMachine {
state: SubscriptionState,
}
impl Default for SubscriptionStateMachine {
fn default() -> Self {
Self::new()
}
}
impl SubscriptionStateMachine {
/// Creates a new state machine in the [`SubscriptionState::Idle`] state.
pub fn new() -> Self {
Self { state: SubscriptionState::Idle }
}
/// Returns the current state of the subscription.
pub fn state(&self) -> SubscriptionState {
self.state
}
/// Idle → Subscribing (SUBSCRIBE sent).
pub fn on_subscribe_sent(&mut self) -> Result<(), SubscriptionError> {
if self.state == SubscriptionState::Idle {
self.state = SubscriptionState::Subscribing;
Ok(())
} else {
Err(SubscriptionError::InvalidTransition {
from: self.state,
event: "on_subscribe_sent".to_string(),
})
}
}
/// Subscribing → Active (SUBSCRIBE_OK received).
pub fn on_subscribe_ok(&mut self) -> Result<(), SubscriptionError> {
if self.state == SubscriptionState::Subscribing {
self.state = SubscriptionState::Active;
Ok(())
} else {
Err(SubscriptionError::InvalidTransition {
from: self.state,
event: "on_subscribe_ok".to_string(),
})
}
}
/// Subscribing → Done (SUBSCRIBE_ERROR received).
pub fn on_subscribe_error(&mut self) -> Result<(), SubscriptionError> {
if self.state == SubscriptionState::Subscribing {
self.state = SubscriptionState::Done;
Ok(())
} else {
Err(SubscriptionError::InvalidTransition {
from: self.state,
event: "on_subscribe_error".to_string(),
})
}
}
/// Active → Done (UNSUBSCRIBE sent).
pub fn on_unsubscribe(&mut self) -> Result<(), SubscriptionError> {
if self.state == SubscriptionState::Active {
self.state = SubscriptionState::Done;
Ok(())
} else {
Err(SubscriptionError::InvalidTransition {
from: self.state,
event: "on_unsubscribe".to_string(),
})
}
}
/// Active → Active (SUBSCRIBE_UPDATE sent/received — self-transition).
pub fn on_subscribe_update(&mut self) -> Result<(), SubscriptionError> {
if self.state == SubscriptionState::Active {
Ok(())
} else {
Err(SubscriptionError::InvalidTransition {
from: self.state,
event: "on_subscribe_update".to_string(),
})
}
}
/// Active → Done (SUBSCRIBE_DONE received — publisher finished).
pub fn on_subscribe_done(&mut self) -> Result<(), SubscriptionError> {
if self.state == SubscriptionState::Active {
self.state = SubscriptionState::Done;
Ok(())
} else {
Err(SubscriptionError::InvalidTransition {
from: self.state,
event: "on_subscribe_done".to_string(),
})
}
}
}