sark-h2 0.25.0

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
98
99
100
101
102
103

use core::marker;

use sark_core::life::session;
use sark_http::{field::metadata::section::rules, payload::compress::dynamic::hash};

use crate::conn::{
    self, config, event,
    ingress::{self, Config, Fields},
    machine::{Connection, ops::state},
    outputs,
    registry::Registry,
};

impl<F, C, E> Connection<crate::ServerRole, F, C, rules::RejectPush, E>
where
    F: rules::Policy,
    C: session::Storage,
    E: event::Evidence,
{
    pub(crate) fn from_runtime_seed(
        config: config::Validated<crate::ServerRole>,
        seed: hash::Seed,
    ) -> Result<Self, conn::Build> {
        let mut connection = Self::from_seed(config, seed)?;
        connection.state.lifecycle.queue_events();
        Ok(connection)
    }

    pub(crate) fn cancel_ingress(
        &mut self,
        key: crate::stream::Key,
        error: crate::frame::numbers::ErrorCode,
    ) -> Option<event::Retirement> {
        self.ingress.events.cancel(key);
        self.state
            .active_streams
            .store
            .release(key, crate::conn::registry::store::Notice::Cancel);
        self.streams().retire(key, error)
    }

    pub(crate) fn hold_duplex(&mut self, key: crate::stream::Key) {
        self.state.active_streams.store.hold_duplex(key);
    }

    pub(crate) fn release_duplex(&mut self, key: crate::stream::Key) {
        self.state
            .active_streams
            .store
            .release(key, crate::conn::registry::store::Notice::Duplex);
    }
}

impl<R, F, C, A, E> Connection<R, F, C, A, E>
where
    R: crate::Role,
    F: rules::Policy,
    C: session::Storage,
    A: rules::Push,
    E: event::Evidence,
{
    /// Builds from admitted geometry and an owning hash seed without acquiring entropy.
    pub fn from_seed(config: config::Validated<R>, seed: hash::Seed) -> Result<Self, conn::Build> {
        use conn::Build;

        let config::Validated {
            local,
            recv_window_target: recv,
            streams,
            egress,
            hpack,
            buffers,
            marker: _,
        } = config;
        let streams = Registry::try_new(streams).map_err(Build::Streams)?;
        Ok(Self {
            ingress: ingress::Ingress::try_new(Config {
                capacity: buffers.ingress,
                event_capacity: buffers.event_capacity,
                retention: buffers.retention,
                headers: Fields {
                    plan: buffers.header_plan,
                    decoder: hpack.decoder(),
                    cap: buffers.inbound_header_list_cap,
                    connect: local.enable_connect_protocol,
                },
                preface: ingress::PrefacePhase::for_role::<R>(),
            })
            .map_err(Build::Ingress)?,
            egress: outputs::Egress::try_new::<R>(
                egress,
                buffers.ingress.segments(),
                hpack.encoder(),
                buffers.outbound_headers,
                buffers.header_wire,
                seed,
            )
            .map_err(Build::Egress)?,
            state: state::State::new(local, recv, streams),
            push: marker::PhantomData,
        })
    }
}