clasp-core 4.5.0

Core types and encoding for CLASP protocol
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

//! CLASP Core
//!
//! Core types, encoding, and protocol primitives for CLASP v3.
//! Creative Low-Latency Application Streaming Protocol.
//!
//! # Wire Format v3
//!
//! CLASP v3 uses an efficient binary encoding that is ~54% smaller and ~5x faster
//! than the v2 MessagePack-with-named-keys format. The decoder auto-detects v2
//! format for backward compatibility.
//!
//! This crate provides:
//! - Protocol message types ([`Message`], [`SignalType`])
//! - Binary frame encoding/decoding ([`Frame`], [`codec`])
//! - Address parsing and wildcard matching ([`Address`])
//! - State management primitives ([`ParamState`])
//! - Timing utilities ([`Timestamp`])

#![cfg_attr(not(feature = "std"), no_std)]

#[cfg(feature = "alloc")]
extern crate alloc;

pub mod address;
pub mod codec;
pub mod error;
pub mod frame;
#[cfg(feature = "std")]
pub mod p2p;
#[cfg(feature = "std")]
pub mod security;
pub mod state;
pub mod time;
#[cfg(feature = "std")]
pub mod timeline;
pub mod types;

pub use address::Address;
pub use codec::{decode, encode};
pub use error::{Error, Result};
pub use frame::Frame;
#[cfg(feature = "std")]
pub use p2p::{
    extract_target_session, is_p2p_address, is_p2p_signal_address, signal_address, P2PAnnounce,
    P2PConfig, P2PConnectionState, P2PSignal, RoutingMode, TurnServer, P2P_ANNOUNCE, P2P_NAMESPACE,
    P2P_SIGNAL_PREFIX,
};
#[cfg(feature = "std")]
pub use security::{
    Action, CpskValidator, Scope, SecurityMode, TokenInfo, TokenValidator, ValidationResult,
    ValidatorChain,
};
pub use state::ParamState;
pub use time::Timestamp;
#[cfg(feature = "std")]
pub use timeline::{PlaybackState, TimelinePlayer};
pub use types::*;

/// Protocol version (used in HELLO messages)
pub const PROTOCOL_VERSION: u8 = 1;

/// Magic byte for frame identification
pub const MAGIC_BYTE: u8 = 0x53; // 'S' for Streaming

/// Default WebSocket port
pub const DEFAULT_WS_PORT: u16 = 7330;

/// Default UDP discovery port
pub const DEFAULT_DISCOVERY_PORT: u16 = 7331;

/// WebSocket subprotocol identifier
pub const WS_SUBPROTOCOL: &str = "clasp";

/// mDNS service type
pub const MDNS_SERVICE_TYPE: &str = "_clasp._tcp.local.";