. */ namespace SP\Domain\Auth\Ports; use Exception; use SP\Domain\Auth\Models\AuthToken as AuthTokenModel; use SP\Domain\Common\Ports\Repository; use SP\Domain\Core\Dtos\ItemSearchDto; use SP\Domain\Core\Exceptions\ConstraintException; use SP\Domain\Core\Exceptions\QueryException; use SP\Infrastructure\Common\Repositories\DuplicatedItemException; use SP\Infrastructure\Database\QueryResult; /** * Class AuthTokenRepository * * @template T of AuthTokenModel */ interface AuthTokenRepository extends Repository { /** * @param int $id * @return QueryResult * @throws ConstraintException * @throws QueryException */ public function delete(int $id): QueryResult; /** * Returns the item for given id * * @param int $authTokenId * * @return QueryResult */ public function getById(int $authTokenId): QueryResult; /** * Returns all the items * * @return QueryResult */ public function getAll(): QueryResult; /** * Deletes all the items for given ids * * @param array $authTokensId * * @return QueryResult * @throws ConstraintException * @throws QueryException */ public function deleteByIdBatch(array $authTokensId): QueryResult; /** * Searches for items by a given filter * * @param ItemSearchDto $itemSearchData * * @return QueryResult * @throws ConstraintException * @throws QueryException * @throws Exception */ public function search(ItemSearchDto $itemSearchData): QueryResult; /** * Creates an item * * @param AuthTokenModel $authToken * * @return QueryResult * @throws ConstraintException * @throws DuplicatedItemException * @throws QueryException */ public function create(AuthTokenModel $authToken): QueryResult; /** * Obtener el token de la API de un usuario * * @param int $userId * @return QueryResult */ public function getTokenByUserId(int $userId): QueryResult; /** * Updates an item * * @param AuthTokenModel $authToken * @return bool * @throws ConstraintException * @throws DuplicatedItemException * @throws QueryException */ public function update(AuthTokenModel $authToken): bool; /** * Regenerar el hash de los tokens de un usuario * * @param int $userId * @param string $token * * @return int * @throws ConstraintException * @throws QueryException */ public function refreshTokenByUserId(int $userId, string $token): int; /** * Regenerar el hash de los tokens de un usuario * * @param int $userId * @param string $vault * @param string $hash * * @return int * @throws ConstraintException * @throws QueryException */ public function refreshVaultByUserId(int $userId, string $vault, string $hash): int; /** * Devolver los datos de un token * * @param $actionId int El id de la accion * @param $token string El token de seguridad * * @return QueryResult */ public function getTokenByToken(int $actionId, string $token): QueryResult; }