From 397b1d1654d543a6cd040f5de31725055c457ad0 Mon Sep 17 00:00:00 2001 From: Marcel Klehr Date: Fri, 26 Jul 2024 11:20:46 +0200 Subject: [PATCH] chore: deprecate old AI APIs Signed-off-by: Marcel Klehr --- lib/public/SpeechToText/Events/AbstractTranscriptionEvent.php | 1 + lib/public/SpeechToText/Events/TranscriptionFailedEvent.php | 1 + lib/public/SpeechToText/Events/TranscriptionSuccessfulEvent.php | 1 + lib/public/SpeechToText/ISpeechToTextManager.php | 1 + lib/public/SpeechToText/ISpeechToTextProvider.php | 1 + lib/public/SpeechToText/ISpeechToTextProviderWithId.php | 1 + lib/public/SpeechToText/ISpeechToTextProviderWithUserId.php | 1 + lib/public/TextProcessing/Events/AbstractTextProcessingEvent.php | 1 + lib/public/TextProcessing/Events/TaskFailedEvent.php | 1 + lib/public/TextProcessing/Events/TaskSuccessfulEvent.php | 1 + lib/public/TextProcessing/Exception/TaskFailureException.php | 1 + lib/public/TextProcessing/FreePromptTaskType.php | 1 + lib/public/TextProcessing/HeadlineTaskType.php | 1 + lib/public/TextProcessing/IManager.php | 1 + lib/public/TextProcessing/IProvider.php | 1 + lib/public/TextProcessing/IProviderWithExpectedRuntime.php | 1 + lib/public/TextProcessing/IProviderWithId.php | 1 + lib/public/TextProcessing/IProviderWithUserId.php | 1 + lib/public/TextProcessing/ITaskType.php | 1 + lib/public/TextProcessing/SummaryTaskType.php | 1 + lib/public/TextProcessing/Task.php | 1 + lib/public/TextProcessing/TopicsTaskType.php | 1 + lib/public/TextToImage/Events/AbstractTextToImageEvent.php | 1 + lib/public/TextToImage/Events/TaskFailedEvent.php | 1 + lib/public/TextToImage/Events/TaskSuccessfulEvent.php | 1 + lib/public/TextToImage/Exception/TaskFailureException.php | 1 + lib/public/TextToImage/Exception/TaskNotFoundException.php | 1 + lib/public/TextToImage/Exception/TextToImageException.php | 1 + lib/public/TextToImage/IManager.php | 1 + lib/public/TextToImage/IProvider.php | 1 + lib/public/TextToImage/IProviderWithUserId.php | 1 + lib/public/TextToImage/Task.php | 1 + lib/public/Translation/CouldNotTranslateException.php | 1 + lib/public/Translation/IDetectLanguageProvider.php | 1 + lib/public/Translation/ITranslationManager.php | 1 + lib/public/Translation/ITranslationProvider.php | 1 + lib/public/Translation/ITranslationProviderWithId.php | 1 + lib/public/Translation/ITranslationProviderWithUserId.php | 1 + lib/public/Translation/LanguageTuple.php | 1 + 39 files changed, 39 insertions(+) diff --git a/lib/public/SpeechToText/Events/AbstractTranscriptionEvent.php b/lib/public/SpeechToText/Events/AbstractTranscriptionEvent.php index eeb7695b387..6554292d413 100644 --- a/lib/public/SpeechToText/Events/AbstractTranscriptionEvent.php +++ b/lib/public/SpeechToText/Events/AbstractTranscriptionEvent.php @@ -13,6 +13,7 @@ use OCP\Files\File; /** * @since 27.0.0 + * @deprecated 30.0.0 */ abstract class AbstractTranscriptionEvent extends Event { /** diff --git a/lib/public/SpeechToText/Events/TranscriptionFailedEvent.php b/lib/public/SpeechToText/Events/TranscriptionFailedEvent.php index 53eb56c2ea9..4c2b0d52017 100644 --- a/lib/public/SpeechToText/Events/TranscriptionFailedEvent.php +++ b/lib/public/SpeechToText/Events/TranscriptionFailedEvent.php @@ -15,6 +15,7 @@ use OCP\Files\File; /** * This Event is emitted if a transcription of a media file using a Speech-To-Text provider failed * @since 27.0.0 + * @deprecated 30.0.0 */ class TranscriptionFailedEvent extends AbstractTranscriptionEvent { /** diff --git a/lib/public/SpeechToText/Events/TranscriptionSuccessfulEvent.php b/lib/public/SpeechToText/Events/TranscriptionSuccessfulEvent.php index 1e333fdc3c7..e8e5359a29e 100644 --- a/lib/public/SpeechToText/Events/TranscriptionSuccessfulEvent.php +++ b/lib/public/SpeechToText/Events/TranscriptionSuccessfulEvent.php @@ -15,6 +15,7 @@ use OCP\Files\File; /** * This Event is emitted when a transcription of a media file happened successfully * @since 27.0.0 + * @deprecated 30.0.0 */ class TranscriptionSuccessfulEvent extends AbstractTranscriptionEvent { /** diff --git a/lib/public/SpeechToText/ISpeechToTextManager.php b/lib/public/SpeechToText/ISpeechToTextManager.php index 27523a69a95..043dac0ba14 100644 --- a/lib/public/SpeechToText/ISpeechToTextManager.php +++ b/lib/public/SpeechToText/ISpeechToTextManager.php @@ -17,6 +17,7 @@ use RuntimeException; /** * @since 27.0.0 + * @deprecated 30.0.0 */ interface ISpeechToTextManager { /** diff --git a/lib/public/SpeechToText/ISpeechToTextProvider.php b/lib/public/SpeechToText/ISpeechToTextProvider.php index a1aca06e2e4..dce4a68ea0a 100644 --- a/lib/public/SpeechToText/ISpeechToTextProvider.php +++ b/lib/public/SpeechToText/ISpeechToTextProvider.php @@ -15,6 +15,7 @@ use RuntimeException; /** * @since 27.0.0 + * @deprecated 30.0.0 */ interface ISpeechToTextProvider { /** diff --git a/lib/public/SpeechToText/ISpeechToTextProviderWithId.php b/lib/public/SpeechToText/ISpeechToTextProviderWithId.php index a1d73d10a58..8020c6c9b96 100644 --- a/lib/public/SpeechToText/ISpeechToTextProviderWithId.php +++ b/lib/public/SpeechToText/ISpeechToTextProviderWithId.php @@ -8,6 +8,7 @@ namespace OCP\SpeechToText; /** * @since 28.0.0 + * @deprecated 30.0.0 */ interface ISpeechToTextProviderWithId extends ISpeechToTextProvider { diff --git a/lib/public/SpeechToText/ISpeechToTextProviderWithUserId.php b/lib/public/SpeechToText/ISpeechToTextProviderWithUserId.php index f1b84476b9a..d1bc4216a38 100644 --- a/lib/public/SpeechToText/ISpeechToTextProviderWithUserId.php +++ b/lib/public/SpeechToText/ISpeechToTextProviderWithUserId.php @@ -12,6 +12,7 @@ namespace OCP\SpeechToText; /** * @since 29.0.0 + * @deprecated 30.0.0 */ interface ISpeechToTextProviderWithUserId extends ISpeechToTextProvider { /** diff --git a/lib/public/TextProcessing/Events/AbstractTextProcessingEvent.php b/lib/public/TextProcessing/Events/AbstractTextProcessingEvent.php index d61847716bf..e42f64ca28c 100644 --- a/lib/public/TextProcessing/Events/AbstractTextProcessingEvent.php +++ b/lib/public/TextProcessing/Events/AbstractTextProcessingEvent.php @@ -13,6 +13,7 @@ use OCP\TextProcessing\Task; /** * @since 27.1.0 + * @deprecated 30.0.0 */ abstract class AbstractTextProcessingEvent extends Event { /** diff --git a/lib/public/TextProcessing/Events/TaskFailedEvent.php b/lib/public/TextProcessing/Events/TaskFailedEvent.php index b41c519bab9..dfdb9137f95 100644 --- a/lib/public/TextProcessing/Events/TaskFailedEvent.php +++ b/lib/public/TextProcessing/Events/TaskFailedEvent.php @@ -10,6 +10,7 @@ use OCP\TextProcessing\Task; /** * @since 27.1.0 + * @deprecated 30.0.0 */ class TaskFailedEvent extends AbstractTextProcessingEvent { /** diff --git a/lib/public/TextProcessing/Events/TaskSuccessfulEvent.php b/lib/public/TextProcessing/Events/TaskSuccessfulEvent.php index b96e401364d..0716f4d45c6 100644 --- a/lib/public/TextProcessing/Events/TaskSuccessfulEvent.php +++ b/lib/public/TextProcessing/Events/TaskSuccessfulEvent.php @@ -8,6 +8,7 @@ namespace OCP\TextProcessing\Events; /** * @since 27.1.0 + * @deprecated 30.0.0 */ class TaskSuccessfulEvent extends AbstractTextProcessingEvent { } diff --git a/lib/public/TextProcessing/Exception/TaskFailureException.php b/lib/public/TextProcessing/Exception/TaskFailureException.php index e996811c28e..06fbdf5e765 100644 --- a/lib/public/TextProcessing/Exception/TaskFailureException.php +++ b/lib/public/TextProcessing/Exception/TaskFailureException.php @@ -9,6 +9,7 @@ namespace OCP\TextProcessing\Exception; /** * Exception thrown when a task failed * @since 28.0.0 + * @deprecated 30.0.0 */ class TaskFailureException extends \RuntimeException { } diff --git a/lib/public/TextProcessing/FreePromptTaskType.php b/lib/public/TextProcessing/FreePromptTaskType.php index 2aac04422c1..2433f24dbd7 100644 --- a/lib/public/TextProcessing/FreePromptTaskType.php +++ b/lib/public/TextProcessing/FreePromptTaskType.php @@ -15,6 +15,7 @@ use OCP\L10N\IFactory; /** * This is the text processing task type for free prompting * @since 27.1.0 + * @deprecated 30.0.0 */ class FreePromptTaskType implements ITaskType { private IL10N $l; diff --git a/lib/public/TextProcessing/HeadlineTaskType.php b/lib/public/TextProcessing/HeadlineTaskType.php index 893997ce669..00eb66466ae 100644 --- a/lib/public/TextProcessing/HeadlineTaskType.php +++ b/lib/public/TextProcessing/HeadlineTaskType.php @@ -15,6 +15,7 @@ use OCP\L10N\IFactory; /** * This is the text processing task type for creating headline * @since 27.1.0 + * @deprecated 30.0.0 */ class HeadlineTaskType implements ITaskType { private IL10N $l; diff --git a/lib/public/TextProcessing/IManager.php b/lib/public/TextProcessing/IManager.php index 8869b1d0d60..701ad18940f 100644 --- a/lib/public/TextProcessing/IManager.php +++ b/lib/public/TextProcessing/IManager.php @@ -20,6 +20,7 @@ use RuntimeException; * API surface for apps interacting with and making use of LanguageModel providers * without known which providers are installed * @since 27.1.0 + * @deprecated 30.0.0 */ interface IManager { /** diff --git a/lib/public/TextProcessing/IProvider.php b/lib/public/TextProcessing/IProvider.php index 4f1444e2b0e..24efbc1ec8c 100644 --- a/lib/public/TextProcessing/IProvider.php +++ b/lib/public/TextProcessing/IProvider.php @@ -17,6 +17,7 @@ use RuntimeException; * implement a text processing provider * @psalm-template-covariant T of ITaskType * @since 27.1.0 + * @deprecated 30.0.0 */ interface IProvider { /** diff --git a/lib/public/TextProcessing/IProviderWithExpectedRuntime.php b/lib/public/TextProcessing/IProviderWithExpectedRuntime.php index 46bbcccdc37..b3986e8b3a8 100644 --- a/lib/public/TextProcessing/IProviderWithExpectedRuntime.php +++ b/lib/public/TextProcessing/IProviderWithExpectedRuntime.php @@ -15,6 +15,7 @@ namespace OCP\TextProcessing; * @since 28.0.0 * @template T of ITaskType * @template-extends IProvider + * @deprecated 30.0.0 */ interface IProviderWithExpectedRuntime extends IProvider { /** diff --git a/lib/public/TextProcessing/IProviderWithId.php b/lib/public/TextProcessing/IProviderWithId.php index 7fda3350ae8..359ec9cef71 100644 --- a/lib/public/TextProcessing/IProviderWithId.php +++ b/lib/public/TextProcessing/IProviderWithId.php @@ -13,6 +13,7 @@ namespace OCP\TextProcessing; * @since 28.0.0 * @extends IProvider * @template T of ITaskType + * @deprecated 30.0.0 */ interface IProviderWithId extends IProvider { /** diff --git a/lib/public/TextProcessing/IProviderWithUserId.php b/lib/public/TextProcessing/IProviderWithUserId.php index b97ca2145b7..197dd3d9740 100644 --- a/lib/public/TextProcessing/IProviderWithUserId.php +++ b/lib/public/TextProcessing/IProviderWithUserId.php @@ -15,6 +15,7 @@ namespace OCP\TextProcessing; * @since 28.0.0 * @template T of ITaskType * @template-extends IProvider + * @deprecated 30.0.0 */ interface IProviderWithUserId extends IProvider { /** diff --git a/lib/public/TextProcessing/ITaskType.php b/lib/public/TextProcessing/ITaskType.php index fcff9c8b207..5ec1e8dd049 100644 --- a/lib/public/TextProcessing/ITaskType.php +++ b/lib/public/TextProcessing/ITaskType.php @@ -13,6 +13,7 @@ namespace OCP\TextProcessing; * This is a task type interface that is implemented by text processing * task types * @since 27.1.0 + * @deprecated 30.0.0 */ interface ITaskType { /** diff --git a/lib/public/TextProcessing/SummaryTaskType.php b/lib/public/TextProcessing/SummaryTaskType.php index b77852d3da1..656a50ebc62 100644 --- a/lib/public/TextProcessing/SummaryTaskType.php +++ b/lib/public/TextProcessing/SummaryTaskType.php @@ -15,6 +15,7 @@ use OCP\L10N\IFactory; /** * This is the text processing task type for summaries * @since 27.1.0 + * @deprecated 30.0.0 */ class SummaryTaskType implements ITaskType { private IL10N $l; diff --git a/lib/public/TextProcessing/Task.php b/lib/public/TextProcessing/Task.php index 63fcf2c952a..d968ad9ba3e 100644 --- a/lib/public/TextProcessing/Task.php +++ b/lib/public/TextProcessing/Task.php @@ -13,6 +13,7 @@ namespace OCP\TextProcessing; * This is a text processing task * @since 27.1.0 * @psalm-template-covariant T of ITaskType + * @deprecated 30.0.0 */ final class Task implements \JsonSerializable { protected ?int $id = null; diff --git a/lib/public/TextProcessing/TopicsTaskType.php b/lib/public/TextProcessing/TopicsTaskType.php index 3f1c2c33eda..c693ee3d27f 100644 --- a/lib/public/TextProcessing/TopicsTaskType.php +++ b/lib/public/TextProcessing/TopicsTaskType.php @@ -15,6 +15,7 @@ use OCP\L10N\IFactory; /** * This is the text processing task type for topics extraction * @since 27.1.0 + * @deprecated 30.0.0 */ class TopicsTaskType implements ITaskType { private IL10N $l; diff --git a/lib/public/TextToImage/Events/AbstractTextToImageEvent.php b/lib/public/TextToImage/Events/AbstractTextToImageEvent.php index 4217c75d6b7..75920487412 100644 --- a/lib/public/TextToImage/Events/AbstractTextToImageEvent.php +++ b/lib/public/TextToImage/Events/AbstractTextToImageEvent.php @@ -14,6 +14,7 @@ use OCP\TextToImage\Task; /** * @since 28.0.0 + * @deprecated 30.0.0 */ abstract class AbstractTextToImageEvent extends Event { /** diff --git a/lib/public/TextToImage/Events/TaskFailedEvent.php b/lib/public/TextToImage/Events/TaskFailedEvent.php index eb3049cecc2..8a1b8bbad61 100644 --- a/lib/public/TextToImage/Events/TaskFailedEvent.php +++ b/lib/public/TextToImage/Events/TaskFailedEvent.php @@ -13,6 +13,7 @@ use OCP\TextToImage\Task; /** * @since 28.0.0 + * @deprecated 30.0.0 */ class TaskFailedEvent extends AbstractTextToImageEvent { /** diff --git a/lib/public/TextToImage/Events/TaskSuccessfulEvent.php b/lib/public/TextToImage/Events/TaskSuccessfulEvent.php index c8b125eeb35..ae679437457 100644 --- a/lib/public/TextToImage/Events/TaskSuccessfulEvent.php +++ b/lib/public/TextToImage/Events/TaskSuccessfulEvent.php @@ -11,6 +11,7 @@ namespace OCP\TextToImage\Events; /** * @since 28.0.0 + * @deprecated 30.0.0 */ class TaskSuccessfulEvent extends AbstractTextToImageEvent { } diff --git a/lib/public/TextToImage/Exception/TaskFailureException.php b/lib/public/TextToImage/Exception/TaskFailureException.php index 18d86c6dd1f..89144c3033a 100644 --- a/lib/public/TextToImage/Exception/TaskFailureException.php +++ b/lib/public/TextToImage/Exception/TaskFailureException.php @@ -9,6 +9,7 @@ namespace OCP\TextToImage\Exception; /** * @since 28.0.0 + * @deprecated 30.0.0 */ class TaskFailureException extends TextToImageException { } diff --git a/lib/public/TextToImage/Exception/TaskNotFoundException.php b/lib/public/TextToImage/Exception/TaskNotFoundException.php index a367bc4c849..a488eceb7f4 100644 --- a/lib/public/TextToImage/Exception/TaskNotFoundException.php +++ b/lib/public/TextToImage/Exception/TaskNotFoundException.php @@ -9,6 +9,7 @@ namespace OCP\TextToImage\Exception; /** * @since 28.0.0 + * @deprecated 30.0.0 */ class TaskNotFoundException extends TextToImageException { } diff --git a/lib/public/TextToImage/Exception/TextToImageException.php b/lib/public/TextToImage/Exception/TextToImageException.php index 44b1ccac36a..d8672544072 100644 --- a/lib/public/TextToImage/Exception/TextToImageException.php +++ b/lib/public/TextToImage/Exception/TextToImageException.php @@ -9,6 +9,7 @@ namespace OCP\TextToImage\Exception; /** * @since 28.0.0 + * @deprecated 30.0.0 */ class TextToImageException extends \Exception { } diff --git a/lib/public/TextToImage/IManager.php b/lib/public/TextToImage/IManager.php index a9c3bb8d54b..df8adfc39f4 100644 --- a/lib/public/TextToImage/IManager.php +++ b/lib/public/TextToImage/IManager.php @@ -20,6 +20,7 @@ use RuntimeException; * API surface for apps interacting with and making use of TextToImage providers * without knowing which providers are installed * @since 28.0.0 + * @deprecated 30.0.0 */ interface IManager { /** diff --git a/lib/public/TextToImage/IProvider.php b/lib/public/TextToImage/IProvider.php index ad9deba1730..4a278a0d706 100644 --- a/lib/public/TextToImage/IProvider.php +++ b/lib/public/TextToImage/IProvider.php @@ -15,6 +15,7 @@ use RuntimeException; * This is the interface that is implemented by apps that * implement a text to image provider * @since 28.0.0 + * @deprecated 30.0.0 */ interface IProvider { /** diff --git a/lib/public/TextToImage/IProviderWithUserId.php b/lib/public/TextToImage/IProviderWithUserId.php index c42ec163dbe..a3eedbd9dc0 100644 --- a/lib/public/TextToImage/IProviderWithUserId.php +++ b/lib/public/TextToImage/IProviderWithUserId.php @@ -9,6 +9,7 @@ namespace OCP\TextToImage; /** * @since 29.0.0 + * @deprecated 30.0.0 */ interface IProviderWithUserId extends IProvider { /** diff --git a/lib/public/TextToImage/Task.php b/lib/public/TextToImage/Task.php index a460c082eea..d214354ae34 100644 --- a/lib/public/TextToImage/Task.php +++ b/lib/public/TextToImage/Task.php @@ -20,6 +20,7 @@ use OCP\Image; * This is a text to image task * * @since 28.0.0 + * @deprecated 30.0.0 */ final class Task implements \JsonSerializable { protected ?int $id = null; diff --git a/lib/public/Translation/CouldNotTranslateException.php b/lib/public/Translation/CouldNotTranslateException.php index 77948f18da9..fc9f33c879a 100644 --- a/lib/public/Translation/CouldNotTranslateException.php +++ b/lib/public/Translation/CouldNotTranslateException.php @@ -11,6 +11,7 @@ namespace OCP\Translation; /** * @since 27.0.0 + * @deprecated 30.0.0 */ class CouldNotTranslateException extends \RuntimeException { /** diff --git a/lib/public/Translation/IDetectLanguageProvider.php b/lib/public/Translation/IDetectLanguageProvider.php index 28f64ab8ef5..18f40b1aa52 100644 --- a/lib/public/Translation/IDetectLanguageProvider.php +++ b/lib/public/Translation/IDetectLanguageProvider.php @@ -12,6 +12,7 @@ namespace OCP\Translation; /** * @since 26.0.0 + * @deprecated 30.0.0 */ interface IDetectLanguageProvider { /** diff --git a/lib/public/Translation/ITranslationManager.php b/lib/public/Translation/ITranslationManager.php index 8c587f5286f..efeaa2de1e2 100644 --- a/lib/public/Translation/ITranslationManager.php +++ b/lib/public/Translation/ITranslationManager.php @@ -15,6 +15,7 @@ use OCP\PreConditionNotMetException; /** * @since 26.0.0 + * @deprecated 30.0.0 */ interface ITranslationManager { /** diff --git a/lib/public/Translation/ITranslationProvider.php b/lib/public/Translation/ITranslationProvider.php index 45c0467f77e..39267ab9ca5 100644 --- a/lib/public/Translation/ITranslationProvider.php +++ b/lib/public/Translation/ITranslationProvider.php @@ -14,6 +14,7 @@ use RuntimeException; /** * @since 26.0.0 + * @deprecated 30.0.0 */ interface ITranslationProvider { /** diff --git a/lib/public/Translation/ITranslationProviderWithId.php b/lib/public/Translation/ITranslationProviderWithId.php index 1554fd9bb01..93fc641ee02 100644 --- a/lib/public/Translation/ITranslationProviderWithId.php +++ b/lib/public/Translation/ITranslationProviderWithId.php @@ -12,6 +12,7 @@ namespace OCP\Translation; /** * @since 29.0.0 + * @deprecated 30.0.0 */ interface ITranslationProviderWithId extends ITranslationProvider { /** diff --git a/lib/public/Translation/ITranslationProviderWithUserId.php b/lib/public/Translation/ITranslationProviderWithUserId.php index a89058ce488..5bc2255f21f 100644 --- a/lib/public/Translation/ITranslationProviderWithUserId.php +++ b/lib/public/Translation/ITranslationProviderWithUserId.php @@ -12,6 +12,7 @@ namespace OCP\Translation; /** * @since 29.0.0 + * @deprecated 30.0.0 */ interface ITranslationProviderWithUserId extends ITranslationProvider { /** diff --git a/lib/public/Translation/LanguageTuple.php b/lib/public/Translation/LanguageTuple.php index 21edcf24453..883daa01da3 100644 --- a/lib/public/Translation/LanguageTuple.php +++ b/lib/public/Translation/LanguageTuple.php @@ -14,6 +14,7 @@ use JsonSerializable; /** * @since 26.0.0 + * @deprecated 30.0.0 */ class LanguageTuple implements JsonSerializable { /** -- 2.39.5