fcc61c0cb8
Extracted credential validation, request building, response parsing, and configuration helpers from the 464-line OpenRouter provider into separate, focused classes. This follows the pattern established by the Cloudflare image provider and brings all files under the project's 300-line limit. Files created: - class-open-router-validator.php (152 lines): Handles credential validation with HTTP probes and diagnostic messaging. Delegates from the provider. - class-open-router-config.php (84 lines): Centralizes admin config resolution for API base URL and cache TTL settings. Used by both provider and validator. - class-open-router-request-builder.php (79 lines): Encapsulates request header building and cURL auth filter registration for hosting environments that strip Authorization headers. - class-open-router-response-parser.php (87 lines): Handles response parsing, error classification, and retry-decision logic. - Tests: OpenRouterValidatorTest.php with comprehensive credential checks. Provider shrinks from 464 to 278 lines. All classes are under 300 lines. Dependencies remain clean: validator and config are independent, request-builder and response-parser have no circular imports. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
88 lines
2.7 KiB
PHP
88 lines
2.7 KiB
PHP
<?php
|
|
declare(strict_types=1);
|
|
|
|
/**
|
|
* Response parser for OpenRouter API responses.
|
|
*
|
|
* Encapsulates the logic for parsing and validating OpenRouter chat completion
|
|
* responses, including error classification and retry-decision logic.
|
|
*
|
|
* Triggered by: PRAutoBlogger_OpenRouter_Provider::send_chat_completion()
|
|
* Dependencies: PRAutoBlogger_Logger (for error/warning logging).
|
|
*
|
|
* @see class-open-router-provider.php — Parent class that uses this parser.
|
|
*/
|
|
class PRAutoBlogger_OpenRouter_Response_Parser {
|
|
|
|
/**
|
|
* Determine if an HTTP status code indicates a retryable error.
|
|
*
|
|
* Returns true if the failure is transient (5xx, 429) and the retry loop
|
|
* should continue with backoff. Returns false for 4xx errors, which should
|
|
* fail immediately without retry.
|
|
*
|
|
* @param int $status_code HTTP status code.
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function is_retryable( int $status_code ): bool {
|
|
return 429 === $status_code || $status_code >= 500;
|
|
}
|
|
|
|
/**
|
|
* Parse a successful OpenRouter response.
|
|
*
|
|
* Validates the response contains the required fields and extracts
|
|
* the completion content and token usage.
|
|
*
|
|
* @param array $data Decoded JSON response from OpenRouter.
|
|
* @param string $model The model that was requested (fallback if not in response).
|
|
*
|
|
* @return array{
|
|
* content: string,
|
|
* model: string,
|
|
* prompt_tokens: int,
|
|
* completion_tokens: int,
|
|
* total_tokens: int,
|
|
* finish_reason: string,
|
|
* }
|
|
*
|
|
* @throws \RuntimeException If response structure is invalid.
|
|
*/
|
|
public function parse_success( array $data, string $model ): array {
|
|
if ( ! isset( $data['choices'][0]['message']['content'] ) ) {
|
|
throw new \RuntimeException(
|
|
__( 'OpenRouter returned unexpected response format.', 'prautoblogger' )
|
|
);
|
|
}
|
|
|
|
$usage = $data['usage'] ?? [];
|
|
|
|
return [
|
|
'content' => $data['choices'][0]['message']['content'],
|
|
'model' => $data['model'] ?? $model,
|
|
'prompt_tokens' => (int) ( $usage['prompt_tokens'] ?? 0 ),
|
|
'completion_tokens' => (int) ( $usage['completion_tokens'] ?? 0 ),
|
|
'total_tokens' => (int) ( $usage['total_tokens'] ?? 0 ),
|
|
'finish_reason' => $data['choices'][0]['finish_reason'] ?? 'unknown',
|
|
];
|
|
}
|
|
|
|
/**
|
|
* Extract the error message from a failed response.
|
|
*
|
|
* Prefers the `error.message` field if present; falls back to the
|
|
* HTTP status code as a string.
|
|
*
|
|
* @param array $data Decoded JSON response (may be empty or malformed).
|
|
* @param int $status HTTP status code.
|
|
*
|
|
* @return string Human-readable error message.
|
|
*/
|
|
public function get_error_message( array $data, int $status ): string {
|
|
return isset( $data['error']['message'] )
|
|
? $data['error']['message']
|
|
: 'HTTP ' . $status;
|
|
}
|
|
}
|