87 lines
1.8 KiB
PHP
87 lines
1.8 KiB
PHP
<?php
|
|
|
|
namespace App\Models;
|
|
|
|
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
|
|
|
/**
|
|
* @property string $purpose login/transfer/pin_change/phone_change/kyc/registration
|
|
* @property string $code_hash NEVER plain text — always hash
|
|
* @property string $channel sms/authenticator
|
|
* @property int $attempts
|
|
* @property \Illuminate\Support\Carbon $expires_at
|
|
* @property \Illuminate\Support\Carbon|null $used_at
|
|
*/
|
|
class OtpCode extends BaseModel
|
|
{
|
|
use HasFactory;
|
|
|
|
protected $fillable = [
|
|
'user_id',
|
|
'purpose',
|
|
'code_hash',
|
|
'channel',
|
|
'attempts',
|
|
'expires_at',
|
|
'used_at',
|
|
];
|
|
|
|
protected $casts = [
|
|
'attempts' => 'integer',
|
|
'expires_at' => 'datetime',
|
|
'used_at' => 'datetime',
|
|
];
|
|
|
|
// ── Relationships ──
|
|
|
|
public function user()
|
|
{
|
|
return $this->belongsTo(User::class);
|
|
}
|
|
|
|
// ── Scopes ──
|
|
|
|
public function scopeValid($query)
|
|
{
|
|
return $query->where('expires_at', '>', now())
|
|
->whereNull('used_at');
|
|
}
|
|
|
|
public function scopeForPurpose($query, string $purpose)
|
|
{
|
|
return $query->where('purpose', $purpose);
|
|
}
|
|
|
|
public function scopeForUser($query, int $userId)
|
|
{
|
|
return $query->where('user_id', $userId);
|
|
}
|
|
|
|
// ── Helpers ──
|
|
|
|
public function isExpired(): bool
|
|
{
|
|
return $this->expires_at->isPast();
|
|
}
|
|
|
|
public function isUsed(): bool
|
|
{
|
|
return !is_null($this->used_at);
|
|
}
|
|
|
|
public function hasAttemptsLeft(int $max): bool
|
|
{
|
|
return $this->attempts < $max;
|
|
}
|
|
|
|
public function incrementAttempts(): bool
|
|
{
|
|
return $this->increment('attempts');
|
|
}
|
|
|
|
public function markUsed(): bool
|
|
{
|
|
return $this->update(['used_at' => now()]);
|
|
}
|
|
}
|