fix: add event status and participant status

Signed-off-by: SebastianKrupinski <krupinskis05@gmail.com>

Author: SebastianKrupinski

lib/private/Calendar/CalendarEventBuilder.php

@@ -12,6 +12,7 @@
 use DateTimeInterface;
 use InvalidArgumentException;
 use OCP\AppFramework\Utility\ITimeFactory;
+use OCP\Calendar\CalendarEventStatus;
 use OCP\Calendar\ICalendarEventBuilder;
 use OCP\Calendar\ICreateFromString;
 use Sabre\VObject\Component\VCalendar;
@@ -23,6 +24,7 @@ class CalendarEventBuilder implements ICalendarEventBuilder {
 	private ?string $summary = null;
 	private ?string $description = null;
 	private ?string $location = null;
+	private ?CalendarEventStatus $status = null;
 	private ?array $organizer = null;
 	private array $attendees = [];
 
@@ -57,6 +59,11 @@ public function setLocation(string $location): ICalendarEventBuilder {
 		return $this;
 	}
 
+	public function setStatus(CalendarEventStatus $status): static {
+		$this->status = $status;
+		return $this;
+	}
+
 	public function setOrganizer(string $email, ?string $commonName = null): ICalendarEventBuilder {
 		$this->organizer = [$email, $commonName];
 		return $this;
@@ -91,6 +98,7 @@ public function toIcs(): string {
 			'SUMMARY' => $this->summary,
 			'DTSTART' => $this->startDate,
 			'DTEND' => $this->endDate,
+			'STATUS' => $this->status->value,
 		];
 		if ($this->description !== null) {
 			$props['DESCRIPTION'] = $this->description;
@@ -126,6 +134,13 @@ private static function addAttendeeToVEvent(VEvent $vevent, string $name, array
 		$params = [];
 		if ($cn !== null) {
 			$params['CN'] = $cn;
+			if ($name === 'ORGANIZER') {
+				$params['ROLE'] = 'CHAIR';
+				$params['PARTSTAT'] = 'ACCEPTED';
+			} else {
+				$params['ROLE'] = 'REQ-PARTICIPANT';
+				$params['PARTSTAT'] = 'NEEDS-ACTION';
+			}
 		}
 		$vevent->add($name, $email, $params);
 	}

lib/public/Calendar/CalendarEventStatus.php

@@ -0,0 +1,19 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+namespace OCP\Calendar;
+
+/**
+ * The status of a calendar event.
+ *
+ * @since 32.0.0
+ */
+enum CalendarEventStatus: string {
+	case TENTATIVE = 'TENTATIVE';
+	case CONFIRMED = 'CONFIRMED';
+	case CANCELLED = 'CANCELLED';
+};

lib/public/Calendar/ICalendarEventBuilder.php

@@ -65,6 +65,13 @@ public function setDescription(string $description): self;
 	 */
 	public function setLocation(string $location): self;
 
+	/**
+	 * Set the event status.
+	 *
+	 * @since 32.0.0
+	 */
+	public function setStatus(CalendarEventStatus $status): static;
+
 	/**
 	 * Set the event organizer.
 	 * This property is required if attendees are added!

tests/data/ics/event-builder-complete.ics

@@ -8,6 +8,7 @@ DTSTAMP:20250105T000000Z
 SUMMARY:My event
 DTSTART:20250105T170958Z
 DTEND:20250105T171958Z
+STATUS:CONFIRMED
 DESCRIPTION:Foo bar baz
 ORGANIZER:mailto:organizer@domain.tld
 ATTENDEE:mailto:attendee1@domain.tld

tests/data/ics/event-builder-without-attendees.ics

@@ -8,6 +8,7 @@ DTSTAMP:20250105T000000Z
 SUMMARY:My event
 DTSTART:20250105T170958Z
 DTEND:20250105T171958Z
+STATUS:CONFIRMED
 DESCRIPTION:Foo bar baz
 END:VEVENT
 END:VCALENDAR

tests/lib/Calendar/CalendarEventBuilderTest.php

@@ -13,6 +13,7 @@
 use InvalidArgumentException;
 use OC\Calendar\CalendarEventBuilder;
 use OCP\AppFramework\Utility\ITimeFactory;
+use OCP\Calendar\CalendarEventStatus;
 use OCP\Calendar\ICreateFromString;
 use PHPUnit\Framework\MockObject\MockObject;
 use Test\TestCase;
@@ -37,6 +38,7 @@ protected function setUp(): void {
 	public function testToIcs(): void {
 		$this->calendarEventBuilder->setStartDate(new DateTimeImmutable('2025-01-05T17:09:58Z'));
 		$this->calendarEventBuilder->setEndDate(new DateTimeImmutable('2025-01-05T17:19:58Z'));
+		$this->calendarEventBuilder->setStatus(CalendarEventStatus::CONFIRMED);
 		$this->calendarEventBuilder->setSummary('My event');
 		$this->calendarEventBuilder->setDescription('Foo bar baz');
 		$this->calendarEventBuilder->setOrganizer('mailto:organizer@domain.tld');
@@ -51,6 +53,7 @@ public function testToIcs(): void {
 	public function testToIcsWithoutOrganizerAndAttendees(): void {
 		$this->calendarEventBuilder->setStartDate(new DateTimeImmutable('2025-01-05T17:09:58Z'));
 		$this->calendarEventBuilder->setEndDate(new DateTimeImmutable('2025-01-05T17:19:58Z'));
+		$this->calendarEventBuilder->setStatus(CalendarEventStatus::CONFIRMED);
 		$this->calendarEventBuilder->setSummary('My event');
 		$this->calendarEventBuilder->setDescription('Foo bar baz');
 
@@ -62,6 +65,7 @@ public function testToIcsWithoutOrganizerAndAttendees(): void {
 	public function testToIcsWithoutMailtoPrefix(): void {
 		$this->calendarEventBuilder->setStartDate(new DateTimeImmutable('2025-01-05T17:09:58Z'));
 		$this->calendarEventBuilder->setEndDate(new DateTimeImmutable('2025-01-05T17:19:58Z'));
+		$this->calendarEventBuilder->setStatus(CalendarEventStatus::CONFIRMED);
 		$this->calendarEventBuilder->setSummary('My event');
 		$this->calendarEventBuilder->setDescription('Foo bar baz');
 		$this->calendarEventBuilder->setOrganizer('organizer@domain.tld');
@@ -76,6 +80,7 @@ public function testToIcsWithoutMailtoPrefix(): void {
 	public function testCreateInCalendar(): void {
 		$this->calendarEventBuilder->setStartDate(new DateTimeImmutable('2025-01-05T17:09:58Z'));
 		$this->calendarEventBuilder->setEndDate(new DateTimeImmutable('2025-01-05T17:19:58Z'));
+		$this->calendarEventBuilder->setStatus(CalendarEventStatus::CONFIRMED);
 		$this->calendarEventBuilder->setSummary('My event');
 		$this->calendarEventBuilder->setDescription('Foo bar baz');
 		$this->calendarEventBuilder->setOrganizer('organizer@domain.tld');