From bcd67c7bcd73d9946473bf9a333d14a729c5e2a9 Mon Sep 17 00:00:00 2001
From: ZanSara <sara.zanzottera@deepset.ai>
Date: Wed, 20 Sep 2023 16:03:21 +0200
Subject: [PATCH 01/13] fix tests

---
 .../components/audio/test_whisper_local.py      |   2 +-
 .../components/audio/test_whisper_remote.py     |   2 +-
 test/preview/test_files/audio/answer.wav        | Bin 0 -> 29228 bytes
 3 files changed, 2 insertions(+), 2 deletions(-)
 create mode 100644 test/preview/test_files/audio/answer.wav

diff --git a/test/preview/components/audio/test_whisper_local.py b/test/preview/components/audio/test_whisper_local.py
index 1acb47878a..745ece37c5 100644
--- a/test/preview/components/audio/test_whisper_local.py
+++ b/test/preview/components/audio/test_whisper_local.py
@@ -157,7 +157,7 @@ def test_transcribe_stream(self):
         assert results == [expected]
 
     @pytest.mark.integration
-    def test_whisper_local_transcriber(preview_samples_path):
+    def test_whisper_local_transcriber(self, preview_samples_path):
         comp = LocalWhisperTranscriber(model_name_or_path="medium")
         comp.warm_up()
         output = comp.run(
diff --git a/test/preview/components/audio/test_whisper_remote.py b/test/preview/components/audio/test_whisper_remote.py
index 26851845a2..ad71c9a5c7 100644
--- a/test/preview/components/audio/test_whisper_remote.py
+++ b/test/preview/components/audio/test_whisper_remote.py
@@ -217,7 +217,7 @@ def test_custom_api_base(self, mock_request, preview_samples_path):
         reason="Export an env var called OPENAI_API_KEY containing the OpenAI API key to run this test.",
     )
     @pytest.mark.integration
