nextcloud / server

apps/dav/lib/CalDAV/BirthdayService.php

Indentation +459 added lines, -459 removed lines

@@ -29,464 +29,464 @@
  * @package OCA\DAV\CalDAV
  */
 class BirthdayService {
-	public const BIRTHDAY_CALENDAR_URI = 'contact_birthdays';
-	public const EXCLUDE_FROM_BIRTHDAY_CALENDAR_PROPERTY_NAME = 'X-NC-EXCLUDE-FROM-BIRTHDAY-CALENDAR';
-
-	/**
-	 * BirthdayService constructor.
-	 */
-	public function __construct(
-		private CalDavBackend $calDavBackEnd,
-		private CardDavBackend $cardDavBackEnd,
-		private GroupPrincipalBackend $principalBackend,
-		private IConfig $config,
-		private IDBConnection $dbConnection,
-		private IL10N $l10n,
-	) {
-	}
-
-	public function onCardChanged(int $addressBookId,
-		string $cardUri,
-		string $cardData): void {
-		if (!$this->isGloballyEnabled()) {
-			return;
-		}
-
-		$targetPrincipals = $this->getAllAffectedPrincipals($addressBookId);
-		$book = $this->cardDavBackEnd->getAddressBookById($addressBookId);
-		if ($book === null) {
-			return;
-		}
-		$targetPrincipals[] = $book['principaluri'];
-		$datesToSync = [
-			['postfix' => '', 'field' => 'BDAY'],
-			['postfix' => '-death', 'field' => 'DEATHDATE'],
-			['postfix' => '-anniversary', 'field' => 'ANNIVERSARY'],
-		];
-
-		foreach ($targetPrincipals as $principalUri) {
-			if (!$this->isUserEnabled($principalUri)) {
-				continue;
-			}
-
-			$reminderOffset = $this->getReminderOffsetForUser($principalUri);
-
-			$calendar = $this->ensureCalendarExists($principalUri);
-			if ($calendar === null) {
-				return;
-			}
-			foreach ($datesToSync as $type) {
-				$this->updateCalendar($cardUri, $cardData, $book, (int)$calendar['id'], $type, $reminderOffset);
-			}
-		}
-	}
-
-	public function onCardDeleted(int $addressBookId,
-		string $cardUri): void {
-		if (!$this->isGloballyEnabled()) {
-			return;
-		}
-
-		$targetPrincipals = $this->getAllAffectedPrincipals($addressBookId);
-		$book = $this->cardDavBackEnd->getAddressBookById($addressBookId);
-		$targetPrincipals[] = $book['principaluri'];
-		foreach ($targetPrincipals as $principalUri) {
-			if (!$this->isUserEnabled($principalUri)) {
-				continue;
-			}
-
-			$calendar = $this->ensureCalendarExists($principalUri);
-			foreach (['', '-death', '-anniversary'] as $tag) {
-				$objectUri = $book['uri'] . '-' . $cardUri . $tag . '.ics';
-				$this->calDavBackEnd->deleteCalendarObject($calendar['id'], $objectUri, CalDavBackend::CALENDAR_TYPE_CALENDAR, true);
-			}
-		}
-	}
-
-	/**
-	 * @throws \Sabre\DAV\Exception\BadRequest
-	 */
-	public function ensureCalendarExists(string $principal): ?array {
-		$calendar = $this->calDavBackEnd->getCalendarByUri($principal, self::BIRTHDAY_CALENDAR_URI);
-		if (!is_null($calendar)) {
-			return $calendar;
-		}
-		$this->calDavBackEnd->createCalendar($principal, self::BIRTHDAY_CALENDAR_URI, [
-			'{DAV:}displayname' => $this->l10n->t('Contact birthdays'),
-			'{http://apple.com/ns/ical/}calendar-color' => '#E9D859',
-			'components' => 'VEVENT',
-		]);
-
-		return $this->calDavBackEnd->getCalendarByUri($principal, self::BIRTHDAY_CALENDAR_URI);
-	}
-
-	/**
-	 * @param $cardData
-	 * @param $dateField
-	 * @param $postfix
-	 * @param $reminderOffset
-	 * @return VCalendar|null
-	 * @throws InvalidDataException
-	 */
-	public function buildDateFromContact(string $cardData,
-		string $dateField,
-		string $postfix,
-		?string $reminderOffset):?VCalendar {
-		if (empty($cardData)) {
-			return null;
-		}
-		try {
-			$doc = Reader::read($cardData);
-			// We're always converting to vCard 4.0 so we can rely on the
-			// VCardConverter handling the X-APPLE-OMIT-YEAR property for us.
-			if (!$doc instanceof VCard) {
-				return null;
-			}
-			$doc = $doc->convert(Document::VCARD40);
-		} catch (Exception $e) {
-			return null;
-		}
-
-		if (isset($doc->{self::EXCLUDE_FROM_BIRTHDAY_CALENDAR_PROPERTY_NAME})) {
-			return null;
-		}
-
-		if (!isset($doc->{$dateField})) {
-			return null;
-		}
-		if (!isset($doc->FN)) {
-			return null;
-		}
-		$birthday = $doc->{$dateField};
-		if (!(string)$birthday) {
-			return null;
-		}
-		// Skip if the BDAY property is not of the right type.
-		if (!$birthday instanceof DateAndOrTime) {
-			return null;
-		}
-
-		// Skip if we can't parse the BDAY value.
-		try {
-			$dateParts = DateTimeParser::parseVCardDateTime($birthday->getValue());
-		} catch (InvalidDataException $e) {
-			return null;
-		}
-		if ($dateParts['year'] !== null) {
-			$parameters = $birthday->parameters();
-			$omitYear = (isset($parameters['X-APPLE-OMIT-YEAR'])
-					&& $parameters['X-APPLE-OMIT-YEAR'] === $dateParts['year']);
-			// 'X-APPLE-OMIT-YEAR' is not always present, at least iOS 12.4 uses the hard coded date of 1604 (the start of the gregorian calendar) when the year is unknown
-			if ($omitYear || (int)$dateParts['year'] === 1604) {
-				$dateParts['year'] = null;
-			}
-		}
-
-		$originalYear = null;
-		if ($dateParts['year'] !== null) {
-			$originalYear = (int)$dateParts['year'];
-		}
-
-		$leapDay = ((int)$dateParts['month'] === 2 && (int)$dateParts['date'] === 29);
-
-		if ($dateParts['year'] === null) {
-			$birthday = ($leapDay ? '1972-' : '1970-')
-				. $dateParts['month'] . '-' . $dateParts['date'];
-		}
-
-		try {
-			if ($birthday instanceof DateAndOrTime) {
-				$date = $birthday->getDateTime();
-			} else {
-				$date = new \DateTimeImmutable($birthday);
-			}
-		} catch (Exception $e) {
-			return null;
-		}
-
-		$summary = $this->formatTitle($dateField, $doc->FN->getValue(), $originalYear, $this->dbConnection->supports4ByteText());
-
-		$vCal = new VCalendar();
-		$vCal->VERSION = '2.0';
-		$vCal->PRODID = '-//IDN nextcloud.com//Birthday calendar//EN';
-		$vEvent = $vCal->createComponent('VEVENT');
-		$vEvent->add('DTSTART');
-		$vEvent->DTSTART->setDateTime(
-			$date
-		);
-		$vEvent->DTSTART['VALUE'] = 'DATE';
-		$vEvent->add('DTEND');
-
-		$dtEndDate = (new \DateTime())->setTimestamp($date->getTimeStamp());
-		$dtEndDate->add(new \DateInterval('P1D'));
-		$vEvent->DTEND->setDateTime(
-			$dtEndDate
-		);
-
-		$vEvent->DTEND['VALUE'] = 'DATE';
-		$vEvent->{'UID'} = $doc->UID . $postfix;
-		$vEvent->{'RRULE'} = 'FREQ=YEARLY';
-		if ($leapDay) {
-			/* Sabre\VObject supports BYMONTHDAY only if BYMONTH
+    public const BIRTHDAY_CALENDAR_URI = 'contact_birthdays';
+    public const EXCLUDE_FROM_BIRTHDAY_CALENDAR_PROPERTY_NAME = 'X-NC-EXCLUDE-FROM-BIRTHDAY-CALENDAR';
+
+    /**
+     * BirthdayService constructor.
+     */
+    public function __construct(
+        private CalDavBackend $calDavBackEnd,
+        private CardDavBackend $cardDavBackEnd,
+        private GroupPrincipalBackend $principalBackend,
+        private IConfig $config,
+        private IDBConnection $dbConnection,
+        private IL10N $l10n,
+    ) {
+    }
+
+    public function onCardChanged(int $addressBookId,
+        string $cardUri,
+        string $cardData): void {
+        if (!$this->isGloballyEnabled()) {
+            return;
+        }
+
+        $targetPrincipals = $this->getAllAffectedPrincipals($addressBookId);
+        $book = $this->cardDavBackEnd->getAddressBookById($addressBookId);
+        if ($book === null) {
+            return;
+        }
+        $targetPrincipals[] = $book['principaluri'];
+        $datesToSync = [
+            ['postfix' => '', 'field' => 'BDAY'],
+            ['postfix' => '-death', 'field' => 'DEATHDATE'],
+            ['postfix' => '-anniversary', 'field' => 'ANNIVERSARY'],
+        ];
+
+        foreach ($targetPrincipals as $principalUri) {
+            if (!$this->isUserEnabled($principalUri)) {
+                continue;
+            }
+
+            $reminderOffset = $this->getReminderOffsetForUser($principalUri);
+
+            $calendar = $this->ensureCalendarExists($principalUri);
+            if ($calendar === null) {
+                return;
+            }
+            foreach ($datesToSync as $type) {
+                $this->updateCalendar($cardUri, $cardData, $book, (int)$calendar['id'], $type, $reminderOffset);
+            }
+        }
+    }
+
+    public function onCardDeleted(int $addressBookId,
+        string $cardUri): void {
+        if (!$this->isGloballyEnabled()) {
+            return;
+        }
+
+        $targetPrincipals = $this->getAllAffectedPrincipals($addressBookId);
+        $book = $this->cardDavBackEnd->getAddressBookById($addressBookId);
+        $targetPrincipals[] = $book['principaluri'];
+        foreach ($targetPrincipals as $principalUri) {
+            if (!$this->isUserEnabled($principalUri)) {
+                continue;
+            }
+
+            $calendar = $this->ensureCalendarExists($principalUri);
+            foreach (['', '-death', '-anniversary'] as $tag) {
+                $objectUri = $book['uri'] . '-' . $cardUri . $tag . '.ics';
+                $this->calDavBackEnd->deleteCalendarObject($calendar['id'], $objectUri, CalDavBackend::CALENDAR_TYPE_CALENDAR, true);
+            }
+        }
+    }
+
+    /**
+     * @throws \Sabre\DAV\Exception\BadRequest
+     */
+    public function ensureCalendarExists(string $principal): ?array {
+        $calendar = $this->calDavBackEnd->getCalendarByUri($principal, self::BIRTHDAY_CALENDAR_URI);
+        if (!is_null($calendar)) {
+            return $calendar;
+        }
+        $this->calDavBackEnd->createCalendar($principal, self::BIRTHDAY_CALENDAR_URI, [
+            '{DAV:}displayname' => $this->l10n->t('Contact birthdays'),
+            '{http://apple.com/ns/ical/}calendar-color' => '#E9D859',
+            'components' => 'VEVENT',
+        ]);
+
+        return $this->calDavBackEnd->getCalendarByUri($principal, self::BIRTHDAY_CALENDAR_URI);
+    }
+
+    /**
+     * @param $cardData
+     * @param $dateField
+     * @param $postfix
+     * @param $reminderOffset
+     * @return VCalendar|null
+     * @throws InvalidDataException
+     */
+    public function buildDateFromContact(string $cardData,
+        string $dateField,
+        string $postfix,
+        ?string $reminderOffset):?VCalendar {
+        if (empty($cardData)) {
+            return null;
+        }
+        try {
+            $doc = Reader::read($cardData);
+            // We're always converting to vCard 4.0 so we can rely on the
+            // VCardConverter handling the X-APPLE-OMIT-YEAR property for us.
+            if (!$doc instanceof VCard) {
+                return null;
+            }
+            $doc = $doc->convert(Document::VCARD40);
+        } catch (Exception $e) {
+            return null;
+        }
+
+        if (isset($doc->{self::EXCLUDE_FROM_BIRTHDAY_CALENDAR_PROPERTY_NAME})) {
+            return null;
+        }
+
+        if (!isset($doc->{$dateField})) {
+            return null;
+        }
+        if (!isset($doc->FN)) {
+            return null;
+        }
+        $birthday = $doc->{$dateField};
+        if (!(string)$birthday) {
+            return null;
+        }
+        // Skip if the BDAY property is not of the right type.
+        if (!$birthday instanceof DateAndOrTime) {
+            return null;
+        }
+
+        // Skip if we can't parse the BDAY value.
+        try {
+            $dateParts = DateTimeParser::parseVCardDateTime($birthday->getValue());
+        } catch (InvalidDataException $e) {
+            return null;
+        }
+        if ($dateParts['year'] !== null) {
+            $parameters = $birthday->parameters();
+            $omitYear = (isset($parameters['X-APPLE-OMIT-YEAR'])
+                    && $parameters['X-APPLE-OMIT-YEAR'] === $dateParts['year']);
+            // 'X-APPLE-OMIT-YEAR' is not always present, at least iOS 12.4 uses the hard coded date of 1604 (the start of the gregorian calendar) when the year is unknown
+            if ($omitYear || (int)$dateParts['year'] === 1604) {
+                $dateParts['year'] = null;
+            }
+        }
+
+        $originalYear = null;
+        if ($dateParts['year'] !== null) {
+            $originalYear = (int)$dateParts['year'];
+        }
+
+        $leapDay = ((int)$dateParts['month'] === 2 && (int)$dateParts['date'] === 29);
+
+        if ($dateParts['year'] === null) {
+            $birthday = ($leapDay ? '1972-' : '1970-')
+                . $dateParts['month'] . '-' . $dateParts['date'];
+        }
+
+        try {
+            if ($birthday instanceof DateAndOrTime) {
+                $date = $birthday->getDateTime();
+            } else {
+                $date = new \DateTimeImmutable($birthday);
+            }
+        } catch (Exception $e) {
+            return null;
+        }
+
+        $summary = $this->formatTitle($dateField, $doc->FN->getValue(), $originalYear, $this->dbConnection->supports4ByteText());
+
+        $vCal = new VCalendar();
+        $vCal->VERSION = '2.0';
+        $vCal->PRODID = '-//IDN nextcloud.com//Birthday calendar//EN';
+        $vEvent = $vCal->createComponent('VEVENT');
+        $vEvent->add('DTSTART');
+        $vEvent->DTSTART->setDateTime(
+            $date
+        );
+        $vEvent->DTSTART['VALUE'] = 'DATE';
+        $vEvent->add('DTEND');
+
+        $dtEndDate = (new \DateTime())->setTimestamp($date->getTimeStamp());
+        $dtEndDate->add(new \DateInterval('P1D'));
+        $vEvent->DTEND->setDateTime(
+            $dtEndDate
+        );
+
+        $vEvent->DTEND['VALUE'] = 'DATE';
+        $vEvent->{'UID'} = $doc->UID . $postfix;
+        $vEvent->{'RRULE'} = 'FREQ=YEARLY';
+        if ($leapDay) {
+            /* Sabre\VObject supports BYMONTHDAY only if BYMONTH
 			 * is also set */
-			$vEvent->{'RRULE'} = 'FREQ=YEARLY;BYMONTH=2;BYMONTHDAY=-1';
-		}
-		$vEvent->{'SUMMARY'} = $summary;
-		$vEvent->{'TRANSP'} = 'TRANSPARENT';
-		$vEvent->{'X-NEXTCLOUD-BC-FIELD-TYPE'} = $dateField;
-		$vEvent->{'X-NEXTCLOUD-BC-UNKNOWN-YEAR'} = $dateParts['year'] === null ? '1' : '0';
-		if ($originalYear !== null) {
-			$vEvent->{'X-NEXTCLOUD-BC-YEAR'} = (string)$originalYear;
-		}
-		if ($reminderOffset) {
-			$alarm = $vCal->createComponent('VALARM');
-			$alarm->add($vCal->createProperty('TRIGGER', $reminderOffset, ['VALUE' => 'DURATION']));
-			$alarm->add($vCal->createProperty('ACTION', 'DISPLAY'));
-			$alarm->add($vCal->createProperty('DESCRIPTION', $vEvent->{'SUMMARY'}));
-			$vEvent->add($alarm);
-		}
-		$vCal->add($vEvent);
-		return $vCal;
-	}
-
-	/**
-	 * @param string $user
-	 */
-	public function resetForUser(string $user):void {
-		$principal = 'principals/users/' . $user;
-		$calendar = $this->calDavBackEnd->getCalendarByUri($principal, self::BIRTHDAY_CALENDAR_URI);
-		if (!$calendar) {
-			return; // The user's birthday calendar doesn't exist, no need to purge it
-		}
-		$calendarObjects = $this->calDavBackEnd->getCalendarObjects($calendar['id'], CalDavBackend::CALENDAR_TYPE_CALENDAR);
-
-		foreach ($calendarObjects as $calendarObject) {
-			$this->calDavBackEnd->deleteCalendarObject($calendar['id'], $calendarObject['uri'], CalDavBackend::CALENDAR_TYPE_CALENDAR, true);
-		}
-	}
-
-	/**
-	 * @param string $user
-	 * @throws \Sabre\DAV\Exception\BadRequest
-	 */
-	public function syncUser(string $user):void {
-		$principal = 'principals/users/' . $user;
-		$this->ensureCalendarExists($principal);
-		$books = $this->cardDavBackEnd->getAddressBooksForUser($principal);
-		foreach ($books as $book) {
-			$cards = $this->cardDavBackEnd->getCards($book['id']);
-			foreach ($cards as $card) {
-				$this->onCardChanged((int)$book['id'], $card['uri'], $card['carddata']);
-			}
-		}
-	}
-
-	/**
-	 * @param string $existingCalendarData
-	 * @param VCalendar $newCalendarData
-	 * @return bool
-	 */
-	public function birthdayEvenChanged(string $existingCalendarData,
-		VCalendar $newCalendarData):bool {
-		try {
-			$existingBirthday = Reader::read($existingCalendarData);
-		} catch (Exception $ex) {
-			return true;
-		}
-
-		return (
-			$newCalendarData->VEVENT->DTSTART->getValue() !== $existingBirthday->VEVENT->DTSTART->getValue()
-			|| $newCalendarData->VEVENT->SUMMARY->getValue() !== $existingBirthday->VEVENT->SUMMARY->getValue()
-		);
-	}
-
-	/**
-	 * @param integer $addressBookId
-	 * @return mixed
-	 */
-	protected function getAllAffectedPrincipals(int $addressBookId) {
-		$targetPrincipals = [];
-		$shares = $this->cardDavBackEnd->getShares($addressBookId);
-		foreach ($shares as $share) {
-			if ($share['{http://owncloud.org/ns}group-share']) {
-				$users = $this->principalBackend->getGroupMemberSet($share['{http://owncloud.org/ns}principal']);
-				foreach ($users as $user) {
-					$targetPrincipals[] = $user['uri'];
-				}
-			} else {
-				$targetPrincipals[] = $share['{http://owncloud.org/ns}principal'];
-			}
-		}
-		return array_values(array_unique($targetPrincipals, SORT_STRING));
-	}
-
-	/**
-	 * @param string $cardUri
-	 * @param string $cardData
-	 * @param array $book
-	 * @param int $calendarId
-	 * @param array $type
-	 * @param string $reminderOffset
-	 * @throws InvalidDataException
-	 * @throws \Sabre\DAV\Exception\BadRequest
-	 */
-	private function updateCalendar(string $cardUri,
-		string $cardData,
-		array $book,
-		int $calendarId,
-		array $type,
-		?string $reminderOffset):void {
-		$objectUri = $book['uri'] . '-' . $cardUri . $type['postfix'] . '.ics';
-		$calendarData = $this->buildDateFromContact($cardData, $type['field'], $type['postfix'], $reminderOffset);
-		$existing = $this->calDavBackEnd->getCalendarObject($calendarId, $objectUri);
-		if ($calendarData === null) {
-			if ($existing !== null) {
-				$this->calDavBackEnd->deleteCalendarObject($calendarId, $objectUri, CalDavBackend::CALENDAR_TYPE_CALENDAR, true);
-			}
-		} else {
-			if ($existing === null) {
-				// not found by URI, but maybe by UID
-				// happens when a contact with birthday is moved to a different address book
-				$calendarInfo = $this->calDavBackEnd->getCalendarById($calendarId);
-				$extraData = $this->calDavBackEnd->getDenormalizedData($calendarData->serialize());
-
-				if ($calendarInfo && array_key_exists('principaluri', $calendarInfo)) {
-					$existing2path = $this->calDavBackEnd->getCalendarObjectByUID($calendarInfo['principaluri'], $extraData['uid']);
-					if ($existing2path !== null && array_key_exists('uri', $calendarInfo)) {
-						// delete the old birthday entry first so that we do not get duplicate UIDs
-						$existing2objectUri = substr($existing2path, strlen($calendarInfo['uri']) + 1);
-						$this->calDavBackEnd->deleteCalendarObject($calendarId, $existing2objectUri, CalDavBackend::CALENDAR_TYPE_CALENDAR, true);
-					}
-				}
-
-				$this->calDavBackEnd->createCalendarObject($calendarId, $objectUri, $calendarData->serialize());
-			} else {
-				if ($this->birthdayEvenChanged($existing['calendardata'], $calendarData)) {
-					$this->calDavBackEnd->updateCalendarObject($calendarId, $objectUri, $calendarData->serialize());
-				}
-			}
-		}
-	}
-
-	/**
-	 * checks if the admin opted-out of birthday calendars
-	 *
-	 * @return bool
-	 */
-	private function isGloballyEnabled():bool {
-		return $this->config->getAppValue('dav', 'generateBirthdayCalendar', 'yes') === 'yes';
-	}
-
-	/**
-	 * Extracts the userId part of a principal
-	 *
-	 * @param string $userPrincipal
-	 * @return string|null
-	 */
-	private function principalToUserId(string $userPrincipal):?string {
-		if (str_starts_with($userPrincipal, 'principals/users/')) {
-			return substr($userPrincipal, 17);
-		}
-		return null;
-	}
-
-	/**
-	 * Checks if the user opted-out of birthday calendars
-	 *
-	 * @param string $userPrincipal The user principal to check for
-	 * @return bool
-	 */
-	private function isUserEnabled(string $userPrincipal):bool {
-		$userId = $this->principalToUserId($userPrincipal);
-		if ($userId !== null) {
-			$isEnabled = $this->config->getUserValue($userId, 'dav', 'generateBirthdayCalendar', 'yes');
-			return $isEnabled === 'yes';
-		}
-
-		// not sure how we got here, just be on the safe side and return true
-		return true;
-	}
-
-	/**
-	 * Get the reminder offset value for a user. This is a duration string (e.g.
-	 * PT9H) or null if no reminder is wanted.
-	 *
-	 * @param string $userPrincipal
-	 * @return string|null
-	 */
-	private function getReminderOffsetForUser(string $userPrincipal):?string {
-		$userId = $this->principalToUserId($userPrincipal);
-		if ($userId !== null) {
-			return $this->config->getUserValue($userId, 'dav', 'birthdayCalendarReminderOffset', 'PT9H') ?: null;
-		}
-
-		// not sure how we got here, just be on the safe side and return the default value
-		return 'PT9H';
-	}
-
-	/**
-	 * Formats title of Birthday event
-	 *
-	 * @param string $field Field name like BDAY, ANNIVERSARY, ...
-	 * @param string $name Name of contact
-	 * @param int|null $year Year of birth, anniversary, ...
-	 * @param bool $supports4Byte Whether or not the database supports 4 byte chars
-	 * @return string The formatted title
-	 */
-	private function formatTitle(string $field,
-		string $name,
-		?int $year = null,
-		bool $supports4Byte = true):string {
-		if ($supports4Byte) {
-			switch ($field) {
-				case 'BDAY':
-					return implode('', [
-						'

Spacing +22 added lines, -22 removed lines

@@ -76,7 +76,7 @@ 
 				return;
 			}
 			foreach ($datesToSync as $type) {
-				$this->updateCalendar($cardUri, $cardData, $book, (int)$calendar['id'], $type, $reminderOffset);
+				$this->updateCalendar($cardUri, $cardData, $book, (int) $calendar['id'], $type, $reminderOffset);
 			}
 		}
 	}
@@ -97,7 +97,7 @@ 
 
 			$calendar = $this->ensureCalendarExists($principalUri);
 			foreach (['', '-death', '-anniversary'] as $tag) {
-				$objectUri = $book['uri'] . '-' . $cardUri . $tag . '.ics';
+				$objectUri = $book['uri'].'-'.$cardUri.$tag.'.ics';
 				$this->calDavBackEnd->deleteCalendarObject($calendar['id'], $objectUri, CalDavBackend::CALENDAR_TYPE_CALENDAR, true);
 			}
 		}
@@ -131,7 +131,7 @@ 
 	public function buildDateFromContact(string $cardData,
 		string $dateField,
 		string $postfix,
-		?string $reminderOffset):?VCalendar {
+		?string $reminderOffset): ?VCalendar {
 		if (empty($cardData)) {
 			return null;
 		}
@@ -158,7 +158,7 @@ 
 			return null;
 		}
 		$birthday = $doc->{$dateField};
-		if (!(string)$birthday) {
+		if (!(string) $birthday) {
 			return null;
 		}
 		// Skip if the BDAY property is not of the right type.
@@ -177,21 +177,21 @@ 
 			$omitYear = (isset($parameters['X-APPLE-OMIT-YEAR'])
 					&& $parameters['X-APPLE-OMIT-YEAR'] === $dateParts['year']);
 			// 'X-APPLE-OMIT-YEAR' is not always present, at least iOS 12.4 uses the hard coded date of 1604 (the start of the gregorian calendar) when the year is unknown
-			if ($omitYear || (int)$dateParts['year'] === 1604) {
+			if ($omitYear || (int) $dateParts['year'] === 1604) {
 				$dateParts['year'] = null;
 			}
 		}
 
 		$originalYear = null;
 		if ($dateParts['year'] !== null) {
-			$originalYear = (int)$dateParts['year'];
+			$originalYear = (int) $dateParts['year'];
 		}
 
-		$leapDay = ((int)$dateParts['month'] === 2 && (int)$dateParts['date'] === 29);
+		$leapDay = ((int) $dateParts['month'] === 2 && (int) $dateParts['date'] === 29);
 
 		if ($dateParts['year'] === null) {
 			$birthday = ($leapDay ? '1972-' : '1970-')
-				. $dateParts['month'] . '-' . $dateParts['date'];
+				. $dateParts['month'].'-'.$dateParts['date'];
 		}
 
 		try {
@@ -224,7 +224,7 @@ 
 		);
 
 		$vEvent->DTEND['VALUE'] = 'DATE';
-		$vEvent->{'UID'} = $doc->UID . $postfix;
+		$vEvent->{'UID'} = $doc->UID.$postfix;
 		$vEvent->{'RRULE'} = 'FREQ=YEARLY';
 		if ($leapDay) {
 			/* Sabre\VObject supports BYMONTHDAY only if BYMONTH
@@ -236,7 +236,7 @@ 
 		$vEvent->{'X-NEXTCLOUD-BC-FIELD-TYPE'} = $dateField;
 		$vEvent->{'X-NEXTCLOUD-BC-UNKNOWN-YEAR'} = $dateParts['year'] === null ? '1' : '0';
 		if ($originalYear !== null) {
-			$vEvent->{'X-NEXTCLOUD-BC-YEAR'} = (string)$originalYear;
+			$vEvent->{'X-NEXTCLOUD-BC-YEAR'} = (string) $originalYear;
 		}
 		if ($reminderOffset) {
 			$alarm = $vCal->createComponent('VALARM');
@@ -253,7 +253,7 @@ 
 	 * @param string $user
 	 */
 	public function resetForUser(string $user):void {
-		$principal = 'principals/users/' . $user;
+		$principal = 'principals/users/'.$user;
 		$calendar = $this->calDavBackEnd->getCalendarByUri($principal, self::BIRTHDAY_CALENDAR_URI);
 		if (!$calendar) {
 			return; // The user's birthday calendar doesn't exist, no need to purge it
@@ -270,13 +270,13 @@ 
 	 * @throws \Sabre\DAV\Exception\BadRequest
 	 */
 	public function syncUser(string $user):void {
-		$principal = 'principals/users/' . $user;
+		$principal = 'principals/users/'.$user;
 		$this->ensureCalendarExists($principal);
 		$books = $this->cardDavBackEnd->getAddressBooksForUser($principal);
 		foreach ($books as $book) {
 			$cards = $this->cardDavBackEnd->getCards($book['id']);
 			foreach ($cards as $card) {
-				$this->onCardChanged((int)$book['id'], $card['uri'], $card['carddata']);
+				$this->onCardChanged((int) $book['id'], $card['uri'], $card['carddata']);
 			}
 		}
 	}
@@ -336,7 +336,7 @@ 
 		int $calendarId,
 		array $type,
 		?string $reminderOffset):void {
-		$objectUri = $book['uri'] . '-' . $cardUri . $type['postfix'] . '.ics';
+		$objectUri = $book['uri'].'-'.$cardUri.$type['postfix'].'.ics';
 		$calendarData = $this->buildDateFromContact($cardData, $type['field'], $type['postfix'], $reminderOffset);
 		$existing = $this->calDavBackEnd->getCalendarObject($calendarId, $objectUri);
 		if ($calendarData === null) {
@@ -383,7 +383,7 @@ 
 	 * @param string $userPrincipal
 	 * @return string|null
 	 */
-	private function principalToUserId(string $userPrincipal):?string {
+	private function principalToUserId(string $userPrincipal): ?string {
 		if (str_starts_with($userPrincipal, 'principals/users/')) {
 			return substr($userPrincipal, 17);
 		}
@@ -414,7 +414,7 @@ 
 	 * @param string $userPrincipal
 	 * @return string|null
 	 */
-	private function getReminderOffsetForUser(string $userPrincipal):?string {
+	private function getReminderOffsetForUser(string $userPrincipal): ?string {
 		$userId = $this->principalToUserId($userPrincipal);
 		if ($userId !== null) {
 			return $this->config->getUserValue($userId, 'dav', 'birthdayCalendarReminderOffset', 'PT9H') ?: null;
@@ -443,20 +443,20 @@ 
 					return implode('', [
 						'

apps/dav/tests/unit/CardDAV/BirthdayServiceTest.php

Indentation +409 added lines, -409 removed lines

@@ -21,413 +21,413 @@
 use Test\TestCase;
 
 class BirthdayServiceTest extends TestCase {
-	private CalDavBackend&MockObject $calDav;
-	private CardDavBackend&MockObject $cardDav;
-	private GroupPrincipalBackend&MockObject $groupPrincipalBackend;
-	private IConfig&MockObject $config;
-	private IDBConnection&MockObject $dbConnection;
-	private IL10N&MockObject $l10n;
-	private BirthdayService $service;
-
-	protected function setUp(): void {
-		parent::setUp();
-
-		$this->calDav = $this->createMock(CalDavBackend::class);
-		$this->cardDav = $this->createMock(CardDavBackend::class);
-		$this->groupPrincipalBackend = $this->createMock(GroupPrincipalBackend::class);
-		$this->config = $this->createMock(IConfig::class);
-		$this->dbConnection = $this->createMock(IDBConnection::class);
-		$this->l10n = $this->createMock(IL10N::class);
-
-		$this->l10n->expects($this->any())
-			->method('t')
-			->willReturnCallback(function ($string, $args) {
-				return vsprintf($string, $args);
-			});
-
-		$this->service = new BirthdayService($this->calDav, $this->cardDav,
-			$this->groupPrincipalBackend, $this->config,
-			$this->dbConnection, $this->l10n);
-	}
-
-	#[\PHPUnit\Framework\Attributes\DataProvider('providesVCards')]
-	public function testBuildBirthdayFromContact(?string $expectedSummary, ?string $expectedDTStart, ?string $expectedRrule, ?string $expectedFieldType, ?string $expectedUnknownYear, ?string $expectedOriginalYear, ?string $expectedReminder, ?string $data, string $fieldType, string $prefix, bool $supports4Bytes, ?string $configuredReminder): void {
-		$this->dbConnection->method('supports4ByteText')->willReturn($supports4Bytes);
-		$cal = $this->service->buildDateFromContact($data, $fieldType, $prefix, $configuredReminder);
-
-		if ($expectedSummary === null) {
-			$this->assertNull($cal);
-		} else {
-			$this->assertInstanceOf('Sabre\VObject\Component\VCalendar', $cal);
-			$this->assertEquals('-//IDN nextcloud.com//Birthday calendar//EN', $cal->PRODID->getValue());
-			$this->assertTrue(isset($cal->VEVENT));
-			$this->assertEquals($expectedRrule, $cal->VEVENT->RRULE->getValue());
-			$this->assertEquals($expectedSummary, $cal->VEVENT->SUMMARY->getValue());
-			$this->assertEquals($expectedDTStart, $cal->VEVENT->DTSTART->getValue());
-			$this->assertEquals($expectedFieldType, $cal->VEVENT->{'X-NEXTCLOUD-BC-FIELD-TYPE'}->getValue());
-			$this->assertEquals($expectedUnknownYear, $cal->VEVENT->{'X-NEXTCLOUD-BC-UNKNOWN-YEAR'}->getValue());
-
-			if ($expectedOriginalYear) {
-				$this->assertEquals($expectedOriginalYear, $cal->VEVENT->{'X-NEXTCLOUD-BC-YEAR'}->getValue());
-			}
-
-			if ($expectedReminder) {
-				$this->assertEquals($expectedReminder, $cal->VEVENT->VALARM->TRIGGER->getValue());
-				$this->assertEquals('DURATION', $cal->VEVENT->VALARM->TRIGGER->getValueType());
-			}
-
-			$this->assertEquals('TRANSPARENT', $cal->VEVENT->TRANSP->getValue());
-		}
-	}
-
-	public function testOnCardDeleteGloballyDisabled(): void {
-		$this->config->expects($this->once())
-			->method('getAppValue')
-			->with('dav', 'generateBirthdayCalendar', 'yes')
-			->willReturn('no');
-
-		$this->cardDav->expects($this->never())->method('getAddressBookById');
-
-		$this->service->onCardDeleted(666, 'gump.vcf');
-	}
-
-	public function testOnCardDeleteUserDisabled(): void {
-		$this->config->expects($this->once())
-			->method('getAppValue')
-			->with('dav', 'generateBirthdayCalendar', 'yes')
-			->willReturn('yes');
-
-		$this->config->expects($this->once())
-			->method('getUserValue')
-			->with('user01', 'dav', 'generateBirthdayCalendar', 'yes')
-			->willReturn('no');
-
-		$this->cardDav->expects($this->once())->method('getAddressBookById')
-			->with(666)
-			->willReturn([
-				'principaluri' => 'principals/users/user01',
-				'uri' => 'default'
-			]);
-		$this->cardDav->expects($this->once())->method('getShares')->willReturn([]);
-		$this->calDav->expects($this->never())->method('getCalendarByUri');
-		$this->calDav->expects($this->never())->method('deleteCalendarObject');
-
-		$this->service->onCardDeleted(666, 'gump.vcf');
-	}
-
-	public function testOnCardDeleted(): void {
-		$this->config->expects($this->once())
-			->method('getAppValue')
-			->with('dav', 'generateBirthdayCalendar', 'yes')
-			->willReturn('yes');
-
-		$this->config->expects($this->once())
-			->method('getUserValue')
-			->with('user01', 'dav', 'generateBirthdayCalendar', 'yes')
-			->willReturn('yes');
-
-		$this->cardDav->expects($this->once())->method('getAddressBookById')
-			->with(666)
-			->willReturn([
-				'principaluri' => 'principals/users/user01',
-				'uri' => 'default'
-			]);
-		$this->calDav->expects($this->once())->method('getCalendarByUri')
-			->with('principals/users/user01', 'contact_birthdays')
-			->willReturn([
-				'id' => 1234
-			]);
-		$calls = [
-			[1234, 'default-gump.vcf.ics'],
-			[1234, 'default-gump.vcf-death.ics'],
-			[1234, 'default-gump.vcf-anniversary.ics'],
-		];
-		$this->calDav->expects($this->exactly(count($calls)))
-			->method('deleteCalendarObject')
-			->willReturnCallback(function ($calendarId, $objectUri) use (&$calls): void {
-				$expected = array_shift($calls);
-				$this->assertEquals($expected, [$calendarId, $objectUri]);
-			});
-		$this->cardDav->expects($this->once())->method('getShares')->willReturn([]);
-
-		$this->service->onCardDeleted(666, 'gump.vcf');
-	}
-
-	public function testOnCardChangedGloballyDisabled(): void {
-		$this->config->expects($this->once())
-			->method('getAppValue')
-			->with('dav', 'generateBirthdayCalendar', 'yes')
-			->willReturn('no');
-
-		$this->cardDav->expects($this->never())->method('getAddressBookById');
-
-		$service = $this->getMockBuilder(BirthdayService::class)
-			->onlyMethods(['buildDateFromContact', 'birthdayEvenChanged'])
-			->setConstructorArgs([$this->calDav, $this->cardDav, $this->groupPrincipalBackend, $this->config, $this->dbConnection, $this->l10n])
-			->getMock();
-
-		$service->onCardChanged(666, 'gump.vcf', '');
-	}
-
-	public function testOnCardChangedUserDisabled(): void {
-		$this->config->expects($this->once())
-			->method('getAppValue')
-			->with('dav', 'generateBirthdayCalendar', 'yes')
-			->willReturn('yes');
-
-		$this->config->expects($this->once())
-			->method('getUserValue')
-			->with('user01', 'dav', 'generateBirthdayCalendar', 'yes')
-			->willReturn('no');
-
-		$this->cardDav->expects($this->once())->method('getAddressBookById')
-			->with(666)
-			->willReturn([
-				'principaluri' => 'principals/users/user01',
-				'uri' => 'default'
-			]);
-		$this->cardDav->expects($this->once())->method('getShares')->willReturn([]);
-		$this->calDav->expects($this->never())->method('getCalendarByUri');
-
-		/** @var BirthdayService&MockObject $service */
-		$service = $this->getMockBuilder(BirthdayService::class)
-			->onlyMethods(['buildDateFromContact', 'birthdayEvenChanged'])
-			->setConstructorArgs([$this->calDav, $this->cardDav, $this->groupPrincipalBackend, $this->config, $this->dbConnection, $this->l10n])
-			->getMock();
-
-		$service->onCardChanged(666, 'gump.vcf', '');
-	}
-
-	#[\PHPUnit\Framework\Attributes\DataProvider('providesCardChanges')]
-	public function testOnCardChanged(string $expectedOp): void {
-		$this->config->expects($this->once())
-			->method('getAppValue')
-			->with('dav', 'generateBirthdayCalendar', 'yes')
-			->willReturn('yes');
-
-		$this->config->expects($this->exactly(2))
-			->method('getUserValue')
-			->willReturnMap([
-				['user01', 'dav', 'generateBirthdayCalendar', 'yes', 'yes'],
-				['user01', 'dav', 'birthdayCalendarReminderOffset', 'PT9H', 'PT9H'],
-			]);
-
-		$this->cardDav->expects($this->once())->method('getAddressBookById')
-			->with(666)
-			->willReturn([
-				'principaluri' => 'principals/users/user01',
-				'uri' => 'default'
-			]);
-		$this->calDav->expects($this->once())->method('getCalendarByUri')
-			->with('principals/users/user01', 'contact_birthdays')
-			->willReturn([
-				'id' => 1234
-			]);
-		$this->cardDav->expects($this->once())->method('getShares')->willReturn([]);
-
-		/** @var BirthdayService&MockObject $service */
-		$service = $this->getMockBuilder(BirthdayService::class)
-			->onlyMethods(['buildDateFromContact', 'birthdayEvenChanged'])
-			->setConstructorArgs([$this->calDav, $this->cardDav, $this->groupPrincipalBackend, $this->config, $this->dbConnection, $this->l10n])
-			->getMock();
-
-		if ($expectedOp === 'delete') {
-			$this->calDav->expects($this->exactly(3))->method('getCalendarObject')->willReturn('');
-			$service->expects($this->exactly(3))->method('buildDateFromContact')->willReturn(null);
-
-			$calls = [
-				[1234, 'default-gump.vcf.ics'],
-				[1234, 'default-gump.vcf-death.ics'],
-				[1234, 'default-gump.vcf-anniversary.ics']
-			];
-			$this->calDav->expects($this->exactly(count($calls)))
-				->method('deleteCalendarObject')
-				->willReturnCallback(function ($calendarId, $objectUri) use (&$calls): void {
-					$expected = array_shift($calls);
-					$this->assertEquals($expected, [$calendarId, $objectUri]);
-				});
-		}
-		if ($expectedOp === 'create') {
-			$vCal = new VCalendar();
-			$vCal->PRODID = '-//Nextcloud testing//mocked object//';
-
-			$service->expects($this->exactly(3))->method('buildDateFromContact')->willReturn($vCal);
-
-			$createCalendarObjectCalls = [
-				[1234, 'default-gump.vcf.ics', "BEGIN:VCALENDAR\r\nVERSION:2.0\r\nCALSCALE:GREGORIAN\r\nPRODID:-//Nextcloud testing//mocked object//\r\nEND:VCALENDAR\r\n"],
-				[1234, 'default-gump.vcf-death.ics', "BEGIN:VCALENDAR\r\nVERSION:2.0\r\nCALSCALE:GREGORIAN\r\nPRODID:-//Nextcloud testing//mocked object//\r\nEND:VCALENDAR\r\n"],
-				[1234, 'default-gump.vcf-anniversary.ics', "BEGIN:VCALENDAR\r\nVERSION:2.0\r\nCALSCALE:GREGORIAN\r\nPRODID:-//Nextcloud testing//mocked object//\r\nEND:VCALENDAR\r\n"]
-			];
-			$this->calDav->expects($this->exactly(count($createCalendarObjectCalls)))
-				->method('createCalendarObject')
-				->willReturnCallback(function ($calendarId, $objectUri, $calendarData) use (&$createCalendarObjectCalls): void {
-					$expected = array_shift($createCalendarObjectCalls);
-					$this->assertEquals($expected, [$calendarId, $objectUri, $calendarData]);
-				});
-		}
-		if ($expectedOp === 'update') {
-			$vCal = new VCalendar();
-			$vCal->PRODID = '-//Nextcloud testing//mocked object//';
-
-			$service->expects($this->exactly(3))->method('buildDateFromContact')->willReturn($vCal);
-			$service->expects($this->exactly(3))->method('birthdayEvenChanged')->willReturn(true);
-			$this->calDav->expects($this->exactly(3))->method('getCalendarObject')->willReturn(['calendardata' => '']);
-
-			$updateCalendarObjectCalls = [
-				[1234, 'default-gump.vcf.ics', "BEGIN:VCALENDAR\r\nVERSION:2.0\r\nCALSCALE:GREGORIAN\r\nPRODID:-//Nextcloud testing//mocked object//\r\nEND:VCALENDAR\r\n"],
-				[1234, 'default-gump.vcf-death.ics', "BEGIN:VCALENDAR\r\nVERSION:2.0\r\nCALSCALE:GREGORIAN\r\nPRODID:-//Nextcloud testing//mocked object//\r\nEND:VCALENDAR\r\n"],
-				[1234, 'default-gump.vcf-anniversary.ics', "BEGIN:VCALENDAR\r\nVERSION:2.0\r\nCALSCALE:GREGORIAN\r\nPRODID:-//Nextcloud testing//mocked object//\r\nEND:VCALENDAR\r\n"]
-			];
-			$this->calDav->expects($this->exactly(count($updateCalendarObjectCalls)))
-				->method('updateCalendarObject')
-				->willReturnCallback(function ($calendarId, $objectUri, $calendarData) use (&$updateCalendarObjectCalls): void {
-					$expected = array_shift($updateCalendarObjectCalls);
-					$this->assertEquals($expected, [$calendarId, $objectUri, $calendarData]);
-				});
-		}
-
-		$service->onCardChanged(666, 'gump.vcf', '');
-	}
-
-	#[\PHPUnit\Framework\Attributes\DataProvider('providesBirthday')]
-	public function testBirthdayEvenChanged(bool $expected, string $old, string $new): void {
-		$new = Reader::read($new);
-		$this->assertEquals($expected, $this->service->birthdayEvenChanged($old, $new));
-	}
-
-	public function testGetAllAffectedPrincipals(): void {
-		$this->cardDav->expects($this->once())->method('getShares')->willReturn([
-			[
-				'{http://owncloud.org/ns}group-share' => false,
-				'{http://owncloud.org/ns}principal' => 'principals/users/user01'
-			],
-			[
-				'{http://owncloud.org/ns}group-share' => false,
-				'{http://owncloud.org/ns}principal' => 'principals/users/user01'
-			],
-			[
-				'{http://owncloud.org/ns}group-share' => false,
-				'{http://owncloud.org/ns}principal' => 'principals/users/user02'
-			],
-			[
-				'{http://owncloud.org/ns}group-share' => true,
-				'{http://owncloud.org/ns}principal' => 'principals/groups/users'
-			],
-		]);
-		$this->groupPrincipalBackend->expects($this->once())->method('getGroupMemberSet')
-			->willReturn([
-				[
-					'uri' => 'principals/users/user01',
-				],
-				[
-					'uri' => 'principals/users/user02',
-				],
-				[
-					'uri' => 'principals/users/user03',
-				],
-			]);
-		$users = $this->invokePrivate($this->service, 'getAllAffectedPrincipals', [6666]);
-		$this->assertEquals([
-			'principals/users/user01',
-			'principals/users/user02',
-			'principals/users/user03'
-		], $users);
-	}
-
-	public function testBirthdayCalendarHasComponentEvent(): void {
-		$this->calDav->expects($this->once())
-			->method('createCalendar')
-			->with('principal001', 'contact_birthdays', [
-				'{DAV:}displayname' => 'Contact birthdays',
-				'{http://apple.com/ns/ical/}calendar-color' => '#E9D859',
-				'components' => 'VEVENT',
-			]);
-		$this->service->ensureCalendarExists('principal001');
-	}
-
-	public function testResetForUser(): void {
-		$this->calDav->expects($this->once())
-			->method('getCalendarByUri')
-			->with('principals/users/user123', 'contact_birthdays')
-			->willReturn(['id' => 42]);
-
-		$this->calDav->expects($this->once())
-			->method('getCalendarObjects')
-			->with(42, 0)
-			->willReturn([['uri' => '1.ics'], ['uri' => '2.ics'], ['uri' => '3.ics']]);
-
-		$calls = [
-			[42, '1.ics', 0],
-			[42, '2.ics', 0],
-			[42, '3.ics', 0],
-		];
-		$this->calDav->expects($this->exactly(count($calls)))
-			->method('deleteCalendarObject')
-			->willReturnCallback(function ($calendarId, $objectUri, $calendarType) use (&$calls): void {
-				$expected = array_shift($calls);
-				$this->assertEquals($expected, [$calendarId, $objectUri, $calendarType]);
-			});
-
-		$this->service->resetForUser('user123');
-	}
-
-	public static function providesBirthday(): array {
-		return [
-			[true,
-				'',
-				"BEGIN:VCALENDAR\r\nVERSION:2.0\r\nPRODID:-//Sabre//Sabre VObject 4.1.1//EN\r\nCALSCALE:GREGORIAN\r\nBEGIN:VEVENT\r\nUID:12345\r\nDTSTAMP:20160218T133704Z\r\nDTSTART;VALUE=DATE:19000101\r\nDTEND;VALUE=DATE:19000102\r\nRRULE:FREQ=YEARLY\r\nSUMMARY:12345's Birthday (1900)\r\nTRANSP:TRANSPARENT\r\nEND:VEVENT\r\nEND:VCALENDAR\r\n"],
-			[false,
-				"BEGIN:VCALENDAR\r\nVERSION:2.0\r\nPRODID:-//Sabre//Sabre VObject 4.1.1//EN\r\nCALSCALE:GREGORIAN\r\nBEGIN:VEVENT\r\nUID:12345\r\nDTSTAMP:20160218T133704Z\r\nDTSTART;VALUE=DATE:19000101\r\nDTEND;VALUE=DATE:19000102\r\nRRULE:FREQ=YEARLY\r\nSUMMARY:12345's Birthday (1900)\r\nTRANSP:TRANSPARENT\r\nEND:VEVENT\r\nEND:VCALENDAR\r\n",
-				"BEGIN:VCALENDAR\r\nVERSION:2.0\r\nPRODID:-//Sabre//Sabre VObject 4.1.1//EN\r\nCALSCALE:GREGORIAN\r\nBEGIN:VEVENT\r\nUID:12345\r\nDTSTAMP:20160218T133704Z\r\nDTSTART;VALUE=DATE:19000101\r\nDTEND;VALUE=DATE:19000102\r\nRRULE:FREQ=YEARLY\r\nSUMMARY:12345's Birthday (1900)\r\nTRANSP:TRANSPARENT\r\nEND:VEVENT\r\nEND:VCALENDAR\r\n"],
-			[true,
-				"BEGIN:VCALENDAR\r\nVERSION:2.0\r\nPRODID:-//Sabre//Sabre VObject 4.1.1//EN\r\nCALSCALE:GREGORIAN\r\nBEGIN:VEVENT\r\nUID:12345\r\nDTSTAMP:20160218T133704Z\r\nDTSTART;VALUE=DATE:19000101\r\nDTEND;VALUE=DATE:19000102\r\nRRULE:FREQ=YEARLY\r\nSUMMARY:4567's Birthday (1900)\r\nTRANSP:TRANSPARENT\r\nEND:VEVENT\r\nEND:VCALENDAR\r\n",
-				"BEGIN:VCALENDAR\r\nVERSION:2.0\r\nPRODID:-//Sabre//Sabre VObject 4.1.1//EN\r\nCALSCALE:GREGORIAN\r\nBEGIN:VEVENT\r\nUID:12345\r\nDTSTAMP:20160218T133704Z\r\nDTSTART;VALUE=DATE:19000101\r\nDTEND;VALUE=DATE:19000102\r\nRRULE:FREQ=YEARLY\r\nSUMMARY:12345's Birthday (1900)\r\nTRANSP:TRANSPARENT\r\nEND:VEVENT\r\nEND:VCALENDAR\r\n"],
-			[true,
-				"BEGIN:VCALENDAR\r\nVERSION:2.0\r\nPRODID:-//Sabre//Sabre VObject 4.1.1//EN\r\nCALSCALE:GREGORIAN\r\nBEGIN:VEVENT\r\nUID:12345\r\nDTSTAMP:20160218T133704Z\r\nDTSTART;VALUE=DATE:19000101\r\nDTEND;VALUE=DATE:19000102\r\nRRULE:FREQ=YEARLY\r\nSUMMARY:12345's Birthday (1900)\r\nTRANSP:TRANSPARENT\r\nEND:VEVENT\r\nEND:VCALENDAR\r\n",
-				"BEGIN:VCALENDAR\r\nVERSION:2.0\r\nPRODID:-//Sabre//Sabre VObject 4.1.1//EN\r\nCALSCALE:GREGORIAN\r\nBEGIN:VEVENT\r\nUID:12345\r\nDTSTAMP:20160218T133704Z\r\nDTSTART;VALUE=DATE:19000102\r\nDTEND;VALUE=DATE:19000102\r\nRRULE:FREQ=YEARLY\r\nSUMMARY:12345's Birthday (1900)\r\nTRANSP:TRANSPARENT\r\nEND:VEVENT\r\nEND:VCALENDAR\r\n"]
-		];
-	}
-
-	public static function providesCardChanges(): array {
-		return[
-			['delete'],
-			['create'],
-			['update']
-		];
-	}
-
-	public static function providesVCards(): array {
-		return [
-			// $expectedSummary, $expectedDTStart, $expectedRrule, $expectedFieldType, $expectedUnknownYear, $expectedOriginalYear, $expectedReminder, $data, $fieldType, $prefix, $supports4Byte, $configuredReminder
-			[null, null, null, null, null, null, null, 'yasfewf', '', '', true, null],
-			[null, null, null, null, null, null, null, "BEGIN:VCARD\r\nVERSION:3.0\r\nPRODID:-//Sabre//Sabre VObject 4.1.1//EN\r\nUID:12345\r\nFN:12345\r\nN:12345;;;;\r\nEND:VCARD\r\n", 'BDAY', '', true, null],
-			[null, null, null, null, null, null, null, "BEGIN:VCARD\r\nVERSION:3.0\r\nPRODID:-//Sabre//Sabre VObject 4.1.1//EN\r\nUID:12345\r\nFN:12345\r\nN:12345;;;;\r\nBDAY:\r\nEND:VCARD\r\n", 'BDAY', '', true, null],
-			[null, null, null, null, null, null, null, "BEGIN:VCARD\r\nVERSION:3.0\r\nPRODID:-//Sabre//Sabre VObject 4.1.1//EN\r\nUID:12345\r\nFN:12345\r\nN:12345;;;;\r\nBDAY:someday\r\nEND:VCARD\r\n", 'BDAY', '', true, null],
-			['