typecast-python 0.3.5__tar.gz → 0.3.7__tar.gz

{typecast_python-0.3.5 → typecast_python-0.3.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: typecast-python
-Version: 0.3.5
+Version: 0.3.7
 Summary: Official Typecast Python SDK - Convert text to lifelike speech using AI-powered voices
 Project-URL: Homepage, https://typecast.ai
 Project-URL: Documentation, https://typecast.ai/docs/overview

{typecast_python-0.3.5 → typecast_python-0.3.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "typecast-python"
-version = "0.3.5"
+version = "0.3.7"
 description = "Official Typecast Python SDK - Convert text to lifelike speech using AI-powered voices"
 authors = [
     {name = "Neosapience", email = "help@typecast.ai"}

typecast_python-0.3.7/src/typecast/_user_agent.py

@@ -0,0 +1,70 @@
+import platform
+import sys
+from importlib import metadata
+
+import aiohttp
+import requests
+
+from . import conf
+
+
+def _package_version(package_name: str) -> str:
+    try:
+        return metadata.version(package_name)
+    except metadata.PackageNotFoundError:
+        return "dev"
+
+
+def _os_name() -> str:
+    system = platform.system().lower()
+    if system == "darwin":
+        return "macos"
+    if system.startswith("windows"):
+        return "windows"
+    return system or "unknown"
+
+
+def _arch_name() -> str:
+    machine = platform.machine().lower()
+    if machine in {"x86_64", "amd64"}:
+        return "x64"
+    if machine in {"aarch64", "arm64"}:
+        return "arm64"
+    return machine or "unknown"
+
+
+def build_user_agent(
+    *,
+    mode: str,
+    http_library: str,
+    host: str,
+    transport: str = "rest",
+) -> str:
+    sdk_version = _package_version("typecast-python")
+    base = "default" if conf.is_default_host(host) else "custom"
+    return (
+        f"typecast-python/{sdk_version} "
+        f"Python/{sys.version_info.major}.{sys.version_info.minor} "
+        f"{platform.python_implementation()}/{platform.python_version()} "
+        f"{http_library} "
+        f"(mode={mode}; base={base}; transport={transport}; "
+        f"os={_os_name()}; arch={_arch_name()}; sdk_env=python; platform=server)"
+    )
+
+
+def requests_user_agent(host: str, transport: str = "rest") -> str:
+    return build_user_agent(
+        mode="sync",
+        http_library=f"requests/{requests.__version__}",
+        host=host,
+        transport=transport,
+    )
+
+
+def aiohttp_user_agent(host: str, transport: str = "rest") -> str:
+    return build_user_agent(
+        mode="async",
+        http_library=f"aiohttp/{aiohttp.__version__}",
+        host=host,
+        transport=transport,
+    )

{typecast_python-0.3.5 → typecast_python-0.3.7}/src/typecast/async_client.py

@@ -11,6 +11,7 @@ from ._voice_clone import (
     validate_clone_inputs,
     validate_custom_voice_id,
 )
+from ._user_agent import aiohttp_user_agent
 from .client import _guess_audio_mime
 from .client import _output_with_inferred_format
 from .client import _validate_output_path
@@ -81,7 +82,7 @@ class AsyncTypecast:
     async def __aenter__(self):
         # Auth header at session scope; per-request Content-Type is set by aiohttp
         # (json= auto-sets application/json, data=FormData() auto-sets multipart).
-        headers = {}
+        headers = {"User-Agent": aiohttp_user_agent(self.host)}
         if self.api_key:
             headers["X-API-KEY"] = self.api_key
         self.session = aiohttp.ClientSession(headers=headers)
@@ -191,8 +192,7 @@ class AsyncTypecast:
 
         Args:
             request: Streaming TTS request. Uses `OutputStream`, which omits
-                `volume` and `target_lufs` (not supported by the streaming
-                endpoint).
+                `volume` (not supported by the streaming endpoint).
             chunk_size: Maximum bytes returned per yielded chunk.
 
         Yields:
@@ -204,7 +204,11 @@ class AsyncTypecast:
             NotFoundError, UnprocessableEntityError, RateLimitError,
             InternalServerError, TypecastError: depending on response status.
         """
-        if not isinstance(chunk_size, int) or isinstance(chunk_size, bool) or chunk_size < 1:
+        if (
+            not isinstance(chunk_size, int)
+            or isinstance(chunk_size, bool)
+            or chunk_size < 1
+        ):
             raise ValueError("chunk_size must be a positive integer")
         if not self.session:
             raise TypecastError("Client session not initialized. Use async with.")

{typecast_python-0.3.5 → typecast_python-0.3.7}/src/typecast/client.py

@@ -10,6 +10,7 @@ from ._voice_clone import (
     validate_clone_inputs,
     validate_custom_voice_id,
 )
+from ._user_agent import requests_user_agent
 from .composer import SpeechComposer
 from .exceptions import (
     BadRequestError,
@@ -111,7 +112,10 @@ class Typecast:
         if not self.api_key and conf.is_default_host(self.host):
             raise ValueError("API key is required for the default Typecast API host")
         self.session = requests.Session()
-        headers = {"Content-Type": "application/json"}
+        headers = {
+            "Content-Type": "application/json",
+            "User-Agent": requests_user_agent(self.host),
+        }
         if self.api_key:
             headers["X-API-KEY"] = self.api_key
         self.session.headers.update(headers)
@@ -225,8 +229,7 @@ class Typecast:
 
         Args:
             request: Streaming TTS request. Uses `OutputStream`, which omits
-                `volume` and `target_lufs` (not supported by the streaming
-                endpoint).
+                `volume` (not supported by the streaming endpoint).
             chunk_size: Maximum bytes returned per yielded chunk.
 
         Yields:
@@ -237,7 +240,11 @@ class Typecast:
             NotFoundError, UnprocessableEntityError, RateLimitError,
             InternalServerError, TypecastError: depending on response status.
         """
-        if not isinstance(chunk_size, int) or isinstance(chunk_size, bool) or chunk_size < 1:
+        if (
+            not isinstance(chunk_size, int)
+            or isinstance(chunk_size, bool)
+            or chunk_size < 1
+        ):
             raise ValueError("chunk_size must be a positive integer")
         endpoint = "/v1/text-to-speech/stream"
         response = self.session.post(

{typecast_python-0.3.5 → typecast_python-0.3.7}/src/typecast/models/tts.py

@@ -183,9 +183,8 @@ class TTSResponse(BaseModel):
 class OutputStream(BaseModel):
     """Audio output settings for streaming mode.
 
-    Streaming mode does not support `volume` or `target_lufs` because the
-    server has to commit each chunk before the full waveform is known.
-    Passing either field raises a validation error so misuse fails fast.
+    Streaming mode does not support `volume`, but it supports `target_lufs`
+    for absolute loudness normalization.
     """
 
     model_config = ConfigDict(extra="forbid")
@@ -195,12 +194,18 @@ class OutputStream(BaseModel):
     audio_format: Optional[str] = Field(
         default="wav", description="Audio format", examples=["wav", "mp3"]
     )
+    target_lufs: Optional[float] = Field(
+        default=None,
+        ge=-70.0,
+        le=0.0,
+        description="Target loudness in LUFS for streaming output normalization (-70 to 0).",
+    )
 
 
 class TTSRequestStream(BaseModel):
     """Request body for `POST /v1/text-to-speech/stream`.
 
-    Mirrors `TTSRequest` but uses `OutputStream` (no volume / target_lufs).
+    Mirrors `TTSRequest` but uses `OutputStream` (no volume).
     """
 
     model_config = ConfigDict(json_schema_extra={"exclude_none": True})