feat: add cloud factory method to facade

Author: CodeWithKyrian

src/Api.php

@@ -34,7 +34,7 @@
 class Api
 {
     public function __construct(
-        public readonly ClientInterface $httpClient,
+        public readonly ClientInterface $client,
         public readonly RequestFactoryInterface $requestFactory,
         public readonly StreamFactoryInterface $streamFactory,
         public readonly string $baseUri,
@@ -519,7 +519,7 @@ private function sendRequest(string $method, string $path, array $options = []):
         }
 
         try {
-            $response = $this->httpClient->sendRequest($request);
+            $response = $this->client->sendRequest($request);
         } catch (ClientExceptionInterface $e) {
             throw new ChromaConnectionException($e->getMessage(), $e->getCode());
         }

src/ChromaDB.php

@@ -19,6 +19,27 @@ public static function factory(): Factory
         return new Factory();
     }
 
+    /**
+     * Creates a new factory instance configured for Chroma Cloud.
+     */
+    public static function cloud(string $apiKey, ?string $tenant = null, ?string $database = null): Factory
+    {
+        $factory = self::factory()
+            ->withHost('https://api.trychroma.com')
+            ->withPort(8000)
+            ->withHeader('X-Chroma-Token', $apiKey);
+
+        if ($tenant) {
+            $factory->withTenant($tenant);
+        }
+
+        if ($database) {
+            $factory->withDatabase($database);
+        }
+
+        return $factory;
+    }
+
     /**
      * Resets the database. This will delete all collections and entries and
      * return true if the database was reset successfully.