test: Search PHPUnit tests

tests/php/TestCase.php

@@ -81,5 +81,68 @@ protected function checkRequirements(): void { // phpcs:ignore Generic.CodeAnaly
 		parent::checkRequirements();
 	}
 
+	/**
+	 * Intercept Algolia SDK HTTP calls and collect request paths.
+	 *
+	 * @param array<int, string>              $recorded_paths Paths captured from outgoing SDK requests.
+	 * @param (callable(string): string)|null $body_for_path Optional callback to provide a response body for a given request path.
+	 * @param string|null                     $throw_on_path_segment Optional path segment that triggers a RuntimeException when matched.
+	 */
+	public function mock_algolia_http_client( array &$recorded_paths, ?callable $body_for_path = null, ?string $throw_on_path_segment = null ): void {
+		\OneSearch\Vendor\Algolia\AlgoliaSearch\Algolia::setHttpClient(
+			new class( $recorded_paths, $body_for_path, $throw_on_path_segment ) implements \OneSearch\Vendor\Algolia\AlgoliaSearch\Http\HttpClientInterface {
+				/** @var array<int, string> */
+				private array $paths;
+
+				/** @var (callable(string): string)|null */
+				private $body_for_path;
+
+				/** @var string|null */
+				private ?string $throw_on_path_segment;
+
+				/**
+				 * @param array<int, string>              $paths Reference to the array that records intercepted request paths.
+				 * @param (callable(string): string)|null $body_for_path Optional callback to generate mock response bodies.
+				 * @param string|null                     $throw_on_path_segment Optional path segment that triggers a RuntimeException when matched.
+				 */
+				public function __construct( array &$paths, ?callable $body_for_path, ?string $throw_on_path_segment ) {
+					$this->paths                 = &$paths;
+					$this->body_for_path         = $body_for_path;
+					$this->throw_on_path_segment = $throw_on_path_segment;
+				}
+
+				/**
+				 * {@inheritDoc}
+				 *
+				 * @param \OneSearch\Vendor\Psr\Http\Message\RequestInterface $request         The PSR-7 request.
+				 * @param mixed                                               $timeout         Request timeout.
+				 * @param mixed                                               $connect_timeout Connection timeout.
+				 * @throws \RuntimeException When the configured path segment is encountered.
+				 */
+				public function sendRequest( \OneSearch\Vendor\Psr\Http\Message\RequestInterface $request, mixed $timeout, mixed $connect_timeout ): \OneSearch\Vendor\Psr\Http\Message\ResponseInterface { // phpcs:ignore SlevomatCodingStandard.Functions.UnusedParameter.UnusedParameter
+					$path          = (string) $request->getUri()->getPath();
+					$this->paths[] = $path;
+
+					if ( null !== $this->throw_on_path_segment && str_contains( $path, $this->throw_on_path_segment ) ) {
+						throw new \RuntimeException( 'forced test exception' );
+					}
+
+					if ( null !== $this->body_for_path ) {
+						$body = (string) call_user_func( $this->body_for_path, $path );
+					} elseif ( str_contains( $path, '/task/' ) ) {
+						$body = '{"status":"published","pendingTask":false}';
+					} elseif ( str_contains( $path, '/query' ) ) {
+						$body = '{"hits":[{"objectID":"1"}],"nbHits":1,"page":0,"hitsPerPage":20}';
+					} else {
+						$body = '{"taskID":1,"updatedAt":"2024-01-01T00:00:00.000Z"}';
+					}
+
+					// @phpstan-ignore return.type
+					return new \OneSearch\Vendor\Algolia\AlgoliaSearch\Http\Psr7\Response( 200, [], $body );
+				}
+			}
+		);
+	}
+
 	// Add any common setup or utility methods for tests here.
 }