feat: Add API version validation to AsyncAmazonCreatorsApi initialization and a test for invalid versions.

Author: sergioteula

amazon_creatorsapi/aio/api.py

@@ -24,7 +24,7 @@
 )
 
 try:
-    from .auth import AsyncOAuth2TokenManager
+    from .auth import VERSION_ENDPOINTS, AsyncOAuth2TokenManager
     from .client import AsyncHttpClient
 except ImportError as exc:  # pragma: no cover
     msg = (
@@ -110,6 +110,7 @@ class AsyncAmazonCreatorsApi:
 
     Raises:
         InvalidArgumentError: If neither country nor marketplace is provided.
+        ValueError: If version is not supported (valid versions: 2.1, 2.2, 2.3).
 
     """
 
@@ -124,6 +125,9 @@ def __init__(
         throttling: float = DEFAULT_THROTTLING,
     ) -> None:
         """Initialize the async Amazon Creators API client."""
+        # Validate version early to fail fast (before token manager initialization)
+        self._validate_version(version)
+
         self._credential_id = credential_id
         self._credential_secret = credential_secret
         self._version = version
@@ -153,6 +157,21 @@ def __init__(
         )
         self._owns_client = False
 
+    def _validate_version(self, version: str) -> None:
+        """Validate that the API version is supported.
+
+        Args:
+            version: API version to validate.
+
+        Raises:
+            ValueError: If version is not in the list of supported versions.
+
+        """
+        if version not in VERSION_ENDPOINTS:
+            supported = ", ".join(VERSION_ENDPOINTS.keys())
+            msg = f"Unsupported version: {version}. Supported versions are: {supported}"
+            raise ValueError(msg)
+
     async def __aenter__(self) -> Self:
         """Enter async context manager, creating a persistent HTTP client."""
         self._http_client = AsyncHttpClient(host=API_HOST)

tests/amazon_creatorsapi/aio/api_test.py

@@ -99,6 +99,23 @@ def test_raises_error_for_invalid_country(
 
         self.assertIn("Country code", str(context.exception))
 
+    @patch("amazon_creatorsapi.aio.api.AsyncOAuth2TokenManager")
+    def test_raises_error_for_invalid_version(
+        self, mock_token_manager: MagicMock
+    ) -> None:
+        """Test raises ValueError for unsupported API version."""
+        with self.assertRaises(ValueError) as context:
+            AsyncAmazonCreatorsApi(
+                credential_id="test_id",
+                credential_secret="test_secret",
+                version="9.9",  # Invalid version
+                tag="test-tag",
+                country="ES",
+            )
+
+        self.assertIn("Unsupported version: 9.9", str(context.exception))
+        self.assertIn("Supported versions are:", str(context.exception))
+
 
 class TestAsyncAmazonCreatorsApiContextManager(unittest.IsolatedAsyncioTestCase):
     """Tests for AsyncAmazonCreatorsApi async context manager."""