quinzee.cloud

Development edition · 16 November 2026. Commands using repository paths, Make targets or sample projects require access to the Quinzee source checkout. No public installer is available. Examples use disposable local environments.

Contributor’s guide

4. Connection and streaming lifecycle

lib/http/src/connection.hpp defines the connection for plain and TLS streams. Asynchronous operations retain the connection through shared_from_this(). The registry holds weak ownership; final destruction notifies the server.

accept → [TLS handshake] → read headers/body → wait for handler → write response
                                ↑                                      │
                                └────────── keep-alive ────────────────┘
                      error, cancellation or stop → close → destruction

The waiting state is important: worker execution is not a synchronous call inside the read callback. Completions are posted onto the connection's executor, with cancellation/deadline checks before a response is used. During graceful shutdown, active writes/waiting work get the configured shutdown allowance; stragglers are force-closed. Idle/partial reads and handshakes can be closed immediately.

Large request bodies spool to private unlinked files with bounded buffers. Responses can retain an opened immutable Blob generation, so replacement or deletion does not alter an in-flight reader. Block commit copies bounded chunks into a new generation and commits metadata atomically. Ordinary buffered request limits and large transfer limits are distinct.

A parsed exchange is observed once on completion or abandonment. Statistics measure from received headers through reads, worker waiting, execution and writes. Response wire bytes include HTTP framing but not TLS records. Idle connections and incomplete headers are outside this exchange accounting. Observer exceptions must not interrupt transport shutdown or response delivery.

See Blob transfer semantics (source checkout required), connection.hpp (source checkout required) and streaming integration tests (source checkout required).