Update OCP

OCP/AppFramework/Http/Attribute/ExAppRequired.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: 2024 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OCP\AppFramework\Http\Attribute;
+
+use Attribute;
+
+/**
+ * Attribute for controller methods that can only be accessed by ExApps
+ *
+ * @since 30.0.0
+ */
+#[Attribute]
+class ExAppRequired {
+}

OCP/TaskProcessing/IManager.php

@@ -37,6 +37,14 @@ public function hasProviders(): bool;
 	 */
 	public function getProviders(): array;
 
+	/**
+	 * @param string $taskType
+	 * @return IProvider
+	 * @throws Exception
+	 * @since 30.0.0
+	 */
+	public function getPreferredProvider(string $taskType);
+
 	/**
 	 * @return array<string,array{name: string, description: string, inputShape: ShapeDescriptor[], optionalInputShape: ShapeDescriptor[], outputShape: ShapeDescriptor[], optionalOutputShape: ShapeDescriptor[]}>
 	 * @since 30.0.0
@@ -101,13 +109,14 @@ public function setTaskResult(int $id, ?string $error, ?array $result): void;
 	public function setTaskProgress(int $id, float $progress): bool;
 
 	/**
-	 * @param string|null $taskTypeId
+	 * @param list<string> $taskTypeIds
+	 * @param list<int> $taskIdsToIgnore
 	 * @return Task
 	 * @throws Exception If the query failed
 	 * @throws NotFoundException If no task could not be found
 	 * @since 30.0.0
 	 */
-	public function getNextScheduledTask(?string $taskTypeId = null): Task;
+	public function getNextScheduledTask(array $taskTypeIds = [], array $taskIdsToIgnore = []): Task;
 
 	/**
 	 * @param int $id The id of the task
@@ -154,4 +163,13 @@ public function getUserTasksByApp(?string $userId, string $appId, ?string $custo
 	 * @since 30.0.0
 	 */
 	public function prepareInputData(Task $task): array;
+
+	/**
+	 * Changes the task status to STATUS_RUNNING and, if successful, returns True.
+	 *
+	 * @param Task $task
+	 * @return bool
+	 * @since 30.0.0
+	 */
+	public function lockTask(Task $task): bool;
 }

OCP/User/IOutOfOfficeData.php

@@ -22,6 +22,8 @@
  *      endDate: int,
  *      shortMessage: string,
  *      message: string,
+ * 		replacementUserId: string,
+ * 		replacementUserDisplayName: string
  * }
  *
  * @since 28.0.0
@@ -69,6 +71,20 @@ public function getShortMessage(): string;
 	 */
 	public function getMessage(): string;
 
+	/**
+	 * Get the replacement user id for auto responders and similar
+	 *
+	 * @since 30.0.0
+	 */
+	public function getReplacementUserId(): string;
+
+	/**
+	 * Get the replacement user displayName for auto responders and similar
+	 *
+	 * @since 30.0.0
+	 */
+	public function getReplacementUserDisplayName(): string;
+
 	/**
 	 * @return OutOfOfficeData
 	 *