From 08b092e3561906ee13fd088c12310e63012cf32f Mon Sep 17 00:00:00 2001
From: mikolaj <mikolaj.adamczyk@ez.no>
Date: Thu, 8 Jan 2026 14:26:29 +0100
Subject: [PATCH] IBX-11116: Added EmbeddingProviderException and an interface
 for embedding providers' error handling

---
 .../EmbeddingProviderExceptionInterface.php   | 15 +++++++++++++
 .../Embedding/EmbeddingProviderInterface.php  |  2 ++
 .../Embedding/EmbeddingProviderException.php  | 21 +++++++++++++++++++
 3 files changed, 38 insertions(+)
 create mode 100644 src/contracts/Search/Embedding/EmbeddingProviderExceptionInterface.php
 create mode 100644 src/lib/Search/Embedding/EmbeddingProviderException.php

diff --git a/src/contracts/Search/Embedding/EmbeddingProviderExceptionInterface.php b/src/contracts/Search/Embedding/EmbeddingProviderExceptionInterface.php
new file mode 100644
index 0000000000..90fb7d5940
--- /dev/null
+++ b/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
+{
+}
diff --git a/src/contracts/Search/Embedding/EmbeddingProviderInterface.php b/src/contracts/Search/Embedding/EmbeddingProviderInterface.php
index 94328f17a2..f1575502d3 100644
--- a/src/contracts/Search/Embedding/EmbeddingProviderInterface.php
+++ b/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;
 }
diff --git a/src/lib/Search/Embedding/EmbeddingProviderException.php b/src/lib/Search/Embedding/EmbeddingProviderException.php
new file mode 100644
index 0000000000..223b406cb9
--- /dev/null
+++ b/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);
+    }
+}