chore: update type hints and add typing-extensions dependency

Author: twangodev

pyproject.toml

@@ -11,6 +11,7 @@ dependencies = [
     "ormsgpack>=1.5.0",
     "pydantic>=2.9.1",
     "httpx-ws>=0.6.2",
+    "typing-extensions>=4.15.0",
 ]
 requires-python = ">=3.9"
 readme = "README.md"
@@ -55,6 +56,7 @@ asyncio_mode = "auto"
 
 [dependency-groups]
 dev = [
+    "fish-audio-sdk[utils]",
     "mypy>=1.14.1",
     "pydoc-markdown>=4.8.2",
     "pytest>=8.3.5",
@@ -81,3 +83,6 @@ pages = [
     {title = "Utils", name="fishaudio/utils", contents = ["fishaudio.utils.*"] },
     {title = "Exceptions", name="fishaudio/exceptions", contents = ["fishaudio.exceptions.*"] },
 ]
+
+[tool.uv.sources]
+fish-audio-sdk = { workspace = true }

src/fish_audio_sdk/io.py

@@ -6,13 +6,13 @@
     AsyncGenerator,
     Awaitable,
     Callable,
-    Concatenate,
     Generator,
     Generic,
-    ParamSpec,
     TypeVar,
 )
 
+from typing_extensions import Concatenate, ParamSpec
+
 import httpx
 import httpx._client
 import httpx._types

src/fishaudio/utils/play.py

@@ -51,13 +51,13 @@ def play(
         ```
     """
     # Consolidate iterator to bytes
-    if isinstance(audio, Iterator):
+    if not isinstance(audio, bytes):
         audio = b"".join(audio)
 
     # Notebook mode
     if notebook:
         try:
-            from IPython.display import Audio, display
+            from IPython.display import Audio, display  # ty: ignore[unresolved-import]
 
             display(Audio(audio, rate=44100, autoplay=True))
             return

src/fishaudio/utils/save.py

@@ -27,7 +27,7 @@ def save(audio: Union[bytes, Iterator[bytes]], filename: str) -> None:
         ```
     """
     # Consolidate iterator to bytes if needed
-    if isinstance(audio, Iterator):
+    if not isinstance(audio, bytes):
         audio = b"".join(audio)
 
     # Write to file