feat(clickhouse): accept any PSR-18 client in adapter constructor

[loks0n]

What

Widens the ClickHouse adapter's $client constructor parameter (and the backing property) from the concrete Utopia\Client to the PSR-18 Psr\Http\Client\ClientInterface.

-        ?Client $client = null
+        ?ClientInterface $client = null

Why

The adapter only ever calls sendRequest() on the injected transport, so requiring the concrete Utopia\Client was stricter than necessary — and it blocked a real use case.

In a Swoole-coroutine server, the default transport (a cURL client with withConnectionReuse()) keeps a single CurlHandle on the instance. When the adapter is shared as a singleton across concurrent coroutines, that one handle gets clobbered by concurrent requests — it is not coroutine-safe.

The fix for that is Utopia\Client\Pool, which borrows a client from a bounded pool per request and reclaims it. But Pool implements ClientInterface/StreamingClientInterface — it is not a Utopia\Client — so it could not be passed in. Widening to ClientInterface unblocks it:

$transport = new Pool($connections); // Utopia\Client\Pool
$adapter = new ClickHouse($host, $user, $pass, $port, $secure, client: $transport);

The default still constructs the same cURL-backed Utopia\Client, so existing callers are unaffected.

Notes

• Added psr/http-client as an explicit dependency (previously only transitive via utopia-php/client), since the source now references it directly.
• composer check (PHPStan max) and pint pass; unit tests green.

🤖 Generated with Claude Code

[greptile-apps]

Greptile Summary

This PR widens the ClickHouse adapter transport type to accept any PSR-18 client. The main changes are:

• Adds psr/http-client as a direct dependency.
• Changes the injected ClickHouse client type from Utopia\Client to ClientInterface.
• Keeps the existing default cURL-backed Utopia\Client transport.

Confidence Score: 5/5

The change is narrowly scoped and merge-safe.

The adapter continues to use only the PSR-18 sendRequest contract, while the default transport behavior remains unchanged for existing callers.

T-Rex Logs

What T-Rex did

• The base run rejected the non-Utopia PSR-18 client with TypeError and EXIT_CODE: 1.
• The head run accepted the same client, returning constructor_result=success, adapter_class=Utopia\Usage\Adapter\ClickHouse, and EXIT_CODE: 0.
• Two log artifacts were captured to document the base and head run outcomes.

_{Ran code and verified through T-Rex}

_{Reviews (1): Last reviewed commit: "feat(clickhouse): accept any PSR-18 clie..." | Re-trigger Greptile}