NAME

Punk::Push::Result - what one delivery attempt reported

SYNOPSIS

for my $r ($c->push_send($user, \%payload)) {
    next if $r->delivered;
    warn $r->endpoint, ' -> ', $r->status // $r->error;
}

METHODS

endpoint

Which subscription this is about.

status

The HTTP status the push service returned, or undef when the request never completed.

error

The transport error, when there was one.

delivered

True for any 2xx. RFC 8030 specifies 201, but some push services answer 200 or 202, and treating only 201 as success reports a working delivery as a failure.

gone

True for 404 and 410 - the push service saying this subscription is permanently gone. Everything else, 5xx included, is a fact about the service rather than about the subscription.

pruned

Whether the stored subscription was deleted as a result.

queued

The job id, when the send was handed to Punk::Queue rather than performed. A queued result has no status yet: nothing has been sent.

AUTHOR

LNATION <email@lnation.org>

LICENSE AND COPYRIGHT

This software is Copyright (c) 2026 by LNATION <email@lnation.org>.

This is free software, licensed under:

The Artistic License 2.0 (GPL Compatible)