|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); } } }