ClientException

18class ClientException extends InvalidArgumentException19{20    /**21     * The request that failed.22     *23     * @var Request|null24     */25    protected ?Request $request = null;26    /**27     * Returns the request that failed as our Request DTO.28     *29     * @since 0.2.030     *31     * @return Request32     * @throws \RuntimeException If no request is available33     */34    public function getRequest(): Request35    {36        if ($this->request === null) {37            throw new \RuntimeException('Request object not available. This exception was directly instantiated. ' . 'Use a factory method that provides request context.');38        }39        return $this->request;40    }41    /**42     * Creates a ClientException from a client error response (4xx).43     *44     * This method extracts error details from common API response formats45     * and creates an exception with a descriptive message and status code.46     *47     * @since 0.2.048     *49     * @param Response $response The HTTP response that failed.50     * @return self51     */52    public static function fromClientErrorResponse(Response $response): self53    {54        $statusCode = $response->getStatusCode();55        $statusTexts = [400 => 'Bad Request', 401 => 'Unauthorized', 403 => 'Forbidden', 404 => 'Not Found', 422 => 'Unprocessable Entity', 429 => 'Too Many Requests'];56        if (isset($statusTexts[$statusCode])) {57            $errorMessage = sprintf('%s (%d)', $statusTexts[$statusCode], $statusCode);58        } else {59            $errorMessage = sprintf('Client error (%d): Request was rejected due to client-side issue', $statusCode);60        }61        // Extract error message from response data using centralized utility62        $extractedError = ErrorMessageExtractor::extractFromResponseData($response->getData());63        if ($extractedError !== null) {64            $errorMessage .= ' - ' . $extractedError;65        }66        return new self($errorMessage, $statusCode);67    }68}