<?php
declare(strict_types=1);

namespace App\Modules\Shipments;

interface ShipmentTrackingInterface
{
    public function supports(string $provider): bool;

    /**
     * @param array<string, mixed> $package Row from shipment_packages table
     * @return array{status: string, status_raw: string, description: string}|null Null on error/unavailable
     */
    public function getDeliveryStatus(array $package): ?array;
}
