fix(logging): provide raw response in failure logs

Previously, streamed API errors could result in incomplete raw response details in failure logs, making debugging challenging.
This update ensures that the full raw response text, including reassembled data from streams, is explicitly captured within the client's error handling.
The failure logger is also updated to accept and prioritize this explicit raw response, guaranteeing comprehensive error logging for all API error types.

src/rotator_library/client.py

@@ -544,11 +544,12 @@ class RotatingClient:
 
                         except (StreamedAPIError, litellm.RateLimitError) as e:
                             last_exception = e
-                            log_failure(api_key=current_key, model=model, attempt=attempt + 1, error=e, request_headers=dict(request.headers) if request else {})
+                            
                             classified_error = classify_error(e)
                             
                             # This is the final, robust handler for streamed errors.
                             error_payload = {}
+                            cleaned_str = None
                             # The actual exception might be wrapped in our StreamedAPIError.
                             original_exc = getattr(e, 'data', e)
 
@@ -562,6 +563,16 @@ class RotatingClient:
                             except (json.JSONDecodeError, TypeError):
                                 lib_logger.warning("Could not parse JSON details from streamed error exception.")
                                 error_payload = {}
+                            
+                            # Now, log the failure with the extracted raw response.
+                            log_failure(
+                                api_key=current_key,
+                                model=model,
+                                attempt=attempt + 1,
+                                error=e,
+                                request_headers=dict(request.headers) if request else {},
+                                raw_response_text=cleaned_str
+                            )
 
                             error_details = error_payload.get("error", {})
                             error_status = error_details.get("status", "")

src/rotator_library/failure_logger.py

@@ -43,13 +43,15 @@ failure_logger = setup_failure_logger()
 # Get the main library logger for concise, propagated messages
 main_lib_logger = logging.getLogger('rotator_library')
 
-def log_failure(api_key: str, model: str, attempt: int, error: Exception, request_headers: dict):
+def log_failure(api_key: str, model: str, attempt: int, error: Exception, request_headers: dict, raw_response_text: str = None):
     """
     Logs a detailed failure message to a file and a concise summary to the main logger.
     """
     # 1. Log the full, detailed error to the dedicated failures.log file
-    raw_response = None
-    if hasattr(error, 'response') and hasattr(error.response, 'text'):
+    # Prioritize the explicitly passed raw response text, as it may contain
+    # reassembled data from a stream that is not available on the exception object.
+    raw_response = raw_response_text
+    if not raw_response and hasattr(error, 'response') and hasattr(error.response, 'text'):
         raw_response = error.response.text
 
     detailed_log_data = {