ldc-com-app-bo/app/Models/User.php

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;
use Illuminate\Support\Facades\Hash;
use App\Enums\UserRolesEnum;

/**
 * @property integer                  $firstname         User first name.
 * @property string                   $lastname          User last name.
 * @property string                   $email             User email.
 * @property string                   $email_verified_at Email verified date.
 * @property string                   $password          User password.
 * @property string                   $remember_token    User token remember.
 * @property \App\Enums\UserRolesEnum $role              User role.
 * @property-read \Carbon\Carbon      $created_at        Created date.
 * @property-read \Carbon\Carbon      $updated_at        Updated date.
 */
class User extends Authenticatable
{
    use HasFactory;
    use Notifiable;

    /**
     * The attributes that are mass assignable.
     *
     * @var list<string>
     */
    protected $fillable = [
        'firstname',
        'lastname',
        'email',
        'email_verified_at',
        'password',
        'role'
    ];

    /**
     * The attributes that should be hidden for serialization.
     *
     * @var list<string>
     */
    protected $hidden = [
        'password',
        'remember_token',
    ];

    /**
     * The attributes that should be cast.
     *
     * @var array<string, string>
     */
    protected $casts = [
        'email_verified_at' => 'datetime',
        'role'              => UserRolesEnum::class
    ];

    /**
     * Perform any actions required after the model boots.
     *
     * @return void
     */
    protected static function booted(): void
    {
        // * EVENT CLOSURES.
        static::creating(function (self $model) {
            self::updatePassword($model);
        });
        static::updating(function (self $model) {
            self::updatePassword($model);
        });
    }

    // * METHODS

    /**
     * Update password.
     *
     * @param self $model
     * @return void
     */
    private static function updatePassword(self $model): void
    {
        if (Hash::needsRehash($model->password)) {
            $model->password = Hash::make($model->password);
        }
    }

    // * RELATIONSHIPS

    /**
     * MorphToMany directories relation.
     *
     * @return \Illuminate\Database\Eloquent\Relations\MorphToMany
     */
    public function directories(): \Illuminate\Database\Eloquent\Relations\MorphToMany
    {
        return $this->morphToMany(Directory::class, 'directorables');
    }
}