breadcrumb-the-shire/core/Repository/Auth/EmailVerificationRepositoryInterface.php

<?php

namespace MintyPHP\Repository\Auth;

/** Contract for email verification code lifecycle: creation, lookup, attempt tracking, and completion. */
interface EmailVerificationRepositoryInterface
{
    public function create(int $userId, string $codeHash, string $expiresAt): ?int;

    public function invalidateForUser(int $userId): bool;

    public function findActiveByUserId(int $userId): ?array;

    public function findById(int $id): ?array;

    public function incrementAttempts(int $id): bool;

    public function markUsed(int $id): bool;
}