refactor!: sdk release with new fern generated architecture

.fern/metadata.json

@@ -0,0 +1,16 @@
+{
+  "cliVersion": "3.1.0",
+  "generatorName": "fernapi/fern-python-sdk",
+  "generatorVersion": "4.42.0",
+  "generatorConfig": {
+    "client": {
+      "class_name": "BaseClient",
+      "filename": "base_client.py",
+      "exported_class_name": "DeepgramClient",
+      "exported_filename": "client.py"
+    },
+    "use_typeddict_requests": true,
+    "should_generate_websocket_clients": true,
+    "enable_wire_tests": true
+  }
+}

.fernignore

@@ -1,33 +1,79 @@
-# Development, Configuration Files & Documentation
-README.md
-CONTRIBUTING.md
-.vscode/
-.gitignore
-mypy.ini
-websockets-reference.md
-.github/
-scripts/run_examples.sh
-docs/
-pyproject.toml
-CHANGELOG.md
+# WireMock mappings manually fixed to handle x-fern-sdk-method-name attribute
+# Generator doesn't properly handle this attribute, so mappings must be manually maintained
+wiremock/wiremock-mappings.json
 
-# Examples
-examples/
+# Custom client implementation extending BaseClient with additional features:
+# - access_token parameter support (Bearer token authentication)
+# - Automatic session ID generation and header injection (x-deepgram-session-id)
+# This file is manually maintained and should not be regenerated
+src/deepgram/client.py
 
-# Test Files
-tests/unit/
-tests/integrations/
+# Wire test files with manual fixes to correct generator output:
+# - test_listen_v1_media.py: Fixed transcribe_file() call to pass required request parameter (bytes)
+# - test_speak_v1_audio.py: Fixed generate() call to consume iterator for request completion
+# - conftest.py: Changed from generated DeepgramApi to BaseClient for WireMock compatibility
+tests/wire/test_listen_v1_media.py
+tests/wire/test_speak_v1_audio.py
+tests/wire/conftest.py
 
-# Custom Extensions & Clients
-src/deepgram/client.py
-src/deepgram/extensions/
+# Wire tests __init__.py with Python 3.8-3.10 datetime.fromisoformat compatibility fix:
+# The Fern generator creates test files that use datetime.fromisoformat() with ISO 8601 strings
+# ending in 'Z' (e.g., '2024-01-15T09:30:00Z'). However, Python 3.10's datetime.fromisoformat()
+# doesn't support the 'Z' suffix (this was added in Python 3.11). Python 3.8 and 3.9 also lack
+# this support.
+#
+# Rather than modifying generated test files (which would be overwritten on regeneration), we
+# implement a monkey-patch in tests/wire/__init__.py that wraps the datetime.datetime class
+# and overrides fromisoformat() to automatically convert 'Z' to '+00:00' before calling the
+# original implementation.
+#
+# This ensures:
+# 1. Generated test files remain unchanged and can be regenerated without conflicts
+# 2. All wire tests pass on Python 3.8, 3.9, and 3.10 (as well as 3.11+)
+# 3. The fix is transparent to all code importing datetime.datetime in the wire tests module
+#
+# The implementation uses a wrapper class that inherits from the original datetime class,
+# ensuring all other datetime functionality remains unchanged. The wrapper is injected into
+# sys.modules['datetime'].datetime so that any 'from datetime import datetime' statements
+# in the wire tests will get the patched version.
+tests/wire/__init__.py
 
-# Socket Client Implementations
-src/deepgram/agent/v1/socket_client.py
-src/deepgram/listen/v1/socket_client.py
-src/deepgram/listen/v2/socket_client.py
-src/deepgram/speak/v1/socket_client.py
+# Manual standalone tests
+tests/manual
 
-# Bug Fixes
-src/deepgram/listen/client.py
-src/deepgram/core/client_wrapper.py
+# WebSocket socket client files with manual fixes for binary audio data support:
+# The generator incorrectly types \*\_media methods as `str` and uses `_send_model()` which
+# calls `.dict()` on the input, causing runtime errors. These files are manually fixed to:
+# 1. Change parameter type from `str` to `bytes` for all `*_media` methods
+# 2. Change from `_send_model()` to `_send()` to properly handle binary data
+#
+# src/deepgram/listen/v1/socket_client.py:
+# - Line 57: Changed `async def send_listen_v_1_media(self, message: str)` to `message: bytes`
+# - Line 60: Updated docstring from "sent as a str" to "sent as bytes"
+# - Line 62: Changed `await self._send_model(message)` to `await self._send(message)`
+# - Line 138: Changed `def send_listen_v_1_media(self, message: str)` to `message: bytes`
+# - Line 141: Updated docstring from "sent as a str" to "sent as bytes"
+# - Line 143: Changed `self._send_model(message)` to `self._send(message)`
+#
+# src/deepgram/listen/v2/socket_client.py:
+# - Line 54: Changed `async def send_listen_v_2_media(self, message: str)` to `message: bytes`
+# - Line 57: Updated docstring from "sent as a str" to "sent as bytes"
+# - Line 59: Changed `await self._send_model(message)` to `await self._send(message)`
+# - Line 121: Changed `def send_listen_v_2_media(self, message: str)` to `message: bytes`
+# - Line 124: Updated docstring from "sent as a str" to "sent as bytes"
+# - Line 126: Changed `self._send_model(message)` to `self._send(message)`
+#
+# src/deepgram/agent/v1/socket_client.py:
+# - Line 136: Changed `async def send_agent_v_1_media(self, message: str)` to `message: bytes`
+# - Line 139: Updated docstring from "sent as a str" to "sent as bytes"
+# - Line 141: Changed `await self._send_model(message)` to `await self._send(message)`
+# - Line 245: Changed `def send_agent_v_1_media(self, message: str)` to `message: bytes`
+# - Line 248: Updated docstring from "sent as a str" to "sent as bytes"
+# - Line 250: Changed `self._send_model(message)` to `self._send(message)`
+#
+# Reason: Audio data must be sent as binary bytes, not strings. The `_send_model()` method
+# expects Pydantic models and calls `.dict()` which fails on bytes/str. The `_send()` method
+# properly handles bytes by passing them directly to the websocket connection.
+# src/deepgram/listen/v1/socket_client.py
+# src/deepgram/listen/v2/socket_client.py
+# src/deepgram/agent/v1/socket_client.py

.github/.commitlintrc.json

@@ -49,4 +49,5 @@
             100
         ]
     }
-}
+}
+

.github/.release-please-manifest.json

@@ -1,3 +1,4 @@
 {
   ".": "5.3.0"
-}
+}
+