NAME

Apertur::SDK::Resource::Polling - Long polling for new images

DESCRIPTION

Polls an upload session for new images, downloads them, and acknowledges receipt to advance the queue.

METHODS

list($uuid)

Returns the current poll result for a session (hashref with images).

download($uuid, $image_id)

Downloads an image as raw bytes.

ack($uuid, $image_id)

Acknowledges receipt of an image, removing it from the poll queue.

poll_and_process($uuid, $handler, %options)

Blocking polling loop. Calls $handler->($image, $data) for each new image. Options:

interval - seconds between polls (default 3)
timeout - total seconds before stopping (default 0 = no timeout)