ServerException

17class ServerException extends RuntimeException18{19    /**20     * Creates a ServerException from a server error response.21     *22     * This method extracts error details from common API response formats23     * and creates an exception with a descriptive message and status code.24     *25     * @since 0.2.026     *27     * @param Response $response The HTTP response that failed.28     * @return self29     */30    public static function fromServerErrorResponse(Response $response): self31    {32        $statusCode = $response->getStatusCode();33        $statusTexts = [500 => 'Internal Server Error', 502 => 'Bad Gateway', 503 => 'Service Unavailable', 504 => 'Gateway Timeout', 507 => 'Insufficient Storage', 529 => 'Overloaded'];34        if (isset($statusTexts[$statusCode])) {35            $errorMessage = sprintf('%s (%d)', $statusTexts[$statusCode], $statusCode);36        } else {37            $errorMessage = sprintf('Server error (%d): Request was rejected due to server-side issue', $statusCode);38        }39        // Extract error message from response data using centralized utility40        $extractedError = ErrorMessageExtractor::extractFromResponseData($response->getData());41        if ($extractedError !== null) {42            $errorMessage .= ' - ' . $extractedError;43        }44        return new self($errorMessage, $response->getStatusCode());45    }46}