<?php

declare(strict_types=1);

namespace App\Framework\Http;

use App\Framework\Filesystem\ValueObjects\FilePath;

/**
 * Interface for detecting MIME types from file paths
 *
 * Returns MimeTypeInterface which can be either:
 * - MimeType enum for known types
 * - CustomMimeType for unknown types
 */
interface MimeTypeDetector
{
    /**
     * Detect MIME type from file path
     *
     * @return MimeTypeInterface The detected MIME type
     */
    public function detect(FilePath $filePath): MimeTypeInterface;
}
