Fat Enums: ModelHasStateMachine trait for Eloquent

ModelHasStateMachine.php

<?php

namespace App\Models;

use App\Enums\OrderStatus;
use ArtisanBuild\FatEnums\Concerns\ModelHasStateMachine;
use Illuminate\Database\Eloquent\Model;

class Order extends Model
{
    use ModelHasStateMachine;

    protected $casts = [
        'status' => OrderStatus::class,
    ];

    // Define which columns are state machines
    protected array $state_machines = ['status'];
}

// Now transitions are validated automatically on save:

$order = Order::find(1);
$order->status = OrderStatus::Delivered; // Was: Pending
$order->save();

// InvalidStateTransition thrown BEFORE the database is touched
// "Cannot transition from Pending to Delivered..."

// Valid transitions just work:
$order->status = OrderStatus::Processing;
$order->save(); // Works!