fix(speak): correct TTS warning event field names to match API response

[lukeocodes]

Summary

Fixes #617

Changed SpeakV1WarningEvent field names from code/description to warn_code/warn_msg to match the actual field names returned by the Deepgram API.

Issue

When the Deepgram API returns a 429 rate limit warning, the response contains:

{
  "type": "Warning",
  "warn_code": "EXCESSIVE_FLUSH",
  "warn_msg": "Rate limit exceeded for flushes. Please try again later."
}

However, the SDK's SpeakV1WarningEvent model was expecting code and description fields instead, causing a Pydantic validation error that crashed the TTS WebSocket connection instead of calling the on_warning callback.

Changes

1. Updated SpeakV1WarningEvent model:

   • Changed code: str → warn_code: str
   • Changed description: str → warn_msg: str

2. Updated all related tests to use the correct field names

Impact

• ✅ TTS WebSocket connections will now handle warning messages gracefully instead of crashing
• ✅ The on_warning callback will be properly invoked for 429 rate limit warnings
• ✅ Matches the SDK v4.8 behavior where warnings were handled correctly
• ✅ All existing tests updated and passing

Test plan

• Updated all unit tests in test_speak_v1_models.py to use new field names
• Tests verify:
  • Valid warning event creation
  • Serialization/deserialization
  • Missing required fields validation
  • Wrong type validation
  • Multiple warning scenarios

[Copilot]

Pull request overview

This PR fixes a bug in the TTS WebSocket warning event handling by updating the SpeakV1WarningEvent model field names to match the actual Deepgram API response format, preventing validation errors that previously caused crashes.

Changes:

• Updated SpeakV1WarningEvent model fields from code/description to warn_code/warn_msg
• Updated all related unit tests to use the corrected field names

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File	Description
src/deepgram/extensions/types/sockets/speak_v1_warning_event.py	Updated field names in the warning event model to match API response
tests/unit/test_speak_v1_models.py	Updated all test cases to use the corrected field names

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.