Výnimky

Každá výnimka pre klientov rozširuje abstraktnú Exceptions\EventsException (RuntimeException). errorCode() je stabilný kód, status() HTTP stav, ktorým odpovie API, a getMessage() je už text bezpečný pre klienta — preložený do aktuálneho jazyka (events::messages, en a sk), nikdy neuvádza triedu, kľúč ani tabuľku. Vo vlastných kontroléroch:

use RoundlyConsulting\Events\Exceptions\EventsException;

try {
    $rsvp = Events::for($event)->rsvp($request->user())->by($request->user())->going(tier: $request->input('tier'));
} catch (EventsException $e) {
    return response()->json(['message' => $e->getMessage(), 'code' => $e->errorCode()], $e->status());
}

EventTransitionDeniedException má aj denials() (kódy zamietnutia z lifecycle a k nim no_attendees a rescheduled_through_events), retryAfterSeconds() (0, ak nejde o limit požiadaviek; API pošle Retry-After) a previousDenial(). CheckInRefusedException::reason() je jedna z konštánt WRONG_EVENT, NOT_GOING, EVENT_NOT_ACTIVE a OUTSIDE_WINDOW.

Chyby, ktoré API preberá odinakiaľ

V PHP prejdú bez zmeny.

Chyby konfigurácie

Opraviť ich musí aplikácia: sú v angličtine, uvádzajú kľúč a rozširujú PackageToolkitException z toolkitu. InvalidEventsConfigurationException pokrýva chybné trvanie, časové pásmo, názov tabuľky, čas dňa, šablónu URL či voľbu — outOfRange() pre hodnotu mimo hraníc, tooMany() pre viac ako päť posunov pripomienok a keyTypeMismatch(), keď kľúč modelu nezodpovedá events.key_type, ešte pred akýmkoľvek SQL. InvalidEventLifecycleException pokrýva hodnotu events.lifecycle, ktorá nie je LifecycleDefinition implementujúcou Contracts\EventLifecycle, alebo definíciu, ktorá porušuje kontrakt. Vlastná InvalidConfigurationException z toolkitu pokrýva model, resource, triedu notifikácie či zoznam, ktorý nezodpovedá svojmu kľúču.