Campaign status

Every campaign moves through the CampaignStatus enum. Each transition fires a lifecycle event — but only when the status actually changes, so repeated calls never re-dispatch:

startedAt is set on the first switch to Processing, endedAt on the first terminal status. Completed, Failed and Canceled are terminal and final — a cancelled campaign stays Canceled when its batch finishes. Every transition is a compare-and-set on the stored status, so two processes racing one campaign never both move it.

Enum helpers

CampaignStatus is string-backed — each value equals its case name — and adds isTerminal() on top of the enums-for-laravel Helpers trait:

use RoundlyConsulting\Campaigns\Enums\CampaignStatus;

CampaignStatus::Processing->isTerminal();   // false
CampaignStatus::Canceled->isTerminal();     // true — Completed, Failed and Canceled are terminal

CampaignStatus::values();                   // Collection of 'Created', 'Pending', 'Processing', …
CampaignStatus::toOptions();                // Collection: ['Created' => 'Created', …] for selects
CampaignStatus::validationRule();           // 'in:Created,Pending,Processing,Completed,Failed,Canceled'
CampaignStatus::tryFromName('Pending');     // CampaignStatus::Pending
CampaignStatus::hasValue('Failed');         // true
CampaignStatus::Completed->label();         // 'Completed'

The trait also brings labels(), options(), readable() and the other case lookups such as tryFromName() and hasValue(). validationRule() drops straight into a form request when you filter campaigns by status.