/ 
PAGI-Server-0.002010

Changes for version 0.002010 - 2026-08-28

  • Bug fixes
  • h2: a receive() called after the request has been fully delivered now parks until the stream ends and resolves with http.disconnect -- matching h1 -- instead of synthesizing the terminal http.request event again on every call (which busy-looped the spec's own wait-for-disconnect receive pattern and left RST_STREAM invisible to a receive-based app). Same one-shot discipline the SSE closure already had. Pinned by t/http2/40-pending-io-at-disconnect.t.
  • Specification conformance (PAGI 0.002006: core spec 0.5 / Www 0.4)
  • Scopes report pagi.version '0.5' and, for http/websocket/sse, spec_version '0.4' -- the feature-detection gate for the new settlement contract, which this server already implemented. The lifespan scope keeps spec_version '0.3' (its sub-spec did not bump).
  • New end-to-end conformance tests pin the settlement contract over real sockets on every protocol: a send parked on backpressure at abrupt disconnect resolves (never fails, never hangs), the resumed coroutine observes the completed state transition, on_disconnect is never invoked inside the application's send call frame, a pending receive resolves with the protocol's disconnect event, and h2 RST_STREAM settles per-stream I/O without cancelling the application Future (t/61-pending-io-at-disconnect.t, t/http2/40-pending-io-at-disconnect.t).
  • Maintenance
  • t/http2/36 builds its 20KB payload once, outside its send loop: a repeat-op inside a foreach that also awaits yields undef on later iterations under Future::AsyncAwait on ITHREADS perls (upstream bug, minimal reproducer reported; threads is the trigger -- DEBUGGING is not required -- so vendor threaded perls are affected too).

Documentation

README.md
SECURITY.md
pagi-server
PAGI application server
PAGI::Server::Compliance
HTTP/1.1, HTTP/2, WebSocket, SSE, and Security Compliance Documentation

Modules

PAGI::Server
PAGI Reference Server Implementation
PAGI::Server::AppNormalizer
Normalizes PAGI 0.4 application providers to a coderef
PAGI::Server::AsyncFile
Non-blocking file I/O for PAGI::Server internals
PAGI::Server::Connection
Per-connection state machine
PAGI::Server::ConnectionState
Connection state tracking for HTTP requests
PAGI::Server::EventValidator
Mandatory outgoing-event validation
PAGI::Server::Protocol::HTTP1
HTTP/1.1 protocol handler
PAGI::Server::Protocol::HTTP2
HTTP/2 protocol handler using nghttp2
PAGI::Server::Runner
PAGI application loader and server runner
PAGI::Server::TransportState
Outbound flow-control introspection for a connection

Provides

PAGI::Server::Protocol::HTTP2::Session
in lib/PAGI/Server/Protocol/HTTP2.pm

Examples

Other files