sark-h2 0.28.5

Fiber-free HTTP/2 protocol primitives and manifold server for sark
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

use std::num::NonZero;

use o3::buffer::{pool, segments::queue, storage};
use sark_core::life::session;
use sark_http::{
    self,
    field::metadata::{
        block,
        section::{rules, state::Selected},
    },
    payload::compress::dynamic::{mode, plan},
};

use crate::{
    Endpoint,
    conn::{build, event},
    hpack::decode::mode::Store,
};

type Decode = Store<(), ()>;

pub(crate) mod events;
pub(crate) mod header;
pub(crate) mod headers;
pub(crate) mod input;
pub(super) mod payloads;

#[repr(u8)]
#[derive(Clone, Copy, PartialEq, Eq)]
pub(crate) enum PrefacePhase {
    Magic,
    InitialSettings,
    Established,
}

pub(super) struct Fields {
    pub(super) plan: pool::Layout,
    pub(super) decoder: plan::Plan<mode::Staged>,
    pub(super) cap: usize,
    pub(super) connect: block::Connect,
}

pub(super) struct Config {
    pub(super) capacity: queue::Capacity,
    pub(super) event_capacity: NonZero<u32>,
    pub(super) retention: payloads::Plan,
    pub(super) headers: Fields,
    pub(super) preface: PrefacePhase,
}

pub(super) struct Ingress<
    P: rules::Policy,
    C: session::Storage = storage::Shared,
    E: event::Evidence = event::Retirement,
> {
    pub(super) input: input::FrameInput<C>,
    pub(super) events: events::Events<Selected<P>, P::Block, C, E>,
    pub(super) headers: headers::Blocks<P>,
    /// The decoder stopped at a resumable capacity boundary. Event ownership
    /// may be drained independently before the next decoder turn.
    pub(super) decoder_blocked: bool,
}

impl<P: rules::Policy, C: session::Storage, E: event::Evidence> Ingress<P, C, E> {
    pub(super) fn try_new(config: Config) -> Result<Self, build::Ingress> {
        use crate::conn::{
            build::Ingress,
            event::Event,
            ingress::{events::Events, headers::Blocks, input::FrameInput},
        };
        let Config {
            capacity,
            event_capacity: events,
            retention: retain,
            headers,
            preface,
        } = config;
        let first = (preface == PrefacePhase::InitialSettings).then_some(Event::PrefaceComplete);
        Ok(Self {
            input: FrameInput::try_new(capacity, retain, preface).map_err(Ingress::Input)?,
            events: Events::try_new(events, first).map_err(Ingress::Events)?,
            headers: Blocks::try_new(headers.plan, headers.decoder, headers.cap, headers.connect)?,
            decoder_blocked: false,
        })
    }
}

impl PrefacePhase {
    pub(super) fn for_role<R: crate::Role>() -> Self {
        match R::ENDPOINT {
            Endpoint::Client => Self::InitialSettings,
            Endpoint::Server => Self::Magic,
        }
    }
}

const _: () = assert!(core::mem::size_of::<PrefacePhase>() == core::mem::size_of::<bool>());