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
//! `daemon ↔ node`: [`NodeRequest`] and [`NodeEvent`] (§7.3).
//!
//! | Module | Contents |
//! |---|---|
//! | [`request`] | [`NodeRequest`] — the eleven §24.1 verbs a node uses, plus one tail append |
//! | [`event`] | [`NodeEvent`] — the thirteen §24.1 events plus five tail appends |
//! | [`types`] | [`NodeHandshake`], [`OutputPayload`], [`ExtensionKey`], [`ExtensionNamespace`] |
//! | [`config`] | [`NodeConfig`] — the `ASTRS_NODE_CONFIG` blob the daemon hands a node before it can connect at all |
//!
//! This is the busiest leg in the system: every message a node sends or
//! receives crosses it until the route is upgraded to shared memory (§6.3),
//! after which the payloads bypass it entirely and only the control events
//! remain.
//!
//! ```text
//! node daemon
//! ├──────── Register(NodeHandshake) ──────────►│
//! │◄─────── Registered { spec } ───────────────┤
//! ├──────── Subscribe { inputs } ─────────────►│
//! │◄─────── Input { id, metadata, payload } ───┤
//! ├──────── SendMessage { output, payload } ──►│
//! │◄─────── RouteUpgrade { segment } ──────────┤ (§6.3)
//! ├──────── RouteUpgradeAck ──────────────────►│
//! ├──────── OutputDone / CloseOutputs ────────►│
//! │◄─────── Stop { cause } ────────────────────┤
//! ```
//!
//! # Examples
//!
//! ```
//! use astrs_wire::{
//! DataflowId, FrameFlags, FrameLimits, NodeHandshake, NodeId, NodeRequest, WireMessage,
//! };
//!
//! let limits = FrameLimits::uds();
//! let register = NodeRequest::Register(NodeHandshake::new(
//! DataflowId::from_u128(1),
//! NodeId::new("camera")?,
//! 3,
//! ));
//! let bytes = register.to_frame(FrameFlags::EMPTY, &limits)?;
//! let decoded = NodeRequest::from_bytes(&bytes, &limits)?;
//! assert_eq!(decoded.handshake().map(|handshake| handshake.generation), Some(3));
//! # Ok::<(), Box<dyn std::error::Error>>(())
//! ```
pub use ;
pub use NodeEvent;
pub use ;
pub use ;