File Coverage

blib/lib/PAGI/Endpoint/SSE.pm

Criterion	Covered	Total	%
statement	39	40	97.5
branch	6	8	75.0
condition	1	2	50.0
subroutine	11	11	100.0
pod	3	5	60.0
total	60	66	90.9

package PAGI::Endpoint::SSE;
$PAGI::Endpoint::SSE::VERSION = '0.002001';
use strict;
use warnings;

use Future::AsyncAwait;
use Carp qw(croak);

# Factory class method - override in subclass for customization
sub context_class { 'PAGI::Context' }

# Keepalive interval in seconds (0 = disabled)
sub keepalive_interval { 0 }

sub new {
    my ($class, %args) = @_;
    return bless \%args, $class;
}

async sub handle {
    my ($self, $ctx) = @_;
    my $sse = $ctx->sse;

    # Configure keepalive if specified. keepalive() is async (it sends an
    # sse.keepalive event); await it so the send completes rather than being a
    # fire-and-forget Future (PAGI applications must await all $send calls).
    my $keepalive = $self->keepalive_interval;
    if ($keepalive > 0) {
        await $sse->keepalive($keepalive);
    }

    # Register disconnect callback
    if ($self->can('on_disconnect')) {
        $sse->on_close(sub {
            $self->on_disconnect($ctx);
        });
    }

    # Call on_connect if defined
    if ($self->can('on_connect')) {
        await $self->on_connect($ctx);
    } else {
        # Default: just start the stream
        await $sse->start;
    }

    # Wait for disconnect
    await $sse->run;
}

sub to_app {
    my ($class) = @_;
    my $context_class = $class->context_class;

    return async sub {
        my ($scope, $receive, $send) = @_;

        my $type = $scope->{type} // '';
        croak "Expected sse scope, got '$type'" unless $type eq 'sse';

        require PAGI::Context;
        my $endpoint = $class->new;
        my $ctx = $context_class->new($scope, $receive, $send);

        await $endpoint->handle($ctx);
    };
}

1;

__END__