feat(dav): Add an API for upcoming events

Signed-off-by: Christoph Wurst <christoph@winzerhof-wurst.at>

2 files changed, 131 insertions, 0 deletions

diff --git a/apps/dav/lib/CalDAV/UpcomingEvent.php b/apps/dav/lib/CalDAV/UpcomingEvent.php
new file mode 100644
index 00000000000..26760ffedd5
--- /dev/null
+++ b/apps/dav/lib/CalDAV/UpcomingEvent.php
@@ -0,0 +1,67 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: 2024 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OCA\DAV\CalDAV;
+
+use JsonSerializable;
+use OCA\DAV\ResponseDefinitions;
+
+class UpcomingEvent implements JsonSerializable {
+	public function __construct(private string $uri,
+		private ?int $recurrenceId,
+		private string $calendarUri,
+		private ?int $start,
+		private ?string $summary,
+		private ?string $location,
+		private ?string $calendarAppUrl) {
+	}
+
+	public function getUri(): string {
+		return $this->uri;
+	}
+
+	public function getRecurrenceId(): ?int {
+		return $this->recurrenceId;
+	}
+
+	public function getCalendarUri(): string {
+		return $this->calendarUri;
+	}
+
+	public function getStart(): ?int {
+		return $this->start;
+	}
+
+	public function getSummary(): ?string {
+		return $this->summary;
+	}
+
+	public function getLocation(): ?string {
+		return $this->location;
+	}
+
+	public function getCalendarAppUrl(): ?string {
+		return $this->calendarAppUrl;
+	}
+
+	/**
+	 * @see ResponseDefinitions
+	 */
+	public function jsonSerialize(): array {
+		return [
+			'uri' => $this->uri,
+			'recurrenceId' => $this->recurrenceId,
+			'calendarUri' => $this->calendarUri,
+			'start' => $this->start,
+			'summary' => $this->summary,
+			'location' => $this->location,
+			'calendarAppUrl' => $this->calendarAppUrl,
+		];
+	}
+}
diff --git a/apps/dav/lib/CalDAV/UpcomingEventsService.php b/apps/dav/lib/CalDAV/UpcomingEventsService.php
new file mode 100644
index 00000000000..04ab1be19b4
--- /dev/null
+++ b/apps/dav/lib/CalDAV/UpcomingEventsService.php
@@ -0,0 +1,64 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: 2024 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OCA\DAV\CalDAV;
+
+use OCP\App\IAppManager;
+use OCP\AppFramework\Utility\ITimeFactory;
+use OCP\Calendar\IManager;
+use OCP\IURLGenerator;
+use OCP\IUserManager;
+use function array_map;
+
+class UpcomingEventsService {
+	public function __construct(private IManager $calendarManager,
+		private ITimeFactory $timeFactory,
+		private IUserManager $userManager,
+		private IAppManager $appManager,
+		private IURLGenerator $urlGenerator) {
+	}
+
+	/**
+	 * @return UpcomingEvent[]
+	 */
+	public function getEvents(string $userId, ?string $location = null): array {
+		$searchQuery = $this->calendarManager->newQuery('principals/users/' . $userId);
+		if ($location !== null) {
+			$searchQuery->addSearchProperty('LOCATION');
+			$searchQuery->setSearchPattern($location);
+		}
+		$searchQuery->addType('VEVENT');
+		$searchQuery->setLimit(3);
+		$now = $this->timeFactory->now();
+		$searchQuery->setTimerangeStart($now->modify('-1 minute'));
+		$searchQuery->setTimerangeEnd($now->modify('+1 month'));
+
+		$events = $this->calendarManager->searchForPrincipal($searchQuery);
+		$calendarAppEnabled = $this->appManager->isEnabledForUser(
+			'calendar',
+			$this->userManager->get($userId),
+		);
+
+		return array_map(fn (array $event) => new UpcomingEvent(
+			$event['uri'],
+			($event['objects'][0]['RECURRENCE-ID'][0] ?? null)?->getTimeStamp(),
+			$event['calendar-uri'],
+			$event['objects'][0]['DTSTART'][0]?->getTimestamp(),
+			$event['objects'][0]['SUMMARY'][0] ?? null,
+			$event['objects'][0]['LOCATION'][0] ?? null,
+			match ($calendarAppEnabled) {
+				// TODO: create a named, deep route in calendar
+				// TODO: it's a code smell to just assume this route exists, find an abstraction
+				true => $this->urlGenerator->linkToRouteAbsolute('calendar.view.index'),
+				false => null,
+			},
+		), $events);
+	}
+
+}