/ 
PAGI-Server-0.002005

Changes for version 0.002005 - 2026-06-30

  • Features
  • sse.http.response.* decline events (PAGI spec). Before sse.start, an application may decline the stream and return a normal HTTP response (404/401/403/204/redirect/...) by sending sse.http.response.start + sse.http.response.body instead of sse.start. This finally makes an unmatched SSE route return a real HTTP 404 rather than crashing the connection, and gives EventSource the spec's 204 stop-reconnect path. Implemented for both HTTP/1.1 and HTTP/2, reusing the normal HTTP response machinery. First-send-wins: after sse.start a decline raises, and after sse.http.response.start a stream event raises. EventValidator accepts the decline events (status required integer; headers arrayref; more integer).
  • sse.close send-event (PAGI spec). Applications can now end an SSE stream explicitly -- immediately and decoupled from returning -- instead of only by returning. Implemented for both HTTP/1.1 (chunked terminator) and HTTP/2 (final END_STREAM frame). An optional `reason` is server-side metadata only and is never written to the wire. After sse.close a repeat sse.close is a no-op and any other send raises; a transport-gone close (client disconnect) stays a silent no-op. Returning after the final sse.send remains valid and terminates identically. EventValidator accepts sse.close.

Documentation

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

Modules

PAGI::Server
PAGI Reference Server Implementation
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
Dev-mode event field 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