feat(sdk): add X-SDK-Version and X-SDK-Language headers, bump to 1.1.2

- Created _version.py as single source of truth for version string
- __init__.py and config.py both import from _version.py (no more drift)
- Every API request now sends X-SDK-Version and X-SDK-Language headers
- User-Agent reads from _version.py dynamically
- Bumped all version references to 1.1.2
- Added test for SDK version headers

Closes #2319

Author: jesse-validkit

setup.cfg

@@ -1,6 +1,6 @@
 [metadata]
 name = validkit
-version = 1.1.1
+version = 1.1.2
 author = ValidKit
 author_email = support@validkit.com
 description = Async Python SDK for ValidKit Email Verification API - Built for AI Agents

setup.py

@@ -9,7 +9,7 @@
 
 setup(
     name="validkit",
-    version="1.1.1",
+    version="1.1.2",
     author="ValidKit",
     author_email="support@validkit.com",
     description="Async Python SDK for ValidKit Email Verification API - Built for AI Agents",

setup_minimal.py

@@ -5,7 +5,7 @@
 
 setup(
     name="validkit",
-    version="1.1.1",
+    version="1.1.2",
     author="ValidKit",
     author_email="developers@validkit.com",
     description="Async Python SDK for ValidKit Email Verification API",

tests/test_config.py

@@ -39,4 +39,9 @@ def test_defaults(self):
 
     def test_user_agent_contains_version(self):
         config = ValidKitConfig(api_key="test")
-        assert "1.1.1" in config.user_agent
+        assert "1.1.2" in config.user_agent
+
+    def test_headers_include_sdk_version(self):
+        config = ValidKitConfig(api_key="test")
+        assert config.headers["X-SDK-Version"] == "1.1.2"
+        assert config.headers["X-SDK-Language"] == "python"

tests/test_imports.py

@@ -48,7 +48,7 @@ def test_import_exceptions():
 
 def test_version():
     from validkit import __version__
-    assert __version__ == "1.1.1"
+    assert __version__ == "1.1.2"
 
 
 def test_no_email_validator_required():

validkit/__init__.py

@@ -25,7 +25,7 @@
     ConnectionError
 )
 
-__version__ = "1.1.1"
+from validkit._version import __version__  # noqa: E402
 __author__ = "ValidKit"
 __email__ = "support@validkit.com"
 

validkit/_version.py

@@ -0,0 +1,3 @@
+"""Single source of truth for the SDK version."""
+
+__version__ = "1.1.2"

validkit/config.py

@@ -2,6 +2,7 @@
 
 from typing import Optional, Dict, Any
 from dataclasses import dataclass, field
+from validkit._version import __version__
 
 
 @dataclass
@@ -18,7 +19,7 @@ class ValidKitConfig:
     rate_limit: Optional[int] = None  # requests per minute
 
     # Agent-specific settings
-    user_agent: str = "ValidKit-Python/1.1.1"
+    user_agent: str = f"ValidKit-Python/{__version__}"
     enable_compression: bool = True
     compact_format: bool = True  # Use token-efficient format by default
 
@@ -60,6 +61,8 @@ def headers(self) -> Dict[str, str]:
         headers = {
             "User-Agent": self.user_agent,
             "X-API-Key": self.api_key,
+            "X-SDK-Version": __version__,
+            "X-SDK-Language": "python",
             "Content-Type": "application/json",
             "Accept": "application/json",
         }