07 – Extension-Aware Streaming with FullFlush

Demonstrates how to:

• Check for extension support via scope->{extensions}{fullflush}
• Use http.fullflush event during streaming to force immediate TCP buffer flush
• Only send extension events when the server advertises support

The fullflush extension is useful for real-time streaming scenarios where you want each chunk delivered to the client immediately rather than waiting for TCP buffer fill or Nagle's algorithm.

Quick Start

1. Start the server:

pagi-server --app examples/07-extension-fullflush/app.pl --port 5000

2. Demo with curl:

# Watch real-time streaming with immediate flush
curl -N http://localhost:5000/
# => Line 1   (flushed immediately)
# => Line 2   (flushed immediately)
# => Line 3   (flushed immediately)

# Each chunk appears instantly rather than being buffered

Note: The difference from regular streaming is most noticeable with small chunks that would normally be buffered by TCP.

Spec References

Covered by the PAGI specification in the upstream PAGI distribution (PAGI::Spec POD and protocol documents, https://github.com/jjn1056/pagi):

• Extensions section
• Fullflush extension