Enums & exceptions

Status is the normalized status stored on purchases and subscriptions:

Status::isActive() is true only for Completed and InGracePeriod — the states that keep an entitlement. It drives Subscription::isActive() and the active() scope.

ResultType

Select options & validation

Both enums use the Helpers trait from enums-for-laravel, so admin filters and forms need no bespoke arrays or language files:

use RoundlyConsulting\Purchases\Enum\Status;

Status::options();          // list of {value, label, name} option DTOs for select inputs
Status::toOptions();        // ['completed' => 'Completed', 'in_grace' => 'In Grace', …]
Status::labels();           // human strings incl. "In Grace" / "On Hold" (no lang files)
Status::validationRule();   // "in:new,pending,processing,completed,failed,canceled,in_grace,on_hold,refunded"

$status = Status::tryFromLabel('On Hold');   // Status::OnHold
$status?->isActive();                        // false — an account hold keeps no access

Exceptions

All extend RoundlyConsulting\Purchases\Exceptions\Exception, which adds a because(string $message, int $code = 0) named constructor:

use RoundlyConsulting\Purchases\Exceptions\UnknownProviderException;
use RoundlyConsulting\Purchases\Exceptions\VerificationException;
use RoundlyConsulting\Purchases\Facades\Purchases;

try {
    $result = Purchases::result('stripe', $request);
} catch (VerificationException $e) {
    abort(400, $e->getMessage());
} catch (UnknownProviderException) {
    abort(404);
}

Config typos caught by the package toolkit are the exception: an unparseable on/off switch (push authentication aside), a key_type outside bigint, uuid and ulid, and a models.* class that isn’t the packaged model or a subclass of it throw RoundlyConsulting\PackageToolkit\Exceptions\InvalidConfigurationException, which doesn’t extend the package’s base exception. Like the package’s own InvalidConfigurationException, it names the key.