moqtail 0.13.0

Draft 14-compliant Media-over-QUIC (MoQ) protocol library.
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
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

// Copyright 2025 The MOQtail Authors
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

use crate::model::error::ParseError;

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
#[repr(u64)]
pub enum SetupParameterType {
  Path = 0x01,
  MaxRequestId = 0x02,
  AuthorizationToken = 0x03,
  MaxAuthTokenCacheSize = 0x04,
  Authority = 0x05, // MQOtail does not use this (WebTransport)
  MoqtImplementation = 0x07,
}

impl TryFrom<u64> for SetupParameterType {
  type Error = ParseError;

  fn try_from(value: u64) -> Result<Self, Self::Error> {
    match value {
      0x01 => Ok(SetupParameterType::Path),
      0x02 => Ok(SetupParameterType::MaxRequestId),
      0x03 => Ok(SetupParameterType::AuthorizationToken),
      0x04 => Ok(SetupParameterType::MaxAuthTokenCacheSize),
      0x05 => Ok(SetupParameterType::Authority),
      0x07 => Ok(SetupParameterType::MoqtImplementation),
      _ => Err(ParseError::InvalidType {
        context: "SetupParameterType::try_from(u64)",
        details: format!("Invalid type, got {value}"),
      }),
    }
  }
}

impl From<SetupParameterType> for u64 {
  fn from(value: SetupParameterType) -> Self {
    value as u64
  }
}

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
#[repr(u64)]
pub enum MessageParameterType {
  DeliveryTimeout = 0x02,
  AuthorizationToken = 0x03,
  Expires = 0x08,
  LargestObject = 0x09,
  Forward = 0x10,
  SubscriberPriority = 0x20,
  SubscriptionFilter = 0x21,
  GroupOrder = 0x22,
  NewGroupRequest = 0x32,
}

impl TryFrom<u64> for MessageParameterType {
  type Error = ParseError;

  fn try_from(value: u64) -> Result<Self, Self::Error> {
    match value {
      0x02 => Ok(MessageParameterType::DeliveryTimeout),
      0x03 => Ok(MessageParameterType::AuthorizationToken),
      0x08 => Ok(MessageParameterType::Expires),
      0x09 => Ok(MessageParameterType::LargestObject),
      0x10 => Ok(MessageParameterType::Forward),
      0x20 => Ok(MessageParameterType::SubscriberPriority),
      0x21 => Ok(MessageParameterType::SubscriptionFilter),
      0x22 => Ok(MessageParameterType::GroupOrder),
      0x32 => Ok(MessageParameterType::NewGroupRequest),
      _ => Err(ParseError::InvalidType {
        context: "MessageParameterType::try_from(u64)",
        details: format!("Unknown parameter type, got {value}"),
      }),
    }
  }
}

impl From<MessageParameterType> for u64 {
  fn from(value: MessageParameterType) -> Self {
    value as u64
  }
}

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
#[repr(u64)]
pub enum TokenAliasType {
  Delete = 0x0,
  Register = 0x1,
  UseAlias = 0x2,
  UseValue = 0x3,
}
impl TryFrom<u64> for TokenAliasType {
  type Error = ParseError;

  fn try_from(value: u64) -> Result<Self, Self::Error> {
    match value {
      0x0 => Ok(TokenAliasType::Delete),
      0x1 => Ok(TokenAliasType::Register),
      0x2 => Ok(TokenAliasType::UseAlias),
      0x3 => Ok(TokenAliasType::UseValue),
      _ => Err(ParseError::InvalidType {
        context: "TokenAliasType::try_from(u64)",
        details: format!("Invalid type, got {value}"),
      }),
    }
  }
}

impl From<TokenAliasType> for u64 {
  fn from(value: TokenAliasType) -> Self {
    value as u64
  }
}