fedi-feed-router/app/Contracts/HomepageParserInterface.php

<?php

namespace App\Contracts;

interface HomepageParserInterface
{
    /**
     * Check if this parser can handle the given homepage URL
     */
    public function canParse(string $url): bool;

    /**
     * Extract article URLs from homepage HTML
     * @return array<int, string>
     */
    public function extractArticleUrls(string $html): array;

    /**
     * Get the homepage URL for this source
     */
    public function getHomepageUrl(): string;

    /**
     * Get the source name for this parser
     */
    public function getSourceName(): string;
}