. */ namespace SP\Domain\Notification\Ports; use SP\Domain\Common\Services\ServiceException; use SP\Domain\Core\Dtos\ItemSearchDto; use SP\Domain\Core\Exceptions\ConstraintException; use SP\Domain\Core\Exceptions\QueryException; use SP\Domain\Notification\Models\Notification as NotificationModel; use SP\Infrastructure\Common\Repositories\NoSuchItemException; use SP\Infrastructure\Database\QueryResult; /** * Class NotificationService * * @template T of NotificationModel */ interface NotificationService { /** * Creates an item * * @throws ConstraintException * @throws QueryException */ public function create(NotificationModel $notification): int; /** * Updates an item * * @throws ConstraintException * @throws QueryException */ public function update(NotificationModel $notification): int; /** * Devolver los elementos con los ids especificados * * @param int[] $ids * * @return array */ public function getByIdBatch(array $ids): array; /** * Deletes an item preserving the sticky ones * * @throws ConstraintException * @throws QueryException * @throws NoSuchItemException */ public function delete(int $id): NotificationService; /** * Deletes an item * * @throws ConstraintException * @throws QueryException * @throws NoSuchItemException */ public function deleteAdmin(int $id): NotificationService; /** * Deletes an item * * @param int[] $ids * * @throws ConstraintException * @throws QueryException * @throws ServiceException */ public function deleteAdminBatch(array $ids): int; /** * Deletes all the items for given ids * * @param int[] $ids * * @throws ConstraintException * @throws QueryException * @throws ServiceException */ public function deleteByIdBatch(array $ids): int; /** * Returns the item for given id * * @param int $id * @return NotificationModel * @throws NoSuchItemException */ public function getById(int $id): NotificationModel; /** * Returns all the items * * @return array */ public function getAll(): array; /** * Marcar una notificación como leída * * @throws ConstraintException * @throws QueryException * @throws NoSuchItemException */ public function setCheckedById(int $id): void; /** * Devolver las notificaciones de un usuario para una fecha y componente determinados * * @param string $component * @param int $id * @return array */ public function getForUserIdByDate(string $component, int $id): array; /** * @param int $id * @return array */ public function getAllForUserId(int $id): array; /** * @return array */ public function getAllActiveForCurrentUser(): array; /** * Searches for items by a given filter * * @param ItemSearchDto $itemSearchData * @return QueryResult */ public function search(ItemSearchDto $itemSearchData): QueryResult; /** * Searches for items by a given filter * * @param ItemSearchDto $itemSearchData * @param int $userId * @return QueryResult */ public function searchForUserId(ItemSearchDto $itemSearchData, int $userId): QueryResult; }