nextcloud / server

lib/public/Calendar/IManager.php

Indentation +151 added lines, -151 removed lines

@@ -42,155 +42,155 @@
  * @since 13.0.0
  */
 interface IManager {
-	/**
-	 * This function is used to search and find objects within the user's calendars.
-	 * In case $pattern is empty all events/journals/todos will be returned.
-	 *
-	 * @param string $pattern which should match within the $searchProperties
-	 * @param array $searchProperties defines the properties within the query pattern should match
-	 * @param array $options - optional parameters:
-	 *                       ['timerange' => ['start' => new DateTime(...), 'end' => new DateTime(...)]]
-	 * @param integer|null $limit - limit number of search results
-	 * @param integer|null $offset - offset for paging of search results
-	 * @return array an array of events/journals/todos which are arrays of arrays of key-value-pairs
-	 * @since 13.0.0
-	 * @deprecated 23.0.0 use \OCP\Calendar\IManager::searchForPrincipal
-	 */
-	public function search($pattern, array $searchProperties = [], array $options = [], $limit = null, $offset = null);
-
-	/**
-	 * Check if calendars are available
-	 *
-	 * @return bool true if enabled, false if not
-	 * @since 13.0.0
-	 * @deprecated 23.0.0
-	 */
-	public function isEnabled();
-
-	/**
-	 * Registers a calendar
-	 *
-	 * @param ICalendar $calendar
-	 * @return void
-	 * @since 13.0.0
-	 * @deprecated 23.0.0 use \OCP\AppFramework\Bootstrap\IRegistrationContext::registerCalendarProvider
-	 */
-	public function registerCalendar(ICalendar $calendar);
-
-	/**
-	 * Unregisters a calendar
-	 *
-	 * @param ICalendar $calendar
-	 * @return void
-	 * @since 13.0.0
-	 * @deprecated 23.0.0
-	 */
-	public function unregisterCalendar(ICalendar $calendar);
-
-	/**
-	 * In order to improve lazy loading a closure can be registered which will be called in case
-	 * calendars are actually requested
-	 *
-	 * @param \Closure $callable
-	 * @return void
-	 * @since 13.0.0
-	 * @deprecated 23.0.0 use \OCP\AppFramework\Bootstrap\IRegistrationContext::registerCalendarProvider
-	 */
-	public function register(\Closure $callable);
-
-	/**
-	 * @return ICalendar[]
-	 * @since 13.0.0
-	 * @deprecated 23.0.0 use \OCP\Calendar\IManager::getCalendarsForPrincipal
-	 */
-	public function getCalendars();
-
-	/**
-	 * removes all registered calendar instances
-	 *
-	 * @return void
-	 * @since 13.0.0
-	 * @deprecated 23.0.0
-	 */
-	public function clear();
-
-	/**
-	 * @param string $principalUri URI of the principal
-	 * @param string[] $calendarUris optionally specify which calendars to load, or all if this array is empty
-	 *
-	 * @return ICalendar[]
-	 * @since 23.0.0
-	 */
-	public function getCalendarsForPrincipal(string $principalUri, array $calendarUris = []): array;
-
-	/**
-	 * Query a principals calendar(s)
-	 *
-	 * @param ICalendarQuery $query
-	 * @return array[]
-	 * @since 23.0.0
-	 */
-	public function searchForPrincipal(ICalendarQuery $query): array;
-
-	/**
-	 * Build a new query for searchForPrincipal
-	 *
-	 * @return ICalendarQuery
-	 * @since 23.0.0
-	 */
-	public function newQuery(string $principalUri) : ICalendarQuery;
-
-	/**
-	 * Handles a iMip message
-	 *
-	 * @since 32.0.0
-	 *
-	 * @throws \OCP\DB\Exception
-	 */
-	public function handleIMip(string $userId, string $message): bool;
-
-	/**
-	 * Handle a iMip REQUEST message
-	 *
-	 * @since 31.0.0
-	 */
-	public function handleIMipRequest(string $principalUri, string $sender, string $recipient, string $calendarData): bool;
-
-	/**
-	 * Handle a iMip REPLY message
-	 *
-	 * @since 25.0.0
-	 */
-	public function handleIMipReply(string $principalUri, string $sender, string $recipient, string $calendarData): bool;
-
-	/**
-	 * Handle a iMip CANCEL message
-	 *
-	 * @since 25.0.0
-	 */
-	public function handleIMipCancel(string $principalUri, string $sender, ?string $replyTo, string $recipient, string $calendarData): bool;
-
-	/**
-	 * Create a new event builder instance. Please have a look at its documentation and the
-	 * \OCP\Calendar\ICreateFromString interface on how to use it.
-	 *
-	 * @since 31.0.0
-	 */
-	public function createEventBuilder(): ICalendarEventBuilder;
-
-	/**
-	 * Check the availability of the given organizer and attendees in the given time range.
-	 *
-	 * @since 31.0.0
-	 *
-	 * @param IUser $organizer The organizing user from whose perspective to do the availability check.
-	 * @param string[] $attendees Email addresses of attendees to check for (with or without a "mailto:" prefix). Only users on this instance can be checked. The rest will be silently ignored.
-	 * @return IAvailabilityResult[] Availabilities of the organizer and all attendees which are also users on this instance. As such, the array might not contain an entry for each given attendee.
-	 */
-	public function checkAvailability(
-		DateTimeInterface $start,
-		DateTimeInterface $end,
-		IUser $organizer,
-		array $attendees,
-	): array;
+    /**
+     * This function is used to search and find objects within the user's calendars.
+     * In case $pattern is empty all events/journals/todos will be returned.
+     *
+     * @param string $pattern which should match within the $searchProperties
+     * @param array $searchProperties defines the properties within the query pattern should match
+     * @param array $options - optional parameters:
+     *                       ['timerange' => ['start' => new DateTime(...), 'end' => new DateTime(...)]]
+     * @param integer|null $limit - limit number of search results
+     * @param integer|null $offset - offset for paging of search results
+     * @return array an array of events/journals/todos which are arrays of arrays of key-value-pairs
+     * @since 13.0.0
+     * @deprecated 23.0.0 use \OCP\Calendar\IManager::searchForPrincipal
+     */
+    public function search($pattern, array $searchProperties = [], array $options = [], $limit = null, $offset = null);
+
+    /**
+     * Check if calendars are available
+     *
+     * @return bool true if enabled, false if not
+     * @since 13.0.0
+     * @deprecated 23.0.0
+     */
+    public function isEnabled();
+
+    /**
+     * Registers a calendar
+     *
+     * @param ICalendar $calendar
+     * @return void
+     * @since 13.0.0
+     * @deprecated 23.0.0 use \OCP\AppFramework\Bootstrap\IRegistrationContext::registerCalendarProvider
+     */
+    public function registerCalendar(ICalendar $calendar);
+
+    /**
+     * Unregisters a calendar
+     *
+     * @param ICalendar $calendar
+     * @return void
+     * @since 13.0.0
+     * @deprecated 23.0.0
+     */
+    public function unregisterCalendar(ICalendar $calendar);
+
+    /**
+     * In order to improve lazy loading a closure can be registered which will be called in case
+     * calendars are actually requested
+     *
+     * @param \Closure $callable
+     * @return void
+     * @since 13.0.0
+     * @deprecated 23.0.0 use \OCP\AppFramework\Bootstrap\IRegistrationContext::registerCalendarProvider
+     */
+    public function register(\Closure $callable);
+
+    /**
+     * @return ICalendar[]
+     * @since 13.0.0
+     * @deprecated 23.0.0 use \OCP\Calendar\IManager::getCalendarsForPrincipal
+     */
+    public function getCalendars();
+
+    /**
+     * removes all registered calendar instances
+     *
+     * @return void
+     * @since 13.0.0
+     * @deprecated 23.0.0
+     */
+    public function clear();
+
+    /**
+     * @param string $principalUri URI of the principal
+     * @param string[] $calendarUris optionally specify which calendars to load, or all if this array is empty
+     *
+     * @return ICalendar[]
+     * @since 23.0.0
+     */
+    public function getCalendarsForPrincipal(string $principalUri, array $calendarUris = []): array;
+
+    /**
+     * Query a principals calendar(s)
+     *
+     * @param ICalendarQuery $query
+     * @return array[]
+     * @since 23.0.0
+     */
+    public function searchForPrincipal(ICalendarQuery $query): array;
+
+    /**
+     * Build a new query for searchForPrincipal
+     *
+     * @return ICalendarQuery
+     * @since 23.0.0
+     */
+    public function newQuery(string $principalUri) : ICalendarQuery;
+
+    /**
+     * Handles a iMip message
+     *
+     * @since 32.0.0
+     *
+     * @throws \OCP\DB\Exception
+     */
+    public function handleIMip(string $userId, string $message): bool;
+
+    /**
+     * Handle a iMip REQUEST message
+     *
+     * @since 31.0.0
+     */
+    public function handleIMipRequest(string $principalUri, string $sender, string $recipient, string $calendarData): bool;
+
+    /**
+     * Handle a iMip REPLY message
+     *
+     * @since 25.0.0
+     */
+    public function handleIMipReply(string $principalUri, string $sender, string $recipient, string $calendarData): bool;
+
+    /**
+     * Handle a iMip CANCEL message
+     *
+     * @since 25.0.0
+     */
+    public function handleIMipCancel(string $principalUri, string $sender, ?string $replyTo, string $recipient, string $calendarData): bool;
+
+    /**
+     * Create a new event builder instance. Please have a look at its documentation and the
+     * \OCP\Calendar\ICreateFromString interface on how to use it.
+     *
+     * @since 31.0.0
+     */
+    public function createEventBuilder(): ICalendarEventBuilder;
+
+    /**
+     * Check the availability of the given organizer and attendees in the given time range.
+     *
+     * @since 31.0.0
+     *
+     * @param IUser $organizer The organizing user from whose perspective to do the availability check.
+     * @param string[] $attendees Email addresses of attendees to check for (with or without a "mailto:" prefix). Only users on this instance can be checked. The rest will be silently ignored.
+     * @return IAvailabilityResult[] Availabilities of the organizer and all attendees which are also users on this instance. As such, the array might not contain an entry for each given attendee.
+     */
+    public function checkAvailability(
+        DateTimeInterface $start,
+        DateTimeInterface $end,
+        IUser $organizer,
+        array $attendees,
+    ): array;
 }

lib/private/Calendar/Manager.php

Indentation +397 added lines, -397 removed lines

@@ -40,401 +40,401 @@
 use function array_merge;
 
 class Manager implements IManager {
-	/**
-	 * @var ICalendar[] holds all registered calendars
-	 */
-	private array $calendars = [];
-
-	/**
-	 * @var \Closure[] to call to load/register calendar providers
-	 */
-	private array $calendarLoaders = [];
-
-	public function __construct(
-		private Coordinator $coordinator,
-		private ContainerInterface $container,
-		private LoggerInterface $logger,
-		private ITimeFactory $timeFactory,
-		private ISecureRandom $random,
-		private IUserManager $userManager,
-		private ServerFactory $serverFactory,
-	) {
-	}
-
-	/**
-	 * This function is used to search and find objects within the user's calendars.
-	 * In case $pattern is empty all events/journals/todos will be returned.
-	 *
-	 * @param string $pattern which should match within the $searchProperties
-	 * @param array $searchProperties defines the properties within the query pattern should match
-	 * @param array $options - optional parameters:
-	 *                       ['timerange' => ['start' => new DateTime(...), 'end' => new DateTime(...)]]
-	 * @param integer|null $limit - limit number of search results
-	 * @param integer|null $offset - offset for paging of search results
-	 * @return array an array of events/journals/todos which are arrays of arrays of key-value-pairs
-	 * @since 13.0.0
-	 */
-	public function search(
-		$pattern,
-		array $searchProperties = [],
-		array $options = [],
-		$limit = null,
-		$offset = null,
-	): array {
-		$this->loadCalendars();
-		$result = [];
-		foreach ($this->calendars as $calendar) {
-			$r = $calendar->search($pattern, $searchProperties, $options, $limit, $offset);
-			foreach ($r as $o) {
-				$o['calendar-key'] = $calendar->getKey();
-				$result[] = $o;
-			}
-		}
-
-		return $result;
-	}
-
-	/**
-	 * Check if calendars are available
-	 *
-	 * @return bool true if enabled, false if not
-	 * @since 13.0.0
-	 */
-	public function isEnabled(): bool {
-		return !empty($this->calendars) || !empty($this->calendarLoaders);
-	}
-
-	/**
-	 * Registers a calendar
-	 *
-	 * @since 13.0.0
-	 */
-	public function registerCalendar(ICalendar $calendar): void {
-		$this->calendars[$calendar->getKey()] = $calendar;
-	}
-
-	/**
-	 * Unregisters a calendar
-	 *
-	 * @since 13.0.0
-	 */
-	public function unregisterCalendar(ICalendar $calendar): void {
-		unset($this->calendars[$calendar->getKey()]);
-	}
-
-	/**
-	 * In order to improve lazy loading a closure can be registered which will be called in case
-	 * calendars are actually requested
-	 *
-	 * @since 13.0.0
-	 */
-	public function register(\Closure $callable): void {
-		$this->calendarLoaders[] = $callable;
-	}
-
-	/**
-	 * @return ICalendar[]
-	 *
-	 * @since 13.0.0
-	 */
-	public function getCalendars(): array {
-		$this->loadCalendars();
-
-		return array_values($this->calendars);
-	}
-
-	/**
-	 * removes all registered calendar instances
-	 *
-	 * @since 13.0.0
-	 */
-	public function clear(): void {
-		$this->calendars = [];
-		$this->calendarLoaders = [];
-	}
-
-	/**
-	 * loads all calendars
-	 */
-	private function loadCalendars(): void {
-		foreach ($this->calendarLoaders as $callable) {
-			$callable($this);
-		}
-		$this->calendarLoaders = [];
-	}
-
-	/**
-	 * @return ICreateFromString[]
-	 */
-	public function getCalendarsForPrincipal(string $principalUri, array $calendarUris = []): array {
-		$context = $this->coordinator->getRegistrationContext();
-		if ($context === null) {
-			return [];
-		}
-
-		return array_merge(
-			...array_map(function ($registration) use ($principalUri, $calendarUris) {
-				try {
-					/** @var ICalendarProvider $provider */
-					$provider = $this->container->get($registration->getService());
-				} catch (Throwable $e) {
-					$this->logger->error('Could not load calendar provider ' . $registration->getService() . ': ' . $e->getMessage(), [
-						'exception' => $e,
-					]);
-					return [];
-				}
-
-				return $provider->getCalendars($principalUri, $calendarUris);
-			}, $context->getCalendarProviders())
-		);
-	}
-
-	public function searchForPrincipal(ICalendarQuery $query): array {
-		/** @var CalendarQuery $query */
-		$calendars = $this->getCalendarsForPrincipal(
-			$query->getPrincipalUri(),
-			$query->getCalendarUris(),
-		);
-
-		$results = [];
-		foreach ($calendars as $calendar) {
-			$r = $calendar->search(
-				$query->getSearchPattern() ?? '',
-				$query->getSearchProperties(),
-				$query->getOptions(),
-				$query->getLimit(),
-				$query->getOffset()
-			);
-
-			foreach ($r as $o) {
-				$o['calendar-key'] = $calendar->getKey();
-				$o['calendar-uri'] = $calendar->getUri();
-				$results[] = $o;
-			}
-		}
-		return $results;
-	}
-
-	public function newQuery(string $principalUri): ICalendarQuery {
-		return new CalendarQuery($principalUri);
-	}
-
-	/**
-	 * @since 32.0.0
-	 *
-	 * @throws \OCP\DB\Exception
-	 */
-	public function handleIMip(
-		string $userId,
-		string $message,
-	): bool {
-
-		$userUri = 'principals/users/' . $userId;
-
-		$userCalendars = $this->getCalendarsForPrincipal($userUri);
-		if (empty($userCalendars)) {
-			$this->logger->warning('iMip message could not be processed because user has no calendars');
-			return false;
-		}
-
-		try {
-			/** @var VCalendar $vObject|null */
-			$vObject = Reader::read($message);
-		} catch (ParseException $e) {
-			$this->logger->error('iMip message could not be processed because an error occurred while parsing the iMip message', ['exception' => $e]);
-			return false;
-		}
-
-		if (!isset($vObject->VEVENT)) {
-			$this->logger->warning('iMip message does not contain any event(s)');
-			return false;
-		}
-		/** @var VEvent $vEvent */
-		$vEvent = $vObject->VEVENT;
-
-		if (!isset($vEvent->UID)) {
-			$this->logger->warning('iMip message event dose not contains a UID');
-			return false;
-		}
-
-		if (!isset($vEvent->ORGANIZER)) {
-			$this->logger->warning('iMip message event dose not contains an organizer');
-			return false;
-		}
-
-		if (!isset($vEvent->ATTENDEE)) {
-			$this->logger->warning('iMip message event dose not contains any attendees');
-			return false;
-		}
-
-		foreach ($userCalendars as $calendar) {
-			if (!$calendar instanceof ICalendarIsWritable) {
-				continue;
-			}
-			if ($calendar->isDeleted() || !$calendar->isWritable()) {
-				continue;
-			}
-			if (!empty($calendar->search('', [], ['uid' => $vEvent->UID->getValue()]))) {
-				try {
-					if ($calendar instanceof IHandleImipMessage) {
-						$calendar->handleIMipMessage($userId, $vObject->serialize());
-					}
-					return true;
-				} catch (CalendarException $e) {
-					$this->logger->error('iMip message could not be processed because an error occurred', ['exception' => $e]);
-					return false;
-				}
-			}
-		}
-
-		$this->logger->warning('iMip message could not be processed because no corresponding event was found in any calendar');
-
-		return false;
-	}
-
-	/**
-	 * @since 31.0.0
-	 *
-	 * @throws \OCP\DB\Exception
-	 */
-	public function handleIMipRequest(
-		string $principalUri,
-		string $sender,
-		string $recipient,
-		string $calendarData,
-	): bool {
-		if (empty($principalUri) || !str_starts_with($principalUri, 'principals/users/')) {
-			$this->logger->error('Invalid principal URI provided for iMip request');
-			return false;
-		}
-		$userId = substr($principalUri, 17);
-		return $this->handleIMip($userId, $calendarData);
-	}
-
-	/**
-	 * @since 25.0.0
-	 *
-	 * @throws \OCP\DB\Exception
-	 */
-	public function handleIMipReply(
-		string $principalUri,
-		string $sender,
-		string $recipient,
-		string $calendarData,
-	): bool {
-		if (empty($principalUri) || !str_starts_with($principalUri, 'principals/users/')) {
-			$this->logger->error('Invalid principal URI provided for iMip reply');
-			return false;
-		}
-		$userId = substr($principalUri, 17);
-		return $this->handleIMip($userId, $calendarData);
-	}
-
-	/**
-	 * @since 25.0.0
-	 *
-	 * @throws \OCP\DB\Exception
-	 */
-	public function handleIMipCancel(
-		string $principalUri,
-		string $sender,
-		?string $replyTo,
-		string $recipient,
-		string $calendarData,
-	): bool {
-		if (empty($principalUri) || !str_starts_with($principalUri, 'principals/users/')) {
-			$this->logger->error('Invalid principal URI provided for iMip cancel');
-			return false;
-		}
-		$userId = substr($principalUri, 17);
-		return $this->handleIMip($userId, $calendarData);
-	}
-
-	public function createEventBuilder(): ICalendarEventBuilder {
-		$uid = $this->random->generate(32, ISecureRandom::CHAR_ALPHANUMERIC);
-		return new CalendarEventBuilder($uid, $this->timeFactory);
-	}
-
-	public function checkAvailability(
-		DateTimeInterface $start,
-		DateTimeInterface $end,
-		IUser $organizer,
-		array $attendees,
-	): array {
-		$organizerMailto = 'mailto:' . $organizer->getEMailAddress();
-		$request = new VCalendar();
-		$request->METHOD = 'REQUEST';
-		$request->add('VFREEBUSY', [
-			'DTSTART' => $start,
-			'DTEND' => $end,
-			'ORGANIZER' => $organizerMailto,
-			'ATTENDEE' => $organizerMailto,
-		]);
-
-		$mailtoLen = strlen('mailto:');
-		foreach ($attendees as $attendee) {
-			if (str_starts_with($attendee, 'mailto:')) {
-				$attendee = substr($attendee, $mailtoLen);
-			}
-
-			$attendeeUsers = $this->userManager->getByEmail($attendee);
-			if ($attendeeUsers === []) {
-				continue;
-			}
-
-			$request->VFREEBUSY->add('ATTENDEE', "mailto:$attendee");
-		}
-
-		$organizerUid = $organizer->getUID();
-		$server = $this->serverFactory->createAttendeeAvailabilityServer();
-		/** @var CustomPrincipalPlugin $plugin */
-		$plugin = $server->getPlugin('auth');
-		$plugin->setCurrentPrincipal("principals/users/$organizerUid");
-
-		$request = new Request(
-			'POST',
-			"/calendars/$organizerUid/outbox/",
-			[
-				'Content-Type' => 'text/calendar',
-				'Depth' => 0,
-			],
-			$request->serialize(),
-		);
-		$response = new Response();
-		$server->invokeMethod($request, $response, false);
-
-		$xmlService = new \Sabre\Xml\Service();
-		$xmlService->elementMap = [
-			'{urn:ietf:params:xml:ns:caldav}response' => 'Sabre\Xml\Deserializer\keyValue',
-			'{urn:ietf:params:xml:ns:caldav}recipient' => 'Sabre\Xml\Deserializer\keyValue',
-		];
-		$parsedResponse = $xmlService->parse($response->getBodyAsString());
-
-		$result = [];
-		foreach ($parsedResponse as $freeBusyResponse) {
-			$freeBusyResponse = $freeBusyResponse['value'];
-			if ($freeBusyResponse['{urn:ietf:params:xml:ns:caldav}request-status'] !== '2.0;Success') {
-				continue;
-			}
-
-			$freeBusyResponseData = \Sabre\VObject\Reader::read(
-				$freeBusyResponse['{urn:ietf:params:xml:ns:caldav}calendar-data']
-			);
-
-			$attendee = substr(
-				$freeBusyResponse['{urn:ietf:params:xml:ns:caldav}recipient']['{DAV:}href'],
-				$mailtoLen,
-			);
-
-			$vFreeBusy = $freeBusyResponseData->VFREEBUSY;
-			if (!($vFreeBusy instanceof VFreeBusy)) {
-				continue;
-			}
-
-			// TODO: actually check values of FREEBUSY properties to find a free slot
-			$result[] = new AvailabilityResult($attendee, $vFreeBusy->isFree($start, $end));
-		}
-
-		return $result;
-	}
+    /**
+     * @var ICalendar[] holds all registered calendars
+     */
+    private array $calendars = [];
+
+    /**
+     * @var \Closure[] to call to load/register calendar providers
+     */
+    private array $calendarLoaders = [];
+
+    public function __construct(
+        private Coordinator $coordinator,
+        private ContainerInterface $container,
+        private LoggerInterface $logger,
+        private ITimeFactory $timeFactory,
+        private ISecureRandom $random,
+        private IUserManager $userManager,
+        private ServerFactory $serverFactory,
+    ) {
+    }
+
+    /**
+     * This function is used to search and find objects within the user's calendars.
+     * In case $pattern is empty all events/journals/todos will be returned.
+     *
+     * @param string $pattern which should match within the $searchProperties
+     * @param array $searchProperties defines the properties within the query pattern should match
+     * @param array $options - optional parameters:
+     *                       ['timerange' => ['start' => new DateTime(...), 'end' => new DateTime(...)]]
+     * @param integer|null $limit - limit number of search results
+     * @param integer|null $offset - offset for paging of search results
+     * @return array an array of events/journals/todos which are arrays of arrays of key-value-pairs
+     * @since 13.0.0
+     */
+    public function search(
+        $pattern,
+        array $searchProperties = [],
+        array $options = [],
+        $limit = null,
+        $offset = null,
+    ): array {
+        $this->loadCalendars();
+        $result = [];
+        foreach ($this->calendars as $calendar) {
+            $r = $calendar->search($pattern, $searchProperties, $options, $limit, $offset);
+            foreach ($r as $o) {
+                $o['calendar-key'] = $calendar->getKey();
+                $result[] = $o;
+            }
+        }
+
+        return $result;
+    }
+
+    /**
+     * Check if calendars are available
+     *
+     * @return bool true if enabled, false if not
+     * @since 13.0.0
+     */
+    public function isEnabled(): bool {
+        return !empty($this->calendars) || !empty($this->calendarLoaders);
+    }
+
+    /**
+     * Registers a calendar
+     *
+     * @since 13.0.0
+     */
+    public function registerCalendar(ICalendar $calendar): void {
+        $this->calendars[$calendar->getKey()] = $calendar;
+    }
+
+    /**
+     * Unregisters a calendar
+     *
+     * @since 13.0.0
+     */
+    public function unregisterCalendar(ICalendar $calendar): void {
+        unset($this->calendars[$calendar->getKey()]);
+    }
+
+    /**
+     * In order to improve lazy loading a closure can be registered which will be called in case
+     * calendars are actually requested
+     *
+     * @since 13.0.0
+     */
+    public function register(\Closure $callable): void {
+        $this->calendarLoaders[] = $callable;
+    }
+
+    /**
+     * @return ICalendar[]
+     *
+     * @since 13.0.0
+     */
+    public function getCalendars(): array {
+        $this->loadCalendars();
+
+        return array_values($this->calendars);
+    }
+
+    /**
+     * removes all registered calendar instances
+     *
+     * @since 13.0.0
+     */
+    public function clear(): void {
+        $this->calendars = [];
+        $this->calendarLoaders = [];
+    }
+
+    /**
+     * loads all calendars
+     */
+    private function loadCalendars(): void {
+        foreach ($this->calendarLoaders as $callable) {
+            $callable($this);
+        }
+        $this->calendarLoaders = [];
+    }
+
+    /**
+     * @return ICreateFromString[]
+     */
+    public function getCalendarsForPrincipal(string $principalUri, array $calendarUris = []): array {
+        $context = $this->coordinator->getRegistrationContext();
+        if ($context === null) {
+            return [];
+        }
+
+        return array_merge(
+            ...array_map(function ($registration) use ($principalUri, $calendarUris) {
+                try {
+                    /** @var ICalendarProvider $provider */
+                    $provider = $this->container->get($registration->getService());
+                } catch (Throwable $e) {
+                    $this->logger->error('Could not load calendar provider ' . $registration->getService() . ': ' . $e->getMessage(), [
+                        'exception' => $e,
+                    ]);
+                    return [];
+                }
+
+                return $provider->getCalendars($principalUri, $calendarUris);
+            }, $context->getCalendarProviders())
+        );
+    }
+
+    public function searchForPrincipal(ICalendarQuery $query): array {
+        /** @var CalendarQuery $query */
+        $calendars = $this->getCalendarsForPrincipal(
+            $query->getPrincipalUri(),
+            $query->getCalendarUris(),
+        );
+
+        $results = [];
+        foreach ($calendars as $calendar) {
+            $r = $calendar->search(
+                $query->getSearchPattern() ?? '',
+                $query->getSearchProperties(),
+                $query->getOptions(),
+                $query->getLimit(),
+                $query->getOffset()
+            );
+
+            foreach ($r as $o) {
+                $o['calendar-key'] = $calendar->getKey();
+                $o['calendar-uri'] = $calendar->getUri();
+                $results[] = $o;
+            }
+        }
+        return $results;
+    }
+
+    public function newQuery(string $principalUri): ICalendarQuery {
+        return new CalendarQuery($principalUri);
+    }
+
+    /**
+     * @since 32.0.0
+     *
+     * @throws \OCP\DB\Exception
+     */
+    public function handleIMip(
+        string $userId,
+        string $message,
+    ): bool {
+
+        $userUri = 'principals/users/' . $userId;
+
+        $userCalendars = $this->getCalendarsForPrincipal($userUri);
+        if (empty($userCalendars)) {
+            $this->logger->warning('iMip message could not be processed because user has no calendars');
+            return false;
+        }
+
+        try {
+            /** @var VCalendar $vObject|null */
+            $vObject = Reader::read($message);
+        } catch (ParseException $e) {
+            $this->logger->error('iMip message could not be processed because an error occurred while parsing the iMip message', ['exception' => $e]);
+            return false;
+        }
+
+        if (!isset($vObject->VEVENT)) {
+            $this->logger->warning('iMip message does not contain any event(s)');
+            return false;
+        }
+        /** @var VEvent $vEvent */
+        $vEvent = $vObject->VEVENT;
+
+        if (!isset($vEvent->UID)) {
+            $this->logger->warning('iMip message event dose not contains a UID');
+            return false;
+        }
+
+        if (!isset($vEvent->ORGANIZER)) {
+            $this->logger->warning('iMip message event dose not contains an organizer');
+            return false;
+        }
+
+        if (!isset($vEvent->ATTENDEE)) {
+            $this->logger->warning('iMip message event dose not contains any attendees');
+            return false;
+        }
+
+        foreach ($userCalendars as $calendar) {
+            if (!$calendar instanceof ICalendarIsWritable) {
+                continue;
+            }
+            if ($calendar->isDeleted() || !$calendar->isWritable()) {
+                continue;
+            }
+            if (!empty($calendar->search('', [], ['uid' => $vEvent->UID->getValue()]))) {
+                try {
+                    if ($calendar instanceof IHandleImipMessage) {
+                        $calendar->handleIMipMessage($userId, $vObject->serialize());
+                    }
+                    return true;
+                } catch (CalendarException $e) {
+                    $this->logger->error('iMip message could not be processed because an error occurred', ['exception' => $e]);
+                    return false;
+                }
+            }
+        }
+
+        $this->logger->warning('iMip message could not be processed because no corresponding event was found in any calendar');
+
+        return false;
+    }
+
+    /**
+     * @since 31.0.0
+     *
+     * @throws \OCP\DB\Exception
+     */
+    public function handleIMipRequest(
+        string $principalUri,
+        string $sender,
+        string $recipient,
+        string $calendarData,
+    ): bool {
+        if (empty($principalUri) || !str_starts_with($principalUri, 'principals/users/')) {
+            $this->logger->error('Invalid principal URI provided for iMip request');
+            return false;
+        }
+        $userId = substr($principalUri, 17);
+        return $this->handleIMip($userId, $calendarData);
+    }
+
+    /**
+     * @since 25.0.0
+     *
+     * @throws \OCP\DB\Exception
+     */
+    public function handleIMipReply(
+        string $principalUri,
+        string $sender,
+        string $recipient,
+        string $calendarData,
+    ): bool {
+        if (empty($principalUri) || !str_starts_with($principalUri, 'principals/users/')) {
+            $this->logger->error('Invalid principal URI provided for iMip reply');
+            return false;
+        }
+        $userId = substr($principalUri, 17);
+        return $this->handleIMip($userId, $calendarData);
+    }
+
+    /**
+     * @since 25.0.0
+     *
+     * @throws \OCP\DB\Exception
+     */
+    public function handleIMipCancel(
+        string $principalUri,
+        string $sender,
+        ?string $replyTo,
+        string $recipient,
+        string $calendarData,
+    ): bool {
+        if (empty($principalUri) || !str_starts_with($principalUri, 'principals/users/')) {
+            $this->logger->error('Invalid principal URI provided for iMip cancel');
+            return false;
+        }
+        $userId = substr($principalUri, 17);
+        return $this->handleIMip($userId, $calendarData);
+    }
+
+    public function createEventBuilder(): ICalendarEventBuilder {
+        $uid = $this->random->generate(32, ISecureRandom::CHAR_ALPHANUMERIC);
+        return new CalendarEventBuilder($uid, $this->timeFactory);
+    }
+
+    public function checkAvailability(
+        DateTimeInterface $start,
+        DateTimeInterface $end,
+        IUser $organizer,
+        array $attendees,
+    ): array {
+        $organizerMailto = 'mailto:' . $organizer->getEMailAddress();
+        $request = new VCalendar();
+        $request->METHOD = 'REQUEST';
+        $request->add('VFREEBUSY', [
+            'DTSTART' => $start,
+            'DTEND' => $end,
+            'ORGANIZER' => $organizerMailto,
+            'ATTENDEE' => $organizerMailto,
+        ]);
+
+        $mailtoLen = strlen('mailto:');
+        foreach ($attendees as $attendee) {
+            if (str_starts_with($attendee, 'mailto:')) {
+                $attendee = substr($attendee, $mailtoLen);
+            }
+
+            $attendeeUsers = $this->userManager->getByEmail($attendee);
+            if ($attendeeUsers === []) {
+                continue;
+            }
+
+            $request->VFREEBUSY->add('ATTENDEE', "mailto:$attendee");
+        }
+
+        $organizerUid = $organizer->getUID();
+        $server = $this->serverFactory->createAttendeeAvailabilityServer();
+        /** @var CustomPrincipalPlugin $plugin */
+        $plugin = $server->getPlugin('auth');
+        $plugin->setCurrentPrincipal("principals/users/$organizerUid");
+
+        $request = new Request(
+            'POST',
+            "/calendars/$organizerUid/outbox/",
+            [
+                'Content-Type' => 'text/calendar',
+                'Depth' => 0,
+            ],
+            $request->serialize(),
+        );
+        $response = new Response();
+        $server->invokeMethod($request, $response, false);
+
+        $xmlService = new \Sabre\Xml\Service();
+        $xmlService->elementMap = [
+            '{urn:ietf:params:xml:ns:caldav}response' => 'Sabre\Xml\Deserializer\keyValue',
+            '{urn:ietf:params:xml:ns:caldav}recipient' => 'Sabre\Xml\Deserializer\keyValue',
+        ];
+        $parsedResponse = $xmlService->parse($response->getBodyAsString());
+
+        $result = [];
+        foreach ($parsedResponse as $freeBusyResponse) {
+            $freeBusyResponse = $freeBusyResponse['value'];
+            if ($freeBusyResponse['{urn:ietf:params:xml:ns:caldav}request-status'] !== '2.0;Success') {
+                continue;
+            }
+
+            $freeBusyResponseData = \Sabre\VObject\Reader::read(
+                $freeBusyResponse['{urn:ietf:params:xml:ns:caldav}calendar-data']
+            );
+
+            $attendee = substr(
+                $freeBusyResponse['{urn:ietf:params:xml:ns:caldav}recipient']['{DAV:}href'],
+                $mailtoLen,
+            );
+
+            $vFreeBusy = $freeBusyResponseData->VFREEBUSY;
+            if (!($vFreeBusy instanceof VFreeBusy)) {
+                continue;
+            }
+
+            // TODO: actually check values of FREEBUSY properties to find a free slot
+            $result[] = new AvailabilityResult($attendee, $vFreeBusy->isFree($start, $end));
+        }
+
+        return $result;
+    }
 }

