Eloquent cast

AsSteamId is an Eloquent custom cast that keeps a Steam ID in a plain column but exposes it as a SteamId. Every read and write goes through SteamId::fromSteamId64, so an invalid ID never round-trips silently.

1. Add the cast to a model’s casts() method:

   use Fkrzski\LaravelSteamApiSdk\Casts\AsSteamId;
   use Illuminate\Database\Eloquent\Model;
   
   class User extends Model
   {
       protected function casts(): array
       {
           return [
               'steam_id' => AsSteamId::class,
           ];
       }
   }

2. Store the column as a string:

   use Illuminate\Database\Schema\Blueprint;
   
   Schema::table('users', function (Blueprint $table): void {
       $table->string('steam_id')->nullable();
   });

Assign a SteamId, a string, an int or any Stringable — each is validated and persisted as the canonical 64-bit string. Reads always give back a SteamId:

use Fkrzski\SteamApiSdk\ValueObjects\SteamId;

$user->steam_id = SteamId::fromSteamId64('76561198000000000');
$user->steam_id = '76561198000000000';
$user->steam_id = 76561198000000000; // a JSON body sends the ID as an int
$user->steam_id = $request->string('steam_id');
$user->save();

$user->steam_id;        // SteamId value object
$user->steam_id->value; // '76561198000000000'

An invalid value — stored or assigned — throws InvalidSteamIdException. So does a stored non-scalar, and an assigned value that is neither scalar nor Stringable: one catchable domain exception, never a TypeError from inside the model. null is preserved in both directions, so a nullable column stays nullable.

toArray(), toJson() and API Resources emit the plain 64-bit string — not the value object, not a nested {"value": ...} shape:

$user->toArray();  // ['steam_id' => '76561198000000000', ...]
$user->toJson();   // {"steam_id":"76561198000000000", ...}

null stays null, and serialization validates like a write — an invalid stored value throws rather than reaching the response.