-    def test_whisper_remote_transcriber(preview_samples_path):
+    def test_whisper_remote_transcriber(self, preview_samples_path):
         comp = RemoteWhisperTranscriber(api_key=os.environ.get("OPENAI_API_KEY"))
 
         output = comp.run(
diff --git a/test/preview/test_files/audio/answer.wav b/test/preview/test_files/audio/answer.wav
new file mode 100644
index 0000000000000000000000000000000000000000..874eab01fede4e6b7fe24270d70ff85a87f5caa3
GIT binary patch
literal 29228
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

literal 0
HcmV?d00001


From 9253431b5b125d7b3efa99b38bdf56b991725620 Mon Sep 17 00:00:00 2001
From: ZanSara <sara.zanzottera@deepset.ai>
Date: Wed, 20 Sep 2023 16:07:27 +0200
Subject: [PATCH 02/13] add component

---
 .../preview/components/joiners/__init__.py    |  0
 haystack/preview/components/joiners/join.py   | 24 +++++++++++++++++++
 2 files changed, 24 insertions(+)
 create mode 100644 haystack/preview/components/joiners/__init__.py
 create mode 100644 haystack/preview/components/joiners/join.py

diff --git a/haystack/preview/components/joiners/__init__.py b/haystack/preview/components/joiners/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/haystack/preview/components/joiners/join.py b/haystack/preview/components/joiners/join.py
new file mode 100644
index 0000000000..17da22e275
--- /dev/null
+++ b/haystack/preview/components/joiners/join.py
@@ -0,0 +1,24 @@
+from typing import Type
+from haystack.preview import component
+
+
+@component
+class Join:
+    """
+    Simple component that joins together a group of inputs of the same type. Works with every type that supports
+    the + operator for joining, like lists, strings, etc.
+    """
+
+    def __init__(inputs_count: int, inputs_type: Type):
+        """
+        :param inputs_count: the number of inputs to expect.
+        :param inputs_type: the type of the inputs. Every type that supports the + operator works.
+        """
+        component.set_input_types({f"input_{i}": inputs_type for i in range(inputs_count)})
+        component.set_output_types(output=inputs_type)
+
+    def run(self, **kwargs):
+        output = []
+        for values in kwargs.values():
+            output += values
+        return {"output": output}

From 4392537a32e38c00fca8188a8350d4a66ab6880b Mon Sep 17 00:00:00 2001
From: ZanSara <sara.zanzottera@deepset.ai>
Date: Wed, 20 Sep 2023 16:25:00 +0200
Subject: [PATCH 03/13] add test

---
 test/preview/components/joiner/test_join.py | 13 +++++++++++++
 1 file changed, 13 insertions(+)
 create mode 100644 test/preview/components/joiner/test_join.py

diff --git a/test/preview/components/joiner/test_join.py b/test/preview/components/joiner/test_join.py
new file mode 100644
index 0000000000..133e21700b
--- /dev/null
+++ b/test/preview/components/joiner/test_join.py
@@ -0,0 +1,13 @@
+from typing import List
+
+import pytest
+
+from haystack.preview.components.joiners.join import Join
+
+
+class TestJoin:
+    @pytest.mark.unit
+    def test_join(self):
+        comp = Join(inputs_count=2, inputs_type=List[int])
+        output = comp.run(input_1=[1, 2], input_2=[3, 4])
+        assert output == {"output": [1, 2, 3, 4]}

From bfd771791aed80ffb3e126432d74ebbd7c670b41 Mon Sep 17 00:00:00 2001
From: ZanSara <sara.zanzottera@deepset.ai>
Date: Wed, 20 Sep 2023 16:36:47 +0200
Subject: [PATCH 04/13] reno

---
 releasenotes/notes/join-lists-1307f7872a37e238.yaml | 3 +++
 1 file changed, 3 insertions(+)
 create mode 100644 releasenotes/notes/join-lists-1307f7872a37e238.yaml

diff --git a/releasenotes/notes/join-lists-1307f7872a37e238.yaml b/releasenotes/notes/join-lists-1307f7872a37e238.yaml
new file mode 100644
index 0000000000..06f96b0add
--- /dev/null
+++ b/releasenotes/notes/join-lists-1307f7872a37e238.yaml
@@ -0,0 +1,3 @@
+---
+preview:
+  - Add `Join`, a small component that can be used to join lists and other types supporting the + operator.

From 1a25d2f98898e630125dd9e45fbf98b6a645b19d Mon Sep 17 00:00:00 2001
From: ZanSara <sara.zanzottera@deepset.ai>
Date: Wed, 20 Sep 2023 16:48:15 +0200
Subject: [PATCH 05/13] typo

---
 haystack/preview/components/joiners/join.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/haystack/preview/components/joiners/join.py b/haystack/preview/components/joiners/join.py
index 17da22e275..21118266e4 100644
--- a/haystack/preview/components/joiners/join.py
+++ b/haystack/preview/components/joiners/join.py
@@ -9,7 +9,7 @@ class Join:
     the + operator for joining, like lists, strings, etc.
     """
 
-    def __init__(inputs_count: int, inputs_type: Type):
+    def __init__(self, inputs_count: int, inputs_type: Type):
         """
         :param inputs_count: the number of inputs to expect.
         :param inputs_type: the type of the inputs. Every type that supports the + operator works.

From 74eed5989ab9d7503f1885553dca4f05e2ef2fec Mon Sep 17 00:00:00 2001
From: ZanSara <sara.zanzottera@deepset.ai>
Date: Wed, 20 Sep 2023 16:54:33 +0200
Subject: [PATCH 06/13] add serialization

---
 haystack/preview/components/joiners/join.py | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/haystack/preview/components/joiners/join.py b/haystack/preview/components/joiners/join.py
index 21118266e4..e0cca3275d 100644
--- a/haystack/preview/components/joiners/join.py
+++ b/haystack/preview/components/joiners/join.py
@@ -1,5 +1,5 @@
 from typing import Type
-from haystack.preview import component
+from haystack.preview import component, default_from_dict, default_to_dict
 
 
 @component
@@ -14,10 +14,23 @@ def __init__(self, inputs_count: int, inputs_type: Type):
         :param inputs_count: the number of inputs to expect.
         :param inputs_type: the type of the inputs. Every type that supports the + operator works.
         """
+        self.inputs_count = inputs_count
+        self.inputs_type = inputs_type
         component.set_input_types({f"input_{i}": inputs_type for i in range(inputs_count)})
         component.set_output_types(output=inputs_type)
 
+    def to_dict(self):
+        return default_to_dict(self, inputs_count=self.inputs_count, inputs_type=self.inputs_type)
+
+    @classmethod
+    def from_dict(self, data):
+        return default_from_dict(self, data)
+
     def run(self, **kwargs):
+        """
+        Joins together a group of inputs of the same type. Works with every type that supports the + operator,
+        like lists, strings, etc.
+        """
         output = []
         for values in kwargs.values():
             output += values

From 8192e34ec408053c7a2cb3e6b73cd801a98ea05b Mon Sep 17 00:00:00 2001
From: ZanSara <sara.zanzottera@deepset.ai>
Date: Wed, 20 Sep 2023 17:00:14 +0200
Subject: [PATCH 07/13] stray changes

---
 test/preview/components/audio/test_whisper_local.py  | 2 +-
 test/preview/components/audio/test_whisper_remote.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/test/preview/components/audio/test_whisper_local.py b/test/preview/components/audio/test_whisper_local.py
index 745ece37c5..1acb47878a 100644
--- a/test/preview/components/audio/test_whisper_local.py
+++ b/test/preview/components/audio/test_whisper_local.py
@@ -157,7 +157,7 @@ def test_transcribe_stream(self):
         assert results == [expected]
 
     @pytest.mark.integration
-    def test_whisper_local_transcriber(self, preview_samples_path):
+    def test_whisper_local_transcriber(preview_samples_path):
         comp = LocalWhisperTranscriber(model_name_or_path="medium")
         comp.warm_up()
         output = comp.run(
diff --git a/test/preview/components/audio/test_whisper_remote.py b/test/preview/components/audio/test_whisper_remote.py
index ad71c9a5c7..26851845a2 100644
--- a/test/preview/components/audio/test_whisper_remote.py
+++ b/test/preview/components/audio/test_whisper_remote.py
@@ -217,7 +217,7 @@ def test_custom_api_base(self, mock_request, preview_samples_path):
         reason="Export an env var called OPENAI_API_KEY containing the OpenAI API key to run this test.",
     )
     @pytest.mark.integration
-    def test_whisper_remote_transcriber(self, preview_samples_path):
+    def test_whisper_remote_transcriber(preview_samples_path):
         comp = RemoteWhisperTranscriber(api_key=os.environ.get("OPENAI_API_KEY"))
 
         output = comp.run(

From 7b1767e447d07029c061434acb71885775265639 Mon Sep 17 00:00:00 2001
From: ZanSara <sara.zanzottera@deepset.ai>
Date: Wed, 20 Sep 2023 17:10:21 +0200
Subject: [PATCH 08/13] add tests

---
 haystack/preview/components/joiners/join.py | 18 +++++++++-----
 test/preview/components/joiner/test_join.py | 26 +++++++++++++++++++--
 2 files changed, 36 insertions(+), 8 deletions(-)

diff --git a/haystack/preview/components/joiners/join.py b/haystack/preview/components/joiners/join.py
index e0cca3275d..dc42772eeb 100644
--- a/haystack/preview/components/joiners/join.py
+++ b/haystack/preview/components/joiners/join.py
@@ -14,24 +14,30 @@ def __init__(self, inputs_count: int, inputs_type: Type):
         :param inputs_count: the number of inputs to expect.
         :param inputs_type: the type of the inputs. Every type that supports the + operator works.
         """
+        if inputs_count < 1:
+            raise ValueError("inputs_count must be at least 1")
         self.inputs_count = inputs_count
         self.inputs_type = inputs_type
-        component.set_input_types({f"input_{i}": inputs_type for i in range(inputs_count)})
-        component.set_output_types(output=inputs_type)
+        component.set_input_types(self, **{f"input_{i}": inputs_type for i in range(inputs_count)})
+        component.set_output_types(self, output=inputs_type)
 
     def to_dict(self):
         return default_to_dict(self, inputs_count=self.inputs_count, inputs_type=self.inputs_type)
 
     @classmethod
-    def from_dict(self, data):
-        return default_from_dict(self, data)
+    def from_dict(cls, data):
+        return default_from_dict(cls, data)
 
     def run(self, **kwargs):
         """
         Joins together a group of inputs of the same type. Works with every type that supports the + operator,
         like lists, strings, etc.
         """
-        output = []
-        for values in kwargs.values():
+        if len(kwargs) != self.inputs_count:
+            raise ValueError(f"Join expected {self.inputs_count} inputs, but got {len(kwargs)}")
+
+        values = list(kwargs.values())
+        output = values.pop()
+        for values in values:
             output += values
         return {"output": output}
diff --git a/test/preview/components/joiner/test_join.py b/test/preview/components/joiner/test_join.py
index 133e21700b..4609da6196 100644
--- a/test/preview/components/joiner/test_join.py
+++ b/test/preview/components/joiner/test_join.py
@@ -7,7 +7,29 @@
 
 class TestJoin:
     @pytest.mark.unit
-    def test_join(self):
+    def test_join_to_dict(self):
+        comp = Join(inputs_count=2, inputs_type=str)
+        assert comp.to_dict() == {"type": "Join", "init_parameters": {"inputs_count": 2, "inputs_type": str}}
+
+    @pytest.mark.unit
+    def test_join_list(self):
         comp = Join(inputs_count=2, inputs_type=List[int])
-        output = comp.run(input_1=[1, 2], input_2=[3, 4])
+        output = comp.run(input_0=[1, 2], input_1=[3, 4])
         assert output == {"output": [1, 2, 3, 4]}
+
+    @pytest.mark.unit
+    def test_join_str(self):
+        comp = Join(inputs_count=2, inputs_type=str)
+        output = comp.run(input_0="hello", input_1="test")
+        assert output == {"output": "hellotest"}
+
+    @pytest.mark.unit
+    def test_join_one_input(self):
+        comp = Join(inputs_count=1, inputs_type=str)
+        output = comp.run(input_0="hello")
+        assert output == {"output": "hello"}
+
+    @pytest.mark.unit
+    def test_join_zero_input(self):
+        with pytest.raises(ValueError):
+            Join(inputs_count=0, inputs_type=str)

From 74998714239026e7689ea3b98a063737d709b6f1 Mon Sep 17 00:00:00 2001
From: ZanSara <sara.zanzottera@deepset.ai>
Date: Wed, 20 Sep 2023 17:18:03 +0200
Subject: [PATCH 09/13] fix order

---
 haystack/preview/components/joiners/join.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/haystack/preview/components/joiners/join.py b/haystack/preview/components/joiners/join.py
index dc42772eeb..f27af791da 100644
--- a/haystack/preview/components/joiners/join.py
+++ b/haystack/preview/components/joiners/join.py
@@ -37,7 +37,7 @@ def run(self, **kwargs):
             raise ValueError(f"Join expected {self.inputs_count} inputs, but got {len(kwargs)}")
 
         values = list(kwargs.values())
-        output = values.pop()
-        for values in values:
+        output = values[0]
+        for values in values[1:]:
             output += values
         return {"output": output}

From 0657dc2d9d8712e6ff3dddd64a1b1149c092deba Mon Sep 17 00:00:00 2001
From: ZanSara <sara.zanzottera@deepset.ai>
Date: Wed, 20 Sep 2023 17:49:34 +0200
Subject: [PATCH 10/13] marshalling types

---
 haystack/preview/components/joiners/join.py |  8 +++-
 haystack/preview/utils/__init__.py          |  1 +
 haystack/preview/utils/marshalling.py       | 46 +++++++++++++++++++++
 test/preview/components/joiner/test_join.py |  9 +++-
 4 files changed, 61 insertions(+), 3 deletions(-)
 create mode 100644 haystack/preview/utils/marshalling.py

diff --git a/haystack/preview/components/joiners/join.py b/haystack/preview/components/joiners/join.py
index f27af791da..00e37dda9b 100644
--- a/haystack/preview/components/joiners/join.py
+++ b/haystack/preview/components/joiners/join.py
@@ -1,5 +1,6 @@
 from typing import Type
-from haystack.preview import component, default_from_dict, default_to_dict
+from haystack.preview import component, default_from_dict, default_to_dict, DeserializationError
+from haystack.preview.utils import marshal_type, unmarshal_type
 
 
 @component
@@ -22,10 +23,13 @@ def __init__(self, inputs_count: int, inputs_type: Type):
         component.set_output_types(self, output=inputs_type)
 
     def to_dict(self):
-        return default_to_dict(self, inputs_count=self.inputs_count, inputs_type=self.inputs_type)
+        return default_to_dict(self, inputs_count=self.inputs_count, inputs_type=marshal_type(self.inputs_type))
 
     @classmethod
     def from_dict(cls, data):
+        if not "inputs_type" in data["init_parameters"]:
+            raise DeserializationError("The inputs_type parameter for Join is missing.")
+        data["init_parameters"]["inputs_type"] = unmarshal_type(data["init_parameters"]["inputs_type"])
         return default_from_dict(cls, data)
 
     def run(self, **kwargs):
diff --git a/haystack/preview/utils/__init__.py b/haystack/preview/utils/__init__.py
index a84ea468e2..9b13aa8604 100644
--- a/haystack/preview/utils/__init__.py
+++ b/haystack/preview/utils/__init__.py
@@ -1,3 +1,4 @@
 from haystack.preview.utils.expit import expit
 from haystack.preview.utils.requests_utils import request_with_retry
 from haystack.preview.utils.filters import document_matches_filter
+from haystack.preview.utils.marshalling import marshal_type, unmarshal_type
diff --git a/haystack/preview/utils/marshalling.py b/haystack/preview/utils/marshalling.py
new file mode 100644
index 0000000000..1248b3cac0
--- /dev/null
+++ b/haystack/preview/utils/marshalling.py
@@ -0,0 +1,46 @@
+from typing import Type
+import builtins
+import sys
+
+from haystack.preview import DeserializationError
+
+
+def marshal_type(type_: Type) -> str:
+    """
+    Given a type, return a string representation that can be unmarshalled.
+
+    :param type_: The type.
+    :return: Its string representation.
+    """
+    module = type_.__module__
+    if module == "builtins":
+        return type_.__name__
+    return f"{module}.{type_.__name__}"
+
+
+def unmarshal_type(type_name: str) -> Type:
+    """
+    Given the string representation of a type, return the type itself.
+
+    :param type_name: The string representation of the type.
+    :return: The type itself.
+    """
+    if "." not in type_name:
+        type_ = getattr(builtins, type_name, None)
+        if not type_:
+            raise DeserializationError(f"Could not locate builtin called '{type_name}'")
+        return type_
+
+    parts = type_name.split(".")
+    module_name = ".".join(parts[:-1])
+    type_name = parts[-1]
+
+    module = sys.modules.get(module_name, None)
+    if not module:
+        raise DeserializationError(f"Could not locate the module '{module_name}'")
+
+    type_ = getattr(module, type_name, None)
+    if not type_:
+        raise DeserializationError(f"Could not locate the type '{type_name}'")
+
+    return type_
diff --git a/test/preview/components/joiner/test_join.py b/test/preview/components/joiner/test_join.py
index 4609da6196..481c04e392 100644
--- a/test/preview/components/joiner/test_join.py
+++ b/test/preview/components/joiner/test_join.py
@@ -9,7 +9,14 @@ class TestJoin:
     @pytest.mark.unit
     def test_join_to_dict(self):
         comp = Join(inputs_count=2, inputs_type=str)
-        assert comp.to_dict() == {"type": "Join", "init_parameters": {"inputs_count": 2, "inputs_type": str}}
+        assert comp.to_dict() == {"type": "Join", "init_parameters": {"inputs_count": 2, "inputs_type": "str"}}
+
+    @pytest.mark.unit
+    def test_join_from_dict(self):
+        data = {"type": "Join", "init_parameters": {"inputs_count": 2, "inputs_type": "str"}}
+        comp = Join.from_dict(data)
+        assert comp.inputs_count == 2
+        assert comp.inputs_type == str
 
     @pytest.mark.unit
     def test_join_list(self):

From 617fffd1a68a885d8906869d047584c5dc84103f Mon Sep 17 00:00:00 2001
From: ZanSara <sara.zanzottera@deepset.ai>
Date: Wed, 20 Sep 2023 17:52:23 +0200
Subject: [PATCH 11/13] marshalling tests

---
 test/preview/utils/test_marshalling.py | 37 ++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 test/preview/utils/test_marshalling.py

diff --git a/test/preview/utils/test_marshalling.py b/test/preview/utils/test_marshalling.py
new file mode 100644
index 0000000000..c44d26c373
--- /dev/null
+++ b/test/preview/utils/test_marshalling.py
@@ -0,0 +1,37 @@
+import pytest
+
+from haystack.preview import Document, DeserializationError
+from haystack.preview.utils.marshalling import marshal_type, unmarshal_type
+
+
+TYPE_STRING_PAIRS = [(int, "int"), (Document, "haystack.preview.dataclasses.document.Document")]
+
+
+@pytest.mark.unit
+@pytest.mark.parametrize("type_,string", TYPE_STRING_PAIRS)
+def test_marshal_type(type_, string):
+    assert marshal_type(type_) == string
+
+
+@pytest.mark.unit
+@pytest.mark.parametrize("type_,string", TYPE_STRING_PAIRS)
+def test_unmarshal_type(type_, string):
+    assert unmarshal_type(string) == type_
+
+
+@pytest.mark.unit
+def test_unmarshal_type_missing_builtin():
+    with pytest.raises(DeserializationError, match="Could not locate builtin called 'something'"):
+        unmarshal_type("something")
+
+
+@pytest.mark.unit
+def test_unmarshal_type_missing_module():
+    with pytest.raises(DeserializationError, match="Could not locate the module 'something'"):
+        unmarshal_type("something.int")
+
+
+@pytest.mark.unit
+def test_unmarshal_type_missing_type():
+    with pytest.raises(DeserializationError, match="Could not locate the type 'Documentttt'"):
+        unmarshal_type("haystack.preview.dataclasses.document.Documentttt")

From 28246c53a28f7449def977d33941f1ac5f802bdc Mon Sep 17 00:00:00 2001
From: Daria Fokina <daria.fokina@deepset.ai>
Date: Mon, 25 Sep 2023 12:19:00 +0200
Subject: [PATCH 12/13] docstrings update

---
 haystack/preview/components/joiners/join.py | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/haystack/preview/components/joiners/join.py b/haystack/preview/components/joiners/join.py
index 00e37dda9b..c2ba97ac82 100644
--- a/haystack/preview/components/joiners/join.py
+++ b/haystack/preview/components/joiners/join.py
@@ -6,14 +6,14 @@
 @component
 class Join:
     """
-    Simple component that joins together a group of inputs of the same type. Works with every type that supports
-    the + operator for joining, like lists, strings, etc.
+    A simple component that joins together a group of inputs of the same type. Works with every type that supports
+    the + operator for joining, such as lists, strings, etc.
     """
 
     def __init__(self, inputs_count: int, inputs_type: Type):
         """
-        :param inputs_count: the number of inputs to expect.
-        :param inputs_type: the type of the inputs. Every type that supports the + operator works.
+        :param inputs_count: The number of inputs to expect.
+        :param inputs_type: The type of the inputs. Every type that supports the + operator works.
         """
         if inputs_count < 1:
             raise ValueError("inputs_count must be at least 1")
@@ -35,7 +35,7 @@ def from_dict(cls, data):
     def run(self, **kwargs):
         """
         Joins together a group of inputs of the same type. Works with every type that supports the + operator,
-        like lists, strings, etc.
+        such as lists, strings, etc.
         """
         if len(kwargs) != self.inputs_count:
             raise ValueError(f"Join expected {self.inputs_count} inputs, but got {len(kwargs)}")

From 684c0bbaeeafb164cfac9223d6923cd183a0f319 Mon Sep 17 00:00:00 2001
From: ZanSara <sara.zanzottera@deepset.ai>
Date: Mon, 25 Sep 2023 17:41:49 +0200
Subject: [PATCH 13/13] explain the type error

---
 haystack/preview/components/joiners/join.py | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/haystack/preview/components/joiners/join.py b/haystack/preview/components/joiners/join.py
index c2ba97ac82..e819e41b99 100644
--- a/haystack/preview/components/joiners/join.py
+++ b/haystack/preview/components/joiners/join.py
@@ -1,5 +1,5 @@
 from typing import Type
-from haystack.preview import component, default_from_dict, default_to_dict, DeserializationError
+from haystack.preview import component, default_from_dict, default_to_dict, DeserializationError, ComponentError
 from haystack.preview.utils import marshal_type, unmarshal_type
 
 
@@ -42,6 +42,11 @@ def run(self, **kwargs):
 
         values = list(kwargs.values())
         output = values[0]
-        for values in values[1:]:
-            output += values
+        try:
+            for values in values[1:]:
+                output += values
+        except TypeError:
+            raise ComponentError(
+                f"Join expected inputs of a type that supports the + operator, but got: {[type(v) for v in values]}"
+            )
         return {"output": output}