HttpTransporter

29class HttpTransporter implements HttpTransporterInterface30{31    /**32     * @var RequestFactoryInterface PSR-17 request factory.33     */34    private RequestFactoryInterface $requestFactory;35    /**36     * @var StreamFactoryInterface PSR-17 stream factory.37     */38    private StreamFactoryInterface $streamFactory;39    /**40     * @var ClientInterface PSR-18 HTTP client.41     */42    private ClientInterface $client;43    /**44     * Constructor.45     *46     * @since 0.1.047     *48     * @param ClientInterface|null $client PSR-18 HTTP client.49     * @param RequestFactoryInterface|null $requestFactory PSR-17 request factory.50     * @param StreamFactoryInterface|null $streamFactory PSR-17 stream factory.51     */52    public function __construct(?ClientInterface $client = null, ?RequestFactoryInterface $requestFactory = null, ?StreamFactoryInterface $streamFactory = null)53    {54        $this->client = $client ?: Psr18ClientDiscovery::find();55        $this->requestFactory = $requestFactory ?: Psr17FactoryDiscovery::findRequestFactory();56        $this->streamFactory = $streamFactory ?: Psr17FactoryDiscovery::findStreamFactory();57    }58    /**59     * {@inheritDoc}60     *61     * @since 0.1.062     * @since 0.2.0 Added optional RequestOptions parameter and ClientWithOptions support.63     */64    public function send(Request $request, ?RequestOptions $options = null): Response65    {66        $psr7Request = $this->convertToPsr7Request($request);67        // Merge request options with parameter options, with parameter options taking precedence68        $mergedOptions = $this->mergeOptions($request->getOptions(), $options);69        try {70            $hasOptions = $mergedOptions !== null;71            if ($hasOptions && $this->client instanceof ClientWithOptionsInterface) {72                $psr7Response = $this->client->sendRequestWithOptions($psr7Request, $mergedOptions);73            } elseif ($hasOptions && $this->isGuzzleClient($this->client)) {74                $psr7Response = $this->sendWithGuzzle($psr7Request, $mergedOptions);75            } else {76                $psr7Response = $this->client->sendRequest($psr7Request);77            }78        } catch (\WordPress\AiClientDependencies\Psr\Http\Client\NetworkExceptionInterface $e) {79            throw NetworkException::fromPsr18NetworkException($psr7Request, $e);80        } catch (\WordPress\AiClientDependencies\Psr\Http\Client\ClientExceptionInterface $e) {81            // Handle other PSR-18 client exceptions that are not network-related82            throw new RuntimeException(sprintf('HTTP client error occurred while sending request to %s: %s', $request->getUri(), $e->getMessage()), 0, $e);83        }84        return $this->convertFromPsr7Response($psr7Response);85    }86    /**87     * Merges request options with parameter options taking precedence.88     *89     * @since 0.2.090     *91     * @param RequestOptions|null $requestOptions Options from the Request object.92     * @param RequestOptions|null $parameterOptions Options passed as method parameter.93     * @return RequestOptions|null Merged options, or null if both are null.94     */95    private function mergeOptions(?RequestOptions $requestOptions, ?RequestOptions $parameterOptions): ?RequestOptions96    {97        // If no options at all, return null98        if ($requestOptions === null && $parameterOptions === null) {99            return null;100        }101        // If only one set of options exists, return it102        if ($requestOptions === null) {103            return $parameterOptions;104        }105        if ($parameterOptions === null) {106            return $requestOptions;107        }108        // Both exist, merge them with parameter options taking precedence