breadcrumb-the-shire/core/Repository/Security/RateLimitRepositoryInterface.php

<?php

namespace MintyPHP\Repository\Security;

/** Contract for sliding-window rate limit storage by scope and subject hash. */
interface RateLimitRepositoryInterface
{
    public function findByScopeAndHash(string $scope, string $subjectHash): ?array;

    public function create(
        string $scope,
        string $subjectHash,
        int $hits,
        string $windowStartedAt,
        ?string $blockedUntil
    ): bool;

    public function updateStateById(
        int $id,
        int $hits,
        string $windowStartedAt,
        ?string $blockedUntil
    ): bool;

    public function deleteByScopeAndHash(string $scope, string $subjectHash): bool;
}