$events */ public function __construct( public readonly array $events = [], /** A URL to fetch to confirm a subscription, checked by the provider before it is named. */ public readonly ?string $confirmUrl = null, /** What to write in the log when there was nothing to record. */ public readonly string $note = '', /** Whether the body was not this provider's structure at all, as opposed to an event nobody acts on. */ public readonly bool $unreadable = false, ) { } /** @param list $events */ public static function of(array $events): self { return new self(array_values($events)); } /** Nothing to do, and why. */ public static function nothing(string $note = ''): self { return new self([], null, $note); } /** The body was not what this provider sends, and here is what to log. */ public static function unreadable(string $note): self { return new self([], null, $note, true); } /** The provider asking us to confirm we meant to subscribe. */ public static function confirm(string $url): self { return new self([], $url, 'a subscription confirmation'); } public function isEmpty(): bool { return $this->events === []; } }