pjson-rs 0.6.0

Priority JSON Streaming Protocol - high-performance priority-based JSON streaming (requires nightly Rust)
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

//! Commands - Write operations that change system state

use crate::application::dto::{PriorityDto, SessionIdDto, StreamIdDto};
use crate::domain::{aggregates::stream_session::SessionConfig, entities::stream::StreamConfig};
use serde::{Deserialize, Serialize};
use serde_json::Value as JsonValue;

/// Create new streaming session
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CreateSessionCommand {
    /// Session configuration (limits, priority thresholds, transport options).
    pub config: SessionConfig,
    /// Optional human-readable client identifier.
    pub client_info: Option<String>,
    /// Optional `User-Agent` header captured from the originating request.
    pub user_agent: Option<String>,
    /// Optional source IP address captured from the originating request.
    pub ip_address: Option<String>,
}

/// Create new stream within a session
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CreateStreamCommand {
    /// Identifier of the parent session.
    pub session_id: SessionIdDto,
    /// JSON payload that will be decomposed into priority frames.
    pub source_data: JsonValue,
    /// Optional per-stream configuration overriding session defaults.
    pub config: Option<StreamConfig>,
}

/// Start streaming data for a specific stream
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct StartStreamCommand {
    /// Identifier of the parent session.
    pub session_id: SessionIdDto,
    /// Identifier of the stream to start.
    pub stream_id: StreamIdDto,
}

/// Generate frames for a stream with priority filtering
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct GenerateFramesCommand {
    /// Identifier of the parent session.
    pub session_id: SessionIdDto,
    /// Identifier of the stream to generate frames for.
    pub stream_id: StreamIdDto,
    /// Minimum priority frames must satisfy to be emitted.
    pub priority_threshold: PriorityDto,
    /// Maximum number of frames to emit in this batch.
    pub max_frames: usize,
}

/// Complete a stream successfully
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CompleteStreamCommand {
    /// Identifier of the parent session.
    pub session_id: SessionIdDto,
    /// Identifier of the stream being completed.
    pub stream_id: StreamIdDto,
    /// Optional payload checksum used to verify integrity.
    pub checksum: Option<String>,
}

/// Close session gracefully
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CloseSessionCommand {
    /// Identifier of the session to close.
    pub session_id: SessionIdDto,
}

/// Batch generate frames across multiple streams with priority
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct BatchGenerateFramesCommand {
    /// Identifier of the parent session.
    pub session_id: SessionIdDto,
    /// Minimum priority frames must satisfy to be emitted.
    pub priority_threshold: PriorityDto,
    /// Maximum total number of frames to emit across all streams.
    pub max_frames: usize,
}