56 lines
2.0 KiB
PHP
56 lines
2.0 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\BpnConnect;
|
|
|
|
use App\BpnConnect\Exception\BpnConnectException;
|
|
use App\BpnConnect\Model\TravelMailingRecipient;
|
|
use App\BpnConnect\Model\TravelMailingResponse;
|
|
use App\Enum\BusLeg;
|
|
|
|
class TravelsClient extends AbstractApiClient
|
|
{
|
|
private const string MAILING_PATH = '/api/v1/travels/mailing';
|
|
|
|
/**
|
|
* An unknown travel code yields an empty list, not an error: bpn-connect cannot tell it
|
|
* apart from a travel without confirmed participants.
|
|
*
|
|
* @param ?BusLeg $busLeg only participants who booked this bus leg, plus their bookings' applicants
|
|
*/
|
|
public function getMailingRecipients(string $travelCode, ?BusLeg $busLeg = null): TravelMailingResponse
|
|
{
|
|
$query = ['travelCode' => $travelCode];
|
|
if (null !== $busLeg) {
|
|
$query['busLeg'] = $busLeg->value;
|
|
}
|
|
|
|
$payload = $this->request(self::MAILING_PATH, $query);
|
|
|
|
// A bpn-connect that predates the filter ignores the parameter and returns everyone, which
|
|
// must not end up on a list meant for bus passengers only.
|
|
$appliedBusLeg = $payload['meta']['bus_leg'] ?? null;
|
|
if ($appliedBusLeg !== $busLeg?->value) {
|
|
$this->logger->error('BpnConnect ignored the travel mailing bus filter', [
|
|
'travel_code' => $travelCode,
|
|
'requested_bus_leg' => $busLeg?->value,
|
|
'applied_bus_leg' => $appliedBusLeg,
|
|
]);
|
|
|
|
throw new BpnConnectException('BpnConnect did not apply the requested bus leg filter.');
|
|
}
|
|
|
|
$recipients = array_map(
|
|
static fn (array $item) => new TravelMailingRecipient(
|
|
email: $item['email'],
|
|
firstName: $item['first_name'] ?? '',
|
|
lastName: $item['last_name'] ?? '',
|
|
),
|
|
$payload['data'] ?? [],
|
|
);
|
|
|
|
return new TravelMailingResponse($payload['meta']['travel_code'] ?? $travelCode, $recipients, $busLeg);
|
|
}
|
|
}
|