<?php

declare(strict_types=1);

namespace Lvl0\FediDiscover\Clients;

use Illuminate\Support\Collection;
use Lvl0\FediDiscover\Models\Instance;
use Lvl0\FediDiscover\ValueObjects\FediversePost;

interface FediverseClientInterface
{
    /**
     * Fetch posts newer than the given cursor.
     *
     * MUST return posts in newest-first order. Callers treat the
     * first item as the new high-water mark.
     *
     * @return Collection<int, FediversePost>
     */
    public function fetchPostsSince(Instance $instance, ?string $lastSeenId): Collection;
}