<?php

namespace Alsendo\AlsendoWrapper\Api\Points;

use Alsendo\AlsendoWrapper\Api\Points\Model\Point;

interface PickupPointServiceInterface
{
    /**
     * Search pickup points near an address.
     *
     * @param string      $address  Address or city to search near
     * @param string|null $carrier  Filter by carrier (e.g. 'PPL', 'INPOST', 'sameday')
     * @param int         $limit    Max number of results
     * @return Point[]
     */
    public function search(string $address, ?string $carrier = null, int $limit = 20): array;
}
