* * @author Christopher Ng * * @license GNU AGPL version 3 or any later version * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU Affero General Public License as * published by the Free Software Foundation, either version 3 of the * License, or (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU Affero General Public License for more details. * * You should have received a copy of the GNU Affero General Public License * along with this program. If not, see . * */ namespace OCA\FilesReminders\Controller; use DateTime; use DateTimeInterface; use DateTimeZone; use Exception; use OCA\FilesReminders\Exception\NodeNotFoundException; use OCA\FilesReminders\Service\ReminderService; use OCP\AppFramework\Db\DoesNotExistException; use OCP\AppFramework\Http; use OCP\AppFramework\Http\Attribute\NoAdminRequired; use OCP\AppFramework\Http\DataResponse; use OCP\AppFramework\OCSController; use OCP\IRequest; use OCP\IUserSession; use Psr\Log\LoggerInterface; class ApiController extends OCSController { public function __construct( string $appName, IRequest $request, protected ReminderService $reminderService, protected IUserSession $userSession, protected LoggerInterface $logger, ) { parent::__construct($appName, $request); } /** * Get a reminder * * @param int $fileId ID of the file * @return DataResponse|DataResponse, array{}> * * 200: Reminder returned * 401: Account not found */ #[NoAdminRequired] public function get(int $fileId): DataResponse { $user = $this->userSession->getUser(); if ($user === null) { return new DataResponse([], Http::STATUS_UNAUTHORIZED); } try { $reminder = $this->reminderService->getDueForUser($user, $fileId); $reminderData = [ 'dueDate' => $reminder->getDueDate()->format(DateTimeInterface::ATOM), // ISO 8601 ]; return new DataResponse($reminderData, Http::STATUS_OK); } catch (DoesNotExistException $e) { $reminderData = [ 'dueDate' => null, ]; return new DataResponse($reminderData, Http::STATUS_OK); } } /** * Set a reminder * * @param int $fileId ID of the file * @param string $dueDate ISO 8601 formatted date time string * * @return DataResponse, array{}> * * 200: Reminder updated * 201: Reminder created successfully * 400: Creating reminder is not possible * 401: Account not found * 404: File not found */ #[NoAdminRequired] public function set(int $fileId, string $dueDate): DataResponse { try { $dueDate = (new DateTime($dueDate))->setTimezone(new DateTimeZone('UTC')); } catch (Exception $e) { $this->logger->error($e->getMessage(), ['exception' => $e]); return new DataResponse([], Http::STATUS_BAD_REQUEST); } $user = $this->userSession->getUser(); if ($user === null) { return new DataResponse([], Http::STATUS_UNAUTHORIZED); } try { $created = $this->reminderService->createOrUpdate($user, $fileId, $dueDate); if ($created) { return new DataResponse([], Http::STATUS_CREATED); } return new DataResponse([], Http::STATUS_OK); } catch (NodeNotFoundException $e) { return new DataResponse([], Http::STATUS_NOT_FOUND); } } /** * Remove a reminder * * @param int $fileId ID of the file * * @return DataResponse, array{}> * * 200: Reminder deleted successfully * 401: Account not found * 404: Reminder not found */ #[NoAdminRequired] public function remove(int $fileId): DataResponse { $user = $this->userSession->getUser(); if ($user === null) { return new DataResponse([], Http::STATUS_UNAUTHORIZED); } try { $this->reminderService->remove($user, $fileId); return new DataResponse([], Http::STATUS_OK); } catch (DoesNotExistException $e) { return new DataResponse([], Http::STATUS_NOT_FOUND); } } }