Spacing +4 added lines, -4 removed lines

@@ -173,12 +173,12 @@ 
 		}
 
 		return array_merge(
-			...array_map(function ($registration) use ($principalUri, $calendarUris) {
+			...array_map(function($registration) use ($principalUri, $calendarUris) {
 				try {
 					/** @var ICalendarProvider $provider */
 					$provider = $this->container->get($registration->getService());
 				} catch (Throwable $e) {
-					$this->logger->error('Could not load calendar provider ' . $registration->getService() . ': ' . $e->getMessage(), [
+					$this->logger->error('Could not load calendar provider '.$registration->getService().': '.$e->getMessage(), [
 						'exception' => $e,
 					]);
 					return [];
@@ -229,7 +229,7 @@ 
 		string $message,
 	): bool {
 
-		$userUri = 'principals/users/' . $userId;
+		$userUri = 'principals/users/'.$userId;
 
 		$userCalendars = $this->getCalendarsForPrincipal($userUri);
 		if (empty($userCalendars)) {
@@ -361,7 +361,7 @@ 
 		IUser $organizer,
 		array $attendees,
 	): array {
-		$organizerMailto = 'mailto:' . $organizer->getEMailAddress();
+		$organizerMailto = 'mailto:'.$organizer->getEMailAddress();
 		$request = new VCalendar();
 		$request->METHOD = 'REQUEST';
 		$request->add('VFREEBUSY', [

apps/dav/lib/CalDAV/Schedule/Plugin.php

Indentation +699 added lines, -699 removed lines

@@ -42,260 +42,260 @@ 
 
 class Plugin extends \Sabre\CalDAV\Schedule\Plugin {
 
-	/** @var ITip\Message[] */
-	private $schedulingResponses = [];
-
-	/** @var string|null */
-	private $pathOfCalendarObjectChange = null;
-
-	public const CALENDAR_USER_TYPE = '{' . self::NS_CALDAV . '}calendar-user-type';
-	public const SCHEDULE_DEFAULT_CALENDAR_URL = '{' . Plugin::NS_CALDAV . '}schedule-default-calendar-URL';
-
-	/**
-	 * @param IConfig $config
-	 */
-	public function __construct(
-		private IConfig $config,
-		private LoggerInterface $logger,
-		private DefaultCalendarValidator $defaultCalendarValidator,
-	) {
-	}
-
-	/**
-	 * Initializes the plugin
-	 *
-	 * @param Server $server
-	 * @return void
-	 */
-	public function initialize(Server $server) {
-		parent::initialize($server);
-		$server->on('propFind', [$this, 'propFindDefaultCalendarUrl'], 90);
-		$server->on('afterWriteContent', [$this, 'dispatchSchedulingResponses']);
-		$server->on('afterCreateFile', [$this, 'dispatchSchedulingResponses']);
-
-		// We allow mutating the default calendar URL through the CustomPropertiesBackend
-		// (oc_properties table)
-		$server->protectedProperties = array_filter(
-			$server->protectedProperties,
-			static fn (string $property) => $property !== self::SCHEDULE_DEFAULT_CALENDAR_URL,
-		);
-	}
-
-	/**
-	 * Returns an instance of the iTip\Broker.
-	 */
-	protected function createITipBroker(): TipBroker {
-		return new TipBroker();
-	}
-
-	/**
-	 * Allow manual setting of the object change URL
-	 * to support public write
-	 *
-	 * @param string $path
-	 */
-	public function setPathOfCalendarObjectChange(string $path): void {
-		$this->pathOfCalendarObjectChange = $path;
-	}
-
-	/**
-	 * This method handler is invoked during fetching of properties.
-	 *
-	 * We use this event to add calendar-auto-schedule-specific properties.
-	 *
-	 * @param PropFind $propFind
-	 * @param INode $node
-	 * @return void
-	 */
-	public function propFind(PropFind $propFind, INode $node) {
-		if ($node instanceof IPrincipal) {
-			// overwrite Sabre/Dav's implementation
-			$propFind->handle(self::CALENDAR_USER_TYPE, function () use ($node) {
-				if ($node instanceof IProperties) {
-					$props = $node->getProperties([self::CALENDAR_USER_TYPE]);
-
-					if (isset($props[self::CALENDAR_USER_TYPE])) {
-						return $props[self::CALENDAR_USER_TYPE];
-					}
-				}
-
-				return 'INDIVIDUAL';
-			});
-		}
-
-		parent::propFind($propFind, $node);
-	}
-
-	/**
-	 * Returns a list of addresses that are associated with a principal.
-	 *
-	 * @param string $principal
-	 * @return array
-	 */
-	public function getAddressesForPrincipal($principal) {
-		$result = parent::getAddressesForPrincipal($principal);
-
-		if ($result === null) {
-			$result = [];
-		}
-
-		// iterate through items and html decode values
-		foreach ($result as $key => $value) {
-			$result[$key] = urldecode($value);
-		}
-
-		return $result;
-	}
-
-	/**
-	 * @param RequestInterface $request
-	 * @param ResponseInterface $response
-	 * @param VCalendar $vCal
-	 * @param mixed $calendarPath
-	 * @param mixed $modified
-	 * @param mixed $isNew
-	 */
-	public function calendarObjectChange(RequestInterface $request, ResponseInterface $response, VCalendar $vCal, $calendarPath, &$modified, $isNew) {
-		// Save the first path we get as a calendar-object-change request
-		if (!$this->pathOfCalendarObjectChange) {
-			$this->pathOfCalendarObjectChange = $request->getPath();
-		}
-
-		try {
-
-			// Do not generate iTip and iMip messages if scheduling is disabled for this message
-			if ($request->getHeader('x-nc-scheduling') === 'false') {
-				return;
-			}
-
-			if (!$this->scheduleReply($this->server->httpRequest)) {
-				return;
-			}
-
-			/** @var Calendar $calendarNode */
-			$calendarNode = $this->server->tree->getNodeForPath($calendarPath);
-			// extract addresses for owner
-			$addresses = $this->getAddressesForPrincipal($calendarNode->getOwner());
-			// determine if request is from a sharee
-			if ($calendarNode->isShared()) {
-				// extract addresses for sharee and add to address collection
-				$addresses = array_merge(
-					$addresses,
-					$this->getAddressesForPrincipal($calendarNode->getPrincipalURI())
-				);
-			}
-			// determine if we are updating a calendar event
-			if (!$isNew) {
-				// retrieve current calendar event node
-				/** @var CalendarObject $currentNode */
-				$currentNode = $this->server->tree->getNodeForPath($request->getPath());
-				// convert calendar event string data to VCalendar object
-				/** @var \Sabre\VObject\Component\VCalendar $currentObject */
-				$currentObject = Reader::read($currentNode->get());
-			} else {
-				$currentObject = null;
-			}
-			// process request
-			$this->processICalendarChange($currentObject, $vCal, $addresses, [], $modified);
-
-			if ($currentObject) {
-				// Destroy circular references so PHP will GC the object.
-				$currentObject->destroy();
-			}
-
-		} catch (SameOrganizerForAllComponentsException $e) {
-			$this->handleSameOrganizerException($e, $vCal, $calendarPath);
-		}
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	public function beforeUnbind($path): void {
-		try {
-			parent::beforeUnbind($path);
-		} catch (SameOrganizerForAllComponentsException $e) {
-			$node = $this->server->tree->getNodeForPath($path);
-			if (!$node instanceof ICalendarObject || $node instanceof ISchedulingObject) {
-				throw $e;
-			}
-
-			/** @var VCalendar $vCal */
-			$vCal = Reader::read($node->get());
-			$this->handleSameOrganizerException($e, $vCal, $path);
-		}
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	public function scheduleLocalDelivery(ITip\Message $iTipMessage):void {
-		/** @var VEvent|null $vevent */
-		$vevent = $iTipMessage->message->VEVENT ?? null;
-
-		// Strip VALARMs from incoming VEVENT
-		if ($vevent && isset($vevent->VALARM)) {
-			$vevent->remove('VALARM');
-		}
-
-		parent::scheduleLocalDelivery($iTipMessage);
-		// We only care when the message was successfully delivered locally
-		// Log all possible codes returned from the parent method that mean something went wrong
-		// 3.7, 3.8, 5.0, 5.2
-		if ($iTipMessage->scheduleStatus !== '1.2;Message delivered locally') {
-			$this->logger->debug('Message not delivered locally with status: ' . $iTipMessage->scheduleStatus);
-			return;
-		}
-		// We only care about request. reply and cancel are properly handled
-		// by parent::scheduleLocalDelivery already
-		if (strcasecmp($iTipMessage->method, 'REQUEST') !== 0) {
-			return;
-		}
-
-		// If parent::scheduleLocalDelivery set scheduleStatus to 1.2,
-		// it means that it was successfully delivered locally.
-		// Meaning that the ACL plugin is loaded and that a principal
-		// exists for the given recipient id, no need to double check
-		/** @var \Sabre\DAVACL\Plugin $aclPlugin */
-		$aclPlugin = $this->server->getPlugin('acl');
-		$principalUri = $aclPlugin->getPrincipalByUri($iTipMessage->recipient);
-		$calendarUserType = $this->getCalendarUserTypeForPrincipal($principalUri);
-		if (strcasecmp($calendarUserType, 'ROOM') !== 0 && strcasecmp($calendarUserType, 'RESOURCE') !== 0) {
-			$this->logger->debug('Calendar user type is neither room nor resource, not processing further');
-			return;
-		}
-
-		$attendee = $this->getCurrentAttendee($iTipMessage);
-		if (!$attendee) {
-			$this->logger->debug('No attendee set for scheduling message');
-			return;
-		}
-
-		// We only respond when a response was actually requested
-		$rsvp = $this->getAttendeeRSVP($attendee);
-		if (!$rsvp) {
-			$this->logger->debug('No RSVP requested for attendee ' . $attendee->getValue());
-			return;
-		}
-
-		if (!$vevent) {
-			$this->logger->debug('No VEVENT set to process on scheduling message');
-			return;
-		}
-
-		// We don't support autoresponses for recurrencing events for now
-		if (isset($vevent->RRULE) || isset($vevent->RDATE)) {
-			$this->logger->debug('VEVENT is a recurring event, autoresponding not supported');
-			return;
-		}
-
-		$dtstart = $vevent->DTSTART;
-		$dtend = $this->getDTEndFromVEvent($vevent);
-		$uid = $vevent->UID->getValue();
-		$sequence = isset($vevent->SEQUENCE) ? $vevent->SEQUENCE->getValue() : 0;
-		$recurrenceId = isset($vevent->{'RECURRENCE-ID'}) ? $vevent->{'RECURRENCE-ID'}->serialize() : '';
-
-		$message = <<<EOF
+    /** @var ITip\Message[] */
+    private $schedulingResponses = [];
+
+    /** @var string|null */
+    private $pathOfCalendarObjectChange = null;
+
+    public const CALENDAR_USER_TYPE = '{' . self::NS_CALDAV . '}calendar-user-type';
+    public const SCHEDULE_DEFAULT_CALENDAR_URL = '{' . Plugin::NS_CALDAV . '}schedule-default-calendar-URL';
+
+    /**
+     * @param IConfig $config
+     */
+    public function __construct(
+        private IConfig $config,
+        private LoggerInterface $logger,
+        private DefaultCalendarValidator $defaultCalendarValidator,
+    ) {
+    }
+
+    /**
+     * Initializes the plugin
+     *
+     * @param Server $server
+     * @return void
+     */
+    public function initialize(Server $server) {
+        parent::initialize($server);
+        $server->on('propFind', [$this, 'propFindDefaultCalendarUrl'], 90);
+        $server->on('afterWriteContent', [$this, 'dispatchSchedulingResponses']);
+        $server->on('afterCreateFile', [$this, 'dispatchSchedulingResponses']);
+
+        // We allow mutating the default calendar URL through the CustomPropertiesBackend
+        // (oc_properties table)
+        $server->protectedProperties = array_filter(
+            $server->protectedProperties,
+            static fn (string $property) => $property !== self::SCHEDULE_DEFAULT_CALENDAR_URL,
+        );
+    }
+
+    /**
+     * Returns an instance of the iTip\Broker.
+     */
+    protected function createITipBroker(): TipBroker {
+        return new TipBroker();
+    }
+
+    /**
+     * Allow manual setting of the object change URL
+     * to support public write
+     *
+     * @param string $path
+     */
+    public function setPathOfCalendarObjectChange(string $path): void {
+        $this->pathOfCalendarObjectChange = $path;
+    }
+
+    /**
+     * This method handler is invoked during fetching of properties.
+     *
+     * We use this event to add calendar-auto-schedule-specific properties.
+     *
+     * @param PropFind $propFind
+     * @param INode $node
+     * @return void
+     */
+    public function propFind(PropFind $propFind, INode $node) {
+        if ($node instanceof IPrincipal) {
+            // overwrite Sabre/Dav's implementation
+            $propFind->handle(self::CALENDAR_USER_TYPE, function () use ($node) {
+                if ($node instanceof IProperties) {
+                    $props = $node->getProperties([self::CALENDAR_USER_TYPE]);
+
+                    if (isset($props[self::CALENDAR_USER_TYPE])) {
+                        return $props[self::CALENDAR_USER_TYPE];
+                    }
+                }
+
+                return 'INDIVIDUAL';
+            });
+        }
+
+        parent::propFind($propFind, $node);
+    }
+
+    /**
+     * Returns a list of addresses that are associated with a principal.
+     *
+     * @param string $principal
+     * @return array
+     */
+    public function getAddressesForPrincipal($principal) {
+        $result = parent::getAddressesForPrincipal($principal);
+
+        if ($result === null) {
+            $result = [];
+        }
+
+        // iterate through items and html decode values
+        foreach ($result as $key => $value) {
+            $result[$key] = urldecode($value);
+        }
+
+        return $result;
+    }
+
+    /**
+     * @param RequestInterface $request
+     * @param ResponseInterface $response
+     * @param VCalendar $vCal
+     * @param mixed $calendarPath
+     * @param mixed $modified
+     * @param mixed $isNew
+     */
+    public function calendarObjectChange(RequestInterface $request, ResponseInterface $response, VCalendar $vCal, $calendarPath, &$modified, $isNew) {
+        // Save the first path we get as a calendar-object-change request
+        if (!$this->pathOfCalendarObjectChange) {
+            $this->pathOfCalendarObjectChange = $request->getPath();
+        }
+
+        try {
+
+            // Do not generate iTip and iMip messages if scheduling is disabled for this message
+            if ($request->getHeader('x-nc-scheduling') === 'false') {
+                return;
+            }
+
+            if (!$this->scheduleReply($this->server->httpRequest)) {
+                return;
+            }
+
+            /** @var Calendar $calendarNode */
+            $calendarNode = $this->server->tree->getNodeForPath($calendarPath);
+            // extract addresses for owner
+            $addresses = $this->getAddressesForPrincipal($calendarNode->getOwner());
+            // determine if request is from a sharee
+            if ($calendarNode->isShared()) {
+                // extract addresses for sharee and add to address collection
+                $addresses = array_merge(
+                    $addresses,
+                    $this->getAddressesForPrincipal($calendarNode->getPrincipalURI())
+                );
+            }
+            // determine if we are updating a calendar event
+            if (!$isNew) {
+                // retrieve current calendar event node
+                /** @var CalendarObject $currentNode */
+                $currentNode = $this->server->tree->getNodeForPath($request->getPath());
+                // convert calendar event string data to VCalendar object
+                /** @var \Sabre\VObject\Component\VCalendar $currentObject */
+                $currentObject = Reader::read($currentNode->get());
+            } else {
+                $currentObject = null;
+            }
+            // process request
+            $this->processICalendarChange($currentObject, $vCal, $addresses, [], $modified);
+
+            if ($currentObject) {
+                // Destroy circular references so PHP will GC the object.
+                $currentObject->destroy();
+            }
+
+        } catch (SameOrganizerForAllComponentsException $e) {
+            $this->handleSameOrganizerException($e, $vCal, $calendarPath);
+        }
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function beforeUnbind($path): void {
+        try {
+            parent::beforeUnbind($path);
+        } catch (SameOrganizerForAllComponentsException $e) {
+            $node = $this->server->tree->getNodeForPath($path);
+            if (!$node instanceof ICalendarObject || $node instanceof ISchedulingObject) {
+                throw $e;
+            }
+
+            /** @var VCalendar $vCal */
+            $vCal = Reader::read($node->get());
+            $this->handleSameOrganizerException($e, $vCal, $path);
+        }
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function scheduleLocalDelivery(ITip\Message $iTipMessage):void {
+        /** @var VEvent|null $vevent */
+        $vevent = $iTipMessage->message->VEVENT ?? null;
+
+        // Strip VALARMs from incoming VEVENT
+        if ($vevent && isset($vevent->VALARM)) {
+            $vevent->remove('VALARM');
+        }
+
+        parent::scheduleLocalDelivery($iTipMessage);
+        // We only care when the message was successfully delivered locally
+        // Log all possible codes returned from the parent method that mean something went wrong
+        // 3.7, 3.8, 5.0, 5.2
+        if ($iTipMessage->scheduleStatus !== '1.2;Message delivered locally') {
+            $this->logger->debug('Message not delivered locally with status: ' . $iTipMessage->scheduleStatus);
+            return;
+        }
+        // We only care about request. reply and cancel are properly handled
+        // by parent::scheduleLocalDelivery already
+        if (strcasecmp($iTipMessage->method, 'REQUEST') !== 0) {
+            return;
+        }
+
+        // If parent::scheduleLocalDelivery set scheduleStatus to 1.2,
+        // it means that it was successfully delivered locally.
+        // Meaning that the ACL plugin is loaded and that a principal
+        // exists for the given recipient id, no need to double check
+        /** @var \Sabre\DAVACL\Plugin $aclPlugin */
+        $aclPlugin = $this->server->getPlugin('acl');
+        $principalUri = $aclPlugin->getPrincipalByUri($iTipMessage->recipient);
+        $calendarUserType = $this->getCalendarUserTypeForPrincipal($principalUri);
+        if (strcasecmp($calendarUserType, 'ROOM') !== 0 && strcasecmp($calendarUserType, 'RESOURCE') !== 0) {
+            $this->logger->debug('Calendar user type is neither room nor resource, not processing further');
+            return;
+        }
+
+        $attendee = $this->getCurrentAttendee($iTipMessage);
+        if (!$attendee) {
+            $this->logger->debug('No attendee set for scheduling message');
+            return;
+        }
+
+        // We only respond when a response was actually requested
+        $rsvp = $this->getAttendeeRSVP($attendee);
+        if (!$rsvp) {
+            $this->logger->debug('No RSVP requested for attendee ' . $attendee->getValue());
+            return;
+        }
+
+        if (!$vevent) {
+            $this->logger->debug('No VEVENT set to process on scheduling message');
+            return;
+        }
+
+        // We don't support autoresponses for recurrencing events for now
+        if (isset($vevent->RRULE) || isset($vevent->RDATE)) {
+            $this->logger->debug('VEVENT is a recurring event, autoresponding not supported');
+            return;
+        }
+
+        $dtstart = $vevent->DTSTART;
+        $dtend = $this->getDTEndFromVEvent($vevent);
+        $uid = $vevent->UID->getValue();
+        $sequence = isset($vevent->SEQUENCE) ? $vevent->SEQUENCE->getValue() : 0;
+        $recurrenceId = isset($vevent->{'RECURRENCE-ID'}) ? $vevent->{'RECURRENCE-ID'}->serialize() : '';
+
+        $message = <<<EOF
 BEGIN:VCALENDAR
 PRODID:-//Nextcloud/Nextcloud CalDAV Server//EN
 METHOD:REPLY
@@ -310,449 +310,449 @@ 
 END:VCALENDAR
 EOF;
 
-		if ($this->isAvailableAtTime($attendee->getValue(), $dtstart->getDateTime(), $dtend->getDateTime(), $uid)) {
-			$partStat = 'ACCEPTED';
-		} else {
-			$partStat = 'DECLINED';
-		}
-
-		$vObject = Reader::read(vsprintf($message, [
-			$partStat,
-			$iTipMessage->recipient,
-			$iTipMessage->sender,
-			$uid,
-			$sequence,
-			$recurrenceId
-		]));
-
-		$responseITipMessage = new ITip\Message();
-		$responseITipMessage->uid = $uid;
-		$responseITipMessage->component = 'VEVENT';
-		$responseITipMessage->method = 'REPLY';
-		$responseITipMessage->sequence = $sequence;
-		$responseITipMessage->sender = $iTipMessage->recipient;
-		$responseITipMessage->recipient = $iTipMessage->sender;
-		$responseITipMessage->message = $vObject;
-
-		// We can't dispatch them now already, because the organizers calendar-object
-		// was not yet created. Hence Sabre/DAV won't find a calendar-object, when we
-		// send our reply.
-		$this->schedulingResponses[] = $responseITipMessage;
-	}
-
-	/**
-	 * @param string $uri
-	 */
-	public function dispatchSchedulingResponses(string $uri):void {
-		if ($uri !== $this->pathOfCalendarObjectChange) {
-			return;
-		}
-
-		foreach ($this->schedulingResponses as $schedulingResponse) {
-			$this->scheduleLocalDelivery($schedulingResponse);
-		}
-	}
-
-	/**
-	 * Always use the personal calendar as target for scheduled events
-	 *
-	 * @param PropFind $propFind
-	 * @param INode $node
-	 * @return void
-	 */
-	public function propFindDefaultCalendarUrl(PropFind $propFind, INode $node) {
-		if ($node instanceof IPrincipal) {
-			$propFind->handle(self::SCHEDULE_DEFAULT_CALENDAR_URL, function () use ($node) {
-				/** @var \OCA\DAV\CalDAV\Plugin $caldavPlugin */
-				$caldavPlugin = $this->server->getPlugin('caldav');
-				$principalUrl = $node->getPrincipalUrl();
-
-				$calendarHomePath = $caldavPlugin->getCalendarHomeForPrincipal($principalUrl);
-				if (!$calendarHomePath) {
-					return null;
-				}
-
-				$isResourceOrRoom = str_starts_with($principalUrl, 'principals/calendar-resources')
-					|| str_starts_with($principalUrl, 'principals/calendar-rooms');
-
-				if (str_starts_with($principalUrl, 'principals/users')) {
-					[, $userId] = split($principalUrl);
-					$uri = $this->config->getUserValue($userId, 'dav', 'defaultCalendar', CalDavBackend::PERSONAL_CALENDAR_URI);
-					$displayName = CalDavBackend::PERSONAL_CALENDAR_NAME;
-				} elseif ($isResourceOrRoom) {
-					$uri = CalDavBackend::RESOURCE_BOOKING_CALENDAR_URI;
-					$displayName = CalDavBackend::RESOURCE_BOOKING_CALENDAR_NAME;
-				} else {
-					// How did we end up here?
-					// TODO - throw exception or just ignore?
-					return null;
-				}
-
-				/** @var CalendarHome $calendarHome */
-				$calendarHome = $this->server->tree->getNodeForPath($calendarHomePath);
-				$currentCalendarDeleted = false;
-				if (!$calendarHome->childExists($uri) || $currentCalendarDeleted = $this->isCalendarDeleted($calendarHome, $uri)) {
-					// If the default calendar doesn't exist
-					if ($isResourceOrRoom) {
-						// Resources or rooms can't be in the trashbin, so we're fine
-						$this->createCalendar($calendarHome, $principalUrl, $uri, $displayName);
-					} else {
-						// And we're not handling scheduling on resource/room booking
-						$userCalendars = [];
-						/**
-						 * If the default calendar of the user isn't set and the
-						 * fallback doesn't match any of the user's calendar
-						 * try to find the first "personal" calendar we can write to
-						 * instead of creating a new one.
-						 * A appropriate personal calendar to receive invites:
-						 * - isn't a calendar subscription
-						 * - user can write to it (no virtual/3rd-party calendars)
-						 * - calendar isn't a share
-						 * - calendar supports VEVENTs
-						 */
-						foreach ($calendarHome->getChildren() as $node) {
-							if (!($node instanceof Calendar)) {
-								continue;
-							}
-
-							try {
-								$this->defaultCalendarValidator->validateScheduleDefaultCalendar($node);
-							} catch (DavException $e) {
-								continue;
-							}
-
-							$userCalendars[] = $node;
-						}
-
-						if (count($userCalendars) > 0) {
-							// Calendar backend returns calendar by calendarorder property
-							$uri = $userCalendars[0]->getName();
-						} else {
-							// Otherwise if we have really nothing, create a new calendar
-							if ($currentCalendarDeleted) {
-								// If the calendar exists but is in the trash bin, we try to rename its uri
-								// so that we can create the new one and still restore the previous one
-								// otherwise we just purge the calendar by removing it before recreating it
-								$calendar = $this->getCalendar($calendarHome, $uri);
-								if ($calendar instanceof Calendar) {
-									$backend = $calendarHome->getCalDAVBackend();
-									if ($backend instanceof CalDavBackend) {
-										// If the CalDAV backend supports moving calendars
-										$this->moveCalendar($backend, $principalUrl, $uri, $uri . '-back-' . time());
-									} else {
-										// Otherwise just purge the calendar
-										$calendar->disableTrashbin();
-										$calendar->delete();
-									}
-								}
-							}
-							$this->createCalendar($calendarHome, $principalUrl, $uri, $displayName);
-						}
-					}
-				}
-
-				$result = $this->server->getPropertiesForPath($calendarHomePath . '/' . $uri, [], 1);
-				if (empty($result)) {
-					return null;
-				}
-
-				return new LocalHref($result[0]['href']);
-			});
-		}
-	}
-
-	/**
-	 * Returns a list of addresses that are associated with a principal.
-	 *
-	 * @param string $principal
-	 * @return string|null
-	 */
-	protected function getCalendarUserTypeForPrincipal($principal):?string {
-		$calendarUserType = '{' . self::NS_CALDAV . '}calendar-user-type';
-		$properties = $this->server->getProperties(
-			$principal,
-			[$calendarUserType]
-		);
-
-		// If we can't find this information, we'll stop processing
-		if (!isset($properties[$calendarUserType])) {
-			return null;
-		}
-
-		return $properties[$calendarUserType];
-	}
-
-	/**
-	 * @param ITip\Message $iTipMessage
-	 * @return null|Property
-	 */
-	private function getCurrentAttendee(ITip\Message $iTipMessage):?Property {
-		/** @var VEvent $vevent */
-		$vevent = $iTipMessage->message->VEVENT;
-		$attendees = $vevent->select('ATTENDEE');
-		foreach ($attendees as $attendee) {
-			/** @var Property $attendee */
-			if (strcasecmp($attendee->getValue(), $iTipMessage->recipient) === 0) {
-				return $attendee;
-			}
-		}
-		return null;
-	}
-
-	/**
-	 * @param Property|null $attendee
-	 * @return bool
-	 */
-	private function getAttendeeRSVP(?Property $attendee = null):bool {
-		if ($attendee !== null) {
-			$rsvp = $attendee->offsetGet('RSVP');
-			if (($rsvp instanceof Parameter) && (strcasecmp($rsvp->getValue(), 'TRUE') === 0)) {
-				return true;
-			}
-		}
-		// RFC 5545 3.2.17: default RSVP is false
-		return false;
-	}
-
-	/**
-	 * @param VEvent $vevent
-	 * @return Property\ICalendar\DateTime
-	 */
-	private function getDTEndFromVEvent(VEvent $vevent):Property\ICalendar\DateTime {
-		if (isset($vevent->DTEND)) {
-			return $vevent->DTEND;
-		}
-
-		if (isset($vevent->DURATION)) {
-			$isFloating = $vevent->DTSTART->isFloating();
-			/** @var Property\ICalendar\DateTime $end */
-			$end = clone $vevent->DTSTART;
-			$endDateTime = $end->getDateTime();
-			$endDateTime = $endDateTime->add(DateTimeParser::parse($vevent->DURATION->getValue()));
-			$end->setDateTime($endDateTime, $isFloating);
-			return $end;
-		}
-
-		if (!$vevent->DTSTART->hasTime()) {
-			$isFloating = $vevent->DTSTART->isFloating();
-			/** @var Property\ICalendar\DateTime $end */
-			$end = clone $vevent->DTSTART;
-			$endDateTime = $end->getDateTime();
-			$endDateTime = $endDateTime->modify('+1 day');
-			$end->setDateTime($endDateTime, $isFloating);
-			return $end;
-		}
-
-		return clone $vevent->DTSTART;
-	}
-
-	/**
-	 * @param string $email
-	 * @param \DateTimeInterface $start
-	 * @param \DateTimeInterface $end
-	 * @param string $ignoreUID
-	 * @return bool
-	 */
-	private function isAvailableAtTime(string $email, \DateTimeInterface $start, \DateTimeInterface $end, string $ignoreUID):bool {
-		// This method is heavily inspired by Sabre\CalDAV\Schedule\Plugin::scheduleLocalDelivery
-		// and Sabre\CalDAV\Schedule\Plugin::getFreeBusyForEmail
-
-		$aclPlugin = $this->server->getPlugin('acl');
-		$this->server->removeListener('propFind', [$aclPlugin, 'propFind']);
-
-		$result = $aclPlugin->principalSearch(
-			['{http://sabredav.org/ns}email-address' => $this->stripOffMailTo($email)],
-			[
-				'{DAV:}principal-URL',
-				'{' . self::NS_CALDAV . '}calendar-home-set',
-				'{' . self::NS_CALDAV . '}schedule-inbox-URL',
-				'{http://sabredav.org/ns}email-address',
-
-			]
-		);
-		$this->server->on('propFind', [$aclPlugin, 'propFind'], 20);
-
-
-		// Grabbing the calendar list
-		$objects = [];
-		$calendarTimeZone = new DateTimeZone('UTC');
-
-		$homePath = $result[0][200]['{' . self::NS_CALDAV . '}calendar-home-set']->getHref();
-		/** @var Calendar $node */
-		foreach ($this->server->tree->getNodeForPath($homePath)->getChildren() as $node) {
-
-			if (!$node instanceof ICalendar) {
-				continue;
-			}
-
-			// Getting the list of object uris within the time-range
-			$urls = $node->calendarQuery([
-				'name' => 'VCALENDAR',
-				'comp-filters' => [
-					[
-						'name' => 'VEVENT',
-						'is-not-defined' => false,
-						'time-range' => [
-							'start' => $start,
-							'end' => $end,
-						],
-						'comp-filters' => [],
-						'prop-filters' => [],
-					],
-					[
-						'name' => 'VEVENT',
-						'is-not-defined' => false,
-						'time-range' => null,
-						'comp-filters' => [],
-						'prop-filters' => [
-							[
-								'name' => 'UID',
-								'is-not-defined' => false,
-								'time-range' => null,
-								'text-match' => [
-									'value' => $ignoreUID,
-									'negate-condition' => true,
-									'collation' => 'i;octet',
-								],
-								'param-filters' => [],
-							],
-						]
-					],
-				],
-				'prop-filters' => [],
-				'is-not-defined' => false,
-				'time-range' => null,
-			]);
-
-			foreach ($urls as $url) {
-				$objects[] = $node->getChild($url)->get();
-			}
-		}
-
-		$inboxProps = $this->server->getProperties(
-			$result[0][200]['{' . self::NS_CALDAV . '}schedule-inbox-URL']->getHref(),
-			['{' . self::NS_CALDAV . '}calendar-availability']
-		);
-
-		$vcalendar = new VCalendar();
-		$vcalendar->METHOD = 'REPLY';
-
-		$generator = new FreeBusyGenerator();
-		$generator->setObjects($objects);
-		$generator->setTimeRange($start, $end);
-		$generator->setBaseObject($vcalendar);
-		$generator->setTimeZone($calendarTimeZone);
-
-		if (isset($inboxProps['{' . self::NS_CALDAV . '}calendar-availability'])) {
-			$generator->setVAvailability(
-				Reader::read(
-					$inboxProps['{' . self::NS_CALDAV . '}calendar-availability']
-				)
-			);
-		}
-
-		$result = $generator->getResult();
-		if (!isset($result->VFREEBUSY)) {
-			return false;
-		}
-
-		/** @var Component $freeBusyComponent */
-		$freeBusyComponent = $result->VFREEBUSY;
-		$freeBusyProperties = $freeBusyComponent->select('FREEBUSY');
-		// If there is no Free-busy property at all, the time-range is empty and available
-		if (count($freeBusyProperties) === 0) {
-			return true;
-		}
-
-		// If more than one Free-Busy property was returned, it means that an event
-		// starts or ends inside this time-range, so it's not available and we return false
-		if (count($freeBusyProperties) > 1) {
-			return false;
-		}
-
-		/** @var Property $freeBusyProperty */
-		$freeBusyProperty = $freeBusyProperties[0];
-		if (!$freeBusyProperty->offsetExists('FBTYPE')) {
-			// If there is no FBTYPE, it means it's busy
-			return false;
-		}
-
-		$fbTypeParameter = $freeBusyProperty->offsetGet('FBTYPE');
-		if (!($fbTypeParameter instanceof Parameter)) {
-			return false;
-		}
-
-		return (strcasecmp($fbTypeParameter->getValue(), 'FREE') === 0);
-	}
-
-	/**
-	 * @param string $email
-	 * @return string
-	 */
-	private function stripOffMailTo(string $email): string {
-		if (stripos($email, 'mailto:') === 0) {
-			return substr($email, 7);
-		}
-
-		return $email;
-	}
-
-	private function getCalendar(CalendarHome $calendarHome, string $uri): INode {
-		return $calendarHome->getChild($uri);
-	}
-
-	private function isCalendarDeleted(CalendarHome $calendarHome, string $uri): bool {
-		$calendar = $this->getCalendar($calendarHome, $uri);
-		return $calendar instanceof Calendar && $calendar->isDeleted();
-	}
-
-	private function createCalendar(CalendarHome $calendarHome, string $principalUri, string $uri, string $displayName): void {
-		$calendarHome->getCalDAVBackend()->createCalendar($principalUri, $uri, [
-			'{DAV:}displayname' => $displayName,
-		]);
-	}
-
-	private function moveCalendar(CalDavBackend $calDavBackend, string $principalUri, string $oldUri, string $newUri): void {
-		$calDavBackend->moveCalendar($oldUri, $principalUri, $principalUri, $newUri);
-	}
-
-	/**
-	 * Try to handle the given exception gracefully or throw it if necessary.
-	 *
-	 * @throws SameOrganizerForAllComponentsException If the exception should not be ignored
-	 */
-	private function handleSameOrganizerException(
-		SameOrganizerForAllComponentsException $e,
-		VCalendar $vCal,
-		string $calendarPath,
-	): void {
-		// This is very hacky! However, we want to allow saving events with multiple
-		// organizers. Those events are not RFC compliant, but sometimes imported from major
-		// external calendar services (e.g. Google). If the current user is not an organizer of
-		// the event we ignore the exception as no scheduling messages will be sent anyway.
-
-		// It would be cleaner to patch Sabre to validate organizers *after* checking if
-		// scheduling messages are necessary. Currently, organizers are validated first and
-		// afterwards the broker checks if messages should be scheduled. So the code will throw
-		// even if the organizers are not relevant. This is to ensure compliance with RFCs but
-		// a bit too strict for real world usage.
-
-		if (!isset($vCal->VEVENT)) {
-			throw $e;
-		}
-
-		$calendarNode = $this->server->tree->getNodeForPath($calendarPath);
-		if (!($calendarNode instanceof IACL)) {
-			// Should always be an instance of IACL but just to be sure
-			throw $e;
-		}
-
-		$addresses = $this->getAddressesForPrincipal($calendarNode->getOwner());
-		foreach ($vCal->VEVENT as $vevent) {
-			if (in_array($vevent->ORGANIZER->getNormalizedValue(), $addresses, true)) {
-				// User is an organizer => throw the exception
-				throw $e;
-			}
-		}
-	}
+        if ($this->isAvailableAtTime($attendee->getValue(), $dtstart->getDateTime(), $dtend->getDateTime(), $uid)) {
+            $partStat = 'ACCEPTED';
+        } else {
+            $partStat = 'DECLINED';
+        }
+
+        $vObject = Reader::read(vsprintf($message, [
+            $partStat,
+            $iTipMessage->recipient,
+            $iTipMessage->sender,
+            $uid,
+            $sequence,
+            $recurrenceId
+        ]));
+
+        $responseITipMessage = new ITip\Message();
+        $responseITipMessage->uid = $uid;
+        $responseITipMessage->component = 'VEVENT';
+        $responseITipMessage->method = 'REPLY';
+        $responseITipMessage->sequence = $sequence;
+        $responseITipMessage->sender = $iTipMessage->recipient;
+        $responseITipMessage->recipient = $iTipMessage->sender;
+        $responseITipMessage->message = $vObject;
+
+        // We can't dispatch them now already, because the organizers calendar-object
+        // was not yet created. Hence Sabre/DAV won't find a calendar-object, when we
+        // send our reply.
+        $this->schedulingResponses[] = $responseITipMessage;
+    }
+
+    /**
+     * @param string $uri
+     */
+    public function dispatchSchedulingResponses(string $uri):void {
+        if ($uri !== $this->pathOfCalendarObjectChange) {
+            return;
+        }
+
+        foreach ($this->schedulingResponses as $schedulingResponse) {
+            $this->scheduleLocalDelivery($schedulingResponse);
+        }
+    }
+
+    /**
+     * Always use the personal calendar as target for scheduled events
+     *
+     * @param PropFind $propFind
+     * @param INode $node
+     * @return void
+     */
+    public function propFindDefaultCalendarUrl(PropFind $propFind, INode $node) {
+        if ($node instanceof IPrincipal) {
+            $propFind->handle(self::SCHEDULE_DEFAULT_CALENDAR_URL, function () use ($node) {
+                /** @var \OCA\DAV\CalDAV\Plugin $caldavPlugin */
+                $caldavPlugin = $this->server->getPlugin('caldav');
+                $principalUrl = $node->getPrincipalUrl();
+
+                $calendarHomePath = $caldavPlugin->getCalendarHomeForPrincipal($principalUrl);
+                if (!$calendarHomePath) {
+                    return null;
+                }
+
+                $isResourceOrRoom = str_starts_with($principalUrl, 'principals/calendar-resources')
+                    || str_starts_with($principalUrl, 'principals/calendar-rooms');
+
+                if (str_starts_with($principalUrl, 'principals/users')) {
+                    [, $userId] = split($principalUrl);
+                    $uri = $this->config->getUserValue($userId, 'dav', 'defaultCalendar', CalDavBackend::PERSONAL_CALENDAR_URI);
+                    $displayName = CalDavBackend::PERSONAL_CALENDAR_NAME;
+                } elseif ($isResourceOrRoom) {
+                    $uri = CalDavBackend::RESOURCE_BOOKING_CALENDAR_URI;
+                    $displayName = CalDavBackend::RESOURCE_BOOKING_CALENDAR_NAME;
+                } else {
+                    // How did we end up here?
+                    // TODO - throw exception or just ignore?
+                    return null;
+                }
+
+                /** @var CalendarHome $calendarHome */
+                $calendarHome = $this->server->tree->getNodeForPath($calendarHomePath);
+                $currentCalendarDeleted = false;
+                if (!$calendarHome->childExists($uri) || $currentCalendarDeleted = $this->isCalendarDeleted($calendarHome, $uri)) {
+                    // If the default calendar doesn't exist
+                    if ($isResourceOrRoom) {
+                        // Resources or rooms can't be in the trashbin, so we're fine
+                        $this->createCalendar($calendarHome, $principalUrl, $uri, $displayName);
+                    } else {
+                        // And we're not handling scheduling on resource/room booking
+                        $userCalendars = [];
+                        /**
+                         * If the default calendar of the user isn't set and the
+                         * fallback doesn't match any of the user's calendar
+                         * try to find the first "personal" calendar we can write to
+                         * instead of creating a new one.
+                         * A appropriate personal calendar to receive invites:
+                         * - isn't a calendar subscription
+                         * - user can write to it (no virtual/3rd-party calendars)
+                         * - calendar isn't a share
+                         * - calendar supports VEVENTs
+                         */
+                        foreach ($calendarHome->getChildren() as $node) {
+                            if (!($node instanceof Calendar)) {
+                                continue;
+                            }
+
+                            try {
+                                $this->defaultCalendarValidator->validateScheduleDefaultCalendar($node);
+                            } catch (DavException $e) {
+                                continue;
+                            }
+
+                            $userCalendars[] = $node;
+                        }
+
+                        if (count($userCalendars) > 0) {
+                            // Calendar backend returns calendar by calendarorder property
+                            $uri = $userCalendars[0]->getName();
+                        } else {
+                            // Otherwise if we have really nothing, create a new calendar
+                            if ($currentCalendarDeleted) {
+                                // If the calendar exists but is in the trash bin, we try to rename its uri
+                                // so that we can create the new one and still restore the previous one
+                                // otherwise we just purge the calendar by removing it before recreating it
+                                $calendar = $this->getCalendar($calendarHome, $uri);
+                                if ($calendar instanceof Calendar) {
+                                    $backend = $calendarHome->getCalDAVBackend();
+                                    if ($backend instanceof CalDavBackend) {
+                                        // If the CalDAV backend supports moving calendars
+                                        $this->moveCalendar($backend, $principalUrl, $uri, $uri . '-back-' . time());
+                                    } else {
+                                        // Otherwise just purge the calendar
+                                        $calendar->disableTrashbin();
+                                        $calendar->delete();
+                                    }
+                                }
+                            }
+                            $this->createCalendar($calendarHome, $principalUrl, $uri, $displayName);
+                        }
+                    }
+                }
+
+                $result = $this->server->getPropertiesForPath($calendarHomePath . '/' . $uri, [], 1);
+                if (empty($result)) {
+                    return null;
+                }
+
+                return new LocalHref($result[0]['href']);
+            });
+        }
+    }
+
+    /**
+     * Returns a list of addresses that are associated with a principal.
+     *
+     * @param string $principal
+     * @return string|null
+     */
+    protected function getCalendarUserTypeForPrincipal($principal):?string {
+        $calendarUserType = '{' . self::NS_CALDAV . '}calendar-user-type';
+        $properties = $this->server->getProperties(
+            $principal,
+            [$calendarUserType]
+        );
+
+        // If we can't find this information, we'll stop processing
+        if (!isset($properties[$calendarUserType])) {
+            return null;
+        }
+
+        return $properties[$calendarUserType];
+    }
+
+    /**
+     * @param ITip\Message $iTipMessage
+     * @return null|Property
+     */
+    private function getCurrentAttendee(ITip\Message $iTipMessage):?Property {
+        /** @var VEvent $vevent */
+        $vevent = $iTipMessage->message->VEVENT;
+        $attendees = $vevent->select('ATTENDEE');
+        foreach ($attendees as $attendee) {
+            /** @var Property $attendee */
+            if (strcasecmp($attendee->getValue(), $iTipMessage->recipient) === 0) {
+                return $attendee;
+            }
+        }
+        return null;
+    }
+
+    /**
+     * @param Property|null $attendee
+     * @return bool
+     */
+    private function getAttendeeRSVP(?Property $attendee = null):bool {
+        if ($attendee !== null) {
+            $rsvp = $attendee->offsetGet('RSVP');
+            if (($rsvp instanceof Parameter) && (strcasecmp($rsvp->getValue(), 'TRUE') === 0)) {
+                return true;
+            }
+        }
+        // RFC 5545 3.2.17: default RSVP is false
+        return false;
+    }
+
+    /**
+     * @param VEvent $vevent
+     * @return Property\ICalendar\DateTime
+     */
+    private function getDTEndFromVEvent(VEvent $vevent):Property\ICalendar\DateTime {
+        if (isset($vevent->DTEND)) {
+            return $vevent->DTEND;
+        }
+
+        if (isset($vevent->DURATION)) {
+            $isFloating = $vevent->DTSTART->isFloating();
+            /** @var Property\ICalendar\DateTime $end */
+            $end = clone $vevent->DTSTART;
+            $endDateTime = $end->getDateTime();
+            $endDateTime = $endDateTime->add(DateTimeParser::parse($vevent->DURATION->getValue()));
+            $end->setDateTime($endDateTime, $isFloating);
+            return $end;
+        }
+
+        if (!$vevent->DTSTART->hasTime()) {
+            $isFloating = $vevent->DTSTART->isFloating();
+            /** @var Property\ICalendar\DateTime $end */
+            $end = clone $vevent->DTSTART;
+            $endDateTime = $end->getDateTime();
+            $endDateTime = $endDateTime->modify('+1 day');
+            $end->setDateTime($endDateTime, $isFloating);
+            return $end;
+        }
+
+        return clone $vevent->DTSTART;
+    }
+
+    /**
+     * @param string $email
+     * @param \DateTimeInterface $start
+     * @param \DateTimeInterface $end
+     * @param string $ignoreUID
+     * @return bool
+     */
+    private function isAvailableAtTime(string $email, \DateTimeInterface $start, \DateTimeInterface $end, string $ignoreUID):bool {
+        // This method is heavily inspired by Sabre\CalDAV\Schedule\Plugin::scheduleLocalDelivery
+        // and Sabre\CalDAV\Schedule\Plugin::getFreeBusyForEmail
+
+        $aclPlugin = $this->server->getPlugin('acl');
+        $this->server->removeListener('propFind', [$aclPlugin, 'propFind']);
+
+        $result = $aclPlugin->principalSearch(
+            ['{http://sabredav.org/ns}email-address' => $this->stripOffMailTo($email)],
+            [
+                '{DAV:}principal-URL',
+                '{' . self::NS_CALDAV . '}calendar-home-set',
+                '{' . self::NS_CALDAV . '}schedule-inbox-URL',
+                '{http://sabredav.org/ns}email-address',
+
+            ]
+        );
+        $this->server->on('propFind', [$aclPlugin, 'propFind'], 20);
+
+
+        // Grabbing the calendar list
+        $objects = [];
+        $calendarTimeZone = new DateTimeZone('UTC');
+
+        $homePath = $result[0][200]['{' . self::NS_CALDAV . '}calendar-home-set']->getHref();
+        /** @var Calendar $node */
+        foreach ($this->server->tree->getNodeForPath($homePath)->getChildren() as $node) {
+
+            if (!$node instanceof ICalendar) {
+                continue;
+            }
+
+            // Getting the list of object uris within the time-range
+            $urls = $node->calendarQuery([
+                'name' => 'VCALENDAR',
+                'comp-filters' => [
+                    [
+                        'name' => 'VEVENT',
+                        'is-not-defined' => false,
+                        'time-range' => [
+                            'start' => $start,
+                            'end' => $end,
+                        ],
+                        'comp-filters' => [],
+                        'prop-filters' => [],
+                    ],
+                    [
+                        'name' => 'VEVENT',
+                        'is-not-defined' => false,
+                        'time-range' => null,
+                        'comp-filters' => [],
+                        'prop-filters' => [
+                            [
+                                'name' => 'UID',
+                                'is-not-defined' => false,
+                                'time-range' => null,
+                                'text-match' => [
+                                    'value' => $ignoreUID,
+                                    'negate-condition' => true,
+                                    'collation' => 'i;octet',
+                                ],
+                                'param-filters' => [],
+                            ],
+                        ]
+                    ],
+                ],
+                'prop-filters' => [],
+                'is-not-defined' => false,
+                'time-range' => null,
+            ]);
+
+            foreach ($urls as $url) {
+                $objects[] = $node->getChild($url)->get();
+            }
+        }
+
+        $inboxProps = $this->server->getProperties(
+            $result[0][200]['{' . self::NS_CALDAV . '}schedule-inbox-URL']->getHref(),
+            ['{' . self::NS_CALDAV . '}calendar-availability']
+        );
+
+        $vcalendar = new VCalendar();
+        $vcalendar->METHOD = 'REPLY';
+
+        $generator = new FreeBusyGenerator();
+        $generator->setObjects($objects);
+        $generator->setTimeRange($start, $end);
+        $generator->setBaseObject($vcalendar);
+        $generator->setTimeZone($calendarTimeZone);
+
+        if (isset($inboxProps['{' . self::NS_CALDAV . '}calendar-availability'])) {
+            $generator->setVAvailability(
+                Reader::read(
+                    $inboxProps['{' . self::NS_CALDAV . '}calendar-availability']
+                )
+            );
+        }
+
+        $result = $generator->getResult();
+        if (!isset($result->VFREEBUSY)) {
+            return false;
+        }
+
+        /** @var Component $freeBusyComponent */
+        $freeBusyComponent = $result->VFREEBUSY;
+        $freeBusyProperties = $freeBusyComponent->select('FREEBUSY');
+        // If there is no Free-busy property at all, the time-range is empty and available
+        if (count($freeBusyProperties) === 0) {
+            return true;
+        }
+
+        // If more than one Free-Busy property was returned, it means that an event
+        // starts or ends inside this time-range, so it's not available and we return false
+        if (count($freeBusyProperties) > 1) {
+            return false;
+        }
+
+        /** @var Property $freeBusyProperty */
+        $freeBusyProperty = $freeBusyProperties[0];
+        if (!$freeBusyProperty->offsetExists('FBTYPE')) {
+            // If there is no FBTYPE, it means it's busy
+            return false;
+        }
+
+        $fbTypeParameter = $freeBusyProperty->offsetGet('FBTYPE');
+        if (!($fbTypeParameter instanceof Parameter)) {
+            return false;
+        }
+
+        return (strcasecmp($fbTypeParameter->getValue(), 'FREE') === 0);
+    }
+
+    /**
+     * @param string $email
+     * @return string
+     */
+    private function stripOffMailTo(string $email): string {
+        if (stripos($email, 'mailto:') === 0) {
+            return substr($email, 7);
+        }
+
+        return $email;
+    }
+
+    private function getCalendar(CalendarHome $calendarHome, string $uri): INode {
+        return $calendarHome->getChild($uri);
+    }
+
+    private function isCalendarDeleted(CalendarHome $calendarHome, string $uri): bool {
+        $calendar = $this->getCalendar($calendarHome, $uri);
+        return $calendar instanceof Calendar && $calendar->isDeleted();
+    }
+
+    private function createCalendar(CalendarHome $calendarHome, string $principalUri, string $uri, string $displayName): void {
+        $calendarHome->getCalDAVBackend()->createCalendar($principalUri, $uri, [
+            '{DAV:}displayname' => $displayName,
+        ]);
+    }
+
+    private function moveCalendar(CalDavBackend $calDavBackend, string $principalUri, string $oldUri, string $newUri): void {
+        $calDavBackend->moveCalendar($oldUri, $principalUri, $principalUri, $newUri);
+    }
+
+    /**
+     * Try to handle the given exception gracefully or throw it if necessary.
+     *
+     * @throws SameOrganizerForAllComponentsException If the exception should not be ignored
+     */
+    private function handleSameOrganizerException(
+        SameOrganizerForAllComponentsException $e,
+        VCalendar $vCal,
+        string $calendarPath,
+    ): void {
+        // This is very hacky! However, we want to allow saving events with multiple
+        // organizers. Those events are not RFC compliant, but sometimes imported from major
+        // external calendar services (e.g. Google). If the current user is not an organizer of
+        // the event we ignore the exception as no scheduling messages will be sent anyway.
+
+        // It would be cleaner to patch Sabre to validate organizers *after* checking if
+        // scheduling messages are necessary. Currently, organizers are validated first and
+        // afterwards the broker checks if messages should be scheduled. So the code will throw
+        // even if the organizers are not relevant. This is to ensure compliance with RFCs but
+        // a bit too strict for real world usage.
+
+        if (!isset($vCal->VEVENT)) {
+            throw $e;
+        }
+
+        $calendarNode = $this->server->tree->getNodeForPath($calendarPath);
+        if (!($calendarNode instanceof IACL)) {
+            // Should always be an instance of IACL but just to be sure
+            throw $e;
+        }
+
+        $addresses = $this->getAddressesForPrincipal($calendarNode->getOwner());
+        foreach ($vCal->VEVENT as $vevent) {
+            if (in_array($vevent->ORGANIZER->getNormalizedValue(), $addresses, true)) {
+                // User is an organizer => throw the exception
+                throw $e;
+            }
+        }
+    }
 }

apps/dav/lib/CalDAV/CalendarImpl.php

Indentation +303 added lines, -303 removed lines

@@ -33,308 +33,308 @@
 use function Sabre\Uri\split as uriSplit;
 
 class CalendarImpl implements ICreateFromString, IHandleImipMessage, ICalendarIsWritable, ICalendarIsShared, ICalendarExport, ICalendarIsEnabled {
-	public function __construct(
-		private Calendar $calendar,
-		/** @var array<string, mixed> */
-		private array $calendarInfo,
-		private CalDavBackend $backend,
-	) {
-	}
-
-	private const DAV_PROPERTY_USER_ADDRESS = '{http://sabredav.org/ns}email-address';
-	private const DAV_PROPERTY_USER_ADDRESSES = '{urn:ietf:params:xml:ns:caldav}calendar-user-address-set';
-
-	/**
-	 * @return string defining the technical unique key
-	 * @since 13.0.0
-	 */
-	public function getKey(): string {
-		return (string)$this->calendarInfo['id'];
-	}
-
-	/**
-	 * {@inheritDoc}
-	 */
-	public function getUri(): string {
-		return $this->calendarInfo['uri'];
-	}
-
-	/**
-	 * @return string the principal URI of the calendar owner
-	 * @since 32.0.0
-	 */
-	public function getPrincipalUri(): string {
-		return $this->calendarInfo['principaluri'];
-	}
-
-	/**
-	 * In comparison to getKey() this function returns a human readable (maybe translated) name
-	 * @since 13.0.0
-	 */
-	public function getDisplayName(): ?string {
-		return $this->calendarInfo['{DAV:}displayname'];
-	}
-
-	/**
-	 * Calendar color
-	 * @since 13.0.0
-	 */
-	public function getDisplayColor(): ?string {
-		return $this->calendarInfo['{http://apple.com/ns/ical/}calendar-color'];
-	}
-
-	public function getSchedulingTransparency(): ?ScheduleCalendarTransp {
-		return $this->calendarInfo['{' . \OCA\DAV\CalDAV\Schedule\Plugin::NS_CALDAV . '}schedule-calendar-transp'];
-	}
-
-	public function getSchedulingTimezone(): ?VTimeZone {
-		$tzProp = '{' . \OCA\DAV\CalDAV\Schedule\Plugin::NS_CALDAV . '}calendar-timezone';
-		if (!isset($this->calendarInfo[$tzProp])) {
-			return null;
-		}
-		// This property contains a VCALENDAR with a single VTIMEZONE
-		/** @var string $timezoneProp */
-		$timezoneProp = $this->calendarInfo[$tzProp];
-		/** @var VCalendar $vobj */
-		$vobj = Reader::read($timezoneProp);
-		$components = $vobj->getComponents();
-		if (empty($components)) {
-			return null;
-		}
-		/** @var VTimeZone $vtimezone */
-		$vtimezone = $components[0];
-		return $vtimezone;
-	}
-
-	public function search(string $pattern, array $searchProperties = [], array $options = [], $limit = null, $offset = null): array {
-		return $this->backend->search($this->calendarInfo, $pattern,
-			$searchProperties, $options, $limit, $offset);
-	}
-
-	/**
-	 * @return int build up using \OCP\Constants
-	 * @since 13.0.0
-	 */
-	public function getPermissions(): int {
-		$permissions = $this->calendar->getACL();
-		$result = 0;
-		foreach ($permissions as $permission) {
-			if ($this->calendarInfo['principaluri'] !== $permission['principal']) {
-				continue;
-			}
-
-			switch ($permission['privilege']) {
-				case '{DAV:}read':
-					$result |= Constants::PERMISSION_READ;
-					break;
-				case '{DAV:}write':
-					$result |= Constants::PERMISSION_CREATE;
-					$result |= Constants::PERMISSION_UPDATE;
-					break;
-				case '{DAV:}all':
-					$result |= Constants::PERMISSION_ALL;
-					break;
-			}
-		}
-
-		return $result;
-	}
-
-	/**
-	 * @since 32.0.0
-	 */
-	public function isEnabled(): bool {
-		return $this->calendarInfo['{http://owncloud.org/ns}calendar-enabled'] ?? true;
-	}
-
-	/**
-	 * @since 31.0.0
-	 */
-	public function isWritable(): bool {
-		return $this->calendar->canWrite();
-	}
-
-	/**
-	 * @since 26.0.0
-	 */
-	public function isDeleted(): bool {
-		return $this->calendar->isDeleted();
-	}
-
-	/**
-	 * @since 31.0.0
-	 */
-	public function isShared(): bool {
-		return $this->calendar->isShared();
-	}
-
-	/**
-	 * @throws CalendarException
-	 */
-	private function createFromStringInServer(
-		string $name,
-		string $calendarData,
-		Server $server,
-	): void {
-		/** @var CustomPrincipalPlugin $plugin */
-		$plugin = $server->getPlugin('auth');
-		// we're working around the previous implementation
-		// that only allowed the public system principal to be used
-		// so set the custom principal here
-		$plugin->setCurrentPrincipal($this->calendar->getPrincipalURI());
-
-		if (empty($this->calendarInfo['uri'])) {
-			throw new CalendarException('Could not write to calendar as URI parameter is missing');
-		}
-
-		// Build full calendar path
-		[, $user] = uriSplit($this->calendar->getPrincipalURI());
-		$fullCalendarFilename = sprintf('calendars/%s/%s/%s', $user, $this->calendarInfo['uri'], $name);
-
-		// Force calendar change URI
-		/** @var Schedule\Plugin $schedulingPlugin */
-		$schedulingPlugin = $server->getPlugin('caldav-schedule');
-		$schedulingPlugin->setPathOfCalendarObjectChange($fullCalendarFilename);
-
-		$stream = fopen('php://memory', 'rb+');
-		fwrite($stream, $calendarData);
-		rewind($stream);
-		try {
-			$server->createFile($fullCalendarFilename, $stream);
-		} catch (Conflict $e) {
-			throw new CalendarException('Could not create new calendar event: ' . $e->getMessage(), 0, $e);
-		} finally {
-			fclose($stream);
-		}
-	}
-
-	public function createFromString(string $name, string $calendarData): void {
-		$server = new EmbeddedCalDavServer(false);
-		$this->createFromStringInServer($name, $calendarData, $server->getServer());
-	}
-
-	public function createFromStringMinimal(string $name, string $calendarData): void {
-		$server = new InvitationResponseServer(false);
-		$this->createFromStringInServer($name, $calendarData, $server->getServer());
-	}
-
-	/**
-	 * @throws CalendarException
-	 */
-	public function handleIMipMessage(string $name, string $calendarData): void {
-
-		try {
-			/** @var VCalendar $vObject|null */
-			$vObject = Reader::read($calendarData);
-		} catch (ParseException $e) {
-			throw new CalendarException('iMip message could not be processed because an error occurred while parsing the iMip message', 0, $e);
-		}
-		// validate the iMip message
-		if (!isset($vObject->METHOD)) {
-			throw new CalendarException('iMip message contains no valid method');
-		}
-		if (!isset($vObject->VEVENT)) {
-			throw new CalendarException('iMip message contains no event');
-		}
-		if (!isset($vObject->VEVENT->UID)) {
-			throw new CalendarException('iMip message event dose not contain a UID');
-		}
-		if (!isset($vObject->VEVENT->ORGANIZER)) {
-			throw new CalendarException('iMip message event dose not contain an organizer');
-		}
-		if (!isset($vObject->VEVENT->ATTENDEE)) {
-			throw new CalendarException('iMip message event dose not contain an attendee');
-		}
-		if (empty($this->calendarInfo['uri'])) {
-			throw new CalendarException('Could not write to calendar as URI parameter is missing');
-		}
-		// construct dav server
-		$server = $this->getInvitationResponseServer();
-		/** @var CustomPrincipalPlugin $authPlugin */
-		$authPlugin = $server->getServer()->getPlugin('auth');
-		// we're working around the previous implementation
-		// that only allowed the public system principal to be used
-		// so set the custom principal here
-		$authPlugin->setCurrentPrincipal($this->calendar->getPrincipalURI());
-		// retrieve all users addresses
-		$userProperties = $server->getServer()->getProperties($this->calendar->getPrincipalURI(), [ self::DAV_PROPERTY_USER_ADDRESS, self::DAV_PROPERTY_USER_ADDRESSES ]);
-		$userAddress = 'mailto:' . ($userProperties[self::DAV_PROPERTY_USER_ADDRESS] ?? null);
-		$userAddresses = $userProperties[self::DAV_PROPERTY_USER_ADDRESSES]->getHrefs() ?? [];
-		$userAddresses = array_map('strtolower', array_map('urldecode', $userAddresses));
-		// validate the method, recipient and sender
-		$imipMethod = strtoupper($vObject->METHOD->getValue());
-		if (in_array($imipMethod, ['REPLY', 'REFRESH'], true)) {
-			// extract sender (REPLY and REFRESH method should only have one attendee)
-			$sender = strtolower($vObject->VEVENT->ATTENDEE->getValue());
-			// extract and verify the recipient
-			$recipient = strtolower($vObject->VEVENT->ORGANIZER->getValue());
-			if (!in_array($recipient, $userAddresses, true)) {
-				throw new CalendarException('iMip message dose not contain an organizer that matches the user');
-			}
-			// if the recipient address is not the same as the user address this means an alias was used
-			// the iTip broker uses the users primary email address during processing
-			if ($userAddress !== $recipient) {
-				$recipient = $userAddress;
-			}
-		} elseif (in_array($imipMethod, ['PUBLISH', 'REQUEST', 'ADD', 'CANCEL'], true)) {
-			// extract sender
-			$sender = strtolower($vObject->VEVENT->ORGANIZER->getValue());
-			// extract and verify the recipient
-			foreach ($vObject->VEVENT->ATTENDEE as $attendee) {
-				$recipient = strtolower($attendee->getValue());
-				if (in_array($recipient, $userAddresses, true)) {
-					break;
-				}
-				$recipient = null;
-			}
-			if ($recipient === null) {
-				throw new CalendarException('iMip message dose not contain an attendee that matches the user');
-			}
-			// if the recipient address is not the same as the user address this means an alias was used
-			// the iTip broker uses the users primary email address during processing
-			if ($userAddress !== $recipient) {
-				$recipient = $userAddress;
-			}
-		} else {
-			throw new CalendarException('iMip message contains a method that is not supported: ' . $imipMethod);
-		}
-		// generate the iTip message
-		$iTip = new Message();
-		$iTip->method = $imipMethod;
-		$iTip->sender = $sender;
-		$iTip->recipient = $recipient;
-		$iTip->component = 'VEVENT';
-		$iTip->uid = $vObject->VEVENT->UID->getValue();
-		$iTip->sequence = isset($vObject->VEVENT->SEQUENCE) ? (int)$vObject->VEVENT->SEQUENCE->getValue() : 1;
-		$iTip->message = $vObject;
-
-		$server->server->emit('schedule', [$iTip]);
-	}
-
-	public function getInvitationResponseServer(): InvitationResponseServer {
-		return new InvitationResponseServer(false);
-	}
-
-	/**
-	 * Export objects
-	 *
-	 * @since 32.0.0
-	 *
-	 * @return Generator<mixed, \Sabre\VObject\Component\VCalendar, mixed, mixed>
-	 */
-	public function export(?CalendarExportOptions $options = null): Generator {
-		foreach (
-			$this->backend->exportCalendar(
-				$this->calendarInfo['id'],
-				$this->backend::CALENDAR_TYPE_CALENDAR,
-				$options
-			) as $event
-		) {
-			$vObject = Reader::read($event['calendardata']);
-			if ($vObject instanceof VCalendar) {
-				yield $vObject;
-			}
-		}
-	}
+    public function __construct(
+        private Calendar $calendar,
+        /** @var array<string, mixed> */
+        private array $calendarInfo,
+        private CalDavBackend $backend,
+    ) {
+    }
+
+    private const DAV_PROPERTY_USER_ADDRESS = '{http://sabredav.org/ns}email-address';
+    private const DAV_PROPERTY_USER_ADDRESSES = '{urn:ietf:params:xml:ns:caldav}calendar-user-address-set';
+
+    /**
+     * @return string defining the technical unique key
+     * @since 13.0.0
+     */
+    public function getKey(): string {
+        return (string)$this->calendarInfo['id'];
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function getUri(): string {
+        return $this->calendarInfo['uri'];
+    }
+
+    /**
+     * @return string the principal URI of the calendar owner
+     * @since 32.0.0
+     */
+    public function getPrincipalUri(): string {
+        return $this->calendarInfo['principaluri'];
+    }
+
+    /**
+     * In comparison to getKey() this function returns a human readable (maybe translated) name
+     * @since 13.0.0
+     */
+    public function getDisplayName(): ?string {
+        return $this->calendarInfo['{DAV:}displayname'];
+    }
+
+    /**
+     * Calendar color
+     * @since 13.0.0
+     */
+    public function getDisplayColor(): ?string {
+        return $this->calendarInfo['{http://apple.com/ns/ical/}calendar-color'];
+    }
+
+    public function getSchedulingTransparency(): ?ScheduleCalendarTransp {
+        return $this->calendarInfo['{' . \OCA\DAV\CalDAV\Schedule\Plugin::NS_CALDAV . '}schedule-calendar-transp'];
+    }
+
+    public function getSchedulingTimezone(): ?VTimeZone {
+        $tzProp = '{' . \OCA\DAV\CalDAV\Schedule\Plugin::NS_CALDAV . '}calendar-timezone';
+        if (!isset($this->calendarInfo[$tzProp])) {
+            return null;
+        }
+        // This property contains a VCALENDAR with a single VTIMEZONE
+        /** @var string $timezoneProp */
+        $timezoneProp = $this->calendarInfo[$tzProp];
+        /** @var VCalendar $vobj */
+        $vobj = Reader::read($timezoneProp);
+        $components = $vobj->getComponents();
+        if (empty($components)) {
+            return null;
+        }
+        /** @var VTimeZone $vtimezone */
+        $vtimezone = $components[0];
+        return $vtimezone;
+    }
+
+    public function search(string $pattern, array $searchProperties = [], array $options = [], $limit = null, $offset = null): array {
+        return $this->backend->search($this->calendarInfo, $pattern,
+            $searchProperties, $options, $limit, $offset);
+    }
+
+    /**
+     * @return int build up using \OCP\Constants
+     * @since 13.0.0
+     */
+    public function getPermissions(): int {
+        $permissions = $this->calendar->getACL();
+        $result = 0;
+        foreach ($permissions as $permission) {
+            if ($this->calendarInfo['principaluri'] !== $permission['principal']) {
+                continue;
+            }
+
+            switch ($permission['privilege']) {
+                case '{DAV:}read':
+                    $result |= Constants::PERMISSION_READ;
+                    break;
+                case '{DAV:}write':
+                    $result |= Constants::PERMISSION_CREATE;
+                    $result |= Constants::PERMISSION_UPDATE;
+                    break;
+                case '{DAV:}all':
+                    $result |= Constants::PERMISSION_ALL;
+                    break;
+            }
+        }
+
+        return $result;
+    }
+
+    /**
+     * @since 32.0.0
+     */
+    public function isEnabled(): bool {
+        return $this->calendarInfo['{http://owncloud.org/ns}calendar-enabled'] ?? true;
+    }
+
+    /**
+     * @since 31.0.0
+     */
+    public function isWritable(): bool {
+        return $this->calendar->canWrite();
+    }
+
+    /**
+     * @since 26.0.0
+     */
+    public function isDeleted(): bool {
+        return $this->calendar->isDeleted();
+    }
+
+    /**
+     * @since 31.0.0
+     */
+    public function isShared(): bool {
+        return $this->calendar->isShared();
+    }
+
+    /**
+     * @throws CalendarException
+     */
+    private function createFromStringInServer(
+        string $name,
+        string $calendarData,
+        Server $server,
+    ): void {
+        /** @var CustomPrincipalPlugin $plugin */
+        $plugin = $server->getPlugin('auth');
+        // we're working around the previous implementation
+        // that only allowed the public system principal to be used
+        // so set the custom principal here
+        $plugin->setCurrentPrincipal($this->calendar->getPrincipalURI());
+
+        if (empty($this->calendarInfo['uri'])) {
+            throw new CalendarException('Could not write to calendar as URI parameter is missing');
+        }
+
+        // Build full calendar path
+        [, $user] = uriSplit($this->calendar->getPrincipalURI());
+        $fullCalendarFilename = sprintf('calendars/%s/%s/%s', $user, $this->calendarInfo['uri'], $name);
+
+        // Force calendar change URI
+        /** @var Schedule\Plugin $schedulingPlugin */
+        $schedulingPlugin = $server->getPlugin('caldav-schedule');
+        $schedulingPlugin->setPathOfCalendarObjectChange($fullCalendarFilename);
+
+        $stream = fopen('php://memory', 'rb+');
+        fwrite($stream, $calendarData);
+        rewind($stream);
+        try {
+            $server->createFile($fullCalendarFilename, $stream);
+        } catch (Conflict $e) {
+            throw new CalendarException('Could not create new calendar event: ' . $e->getMessage(), 0, $e);
+        } finally {
+            fclose($stream);
+        }
+    }
+
+    public function createFromString(string $name, string $calendarData): void {
+        $server = new EmbeddedCalDavServer(false);
+        $this->createFromStringInServer($name, $calendarData, $server->getServer());
+    }
+
+    public function createFromStringMinimal(string $name, string $calendarData): void {
+        $server = new InvitationResponseServer(false);
+        $this->createFromStringInServer($name, $calendarData, $server->getServer());
+    }
+
+    /**
+     * @throws CalendarException
+     */
+    public function handleIMipMessage(string $name, string $calendarData): void {
+
+        try {
+            /** @var VCalendar $vObject|null */
+            $vObject = Reader::read($calendarData);
+        } catch (ParseException $e) {
+            throw new CalendarException('iMip message could not be processed because an error occurred while parsing the iMip message', 0, $e);
+        }
+        // validate the iMip message
+        if (!isset($vObject->METHOD)) {
+            throw new CalendarException('iMip message contains no valid method');
+        }
+        if (!isset($vObject->VEVENT)) {
+            throw new CalendarException('iMip message contains no event');
+        }
+        if (!isset($vObject->VEVENT->UID)) {
+            throw new CalendarException('iMip message event dose not contain a UID');
+        }
+        if (!isset($vObject->VEVENT->ORGANIZER)) {
+            throw new CalendarException('iMip message event dose not contain an organizer');
+        }
+        if (!isset($vObject->VEVENT->ATTENDEE)) {
+            throw new CalendarException('iMip message event dose not contain an attendee');
+        }
+        if (empty($this->calendarInfo['uri'])) {
+            throw new CalendarException('Could not write to calendar as URI parameter is missing');
+        }
+        // construct dav server
+        $server = $this->getInvitationResponseServer();
+        /** @var CustomPrincipalPlugin $authPlugin */
+        $authPlugin = $server->getServer()->getPlugin('auth');
+        // we're working around the previous implementation
+        // that only allowed the public system principal to be used
+        // so set the custom principal here
+        $authPlugin->setCurrentPrincipal($this->calendar->getPrincipalURI());
+        // retrieve all users addresses
+        $userProperties = $server->getServer()->getProperties($this->calendar->getPrincipalURI(), [ self::DAV_PROPERTY_USER_ADDRESS, self::DAV_PROPERTY_USER_ADDRESSES ]);
+        $userAddress = 'mailto:' . ($userProperties[self::DAV_PROPERTY_USER_ADDRESS] ?? null);
+        $userAddresses = $userProperties[self::DAV_PROPERTY_USER_ADDRESSES]->getHrefs() ?? [];
+        $userAddresses = array_map('strtolower', array_map('urldecode', $userAddresses));
+        // validate the method, recipient and sender
+        $imipMethod = strtoupper($vObject->METHOD->getValue());
+        if (in_array($imipMethod, ['REPLY', 'REFRESH'], true)) {
+            // extract sender (REPLY and REFRESH method should only have one attendee)
+            $sender = strtolower($vObject->VEVENT->ATTENDEE->getValue());
+            // extract and verify the recipient
+            $recipient = strtolower($vObject->VEVENT->ORGANIZER->getValue());
+            if (!in_array($recipient, $userAddresses, true)) {
+                throw new CalendarException('iMip message dose not contain an organizer that matches the user');
+            }
+            // if the recipient address is not the same as the user address this means an alias was used
+            // the iTip broker uses the users primary email address during processing
+            if ($userAddress !== $recipient) {
+                $recipient = $userAddress;
+            }
+        } elseif (in_array($imipMethod, ['PUBLISH', 'REQUEST', 'ADD', 'CANCEL'], true)) {
+            // extract sender
+            $sender = strtolower($vObject->VEVENT->ORGANIZER->getValue());
+            // extract and verify the recipient
+            foreach ($vObject->VEVENT->ATTENDEE as $attendee) {
+                $recipient = strtolower($attendee->getValue());
+                if (in_array($recipient, $userAddresses, true)) {
+                    break;
+                }
+                $recipient = null;
+            }
+            if ($recipient === null) {
+                throw new CalendarException('iMip message dose not contain an attendee that matches the user');
+            }
+            // if the recipient address is not the same as the user address this means an alias was used
+            // the iTip broker uses the users primary email address during processing
+            if ($userAddress !== $recipient) {
+                $recipient = $userAddress;
+            }
+        } else {
+            throw new CalendarException('iMip message contains a method that is not supported: ' . $imipMethod);
+        }
+        // generate the iTip message
+        $iTip = new Message();
+        $iTip->method = $imipMethod;
+        $iTip->sender = $sender;
+        $iTip->recipient = $recipient;
+        $iTip->component = 'VEVENT';
+        $iTip->uid = $vObject->VEVENT->UID->getValue();
+        $iTip->sequence = isset($vObject->VEVENT->SEQUENCE) ? (int)$vObject->VEVENT->SEQUENCE->getValue() : 1;
+        $iTip->message = $vObject;
+
+        $server->server->emit('schedule', [$iTip]);
+    }
+
+    public function getInvitationResponseServer(): InvitationResponseServer {
+        return new InvitationResponseServer(false);
+    }
+
+    /**
+     * Export objects
+     *
+     * @since 32.0.0
+     *
+     * @return Generator<mixed, \Sabre\VObject\Component\VCalendar, mixed, mixed>
+     */
+    public function export(?CalendarExportOptions $options = null): Generator {
+        foreach (
+            $this->backend->exportCalendar(
+                $this->calendarInfo['id'],
+                $this->backend::CALENDAR_TYPE_CALENDAR,
+                $options
+            ) as $event
+        ) {
+            $vObject = Reader::read($event['calendardata']);
+            if ($vObject instanceof VCalendar) {
+                yield $vObject;
+            }
+        }
+    }
 
 }

Spacing +8 added lines, -8 removed lines

@@ -49,7 +49,7 @@ 
 	 * @since 13.0.0
 	 */
 	public function getKey(): string {
-		return (string)$this->calendarInfo['id'];
+		return (string) $this->calendarInfo['id'];
 	}
 
 	/**
@@ -84,11 +84,11 @@ 
 	}
 
 	public function getSchedulingTransparency(): ?ScheduleCalendarTransp {
-		return $this->calendarInfo['{' . \OCA\DAV\CalDAV\Schedule\Plugin::NS_CALDAV . '}schedule-calendar-transp'];
+		return $this->calendarInfo['{'.\OCA\DAV\CalDAV\Schedule\Plugin::NS_CALDAV.'}schedule-calendar-transp'];
 	}
 
 	public function getSchedulingTimezone(): ?VTimeZone {
-		$tzProp = '{' . \OCA\DAV\CalDAV\Schedule\Plugin::NS_CALDAV . '}calendar-timezone';
+		$tzProp = '{'.\OCA\DAV\CalDAV\Schedule\Plugin::NS_CALDAV.'}calendar-timezone';
 		if (!isset($this->calendarInfo[$tzProp])) {
 			return null;
 		}
@@ -202,7 +202,7 @@ 
 		try {
 			$server->createFile($fullCalendarFilename, $stream);
 		} catch (Conflict $e) {
-			throw new CalendarException('Could not create new calendar event: ' . $e->getMessage(), 0, $e);
+			throw new CalendarException('Could not create new calendar event: '.$e->getMessage(), 0, $e);
 		} finally {
 			fclose($stream);
 		}
@@ -257,8 +257,8 @@ 
 		// so set the custom principal here
 		$authPlugin->setCurrentPrincipal($this->calendar->getPrincipalURI());
 		// retrieve all users addresses
-		$userProperties = $server->getServer()->getProperties($this->calendar->getPrincipalURI(), [ self::DAV_PROPERTY_USER_ADDRESS, self::DAV_PROPERTY_USER_ADDRESSES ]);
-		$userAddress = 'mailto:' . ($userProperties[self::DAV_PROPERTY_USER_ADDRESS] ?? null);
+		$userProperties = $server->getServer()->getProperties($this->calendar->getPrincipalURI(), [self::DAV_PROPERTY_USER_ADDRESS, self::DAV_PROPERTY_USER_ADDRESSES]);
+		$userAddress = 'mailto:'.($userProperties[self::DAV_PROPERTY_USER_ADDRESS] ?? null);
 		$userAddresses = $userProperties[self::DAV_PROPERTY_USER_ADDRESSES]->getHrefs() ?? [];
 		$userAddresses = array_map('strtolower', array_map('urldecode', $userAddresses));
 		// validate the method, recipient and sender
@@ -296,7 +296,7 @@ 
 				$recipient = $userAddress;
 			}
 		} else {
-			throw new CalendarException('iMip message contains a method that is not supported: ' . $imipMethod);
+			throw new CalendarException('iMip message contains a method that is not supported: '.$imipMethod);
 		}
 		// generate the iTip message
 		$iTip = new Message();
@@ -305,7 +305,7 @@ 
 		$iTip->recipient = $recipient;
 		$iTip->component = 'VEVENT';
 		$iTip->uid = $vObject->VEVENT->UID->getValue();
-		$iTip->sequence = isset($vObject->VEVENT->SEQUENCE) ? (int)$vObject->VEVENT->SEQUENCE->getValue() : 1;
+		$iTip->sequence = isset($vObject->VEVENT->SEQUENCE) ? (int) $vObject->VEVENT->SEQUENCE->getValue() : 1;
 		$iTip->message = $vObject;
 
 		$server->server->emit('schedule', [$iTip]);

apps/dav/tests/unit/CalDAV/CalendarImplTest.php

Indentation +246 added lines, -246 removed lines

@@ -20,251 +20,251 @@
 use Sabre\VObject\ITip\Message;
 
 class CalendarImplTest extends \Test\TestCase {
-	private CalDavBackend|MockObject $backend;
-	private Calendar|MockObject $calendar;
-	private CalendarImpl|MockObject $calendarImpl;
-	private array $calendarInfo;
-	private VCalendar $vCalendar1a;
-	private array $mockExportCollection;
-
-	protected function setUp(): void {
-		parent::setUp();
-
-		$this->backend = $this->createMock(CalDavBackend::class);
-		$this->calendar = $this->createMock(Calendar::class);
-		$this->calendarInfo = [
-			'id' => 'fancy_id_123',
-			'{DAV:}displayname' => 'user readable name 123',
-			'{http://apple.com/ns/ical/}calendar-color' => '#AABBCC',
-			'uri' => '/this/is/a/uri',
-			'principaluri' => 'principal/users/foobar'
-		];
-		$this->calendarImpl = new CalendarImpl($this->calendar, $this->calendarInfo, $this->backend);
-
-		// construct calendar with a 1 hour event and same start/end time zones
-		$this->vCalendar1a = new VCalendar();
-		/** @var VEvent $vEvent */
-		$vEvent = $this->vCalendar1a->add('VEVENT', []);
-		$vEvent->UID->setValue('96a0e6b1-d886-4a55-a60d-152b31401dcc');
-		$vEvent->add('DTSTART', '20240701T080000', ['TZID' => 'America/Toronto']);
-		$vEvent->add('DTEND', '20240701T090000', ['TZID' => 'America/Toronto']);
-		$vEvent->add('SEQUENCE', 1);
-		$vEvent->add('SUMMARY', 'Test Event');
-		$vEvent->add('ORGANIZER', 'mailto:organizer@testing.com', ['CN' => 'Organizer']);
-		$vEvent->add('ATTENDEE', 'mailto:attendee1@testing.com', [
-			'CN' => 'Attendee One',
-			'CUTYPE' => 'INDIVIDUAL',
-			'PARTSTAT' => 'NEEDS-ACTION',
-			'ROLE' => 'REQ-PARTICIPANT',
-			'RSVP' => 'TRUE'
-		]);
-	}
-
-
-	public function testGetKey(): void {
-		$this->assertEquals($this->calendarImpl->getKey(), 'fancy_id_123');
-	}
-
-	public function testGetDisplayname(): void {
-		$this->assertEquals($this->calendarImpl->getDisplayName(), 'user readable name 123');
-	}
-
-	public function testGetDisplayColor(): void {
-		$this->assertEquals($this->calendarImpl->getDisplayColor(), '#AABBCC');
-	}
-
-	public function testSearch(): void {
-		$this->backend->expects($this->once())
-			->method('search')
-			->with($this->calendarInfo, 'abc', ['def'], ['ghi'], 42, 1337)
-			->willReturn(['SEARCHRESULTS']);
-
-		$result = $this->calendarImpl->search('abc', ['def'], ['ghi'], 42, 1337);
-		$this->assertEquals($result, ['SEARCHRESULTS']);
-	}
-
-	public function testGetPermissionRead(): void {
-		$this->calendar->expects($this->once())
-			->method('getACL')
-			->with()
-			->willReturn([
-				['privilege' => '{DAV:}read', 'principal' => 'principal/users/foobar'],
-				['privilege' => '{DAV:}read', 'principal' => 'principal/users/other'],
-				['privilege' => '{DAV:}write', 'principal' => 'principal/users/other'],
-				['privilege' => '{DAV:}all', 'principal' => 'principal/users/other'],
-			]);
-
-		$this->assertEquals(1, $this->calendarImpl->getPermissions());
-	}
-
-	public function testGetPermissionWrite(): void {
-		$this->calendar->expects($this->once())
-			->method('getACL')
-			->with()
-			->willReturn([
-				['privilege' => '{DAV:}write', 'principal' => 'principal/users/foobar'],
-				['privilege' => '{DAV:}read', 'principal' => 'principal/users/other'],
-				['privilege' => '{DAV:}all', 'principal' => 'principal/users/other'],
-			]);
-
-		$this->assertEquals(6, $this->calendarImpl->getPermissions());
-	}
-
-	public function testGetPermissionReadWrite(): void {
-		$this->calendar->expects($this->once())
-			->method('getACL')
-			->with()
-			->willReturn([
-				['privilege' => '{DAV:}write', 'principal' => 'principal/users/foobar'],
-				['privilege' => '{DAV:}read', 'principal' => 'principal/users/foobar'],
-				['privilege' => '{DAV:}all', 'principal' => 'principal/users/other'],
-			]);
-
-		$this->assertEquals(7, $this->calendarImpl->getPermissions());
-	}
-
-	public function testGetPermissionAll(): void {
-		$this->calendar->expects($this->once())
-			->method('getACL')
-			->with()
-			->willReturn([
-				['privilege' => '{DAV:}all', 'principal' => 'principal/users/foobar'],
-			]);
-
-		$this->assertEquals(31, $this->calendarImpl->getPermissions());
-	}
-
-	public function testHandleImipNoMethod(): void {
-		// Arrange
-		$vObject = $this->vCalendar1a;
-
-		$this->expectException(CalendarException::class);
-		$this->expectExceptionMessage('iMip message contains no valid method');
-
-		// Act
-		$this->calendarImpl->handleIMipMessage('fakeUser', $vObject->serialize());
-	}
-
-	public function testHandleImipNoEvent(): void {
-		// Arrange
-		$vObject = $this->vCalendar1a;
-		$vObject->add('METHOD', 'REQUEST');
-		$vObject->remove('VEVENT');
-
-		$this->expectException(CalendarException::class);
-		$this->expectExceptionMessage('iMip message contains no event');
-
-		// Act
-		$this->calendarImpl->handleIMipMessage('fakeUser', $vObject->serialize());
-	}
-
-	public function testHandleImipNoUid(): void {
-		// Arrange
-		$vObject = $this->vCalendar1a;
-		$vObject->add('METHOD', 'REQUEST');
-		$vObject->VEVENT->remove('UID');
-
-		$this->expectException(CalendarException::class);
-		$this->expectExceptionMessage('iMip message event dose not contain a UID');
-
-		// Act
-		$this->calendarImpl->handleIMipMessage('fakeUser', $vObject->serialize());
-	}
-
-	public function testHandleImipNoOrganizer(): void {
-		// Arrange
-		$vObject = $this->vCalendar1a;
-		$vObject->add('METHOD', 'REQUEST');
-		$vObject->VEVENT->remove('ORGANIZER');
-
-		$this->expectException(CalendarException::class);
-		$this->expectExceptionMessage('iMip message event dose not contain an organizer');
-
-		// Act
-		$this->calendarImpl->handleIMipMessage('fakeUser', $vObject->serialize());
-	}
-
-	public function testHandleImipNoAttendee(): void {
-		// Arrange
-		$vObject = $this->vCalendar1a;
-		$vObject->add('METHOD', 'REQUEST');
-		$vObject->VEVENT->remove('ATTENDEE');
-
-		$this->expectException(CalendarException::class);
-		$this->expectExceptionMessage('iMip message event dose not contain an attendee');
-
-		// Act
-		$this->calendarImpl->handleIMipMessage('fakeUser', $vObject->serialize());
-	}
-
-	public function testHandleImipRequest(): void {
-		$userAddressSet = new class([ 'mailto:attendee1@testing.com', '/remote.php/dav/principals/users/attendee1/', ]) {
-			public function __construct(
-				private array $hrefs,
-			) {
-			}
-			public function getHrefs(): array {
-				return $this->hrefs;
-			}
-		};
-
-		$vObject = $this->vCalendar1a;
-		$vObject->add('METHOD', 'REQUEST');
-
-		$iTip = new Message();
-		$iTip->method = 'REQUEST';
-		$iTip->sender = $vObject->VEVENT->ORGANIZER->getValue();
-		$iTip->recipient = $vObject->VEVENT->ATTENDEE->getValue();
-		$iTip->component = 'VEVENT';
-		$iTip->uid = $vObject->VEVENT->UID->getValue();
-		$iTip->sequence = (int)$vObject->VEVENT->SEQUENCE->getValue() ?? 0;
-		$iTip->message = $vObject;
-
-		/** @var CustomPrincipalPlugin|MockObject $authPlugin */
-		$authPlugin = $this->createMock(CustomPrincipalPlugin::class);
-		$authPlugin->expects(self::once())
-			->method('setCurrentPrincipal')
-			->with($this->calendar->getPrincipalURI());
-		/** @var \Sabre\DAVACL\Plugin|MockObject $aclPlugin */
-		$aclPlugin = $this->createMock(\Sabre\DAVACL\Plugin::class);
-
-		$server = $this->createMock(Server::class);
-		$server->expects($this->any())
-			->method('getPlugin')
-			->willReturnMap([
-				['auth', $authPlugin],
-				['acl', $aclPlugin],
-			]);
-
-		$server->expects(self::once())
-			->method('getProperties')
-			->with(
-				$this->calendar->getPrincipalURI(),
-				[
-					'{http://sabredav.org/ns}email-address',
-					'{urn:ietf:params:xml:ns:caldav}calendar-user-address-set'
-				]
-			)
-			->willReturn([
-				'{http://sabredav.org/ns}email-address' => 'attendee1@testing.com',
-				'{urn:ietf:params:xml:ns:caldav}calendar-user-address-set' => $userAddressSet,
-			]);
-		$server->expects(self::once())
-			->method('emit');
-		$invitationResponseServer = $this->createMock(InvitationResponseServer::class, ['getServer']);
-		$invitationResponseServer->server = $server;
-		$invitationResponseServer->expects($this->any())
-			->method('getServer')
-			->willReturn($server);
-		$calendarImpl = $this->getMockBuilder(CalendarImpl::class)
-			->setConstructorArgs([$this->calendar, $this->calendarInfo, $this->backend])
-			->onlyMethods(['getInvitationResponseServer'])
-			->getMock();
-		$calendarImpl->expects($this->once())
-			->method('getInvitationResponseServer')
-			->willReturn($invitationResponseServer);
-
-		$calendarImpl->handleIMipMessage('fakeUser', $vObject->serialize());
-	}
+    private CalDavBackend|MockObject $backend;
+    private Calendar|MockObject $calendar;
+    private CalendarImpl|MockObject $calendarImpl;
+    private array $calendarInfo;
+    private VCalendar $vCalendar1a;
+    private array $mockExportCollection;
+
+    protected function setUp(): void {
+        parent::setUp();
+
+        $this->backend = $this->createMock(CalDavBackend::class);
+        $this->calendar = $this->createMock(Calendar::class);
+        $this->calendarInfo = [
+            'id' => 'fancy_id_123',
+            '{DAV:}displayname' => 'user readable name 123',
+            '{http://apple.com/ns/ical/}calendar-color' => '#AABBCC',
+            'uri' => '/this/is/a/uri',
+            'principaluri' => 'principal/users/foobar'
+        ];
+        $this->calendarImpl = new CalendarImpl($this->calendar, $this->calendarInfo, $this->backend);
+
+        // construct calendar with a 1 hour event and same start/end time zones
+        $this->vCalendar1a = new VCalendar();
+        /** @var VEvent $vEvent */
+        $vEvent = $this->vCalendar1a->add('VEVENT', []);
+        $vEvent->UID->setValue('96a0e6b1-d886-4a55-a60d-152b31401dcc');
+        $vEvent->add('DTSTART', '20240701T080000', ['TZID' => 'America/Toronto']);
+        $vEvent->add('DTEND', '20240701T090000', ['TZID' => 'America/Toronto']);
+        $vEvent->add('SEQUENCE', 1);
+        $vEvent->add('SUMMARY', 'Test Event');
+        $vEvent->add('ORGANIZER', 'mailto:organizer@testing.com', ['CN' => 'Organizer']);
+        $vEvent->add('ATTENDEE', 'mailto:attendee1@testing.com', [
+            'CN' => 'Attendee One',
+            'CUTYPE' => 'INDIVIDUAL',
+            'PARTSTAT' => 'NEEDS-ACTION',
+            'ROLE' => 'REQ-PARTICIPANT',
+            'RSVP' => 'TRUE'
+        ]);
+    }
+
+
+    public function testGetKey(): void {
+        $this->assertEquals($this->calendarImpl->getKey(), 'fancy_id_123');
+    }
+
+    public function testGetDisplayname(): void {
+        $this->assertEquals($this->calendarImpl->getDisplayName(), 'user readable name 123');
+    }
+
+    public function testGetDisplayColor(): void {
+        $this->assertEquals($this->calendarImpl->getDisplayColor(), '#AABBCC');
+    }
+
+    public function testSearch(): void {
+        $this->backend->expects($this->once())
+            ->method('search')
+            ->with($this->calendarInfo, 'abc', ['def'], ['ghi'], 42, 1337)
+            ->willReturn(['SEARCHRESULTS']);
+
+        $result = $this->calendarImpl->search('abc', ['def'], ['ghi'], 42, 1337);
+        $this->assertEquals($result, ['SEARCHRESULTS']);
+    }
+
+    public function testGetPermissionRead(): void {
+        $this->calendar->expects($this->once())
+            ->method('getACL')
+            ->with()
+            ->willReturn([
+                ['privilege' => '{DAV:}read', 'principal' => 'principal/users/foobar'],
+                ['privilege' => '{DAV:}read', 'principal' => 'principal/users/other'],
+                ['privilege' => '{DAV:}write', 'principal' => 'principal/users/other'],
+                ['privilege' => '{DAV:}all', 'principal' => 'principal/users/other'],
+            ]);
+
+        $this->assertEquals(1, $this->calendarImpl->getPermissions());
+    }
+
+    public function testGetPermissionWrite(): void {
+        $this->calendar->expects($this->once())
+            ->method('getACL')
+            ->with()
+            ->willReturn([
+                ['privilege' => '{DAV:}write', 'principal' => 'principal/users/foobar'],
+                ['privilege' => '{DAV:}read', 'principal' => 'principal/users/other'],
+                ['privilege' => '{DAV:}all', 'principal' => 'principal/users/other'],
+            ]);
+
+        $this->assertEquals(6, $this->calendarImpl->getPermissions());
+    }
+
+    public function testGetPermissionReadWrite(): void {
+        $this->calendar->expects($this->once())
+            ->method('getACL')
+            ->with()
+            ->willReturn([
+                ['privilege' => '{DAV:}write', 'principal' => 'principal/users/foobar'],
+                ['privilege' => '{DAV:}read', 'principal' => 'principal/users/foobar'],
+                ['privilege' => '{DAV:}all', 'principal' => 'principal/users/other'],
+            ]);
+
+        $this->assertEquals(7, $this->calendarImpl->getPermissions());
+    }
+
+    public function testGetPermissionAll(): void {
+        $this->calendar->expects($this->once())
+            ->method('getACL')
+            ->with()
+            ->willReturn([
+                ['privilege' => '{DAV:}all', 'principal' => 'principal/users/foobar'],
+            ]);
+
+        $this->assertEquals(31, $this->calendarImpl->getPermissions());
+    }
+
+    public function testHandleImipNoMethod(): void {
+        // Arrange
+        $vObject = $this->vCalendar1a;
+
+        $this->expectException(CalendarException::class);
+        $this->expectExceptionMessage('iMip message contains no valid method');
+
+        // Act
+        $this->calendarImpl->handleIMipMessage('fakeUser', $vObject->serialize());
+    }
+
+    public function testHandleImipNoEvent(): void {
+        // Arrange
+        $vObject = $this->vCalendar1a;
+        $vObject->add('METHOD', 'REQUEST');
+        $vObject->remove('VEVENT');
+
+        $this->expectException(CalendarException::class);
+        $this->expectExceptionMessage('iMip message contains no event');
+
+        // Act
+        $this->calendarImpl->handleIMipMessage('fakeUser', $vObject->serialize());
+    }
+
+    public function testHandleImipNoUid(): void {
+        // Arrange
+        $vObject = $this->vCalendar1a;
+        $vObject->add('METHOD', 'REQUEST');
+        $vObject->VEVENT->remove('UID');
+
+        $this->expectException(CalendarException::class);
+        $this->expectExceptionMessage('iMip message event dose not contain a UID');
+
+        // Act
+        $this->calendarImpl->handleIMipMessage('fakeUser', $vObject->serialize());
+    }
+
+    public function testHandleImipNoOrganizer(): void {
+        // Arrange
+        $vObject = $this->vCalendar1a;
+        $vObject->add('METHOD', 'REQUEST');
+        $vObject->VEVENT->remove('ORGANIZER');
+
+        $this->expectException(CalendarException::class);
+        $this->expectExceptionMessage('iMip message event dose not contain an organizer');
+
+        // Act
+        $this->calendarImpl->handleIMipMessage('fakeUser', $vObject->serialize());
+    }
+
+    public function testHandleImipNoAttendee(): void {
+        // Arrange
+        $vObject = $this->vCalendar1a;
+        $vObject->add('METHOD', 'REQUEST');
+        $vObject->VEVENT->remove('ATTENDEE');
+
+        $this->expectException(CalendarException::class);
+        $this->expectExceptionMessage('iMip message event dose not contain an attendee');
+
+        // Act
+        $this->calendarImpl->handleIMipMessage('fakeUser', $vObject->serialize());
+    }
+
+    public function testHandleImipRequest(): void {
+        $userAddressSet = new class([ 'mailto:attendee1@testing.com', '/remote.php/dav/principals/users/attendee1/', ]) {
+            public function __construct(
+                private array $hrefs,
+            ) {
+            }
+            public function getHrefs(): array {
+                return $this->hrefs;
+            }
+        };
+
+        $vObject = $this->vCalendar1a;
+        $vObject->add('METHOD', 'REQUEST');
+
+        $iTip = new Message();
+        $iTip->method = 'REQUEST';
+        $iTip->sender = $vObject->VEVENT->ORGANIZER->getValue();
+        $iTip->recipient = $vObject->VEVENT->ATTENDEE->getValue();
+        $iTip->component = 'VEVENT';
+        $iTip->uid = $vObject->VEVENT->UID->getValue();
+        $iTip->sequence = (int)$vObject->VEVENT->SEQUENCE->getValue() ?? 0;
+        $iTip->message = $vObject;
+
+        /** @var CustomPrincipalPlugin|MockObject $authPlugin */
+        $authPlugin = $this->createMock(CustomPrincipalPlugin::class);
+        $authPlugin->expects(self::once())
+            ->method('setCurrentPrincipal')
+            ->with($this->calendar->getPrincipalURI());
+        /** @var \Sabre\DAVACL\Plugin|MockObject $aclPlugin */
+        $aclPlugin = $this->createMock(\Sabre\DAVACL\Plugin::class);
+
+        $server = $this->createMock(Server::class);
+        $server->expects($this->any())
+            ->method('getPlugin')
+            ->willReturnMap([
+                ['auth', $authPlugin],
+                ['acl', $aclPlugin],
+            ]);
+
+        $server->expects(self::once())
+            ->method('getProperties')
+            ->with(
+                $this->calendar->getPrincipalURI(),
+                [
+                    '{http://sabredav.org/ns}email-address',
+                    '{urn:ietf:params:xml:ns:caldav}calendar-user-address-set'
+                ]
+            )
+            ->willReturn([
+                '{http://sabredav.org/ns}email-address' => 'attendee1@testing.com',
+                '{urn:ietf:params:xml:ns:caldav}calendar-user-address-set' => $userAddressSet,
+            ]);
+        $server->expects(self::once())
+            ->method('emit');
+        $invitationResponseServer = $this->createMock(InvitationResponseServer::class, ['getServer']);
+        $invitationResponseServer->server = $server;
+        $invitationResponseServer->expects($this->any())
+            ->method('getServer')
+            ->willReturn($server);
+        $calendarImpl = $this->getMockBuilder(CalendarImpl::class)
+            ->setConstructorArgs([$this->calendar, $this->calendarInfo, $this->backend])
+            ->onlyMethods(['getInvitationResponseServer'])
+            ->getMock();
+        $calendarImpl->expects($this->once())
+            ->method('getInvitationResponseServer')
+            ->willReturn($invitationResponseServer);
+
+        $calendarImpl->handleIMipMessage('fakeUser', $vObject->serialize());
+    }
 
 }

Spacing +5 added lines, -5 removed lines

@@ -20,9 +20,9 @@ 
 use Sabre\VObject\ITip\Message;
 
 class CalendarImplTest extends \Test\TestCase {
-	private CalDavBackend|MockObject $backend;
-	private Calendar|MockObject $calendar;
-	private CalendarImpl|MockObject $calendarImpl;
+	private CalDavBackend | MockObject $backend;
+	private Calendar | MockObject $calendar;
+	private CalendarImpl | MockObject $calendarImpl;
 	private array $calendarInfo;
 	private VCalendar $vCalendar1a;
 	private array $mockExportCollection;
@@ -198,7 +198,7 @@ 
 	}
 
 	public function testHandleImipRequest(): void {
-		$userAddressSet = new class([ 'mailto:attendee1@testing.com', '/remote.php/dav/principals/users/attendee1/', ]) {
+		$userAddressSet = new class(['mailto:attendee1@testing.com', '/remote.php/dav/principals/users/attendee1/', ]) {
 			public function __construct(
 				private array $hrefs,
 			) {
@@ -217,7 +217,7 @@ 
 		$iTip->recipient = $vObject->VEVENT->ATTENDEE->getValue();
 		$iTip->component = 'VEVENT';
 		$iTip->uid = $vObject->VEVENT->UID->getValue();
-		$iTip->sequence = (int)$vObject->VEVENT->SEQUENCE->getValue() ?? 0;
+		$iTip->sequence = (int) $vObject->VEVENT->SEQUENCE->getValue() ?? 0;
 		$iTip->message = $vObject;
 
 		/** @var CustomPrincipalPlugin|MockObject $authPlugin */

tests/lib/Calendar/ManagerTest.php

Indentation +721 added lines, -721 removed lines

@@ -41,592 +41,592 @@ 
 }
 
 class ManagerTest extends TestCase {
-	/** @var Coordinator&MockObject */
-	private $coordinator;
-
-	/** @var ContainerInterface&MockObject */
-	private $container;
-
-	/** @var LoggerInterface&MockObject */
-	private $logger;
-
-	/** @var Manager */
-	private $manager;
-
-	/** @var ITimeFactory&MockObject */
-	private $time;
-
-	/** @var ISecureRandom&MockObject */
-	private ISecureRandom $secureRandom;
-
-	private IUserManager&MockObject $userManager;
-	private ServerFactory&MockObject $serverFactory;
-
-	private VCalendar $vCalendar1a;
-	private VCalendar $vCalendar2a;
-	private VCalendar $vCalendar3a;
-
-	protected function setUp(): void {
-		parent::setUp();
-
-		$this->coordinator = $this->createMock(Coordinator::class);
-		$this->container = $this->createMock(ContainerInterface::class);
-		$this->logger = $this->createMock(LoggerInterface::class);
-		$this->time = $this->createMock(ITimeFactory::class);
-		$this->secureRandom = $this->createMock(ISecureRandom::class);
-		$this->userManager = $this->createMock(IUserManager::class);
-		$this->serverFactory = $this->createMock(ServerFactory::class);
-
-		$this->manager = new Manager(
-			$this->coordinator,
-			$this->container,
-			$this->logger,
-			$this->time,
-			$this->secureRandom,
-			$this->userManager,
-			$this->serverFactory,
-		);
-
-		// construct calendar with a 1 hour event and same start/end time zones
-		$this->vCalendar1a = new VCalendar();
-		/** @var VEvent $vEvent */
-		$vEvent = $this->vCalendar1a->add('VEVENT', []);
-		$vEvent->UID->setValue('96a0e6b1-d886-4a55-a60d-152b31401dcc');
-		$vEvent->add('DTSTART', '20240701T080000', ['TZID' => 'America/Toronto']);
-		$vEvent->add('DTEND', '20240701T090000', ['TZID' => 'America/Toronto']);
-		$vEvent->add('SUMMARY', 'Test Event');
-		$vEvent->add('SEQUENCE', 3);
-		$vEvent->add('STATUS', 'CONFIRMED');
-		$vEvent->add('TRANSP', 'OPAQUE');
-		$vEvent->add('ORGANIZER', 'mailto:organizer@testing.com', ['CN' => 'Organizer']);
-		$vEvent->add('ATTENDEE', 'mailto:attendee1@testing.com', [
-			'CN' => 'Attendee One',
-			'CUTYPE' => 'INDIVIDUAL',
-			'PARTSTAT' => 'NEEDS-ACTION',
-			'ROLE' => 'REQ-PARTICIPANT',
-			'RSVP' => 'TRUE'
-		]);
-
-		// construct calendar with a event for reply
-		$this->vCalendar2a = new VCalendar();
-		/** @var VEvent $vEvent */
-		$vEvent = $this->vCalendar2a->add('VEVENT', []);
-		$vEvent->UID->setValue('dcc733bf-b2b2-41f2-a8cf-550ae4b67aff');
-		$vEvent->add('DTSTART', '20210820');
-		$vEvent->add('DTEND', '20220821');
-		$vEvent->add('SUMMARY', 'berry basket');
-		$vEvent->add('SEQUENCE', 3);
-		$vEvent->add('STATUS', 'CONFIRMED');
-		$vEvent->add('TRANSP', 'OPAQUE');
-		$vEvent->add('ORGANIZER', 'mailto:linus@stardew-tent-living.com', ['CN' => 'admin']);
-		$vEvent->add('ATTENDEE', 'mailto:pierre@general-store.com', [
-			'CN' => 'pierre@general-store.com',
-			'CUTYPE' => 'INDIVIDUAL',
-			'ROLE' => 'REQ-PARTICIPANT',
-			'PARTSTAT' => 'ACCEPTED',
-		]);
-
-		// construct calendar with a event for reply
-		$this->vCalendar3a = new VCalendar();
-		/** @var VEvent $vEvent */
-		$vEvent = $this->vCalendar3a->add('VEVENT', []);
-		$vEvent->UID->setValue('dcc733bf-b2b2-41f2-a8cf-550ae4b67aff');
-		$vEvent->add('DTSTART', '20210820');
-		$vEvent->add('DTEND', '20220821');
-		$vEvent->add('SUMMARY', 'berry basket');
-		$vEvent->add('SEQUENCE', 3);
-		$vEvent->add('STATUS', 'CANCELLED');
-		$vEvent->add('TRANSP', 'OPAQUE');
-		$vEvent->add('ORGANIZER', 'mailto:linus@stardew-tent-living.com', ['CN' => 'admin']);
-		$vEvent->add('ATTENDEE', 'mailto:pierre@general-store.com', [
-			'CN' => 'pierre@general-store.com',
-			'CUTYPE' => 'INDIVIDUAL',
-			'ROLE' => 'REQ-PARTICIPANT',
-			'PARTSTAT' => 'ACCEPTED',
-		]);
-
-	}
-
-	#[\PHPUnit\Framework\Attributes\DataProvider('searchProvider')]
-	public function testSearch($search1, $search2, $expected): void {
-		/** @var ICalendar | MockObject $calendar1 */
-		$calendar1 = $this->createMock(ICalendar::class);
-		$calendar1->method('getKey')->willReturn('simple:1');
-		$calendar1->expects($this->once())
-			->method('search')
-			->with('', [], [], null, null)
-			->willReturn($search1);
-
-		/** @var ICalendar | MockObject $calendar2 */
-		$calendar2 = $this->createMock(ICalendar::class);
-		$calendar2->method('getKey')->willReturn('simple:2');
-		$calendar2->expects($this->once())
-			->method('search')
-			->with('', [], [], null, null)
-			->willReturn($search2);
-
-		$this->manager->registerCalendar($calendar1);
-		$this->manager->registerCalendar($calendar2);
-
-		$result = $this->manager->search('');
-		$this->assertEquals($expected, $result);
-	}
-
-	#[\PHPUnit\Framework\Attributes\DataProvider('searchProvider')]
-	public function testSearchOptions($search1, $search2, $expected): void {
-		/** @var ICalendar | MockObject $calendar1 */
-		$calendar1 = $this->createMock(ICalendar::class);
-		$calendar1->method('getKey')->willReturn('simple:1');
-		$calendar1->expects($this->once())
-			->method('search')
-			->with('searchTerm', ['SUMMARY', 'DESCRIPTION'],
-				['timerange' => ['start' => null, 'end' => null]], 5, 20)
-			->willReturn($search1);
-
-		/** @var ICalendar | MockObject $calendar2 */
-		$calendar2 = $this->createMock(ICalendar::class);
-		$calendar2->method('getKey')->willReturn('simple:2');
-		$calendar2->expects($this->once())
-			->method('search')
-			->with('searchTerm', ['SUMMARY', 'DESCRIPTION'],
-				['timerange' => ['start' => null, 'end' => null]], 5, 20)
-			->willReturn($search2);
-
-		$this->manager->registerCalendar($calendar1);
-		$this->manager->registerCalendar($calendar2);
-
-		$result = $this->manager->search('searchTerm', ['SUMMARY', 'DESCRIPTION'],
-			['timerange' => ['start' => null, 'end' => null]], 5, 20);
-		$this->assertEquals($expected, $result);
-	}
-
-	public static function searchProvider(): array {
-		$search1 = [
-			[
-				'id' => 1,
-				'data' => 'foobar',
-			],
-			[
-				'id' => 2,
-				'data' => 'barfoo',
-			]
-		];
-		$search2 = [
-			[
-				'id' => 3,
-				'data' => 'blablub',
-			],
-			[
-				'id' => 4,
-				'data' => 'blubbla',
-			]
-		];
-
-		$expected = [
-			[
-				'id' => 1,
-				'data' => 'foobar',
-				'calendar-key' => 'simple:1',
-			],
-			[
-				'id' => 2,
-				'data' => 'barfoo',
-				'calendar-key' => 'simple:1',
-			],
-			[
-				'id' => 3,
-				'data' => 'blablub',
-				'calendar-key' => 'simple:2',
-			],
-			[
-				'id' => 4,
-				'data' => 'blubbla',
-				'calendar-key' => 'simple:2',
-			]
-		];
-
-		return [
-			[
-				$search1,
-				$search2,
-				$expected
-			]
-		];
-	}
-
-	public function testRegisterUnregister(): void {
-		/** @var ICalendar | MockObject $calendar1 */
-		$calendar1 = $this->createMock(ICalendar::class);
-		$calendar1->method('getKey')->willReturn('key1');
-
-		/** @var ICalendar | MockObject $calendar2 */
-		$calendar2 = $this->createMock(ICalendar::class);
-		$calendar2->method('getKey')->willReturn('key2');
-
-		$this->manager->registerCalendar($calendar1);
-		$this->manager->registerCalendar($calendar2);
-
-		$result = $this->manager->getCalendars();
-		$this->assertCount(2, $result);
-		$this->assertContains($calendar1, $result);
-		$this->assertContains($calendar2, $result);
-
-		$this->manager->unregisterCalendar($calendar1);
-
-		$result = $this->manager->getCalendars();
-		$this->assertCount(1, $result);
-		$this->assertContains($calendar2, $result);
-	}
-
-	public function testGetCalendars(): void {
-		/** @var ICalendar | MockObject $calendar1 */
-		$calendar1 = $this->createMock(ICalendar::class);
-		$calendar1->method('getKey')->willReturn('key1');
-
-		/** @var ICalendar | MockObject $calendar2 */
-		$calendar2 = $this->createMock(ICalendar::class);
-		$calendar2->method('getKey')->willReturn('key2');
-
-		$this->manager->registerCalendar($calendar1);
-		$this->manager->registerCalendar($calendar2);
-
-		$result = $this->manager->getCalendars();
-		$this->assertCount(2, $result);
-		$this->assertContains($calendar1, $result);
-		$this->assertContains($calendar2, $result);
-
-		$this->manager->clear();
-
-		$result = $this->manager->getCalendars();
-
-		$this->assertCount(0, $result);
-	}
-
-	public function testEnabledIfNot(): void {
-		$isEnabled = $this->manager->isEnabled();
-		$this->assertFalse($isEnabled);
-	}
-
-	public function testIfEnabledIfSo(): void {
-		/** @var ICalendar | MockObject $calendar */
-		$calendar = $this->createMock(ICalendar::class);
-		$this->manager->registerCalendar($calendar);
-
-		$isEnabled = $this->manager->isEnabled();
-		$this->assertTrue($isEnabled);
-	}
-
-	public function testHandleImipWithNoCalendars(): void {
-		// construct calendar manager returns
-		/** @var Manager&MockObject $manager */
-		$manager = $this->getMockBuilder(Manager::class)
-			->setConstructorArgs([
-				$this->coordinator,
-				$this->container,
-				$this->logger,
-				$this->time,
-				$this->secureRandom,
-				$this->userManager,
-				$this->serverFactory,
-			])
-			->onlyMethods(['getCalendarsForPrincipal'])
-			->getMock();
-		$manager->expects(self::once())
-			->method('getCalendarsForPrincipal')
-			->willReturn([]);
-		// construct logger returns
-		$this->logger->expects(self::once())->method('warning')
-			->with('iMip message could not be processed because user has no calendars');
-		// construct parameters
-		$userId = 'attendee1';
-		$calendar = $this->vCalendar1a;
-		$calendar->add('METHOD', 'REQUEST');
-		// test method
-		$result = $manager->handleIMip($userId, $calendar->serialize());
-		// Assert
-		$this->assertFalse($result);
-	}
-
-	public function testHandleImipWithNoEvent(): void {
-		// construct mock user calendar
-		$userCalendar = $this->createMock(ITestCalendar::class);
-		// construct mock calendar manager and returns
-		/** @var Manager&MockObject $manager */
-		$manager = $this->getMockBuilder(Manager::class)
-			->setConstructorArgs([
-				$this->coordinator,
-				$this->container,
-				$this->logger,
-				$this->time,
-				$this->secureRandom,
-				$this->userManager,
-				$this->serverFactory,
-			])
-			->onlyMethods(['getCalendarsForPrincipal'])
-			->getMock();
-		$manager->expects(self::once())
-			->method('getCalendarsForPrincipal')
-			->willReturn([$userCalendar]);
-		// construct logger returns
-		$this->logger->expects(self::once())->method('warning')
-			->with('iMip message does not contain any event(s)');
-		// construct parameters
-		$userId = 'attendee1';
-		$calendar = $this->vCalendar1a;
-		$calendar->add('METHOD', 'REQUEST');
-		$calendar->remove('VEVENT');
-		// Act
-		$result = $manager->handleIMip($userId, $calendar->serialize());
-		// Assert
-		$this->assertFalse($result);
-	}
-
-	public function testHandleImipWithNoUid(): void {
-		// construct mock user calendar
-		$userCalendar = $this->createMock(ITestCalendar::class);
-		// construct mock calendar manager and returns
-		/** @var Manager&MockObject $manager */
-		$manager = $this->getMockBuilder(Manager::class)
-			->setConstructorArgs([
-				$this->coordinator,
-				$this->container,
-				$this->logger,
-				$this->time,
-				$this->secureRandom,
-				$this->userManager,
-				$this->serverFactory,
-			])
-			->onlyMethods(['getCalendarsForPrincipal'])
-			->getMock();
-		$manager->expects(self::once())
-			->method('getCalendarsForPrincipal')
-			->willReturn([$userCalendar]);
-		// construct logger returns
-		$this->logger->expects(self::once())->method('warning')
-			->with('iMip message event dose not contains a UID');
-		// construct parameters
-		$userId = 'attendee1';
-		$calendar = $this->vCalendar1a;
-		$calendar->add('METHOD', 'REQUEST');
-		$calendar->VEVENT->remove('UID');
-		// test method
-		$result = $manager->handleIMip($userId, $calendar->serialize());
-		// Assert
-		$this->assertFalse($result);
-	}
-
-	public function testHandleImipWithNoMatch(): void {
-		// construct mock user calendar
-		$userCalendar = $this->createMock(ITestCalendar::class);
-		$userCalendar->expects(self::once())
-			->method('isDeleted')
-			->willReturn(false);
-		$userCalendar->expects(self::once())
-			->method('isWritable')
-			->willReturn(true);
-		$userCalendar->expects(self::once())
-			->method('search')
-			->willReturn([]);
-		// construct mock calendar manager and returns
-		/** @var Manager&MockObject $manager */
-		$manager = $this->getMockBuilder(Manager::class)
-			->setConstructorArgs([
-				$this->coordinator,
-				$this->container,
-				$this->logger,
-				$this->time,
-				$this->secureRandom,
-				$this->userManager,
-				$this->serverFactory,
-			])
-			->onlyMethods(['getCalendarsForPrincipal'])
-			->getMock();
-		$manager->expects(self::once())
-			->method('getCalendarsForPrincipal')
-			->willReturn([$userCalendar]);
-		// construct logger returns
-		$this->logger->expects(self::once())->method('warning')
-			->with('iMip message could not be processed because no corresponding event was found in any calendar');
-		// construct parameters
-		$userId = 'attendee1';
-		$calendar = $this->vCalendar1a;
-		$calendar->add('METHOD', 'REQUEST');
-		// test method
-		$result = $manager->handleIMip($userId, $calendar->serialize());
-		// Assert
-		$this->assertFalse($result);
-	}
-
-	public function testHandleImip(): void {
-		// construct mock user calendar
-		$userCalendar = $this->createMock(ITestCalendar::class);
-		$userCalendar->expects(self::once())
-			->method('isDeleted')
-			->willReturn(false);
-		$userCalendar->expects(self::once())
-			->method('isWritable')
-			->willReturn(true);
-		$userCalendar->expects(self::once())
-			->method('search')
-			->willReturn([['uri' => 'principals/user/attendee1/personal']]);
-		// construct mock calendar manager and returns
-		/** @var Manager&MockObject $manager */
-		$manager = $this->getMockBuilder(Manager::class)
-			->setConstructorArgs([
-				$this->coordinator,
-				$this->container,
-				$this->logger,
-				$this->time,
-				$this->secureRandom,
-				$this->userManager,
-				$this->serverFactory,
-			])
-			->onlyMethods(['getCalendarsForPrincipal'])
-			->getMock();
-		$manager->expects(self::once())
-			->method('getCalendarsForPrincipal')
-			->willReturn([$userCalendar]);
-		// construct parameters
-		$userId = 'attendee1';
-		$calendar = $this->vCalendar1a;
-		$calendar->add('METHOD', 'REQUEST');
-		// construct user calendar returns
-		$userCalendar->expects(self::once())
-			->method('handleIMipMessage');
-		// test method
-		$result = $manager->handleIMip($userId, $calendar->serialize());
-	}
-
-	public function testhandleIMipRequestWithInvalidPrincipal() {
-		$invalidPrincipal = 'invalid-principal-uri';
-		$sender = 'sender@example.com';
-		$recipient = 'recipient@example.com';
-		$calendarData = $this->vCalendar1a->serialize();
-
-		$this->logger->expects(self::once())
-			->method('error')
-			->with('Invalid principal URI provided for iMip request');
-
-		$result = $this->manager->handleIMipRequest($invalidPrincipal, $sender, $recipient, $calendarData);
-		$this->assertFalse($result);
-	}
-
-	public function testhandleIMipRequest() {
-		$principalUri = 'principals/users/attendee1';
-		$sender = 'sender@example.com';
-		$recipient = 'recipient@example.com';
-		$calendarData = $this->vCalendar1a->serialize();
-
-		/** @var Manager&MockObject $manager */
-		$manager = $this->getMockBuilder(Manager::class)
-			->setConstructorArgs([
-				$this->coordinator,
-				$this->container,
-				$this->logger,
-				$this->time,
-				$this->secureRandom,
-				$this->userManager,
-				$this->serverFactory,
-			])
-			->onlyMethods(['handleIMip'])
-			->getMock();
-		$manager->expects(self::once())
-			->method('handleIMip')
-			->with('attendee1', $calendarData)
-			->willReturn(true);
-
-		$result = $manager->handleIMipRequest($principalUri, $sender, $recipient, $calendarData);
-		$this->assertTrue($result);
-	}
-
-	public function testhandleIMipReplyWithInvalidPrincipal() {
-		$invalidPrincipal = 'invalid-principal-uri';
-		$sender = 'sender@example.com';
-		$recipient = 'recipient@example.com';
-		$calendarData = $this->vCalendar2a->serialize();
-
-		$this->logger->expects(self::once())
-			->method('error')
-			->with('Invalid principal URI provided for iMip reply');
-
-		$result = $this->manager->handleIMipReply($invalidPrincipal, $sender, $recipient, $calendarData);
-		$this->assertFalse($result);
-	}
-
-	public function testhandleIMipReply() {
-		$principalUri = 'principals/users/attendee2';
-		$sender = 'sender@example.com';
-		$recipient = 'recipient@example.com';
-		$calendarData = $this->vCalendar2a->serialize();
-
-		/** @var Manager&MockObject $manager */
-		$manager = $this->getMockBuilder(Manager::class)
-			->setConstructorArgs([
-				$this->coordinator,
-				$this->container,
-				$this->logger,
-				$this->time,
-				$this->secureRandom,
-				$this->userManager,
-				$this->serverFactory,
-			])
-			->onlyMethods(['handleIMip'])
-			->getMock();
-		$manager->expects(self::once())
-			->method('handleIMip')
-			->with('attendee2', $calendarData)
-			->willReturn(true);
-
-		$result = $manager->handleIMipReply($principalUri, $sender, $recipient, $calendarData);
-		$this->assertTrue($result);
-	}
-
-	public function testhandleIMipCancelWithInvalidPrincipal() {
-		$invalidPrincipal = 'invalid-principal-uri';
-		$sender = 'sender@example.com';
-		$replyTo = null;
-		$recipient = 'recipient@example.com';
-		$calendarData = $this->vCalendar3a->serialize();
-
-		$this->logger->expects(self::once())
-			->method('error')
-			->with('Invalid principal URI provided for iMip cancel');
-
-		$result = $this->manager->handleIMipCancel($invalidPrincipal, $sender, $replyTo, $recipient, $calendarData);
-		$this->assertFalse($result);
-	}
-
-	public function testhandleIMipCancel() {
-		$principalUri = 'principals/users/attendee3';
-		$sender = 'sender@example.com';
-		$replyTo = null;
-		$recipient = 'recipient@example.com';
-		$calendarData = $this->vCalendar3a->serialize();
-
-		/** @var Manager&MockObject $manager */
-		$manager = $this->getMockBuilder(Manager::class)
-			->setConstructorArgs([
-				$this->coordinator,
-				$this->container,
-				$this->logger,
-				$this->time,
-				$this->secureRandom,
-				$this->userManager,
-				$this->serverFactory,
-			])
-			->onlyMethods(['handleIMip'])
-			->getMock();
-		$manager->expects(self::once())
-			->method('handleIMip')
-			->with('attendee3', $calendarData)
-			->willReturn(true);
-
-		$result = $manager->handleIMipCancel($principalUri, $sender, $replyTo, $recipient, $calendarData);
-		$this->assertTrue($result);
-	}
-
-	private function getFreeBusyResponse(): string {
-		return <<<EOF
+    /** @var Coordinator&MockObject */
+    private $coordinator;
+
+    /** @var ContainerInterface&MockObject */
+    private $container;
+
+    /** @var LoggerInterface&MockObject */
+    private $logger;
+
+    /** @var Manager */
+    private $manager;
+
+    /** @var ITimeFactory&MockObject */
+    private $time;
+
+    /** @var ISecureRandom&MockObject */
+    private ISecureRandom $secureRandom;
+
+    private IUserManager&MockObject $userManager;
+    private ServerFactory&MockObject $serverFactory;
+
+    private VCalendar $vCalendar1a;
+    private VCalendar $vCalendar2a;
+    private VCalendar $vCalendar3a;
+
+    protected function setUp(): void {
+        parent::setUp();
+
+        $this->coordinator = $this->createMock(Coordinator::class);
+        $this->container = $this->createMock(ContainerInterface::class);
+        $this->logger = $this->createMock(LoggerInterface::class);
+        $this->time = $this->createMock(ITimeFactory::class);
+        $this->secureRandom = $this->createMock(ISecureRandom::class);
+        $this->userManager = $this->createMock(IUserManager::class);
+        $this->serverFactory = $this->createMock(ServerFactory::class);
+
+        $this->manager = new Manager(
+            $this->coordinator,
+            $this->container,
+            $this->logger,
+            $this->time,
+            $this->secureRandom,
+            $this->userManager,
+            $this->serverFactory,
+        );
+
+        // construct calendar with a 1 hour event and same start/end time zones
+        $this->vCalendar1a = new VCalendar();
+        /** @var VEvent $vEvent */
+        $vEvent = $this->vCalendar1a->add('VEVENT', []);
+        $vEvent->UID->setValue('96a0e6b1-d886-4a55-a60d-152b31401dcc');
+        $vEvent->add('DTSTART', '20240701T080000', ['TZID' => 'America/Toronto']);
+        $vEvent->add('DTEND', '20240701T090000', ['TZID' => 'America/Toronto']);
+        $vEvent->add('SUMMARY', 'Test Event');
+        $vEvent->add('SEQUENCE', 3);
+        $vEvent->add('STATUS', 'CONFIRMED');
+        $vEvent->add('TRANSP', 'OPAQUE');
+        $vEvent->add('ORGANIZER', 'mailto:organizer@testing.com', ['CN' => 'Organizer']);
+        $vEvent->add('ATTENDEE', 'mailto:attendee1@testing.com', [
+            'CN' => 'Attendee One',
+            'CUTYPE' => 'INDIVIDUAL',
+            'PARTSTAT' => 'NEEDS-ACTION',
+            'ROLE' => 'REQ-PARTICIPANT',
+            'RSVP' => 'TRUE'
+        ]);
+
+        // construct calendar with a event for reply
+        $this->vCalendar2a = new VCalendar();
+        /** @var VEvent $vEvent */
+        $vEvent = $this->vCalendar2a->add('VEVENT', []);
+        $vEvent->UID->setValue('dcc733bf-b2b2-41f2-a8cf-550ae4b67aff');
+        $vEvent->add('DTSTART', '20210820');
+        $vEvent->add('DTEND', '20220821');
+        $vEvent->add('SUMMARY', 'berry basket');
+        $vEvent->add('SEQUENCE', 3);
+        $vEvent->add('STATUS', 'CONFIRMED');
+        $vEvent->add('TRANSP', 'OPAQUE');
+        $vEvent->add('ORGANIZER', 'mailto:linus@stardew-tent-living.com', ['CN' => 'admin']);
+        $vEvent->add('ATTENDEE', 'mailto:pierre@general-store.com', [
+            'CN' => 'pierre@general-store.com',
+            'CUTYPE' => 'INDIVIDUAL',
+            'ROLE' => 'REQ-PARTICIPANT',
+            'PARTSTAT' => 'ACCEPTED',
+        ]);
+
+        // construct calendar with a event for reply
+        $this->vCalendar3a = new VCalendar();
+        /** @var VEvent $vEvent */
+        $vEvent = $this->vCalendar3a->add('VEVENT', []);
+        $vEvent->UID->setValue('dcc733bf-b2b2-41f2-a8cf-550ae4b67aff');
+        $vEvent->add('DTSTART', '20210820');
+        $vEvent->add('DTEND', '20220821');
+        $vEvent->add('SUMMARY', 'berry basket');
+        $vEvent->add('SEQUENCE', 3);
+        $vEvent->add('STATUS', 'CANCELLED');
+        $vEvent->add('TRANSP', 'OPAQUE');
+        $vEvent->add('ORGANIZER', 'mailto:linus@stardew-tent-living.com', ['CN' => 'admin']);
+        $vEvent->add('ATTENDEE', 'mailto:pierre@general-store.com', [
+            'CN' => 'pierre@general-store.com',
+            'CUTYPE' => 'INDIVIDUAL',
+            'ROLE' => 'REQ-PARTICIPANT',
+            'PARTSTAT' => 'ACCEPTED',
+        ]);
+
+    }
+
+    #[\PHPUnit\Framework\Attributes\DataProvider('searchProvider')]
+    public function testSearch($search1, $search2, $expected): void {
+        /** @var ICalendar | MockObject $calendar1 */
+        $calendar1 = $this->createMock(ICalendar::class);
+        $calendar1->method('getKey')->willReturn('simple:1');
+        $calendar1->expects($this->once())
+            ->method('search')
+            ->with('', [], [], null, null)
+            ->willReturn($search1);
+
+        /** @var ICalendar | MockObject $calendar2 */
+        $calendar2 = $this->createMock(ICalendar::class);
+        $calendar2->method('getKey')->willReturn('simple:2');
+        $calendar2->expects($this->once())
+            ->method('search')
+            ->with('', [], [], null, null)
+            ->willReturn($search2);
+
+        $this->manager->registerCalendar($calendar1);
+        $this->manager->registerCalendar($calendar2);
+
+        $result = $this->manager->search('');
+        $this->assertEquals($expected, $result);
+    }
+
+    #[\PHPUnit\Framework\Attributes\DataProvider('searchProvider')]
+    public function testSearchOptions($search1, $search2, $expected): void {
+        /** @var ICalendar | MockObject $calendar1 */
+        $calendar1 = $this->createMock(ICalendar::class);
+        $calendar1->method('getKey')->willReturn('simple:1');
+        $calendar1->expects($this->once())
+            ->method('search')
+            ->with('searchTerm', ['SUMMARY', 'DESCRIPTION'],
+                ['timerange' => ['start' => null, 'end' => null]], 5, 20)
+            ->willReturn($search1);
+
+        /** @var ICalendar | MockObject $calendar2 */
+        $calendar2 = $this->createMock(ICalendar::class);
+        $calendar2->method('getKey')->willReturn('simple:2');
+        $calendar2->expects($this->once())
+            ->method('search')
+            ->with('searchTerm', ['SUMMARY', 'DESCRIPTION'],
+                ['timerange' => ['start' => null, 'end' => null]], 5, 20)
+            ->willReturn($search2);
+
+        $this->manager->registerCalendar($calendar1);
+        $this->manager->registerCalendar($calendar2);
+
+        $result = $this->manager->search('searchTerm', ['SUMMARY', 'DESCRIPTION'],
+            ['timerange' => ['start' => null, 'end' => null]], 5, 20);
+        $this->assertEquals($expected, $result);
+    }
+
+    public static function searchProvider(): array {
+        $search1 = [
+            [
+                'id' => 1,
+                'data' => 'foobar',
+            ],
+            [
+                'id' => 2,
+                'data' => 'barfoo',
+            ]
+        ];
+        $search2 = [
+            [
+                'id' => 3,
+                'data' => 'blablub',
+            ],
+            [
+                'id' => 4,
+                'data' => 'blubbla',
+            ]
+        ];
+
+        $expected = [
+            [
+                'id' => 1,
+                'data' => 'foobar',
+                'calendar-key' => 'simple:1',
+            ],
+            [
+                'id' => 2,
+                'data' => 'barfoo',
+                'calendar-key' => 'simple:1',
+            ],
+            [
+                'id' => 3,
+                'data' => 'blablub',
+                'calendar-key' => 'simple:2',
+            ],
+            [
+                'id' => 4,
+                'data' => 'blubbla',
+                'calendar-key' => 'simple:2',
+            ]
+        ];
+
+        return [
+            [
+                $search1,
+                $search2,
+                $expected
+            ]
+        ];
+    }
+
+    public function testRegisterUnregister(): void {
+        /** @var ICalendar | MockObject $calendar1 */
+        $calendar1 = $this->createMock(ICalendar::class);
+        $calendar1->method('getKey')->willReturn('key1');
+
+        /** @var ICalendar | MockObject $calendar2 */
+        $calendar2 = $this->createMock(ICalendar::class);
+        $calendar2->method('getKey')->willReturn('key2');
+
+        $this->manager->registerCalendar($calendar1);
+        $this->manager->registerCalendar($calendar2);
+
+        $result = $this->manager->getCalendars();
+        $this->assertCount(2, $result);
+        $this->assertContains($calendar1, $result);
+        $this->assertContains($calendar2, $result);
+
+        $this->manager->unregisterCalendar($calendar1);
+
+        $result = $this->manager->getCalendars();
+        $this->assertCount(1, $result);
+        $this->assertContains($calendar2, $result);
+    }
+
+    public function testGetCalendars(): void {
+        /** @var ICalendar | MockObject $calendar1 */
+        $calendar1 = $this->createMock(ICalendar::class);
+        $calendar1->method('getKey')->willReturn('key1');
+
+        /** @var ICalendar | MockObject $calendar2 */
+        $calendar2 = $this->createMock(ICalendar::class);
+        $calendar2->method('getKey')->willReturn('key2');
+
+        $this->manager->registerCalendar($calendar1);
+        $this->manager->registerCalendar($calendar2);
+
+        $result = $this->manager->getCalendars();
+        $this->assertCount(2, $result);
+        $this->assertContains($calendar1, $result);
+        $this->assertContains($calendar2, $result);
+
+        $this->manager->clear();
+
+        $result = $this->manager->getCalendars();
+
+        $this->assertCount(0, $result);
+    }
+
+    public function testEnabledIfNot(): void {
+        $isEnabled = $this->manager->isEnabled();
+        $this->assertFalse($isEnabled);
+    }
+
+    public function testIfEnabledIfSo(): void {
+        /** @var ICalendar | MockObject $calendar */
+        $calendar = $this->createMock(ICalendar::class);
+        $this->manager->registerCalendar($calendar);
+
+        $isEnabled = $this->manager->isEnabled();
+        $this->assertTrue($isEnabled);
+    }
+
+    public function testHandleImipWithNoCalendars(): void {
+        // construct calendar manager returns
+        /** @var Manager&MockObject $manager */
+        $manager = $this->getMockBuilder(Manager::class)
+            ->setConstructorArgs([
+                $this->coordinator,
+                $this->container,
+                $this->logger,
+                $this->time,
+                $this->secureRandom,
+                $this->userManager,
+                $this->serverFactory,
+            ])
+            ->onlyMethods(['getCalendarsForPrincipal'])
+            ->getMock();
+        $manager->expects(self::once())
+            ->method('getCalendarsForPrincipal')
+            ->willReturn([]);
+        // construct logger returns
+        $this->logger->expects(self::once())->method('warning')
+            ->with('iMip message could not be processed because user has no calendars');
+        // construct parameters
+        $userId = 'attendee1';
+        $calendar = $this->vCalendar1a;
+        $calendar->add('METHOD', 'REQUEST');
+        // test method
+        $result = $manager->handleIMip($userId, $calendar->serialize());
+        // Assert
+        $this->assertFalse($result);
+    }
+
+    public function testHandleImipWithNoEvent(): void {
+        // construct mock user calendar
+        $userCalendar = $this->createMock(ITestCalendar::class);
+        // construct mock calendar manager and returns
+        /** @var Manager&MockObject $manager */
+        $manager = $this->getMockBuilder(Manager::class)
+            ->setConstructorArgs([
+                $this->coordinator,
+                $this->container,
+                $this->logger,
+                $this->time,
+                $this->secureRandom,
+                $this->userManager,
+                $this->serverFactory,
+            ])
+            ->onlyMethods(['getCalendarsForPrincipal'])
+            ->getMock();
+        $manager->expects(self::once())
+            ->method('getCalendarsForPrincipal')
+            ->willReturn([$userCalendar]);
+        // construct logger returns
+        $this->logger->expects(self::once())->method('warning')
+            ->with('iMip message does not contain any event(s)');
+        // construct parameters
+        $userId = 'attendee1';
+        $calendar = $this->vCalendar1a;
+        $calendar->add('METHOD', 'REQUEST');
+        $calendar->remove('VEVENT');
+        // Act
+        $result = $manager->handleIMip($userId, $calendar->serialize());
+        // Assert
+        $this->assertFalse($result);
+    }
+
+    public function testHandleImipWithNoUid(): void {
+        // construct mock user calendar
+        $userCalendar = $this->createMock(ITestCalendar::class);
+        // construct mock calendar manager and returns
+        /** @var Manager&MockObject $manager */
+        $manager = $this->getMockBuilder(Manager::class)
+            ->setConstructorArgs([
+                $this->coordinator,
+                $this->container,
+                $this->logger,
+                $this->time,
+                $this->secureRandom,
+                $this->userManager,
+                $this->serverFactory,
+            ])
+            ->onlyMethods(['getCalendarsForPrincipal'])
+            ->getMock();
+        $manager->expects(self::once())
+            ->method('getCalendarsForPrincipal')
+            ->willReturn([$userCalendar]);
+        // construct logger returns
+        $this->logger->expects(self::once())->method('warning')
+            ->with('iMip message event dose not contains a UID');
+        // construct parameters
+        $userId = 'attendee1';
+        $calendar = $this->vCalendar1a;
+        $calendar->add('METHOD', 'REQUEST');
+        $calendar->VEVENT->remove('UID');
+        // test method
+        $result = $manager->handleIMip($userId, $calendar->serialize());
+        // Assert
+        $this->assertFalse($result);
+    }
+
+    public function testHandleImipWithNoMatch(): void {
+        // construct mock user calendar
+        $userCalendar = $this->createMock(ITestCalendar::class);
+        $userCalendar->expects(self::once())
+            ->method('isDeleted')
+            ->willReturn(false);
+        $userCalendar->expects(self::once())
+            ->method('isWritable')
+            ->willReturn(true);
+        $userCalendar->expects(self::once())
+            ->method('search')
+            ->willReturn([]);
+        // construct mock calendar manager and returns
+        /** @var Manager&MockObject $manager */
+        $manager = $this->getMockBuilder(Manager::class)
+            ->setConstructorArgs([
+                $this->coordinator,
+                $this->container,
+                $this->logger,
+                $this->time,
+                $this->secureRandom,
+                $this->userManager,
+                $this->serverFactory,
+            ])
+            ->onlyMethods(['getCalendarsForPrincipal'])
+            ->getMock();
+        $manager->expects(self::once())
+            ->method('getCalendarsForPrincipal')
+            ->willReturn([$userCalendar]);
+        // construct logger returns
+        $this->logger->expects(self::once())->method('warning')
+            ->with('iMip message could not be processed because no corresponding event was found in any calendar');
+        // construct parameters
+        $userId = 'attendee1';
+        $calendar = $this->vCalendar1a;
+        $calendar->add('METHOD', 'REQUEST');
+        // test method
+        $result = $manager->handleIMip($userId, $calendar->serialize());
+        // Assert
+        $this->assertFalse($result);
+    }
+
+    public function testHandleImip(): void {
+        // construct mock user calendar
+        $userCalendar = $this->createMock(ITestCalendar::class);
+        $userCalendar->expects(self::once())
+            ->method('isDeleted')
+            ->willReturn(false);
+        $userCalendar->expects(self::once())
+            ->method('isWritable')
+            ->willReturn(true);
+        $userCalendar->expects(self::once())
+            ->method('search')
+            ->willReturn([['uri' => 'principals/user/attendee1/personal']]);
+        // construct mock calendar manager and returns
+        /** @var Manager&MockObject $manager */
+        $manager = $this->getMockBuilder(Manager::class)
+            ->setConstructorArgs([
+                $this->coordinator,
+                $this->container,
+                $this->logger,
+                $this->time,
+                $this->secureRandom,
+                $this->userManager,
+                $this->serverFactory,
+            ])
+            ->onlyMethods(['getCalendarsForPrincipal'])
+            ->getMock();
+        $manager->expects(self::once())
+            ->method('getCalendarsForPrincipal')
+            ->willReturn([$userCalendar]);
+        // construct parameters
+        $userId = 'attendee1';
+        $calendar = $this->vCalendar1a;
+        $calendar->add('METHOD', 'REQUEST');
+        // construct user calendar returns
+        $userCalendar->expects(self::once())
+            ->method('handleIMipMessage');
+        // test method
+        $result = $manager->handleIMip($userId, $calendar->serialize());
+    }
+
+    public function testhandleIMipRequestWithInvalidPrincipal() {
+        $invalidPrincipal = 'invalid-principal-uri';
+        $sender = 'sender@example.com';
+        $recipient = 'recipient@example.com';
+        $calendarData = $this->vCalendar1a->serialize();
+
+        $this->logger->expects(self::once())
+            ->method('error')
+            ->with('Invalid principal URI provided for iMip request');
+
+        $result = $this->manager->handleIMipRequest($invalidPrincipal, $sender, $recipient, $calendarData);
+        $this->assertFalse($result);
+    }
+
+    public function testhandleIMipRequest() {
+        $principalUri = 'principals/users/attendee1';
+        $sender = 'sender@example.com';
+        $recipient = 'recipient@example.com';
+        $calendarData = $this->vCalendar1a->serialize();
+
+        /** @var Manager&MockObject $manager */
+        $manager = $this->getMockBuilder(Manager::class)
+            ->setConstructorArgs([
+                $this->coordinator,
+                $this->container,
+                $this->logger,
+                $this->time,
+                $this->secureRandom,
+                $this->userManager,
+                $this->serverFactory,
+            ])
+            ->onlyMethods(['handleIMip'])
+            ->getMock();
+        $manager->expects(self::once())
+            ->method('handleIMip')
+            ->with('attendee1', $calendarData)
+            ->willReturn(true);
+
+        $result = $manager->handleIMipRequest($principalUri, $sender, $recipient, $calendarData);
+        $this->assertTrue($result);
+    }
+
+    public function testhandleIMipReplyWithInvalidPrincipal() {
+        $invalidPrincipal = 'invalid-principal-uri';
+        $sender = 'sender@example.com';
+        $recipient = 'recipient@example.com';
+        $calendarData = $this->vCalendar2a->serialize();
+
+        $this->logger->expects(self::once())
+            ->method('error')
+            ->with('Invalid principal URI provided for iMip reply');
+
+        $result = $this->manager->handleIMipReply($invalidPrincipal, $sender, $recipient, $calendarData);
+        $this->assertFalse($result);
+    }
+
+    public function testhandleIMipReply() {
+        $principalUri = 'principals/users/attendee2';
+        $sender = 'sender@example.com';
+        $recipient = 'recipient@example.com';
+        $calendarData = $this->vCalendar2a->serialize();
+
+        /** @var Manager&MockObject $manager */
+        $manager = $this->getMockBuilder(Manager::class)
+            ->setConstructorArgs([
+                $this->coordinator,
+                $this->container,
+                $this->logger,
+                $this->time,
+                $this->secureRandom,
+                $this->userManager,
+                $this->serverFactory,
+            ])
+            ->onlyMethods(['handleIMip'])
+            ->getMock();
+        $manager->expects(self::once())
+            ->method('handleIMip')
+            ->with('attendee2', $calendarData)
+            ->willReturn(true);
+
+        $result = $manager->handleIMipReply($principalUri, $sender, $recipient, $calendarData);
+        $this->assertTrue($result);
+    }
+
+    public function testhandleIMipCancelWithInvalidPrincipal() {
+        $invalidPrincipal = 'invalid-principal-uri';
+        $sender = 'sender@example.com';
+        $replyTo = null;
+        $recipient = 'recipient@example.com';
+        $calendarData = $this->vCalendar3a->serialize();
+
+        $this->logger->expects(self::once())
+            ->method('error')
+            ->with('Invalid principal URI provided for iMip cancel');
+
+        $result = $this->manager->handleIMipCancel($invalidPrincipal, $sender, $replyTo, $recipient, $calendarData);
+        $this->assertFalse($result);
+    }
+
+    public function testhandleIMipCancel() {
+        $principalUri = 'principals/users/attendee3';
+        $sender = 'sender@example.com';
+        $replyTo = null;
+        $recipient = 'recipient@example.com';
+        $calendarData = $this->vCalendar3a->serialize();
+
+        /** @var Manager&MockObject $manager */
+        $manager = $this->getMockBuilder(Manager::class)
+            ->setConstructorArgs([
+                $this->coordinator,
+                $this->container,
+                $this->logger,
+                $this->time,
+                $this->secureRandom,
+                $this->userManager,
+                $this->serverFactory,
+            ])
+            ->onlyMethods(['handleIMip'])
+            ->getMock();
+        $manager->expects(self::once())
+            ->method('handleIMip')
+            ->with('attendee3', $calendarData)
+            ->willReturn(true);
+
+        $result = $manager->handleIMipCancel($principalUri, $sender, $replyTo, $recipient, $calendarData);
+        $this->assertTrue($result);
+    }
+
+    private function getFreeBusyResponse(): string {
+        return <<<EOF
 <?xml version="1.0" encoding="utf-8"?>
 <cal:schedule-response xmlns:d="DAV:" xmlns:s="http://sabredav.org/ns" xmlns:cal="urn:ietf:params:xml:ns:caldav" xmlns:cs="http://calendarserver.org/ns/" xmlns:oc="http://owncloud.org/ns" xmlns:nc="http://nextcloud.org/ns">
   <cal:response>
@@ -704,139 +704,139 @@ 
   </cal:response>
 </cal:schedule-response>
 EOF;
-	}
-
-	public function testCheckAvailability(): void {
-		$organizer = $this->createMock(IUser::class);
-		$organizer->expects(self::once())
-			->method('getUID')
-			->willReturn('admin');
-		$organizer->expects(self::once())
-			->method('getEMailAddress')
-			->willReturn('admin@imap.localhost');
-
-		$user1 = $this->createMock(IUser::class);
-		$user2 = $this->createMock(IUser::class);
-
-		$this->userManager->expects(self::exactly(3))
-			->method('getByEmail')
-			->willReturnMap([
-				['user@imap.localhost', [$user1]],
-				['empty@imap.localhost', [$user2]],
-				['nouser@domain.tld', []],
-			]);
-
-		$authPlugin = $this->createMock(CustomPrincipalPlugin::class);
-		$authPlugin->expects(self::once())
-			->method('setCurrentPrincipal')
-			->with('principals/users/admin');
-
-		$server = $this->createMock(Server::class);
-		$server->expects(self::once())
-			->method('getPlugin')
-			->with('auth')
-			->willReturn($authPlugin);
-		$server->expects(self::once())
-			->method('invokeMethod')
-			->willReturnCallback(function (
-				RequestInterface $request,
-				ResponseInterface $response,
-				bool $sendResponse,
-			): void {
-				$requestBody = file_get_contents(__DIR__ . '/../../data/ics/free-busy-request.ics');
-				$this->assertEquals('POST', $request->getMethod());
-				$this->assertEquals('calendars/admin/outbox', $request->getPath());
-				$this->assertEquals('text/calendar', $request->getHeader('Content-Type'));
-				$this->assertEquals('0', $request->getHeader('Depth'));
-				$this->assertEquals($requestBody, $request->getBodyAsString());
-				$this->assertFalse($sendResponse);
-				$response->setStatus(200);
-				$response->setBody($this->getFreeBusyResponse());
-			});
-
-		$this->serverFactory->expects(self::once())
-			->method('createAttendeeAvailabilityServer')
-			->willReturn($server);
-
-		$start = new DateTimeImmutable('2025-01-16T06:00:00Z');
-		$end = new DateTimeImmutable('2025-01-17T06:00:00Z');
-		$actual = $this->manager->checkAvailability($start, $end, $organizer, [
-			'user@imap.localhost',
-			'empty@imap.localhost',
-			'nouser@domain.tld',
-		]);
-		$expected = [
-			new AvailabilityResult('admin@imap.localhost', false),
-			new AvailabilityResult('empty@imap.localhost', true),
-			new AvailabilityResult('user@imap.localhost', false),
-		];
-		$this->assertEquals($expected, $actual);
-	}
-
-	public function testCheckAvailabilityWithMailtoPrefix(): void {
-		$organizer = $this->createMock(IUser::class);
-		$organizer->expects(self::once())
-			->method('getUID')
-			->willReturn('admin');
-		$organizer->expects(self::once())
-			->method('getEMailAddress')
-			->willReturn('admin@imap.localhost');
-
-		$user1 = $this->createMock(IUser::class);
-		$user2 = $this->createMock(IUser::class);
-
-		$this->userManager->expects(self::exactly(3))
-			->method('getByEmail')
-			->willReturnMap([
-				['user@imap.localhost', [$user1]],
-				['empty@imap.localhost', [$user2]],
-				['nouser@domain.tld', []],
-			]);
-
-		$authPlugin = $this->createMock(CustomPrincipalPlugin::class);
-		$authPlugin->expects(self::once())
-			->method('setCurrentPrincipal')
-			->with('principals/users/admin');
-
-		$server = $this->createMock(Server::class);
-		$server->expects(self::once())
-			->method('getPlugin')
-			->with('auth')
-			->willReturn($authPlugin);
-		$server->expects(self::once())
-			->method('invokeMethod')
-			->willReturnCallback(function (
-				RequestInterface $request,
-				ResponseInterface $response,
-				bool $sendResponse,
-			): void {
-				$requestBody = file_get_contents(__DIR__ . '/../../data/ics/free-busy-request.ics');
-				$this->assertEquals('POST', $request->getMethod());
-				$this->assertEquals('calendars/admin/outbox', $request->getPath());
-				$this->assertEquals('text/calendar', $request->getHeader('Content-Type'));
-				$this->assertEquals('0', $request->getHeader('Depth'));
-				$this->assertEquals($requestBody, $request->getBodyAsString());
-				$this->assertFalse($sendResponse);
-				$response->setStatus(200);
-				$response->setBody($this->getFreeBusyResponse());
-			});
-
-		$this->serverFactory->expects(self::once())
-			->method('createAttendeeAvailabilityServer')
-			->willReturn($server);
-
-		$start = new DateTimeImmutable('2025-01-16T06:00:00Z');
-		$end = new DateTimeImmutable('2025-01-17T06:00:00Z');
-		$actual = $this->manager->checkAvailability($start, $end, $organizer, [
-			'mailto:user@imap.localhost',
-			'mailto:empty@imap.localhost',
-			'mailto:nouser@domain.tld',
-		]);
-		$expected = [
-			new AvailabilityResult('admin@imap.localhost', false),
-			new AvailabilityResult('empty@imap.localhost', true),
-			new AvailabilityResult('user@imap.localhost', false),
-		];
-		$this->assertEquals($expected, $actual);
-	}
+    }
+
+    public function testCheckAvailability(): void {
+        $organizer = $this->createMock(IUser::class);
+        $organizer->expects(self::once())
+            ->method('getUID')
+            ->willReturn('admin');
+        $organizer->expects(self::once())
+            ->method('getEMailAddress')
+            ->willReturn('admin@imap.localhost');
+
+        $user1 = $this->createMock(IUser::class);
+        $user2 = $this->createMock(IUser::class);
+
+        $this->userManager->expects(self::exactly(3))
+            ->method('getByEmail')
+            ->willReturnMap([
+                ['user@imap.localhost', [$user1]],
+                ['empty@imap.localhost', [$user2]],
+                ['nouser@domain.tld', []],
+            ]);
+
+        $authPlugin = $this->createMock(CustomPrincipalPlugin::class);
+        $authPlugin->expects(self::once())
+            ->method('setCurrentPrincipal')
+            ->with('principals/users/admin');
+
+        $server = $this->createMock(Server::class);
+        $server->expects(self::once())
+            ->method('getPlugin')
+            ->with('auth')
+            ->willReturn($authPlugin);
+        $server->expects(self::once())
+            ->method('invokeMethod')
+            ->willReturnCallback(function (
+                RequestInterface $request,
+                ResponseInterface $response,
+                bool $sendResponse,
+            ): void {
+                $requestBody = file_get_contents(__DIR__ . '/../../data/ics/free-busy-request.ics');
+                $this->assertEquals('POST', $request->getMethod());
+                $this->assertEquals('calendars/admin/outbox', $request->getPath());
+                $this->assertEquals('text/calendar', $request->getHeader('Content-Type'));
+                $this->assertEquals('0', $request->getHeader('Depth'));
+                $this->assertEquals($requestBody, $request->getBodyAsString());
+                $this->assertFalse($sendResponse);
+                $response->setStatus(200);
+                $response->setBody($this->getFreeBusyResponse());
+            });
+
+        $this->serverFactory->expects(self::once())
+            ->method('createAttendeeAvailabilityServer')
+            ->willReturn($server);
+
+        $start = new DateTimeImmutable('2025-01-16T06:00:00Z');
+        $end = new DateTimeImmutable('2025-01-17T06:00:00Z');
+        $actual = $this->manager->checkAvailability($start, $end, $organizer, [
+            'user@imap.localhost',
+            'empty@imap.localhost',
+            'nouser@domain.tld',
+        ]);
+        $expected = [
+            new AvailabilityResult('admin@imap.localhost', false),
+            new AvailabilityResult('empty@imap.localhost', true),
+            new AvailabilityResult('user@imap.localhost', false),
+        ];
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testCheckAvailabilityWithMailtoPrefix(): void {
+        $organizer = $this->createMock(IUser::class);
+        $organizer->expects(self::once())
+            ->method('getUID')
+            ->willReturn('admin');
+        $organizer->expects(self::once())
+            ->method('getEMailAddress')
+            ->willReturn('admin@imap.localhost');
+
+        $user1 = $this->createMock(IUser::class);
+        $user2 = $this->createMock(IUser::class);
+
+        $this->userManager->expects(self::exactly(3))
+            ->method('getByEmail')
+            ->willReturnMap([
+                ['user@imap.localhost', [$user1]],
+                ['empty@imap.localhost', [$user2]],
+                ['nouser@domain.tld', []],
+            ]);
+
+        $authPlugin = $this->createMock(CustomPrincipalPlugin::class);
+        $authPlugin->expects(self::once())
+            ->method('setCurrentPrincipal')
+            ->with('principals/users/admin');
+
+        $server = $this->createMock(Server::class);
+        $server->expects(self::once())
+            ->method('getPlugin')
+            ->with('auth')
+            ->willReturn($authPlugin);
+        $server->expects(self::once())
+            ->method('invokeMethod')
+            ->willReturnCallback(function (
+                RequestInterface $request,
+                ResponseInterface $response,
+                bool $sendResponse,
+            ): void {
+                $requestBody = file_get_contents(__DIR__ . '/../../data/ics/free-busy-request.ics');
+                $this->assertEquals('POST', $request->getMethod());
+                $this->assertEquals('calendars/admin/outbox', $request->getPath());
+                $this->assertEquals('text/calendar', $request->getHeader('Content-Type'));
+                $this->assertEquals('0', $request->getHeader('Depth'));
+                $this->assertEquals($requestBody, $request->getBodyAsString());
+                $this->assertFalse($sendResponse);
+                $response->setStatus(200);
+                $response->setBody($this->getFreeBusyResponse());
+            });
+
+        $this->serverFactory->expects(self::once())
+            ->method('createAttendeeAvailabilityServer')
+            ->willReturn($server);
+
+        $start = new DateTimeImmutable('2025-01-16T06:00:00Z');
+        $end = new DateTimeImmutable('2025-01-17T06:00:00Z');
+        $actual = $this->manager->checkAvailability($start, $end, $organizer, [
+            'mailto:user@imap.localhost',
+            'mailto:empty@imap.localhost',
+            'mailto:nouser@domain.tld',
+        ]);
+        $expected = [
+            new AvailabilityResult('admin@imap.localhost', false),
+            new AvailabilityResult('empty@imap.localhost', true),
+            new AvailabilityResult('user@imap.localhost', false),
+        ];
+        $this->assertEquals($expected, $actual);
+    }
 }