IBX-11116: Added EmbeddingProviderException and an interface for embedding providers' error handling

src/contracts/Search/Embedding/EmbeddingProviderExceptionInterface.php

@@ -0,0 +1,15 @@
+<?php
+
+/**
+ * @copyright Copyright (C) Ibexa AS. All rights reserved.
+ * @license For full copyright and license information view LICENSE file distributed with this source code.
+ */
+declare(strict_types=1);
+
+namespace Ibexa\Contracts\Core\Search\Embedding;
+
+use Throwable;
+
+interface EmbeddingProviderExceptionInterface extends Throwable
+{
+}

src/contracts/Search/Embedding/EmbeddingProviderInterface.php

@@ -12,6 +12,8 @@ interface EmbeddingProviderInterface
 {
     /**
      * @return float[]
+     *
+     * @throws \Ibexa\Contracts\Core\Search\Embedding\EmbeddingProviderExceptionInterface
      */
     public function getEmbedding(string $content, ?string $model = null, ?int $maxTokens = null): array;
 }

src/lib/Search/Embedding/EmbeddingProviderException.php

@@ -0,0 +1,21 @@
+<?php
+
+/**
+ * @copyright Copyright (C) Ibexa AS. All rights reserved.
+ * @license For full copyright and license information view LICENSE file distributed with this source code.
+ */
+declare(strict_types=1);
+
+namespace Ibexa\Core\Search\Embedding;
+
+use Ibexa\Contracts\Core\Search\Embedding\EmbeddingProviderExceptionInterface;
+use RuntimeException;
+use Throwable;
+
+final class EmbeddingProviderException extends RuntimeException implements EmbeddingProviderExceptionInterface
+{
+    public static function fromThrowable(Throwable $previous, string $message): self
+    {
+        return new self($message, 0, $previous);
+    }
+}