feat(bundles): add Live Tennis API bundle with four free-tier components

Adds a livetennisapi provider to the lfx-bundles metapackage wrapping the
Live Tennis API REST surface (https://docs.livetennisapi.com), scoped to
the free tier so it can be tested without a paid plan:

- Live Matches: live/upcoming matches with current score, tour filter
- Fixtures: upcoming scheduled fixtures, earliest first
- Player Search: player lookup by name with ranking and bio fields
- Match Score: current score snapshot for one match id

Auth is a SecretStr API key sent as X-API-Key. No new dependencies
(httpx only), so the livetennisapi extra is empty. Includes frontend
icon + sidebar wiring per the contributing-bundles guide and unit tests
with mocked HTTP (importorskip-guarded, so they run in the
bundles-installed CI job).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: bensynapse

pyproject.toml

@@ -169,7 +169,7 @@ Documentation = "https://docs.langflow.org"
 
 [project.optional-dependencies]
 bundles = [
-    "lfx-bundles[all-no-torch]>=1.1.12,<2.0",
+    "lfx-bundles[all-no-torch]>=1.1.13,<2.0",
     "lfx-arxiv>=0.1.0,<1.0.0",
     "lfx-duckduckgo>=0.1.0,<1.0.0",
     "lfx-empiriolabs>=0.1.0,<1.0.0",

src/backend/tests/unit/components/bundles/livetennisapi/__init__.py

@@ -0,0 +1,90 @@
+from unittest.mock import MagicMock, patch
+
+import httpx
+import pytest
+
+pytest.importorskip("lfx_bundles")
+
+from lfx_bundles.livetennisapi.fixtures import LiveTennisFixturesComponent
+
+from tests.base import ComponentTestBaseWithoutClient
+
+
+class TestLiveTennisFixturesComponent(ComponentTestBaseWithoutClient):
+    @pytest.fixture
+    def component_class(self):
+        return LiveTennisFixturesComponent
+
+    @pytest.fixture
+    def default_kwargs(self):
+        return {
+            "api_key": "test-key",
+            "tour": "all",
+            "limit": 50,
+        }
+
+    @pytest.fixture
+    def file_names_mapping(self):
+        # New component, no version history yet.
+        return []
+
+    @pytest.fixture(autouse=True)
+    def mock_httpx_client(self):
+        """Keep every test offline, including the inherited test_latest_version."""
+        with patch("lfx_bundles.livetennisapi.fixtures.httpx.Client") as mock_client:
+            mock_response = MagicMock()
+            mock_response.json.return_value = {"data": [], "meta": {"count": 0}}
+            mock_client.return_value.__enter__.return_value.get.return_value = mock_response
+            yield mock_client
+
+    def test_frontend_node(self, component_class, default_kwargs):
+        component = component_class(**default_kwargs)
+
+        frontend_node = component.to_frontend_node()
+
+        node_data = frontend_node["data"]["node"]
+        assert node_data["display_name"] == "Fixtures"
+        assert node_data["icon"] == "LiveTennisAPI"
+        assert node_data["template"]["api_key"]["password"] is True
+
+    def test_fetch_fixtures_success(self, component_class, default_kwargs, mock_httpx_client):
+        component = component_class(**default_kwargs)
+        mock_get = mock_httpx_client.return_value.__enter__.return_value.get
+        mock_get.return_value.json.return_value = {
+            "data": [
+                {
+                    "id": 456,
+                    "event_date": "2026-08-17",
+                    "start_time": "2026-08-17T11:00:00Z",
+                    "tournament": "US Open",
+                    "round": "1st Round",
+                    "round_code": "R128",
+                    "tour": "atp",
+                    "surface": "hard",
+                    "player1_name": "Player One",
+                    "player1_id": 1,
+                    "player2_name": "Player Two",
+                    "player2_id": None,
+                    "status": "upcoming",
+                }
+            ],
+            "meta": {"count": 1},
+        }
+
+        results = component.fetch_fixtures()
+
+        assert len(results) == 1
+        row = results[0].data
+        assert row["id"] == 456
+        assert row["start_time"] == "2026-08-17T11:00:00Z"
+        assert row["player2_id"] is None
+        assert results[0].text == "Player One vs Player Two — US Open"
+
+    def test_timeout_returns_error_data(self, component_class, default_kwargs, mock_httpx_client):
+        component = component_class(**default_kwargs)
+        mock_httpx_client.return_value.__enter__.return_value.get.side_effect = httpx.TimeoutException("timeout")
+
+        results = component.fetch_fixtures()
+
+        assert len(results) == 1
+        assert "error" in results[0].data

src/backend/tests/unit/components/bundles/livetennisapi/test_fixtures.py

@@ -0,0 +1,116 @@
+from unittest.mock import MagicMock, patch
+
+import httpx
+import pytest
+
+pytest.importorskip("lfx_bundles")
+
+from lfx_bundles.livetennisapi.live_matches import LiveTennisMatchesComponent
+
+from tests.base import ComponentTestBaseWithoutClient
+
+
+class TestLiveTennisMatchesComponent(ComponentTestBaseWithoutClient):
+    @pytest.fixture
+    def component_class(self):
+        return LiveTennisMatchesComponent
+
+    @pytest.fixture
+    def default_kwargs(self):
+        return {
+            "api_key": "test-key",
+            "match_status": "live",
+            "tour": "all",
+            "limit": 50,
+        }
+
+    @pytest.fixture
+    def file_names_mapping(self):
+        # New component, no version history yet.
+        return []
+
+    @pytest.fixture(autouse=True)
+    def mock_httpx_client(self):
+        """Keep every test offline, including the inherited test_latest_version."""
+        with patch("lfx_bundles.livetennisapi.live_matches.httpx.Client") as mock_client:
+            mock_response = MagicMock()
+            mock_response.json.return_value = {"data": [], "meta": {"count": 0}}
+            mock_client.return_value.__enter__.return_value.get.return_value = mock_response
+            yield mock_client
+
+    def test_frontend_node(self, component_class, default_kwargs):
+        component = component_class(**default_kwargs)
+
+        frontend_node = component.to_frontend_node()
+
+        node_data = frontend_node["data"]["node"]
+        assert node_data["display_name"] == "Live Matches"
+        assert node_data["icon"] == "LiveTennisAPI"
+        assert "api_key" in node_data["template"]
+        assert node_data["template"]["api_key"]["password"] is True
+        assert node_data["template"]["match_status"]["options"] == ["live", "upcoming"]
+
+    def test_fetch_matches_success(self, component_class, default_kwargs, mock_httpx_client):
+        component = component_class(**default_kwargs)
+        mock_get = mock_httpx_client.return_value.__enter__.return_value.get
+        mock_get.return_value.json.return_value = {
+            "data": [
+                {
+                    "id": 123,
+                    "status": "live",
+                    "tour": "atp",
+                    "tournament": "Cincinnati Open",
+                    "round": "Quarterfinal",
+                    "surface": "hard",
+                    "players": {
+                        "p1": {"id": 1, "name": "Player One", "country": "sui", "ranking": 3},
+                        "p2": {"id": 2, "name": "Player Two", "country": "esp", "ranking": 1},
+                    },
+                    "score": {
+                        "sets": [1, 0],
+                        "games": [[6, 3], [4, 2]],
+                        "points": ["30", "15"],
+                        "server": 1,
+                    },
+                }
+            ],
+            "meta": {"count": 1},
+        }
+
+        results = component.fetch_matches()
+
+        assert len(results) == 1
+        row = results[0].data
+        assert row["id"] == 123
+        assert row["player1"] == "Player One"
+        assert row["player2"] == "Player Two"
+        assert row["sets"] == "1-0"
+        assert row["games"] == "6-4 3-2"
+        assert row["points"] == "30-15"
+
+        _, kwargs = mock_get.call_args
+        assert kwargs["params"]["status"] == "live"
+        assert "tour" not in kwargs["params"]
+        assert kwargs["headers"]["X-API-Key"] == "test-key"
+
+    def test_tour_filter_is_sent(self, component_class, default_kwargs, mock_httpx_client):
+        component = component_class(**{**default_kwargs, "tour": "wta"})
+
+        component.fetch_matches()
+
+        _, kwargs = mock_httpx_client.return_value.__enter__.return_value.get.call_args
+        assert kwargs["params"]["tour"] == "wta"
+
+    def test_http_error_returns_error_data(self, component_class, default_kwargs, mock_httpx_client):
+        component = component_class(**default_kwargs)
+        mock_response = mock_httpx_client.return_value.__enter__.return_value.get.return_value
+        mock_response.status_code = 401
+        mock_response.text = '{"error":"unauthorized"}'
+        mock_response.raise_for_status.side_effect = httpx.HTTPStatusError(
+            "401", request=MagicMock(), response=mock_response
+        )
+
+        results = component.fetch_matches()
+
+        assert len(results) == 1
+        assert "error" in results[0].data

src/backend/tests/unit/components/bundles/livetennisapi/test_live_matches.py

@@ -0,0 +1,91 @@
+from unittest.mock import MagicMock, patch
+
+import httpx
+import pytest
+
+pytest.importorskip("lfx_bundles")
+
+from lfx_bundles.livetennisapi.match_score import LiveTennisMatchScoreComponent
+
+from tests.base import ComponentTestBaseWithoutClient
+
+
+class TestLiveTennisMatchScoreComponent(ComponentTestBaseWithoutClient):
+    @pytest.fixture
+    def component_class(self):
+        return LiveTennisMatchScoreComponent
+
+    @pytest.fixture
+    def default_kwargs(self):
+        return {
+            "api_key": "test-key",
+            "match_id": "123",
+        }
+
+    @pytest.fixture
+    def file_names_mapping(self):
+        # New component, no version history yet.
+        return []
+
+    @pytest.fixture(autouse=True)
+    def mock_httpx_client(self):
+        """Keep every test offline, including the inherited test_latest_version."""
+        with patch("lfx_bundles.livetennisapi.match_score.httpx.Client") as mock_client:
+            mock_response = MagicMock()
+            mock_response.json.return_value = {}
+            mock_client.return_value.__enter__.return_value.get.return_value = mock_response
+            yield mock_client
+
+    def test_frontend_node(self, component_class, default_kwargs):
+        component = component_class(**default_kwargs)
+
+        frontend_node = component.to_frontend_node()
+
+        node_data = frontend_node["data"]["node"]
+        assert node_data["display_name"] == "Match Score"
+        assert node_data["icon"] == "LiveTennisAPI"
+        assert node_data["template"]["match_id"]["value"] == "123"
+
+    def test_fetch_score_success(self, component_class, default_kwargs, mock_httpx_client):
+        component = component_class(**default_kwargs)
+        mock_get = mock_httpx_client.return_value.__enter__.return_value.get
+        mock_get.return_value.json.return_value = {
+            "sets": [1, 0],
+            "games": [[6, 3], [2, 1]],
+            "points": ["40", "30"],
+            "server": 2,
+            "is_tiebreak": False,
+            "timestamp": "2026-08-16T12:00:00Z",
+        }
+
+        result = component.fetch_score()
+
+        assert result.data["sets"] == [1, 0]
+        assert result.data["server"] == 2
+        assert "sets 1-0" in result.text
+        assert "games 6-2 3-1" in result.text
+
+        args, kwargs = mock_get.call_args
+        assert args[0].endswith("/matches/123/score")
+        assert kwargs["headers"]["X-API-Key"] == "test-key"
+
+    def test_non_integer_match_id_returns_error(self, component_class, default_kwargs):
+        component = component_class(**{**default_kwargs, "match_id": "not-a-number"})
+
+        result = component.fetch_score()
+
+        assert "error" in result.data
+
+    def test_not_found_returns_friendly_error(self, component_class, default_kwargs, mock_httpx_client):
+        component = component_class(**default_kwargs)
+        mock_response = mock_httpx_client.return_value.__enter__.return_value.get.return_value
+        mock_response.status_code = 404
+        mock_response.text = '{"error":"not_found"}'
+        mock_response.raise_for_status.side_effect = httpx.HTTPStatusError(
+            "404", request=MagicMock(), response=mock_response
+        )
+
+        result = component.fetch_score()
+
+        assert "error" in result.data
+        assert "not found" in result.text

src/backend/tests/unit/components/bundles/livetennisapi/test_match_score.py

@@ -0,0 +1,87 @@
+from unittest.mock import MagicMock, patch
+
+import pytest
+
+pytest.importorskip("lfx_bundles")
+
+from lfx_bundles.livetennisapi.player_search import LiveTennisPlayerSearchComponent
+
+from tests.base import ComponentTestBaseWithoutClient
+
+
+class TestLiveTennisPlayerSearchComponent(ComponentTestBaseWithoutClient):
+    @pytest.fixture
+    def component_class(self):
+        return LiveTennisPlayerSearchComponent
+
+    @pytest.fixture
+    def default_kwargs(self):
+        return {
+            "api_key": "test-key",
+            "search": "alcaraz",
+            "limit": 50,
+        }
+
+    @pytest.fixture
+    def file_names_mapping(self):
+        # New component, no version history yet.
+        return []
+
+    @pytest.fixture(autouse=True)
+    def mock_httpx_client(self):
+        """Keep every test offline, including the inherited test_latest_version."""
+        with patch("lfx_bundles.livetennisapi.player_search.httpx.Client") as mock_client:
+            mock_response = MagicMock()
+            mock_response.json.return_value = {"data": [], "meta": {"count": 0}}
+            mock_client.return_value.__enter__.return_value.get.return_value = mock_response
+            yield mock_client
+
+    def test_frontend_node(self, component_class, default_kwargs):
+        component = component_class(**default_kwargs)
+
+        frontend_node = component.to_frontend_node()
+
+        node_data = frontend_node["data"]["node"]
+        assert node_data["display_name"] == "Player Search"
+        assert node_data["icon"] == "LiveTennisAPI"
+        assert node_data["template"]["search"]["value"] == "alcaraz"
+
+    def test_fetch_players_success(self, component_class, default_kwargs, mock_httpx_client):
+        component = component_class(**default_kwargs)
+        mock_get = mock_httpx_client.return_value.__enter__.return_value.get
+        mock_get.return_value.json.return_value = {
+            "data": [
+                {
+                    "id": 7,
+                    "name": "Carlos Alcaraz",
+                    "tour": "atp",
+                    "country": "esp",
+                    "ranking": 1,
+                    "ranking_points": 9000,
+                    "ranking_movement": "same",
+                    "hand": "R",
+                    "birthday": "2003-05-05",
+                    "is_doubles_team": False,
+                }
+            ],
+            "meta": {"count": 1},
+        }
+
+        results = component.fetch_players()
+
+        assert len(results) == 1
+        row = results[0].data
+        assert row["name"] == "Carlos Alcaraz"
+        assert row["ranking"] == 1
+        assert row["is_doubles_team"] is False
+
+        _, kwargs = mock_get.call_args
+        assert kwargs["params"]["search"] == "alcaraz"
+
+    def test_empty_search_omits_param(self, component_class, default_kwargs, mock_httpx_client):
+        component = component_class(**{**default_kwargs, "search": ""})
+
+        component.fetch_players()
+
+        _, kwargs = mock_httpx_client.return_value.__enter__.return_value.get.call_args
+        assert "search" not in kwargs["params"]