feat: add Albert API bridge

- Create dedicated PlatformFactory for Albert API
- Handle Albert-specific URL configuration
- Add tests for the new bridge
- Update documentation to reflect Albert as a separate platform

Author: OskarStark

README.md

@@ -69,7 +69,7 @@ $embeddings = new Embeddings();
   * [DeepSeek's R1](https://www.deepseek.com/) with [OpenRouter](https://www.openrouter.com/) as Platform
   * [Amazon's Nova](https://nova.amazon.com) with [AWS](https://aws.amazon.com/bedrock/) as Platform
   * [Mistral's Mistral](https://www.mistral.ai/) with [Mistral](https://www.mistral.ai/) as Platform
-  * OpenAI-compatible models via [Albert API](https://github.com/etalab-ia/albert-api) (French government's sovereign AI gateway)
+  * [Albert API](https://github.com/etalab-ia/albert-api) models with [Albert](https://github.com/etalab-ia/albert-api) as Platform (French government's sovereign AI gateway)
 * Embeddings Models
   * [OpenAI's Text Embeddings](https://platform.openai.com/docs/guides/embeddings/embedding-models) with [OpenAI](https://platform.openai.com/docs/overview) and [Azure](https://learn.microsoft.com/azure/ai-services/openai/concepts/models) as Platform
   * [Voyage's Embeddings](https://docs.voyageai.com/docs/embeddings) with [Voyage](https://www.voyageai.com/) as Platform

examples/albert/chat.php

@@ -3,8 +3,8 @@
 declare(strict_types=1);
 
 use PhpLlm\LlmChain\Chain\Chain;
+use PhpLlm\LlmChain\Platform\Bridge\Albert\PlatformFactory;
 use PhpLlm\LlmChain\Platform\Bridge\OpenAI\GPT;
-use PhpLlm\LlmChain\Platform\Bridge\OpenAI\PlatformFactory;
 use PhpLlm\LlmChain\Platform\Message\Message;
 use PhpLlm\LlmChain\Platform\Message\MessageBag;
 
@@ -24,9 +24,10 @@
     exit(1);
 }
 
+// Create platform instance for Albert API
 $platform = PlatformFactory::create(
     apiKey: $albertApiKey,
-    baseUrl: rtrim((string) $albertApiUrl, '/').'/v1/',
+    albertUrl: $albertApiUrl,
 );
 
 $model = new GPT('gpt-4o');

src/Platform/Bridge/Albert/PlatformFactory.php

@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PhpLlm\LlmChain\Platform\Bridge\Albert;
+
+use PhpLlm\LlmChain\Platform\Bridge\OpenAI\Platform;
+use Symfony\Component\HttpClient\HttpClient;
+use Symfony\Contracts\HttpClient\HttpClientInterface;
+
+final class PlatformFactory
+{
+    /**
+     * Creates a Platform instance for Albert API.
+     */
+    public static function create(
+        string $apiKey,
+        string $albertUrl,
+        ?HttpClientInterface $httpClient = null,
+    ): Platform {
+        $httpClient ??= HttpClient::create();
+
+        return new Platform(
+            $httpClient,
+            $apiKey,
+            rtrim($albertUrl, '/').'/v1/',
+        );
+    }
+}

tests/Platform/Bridge/Albert/PlatformFactoryTest.php

@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PhpLlm\LlmChain\Tests\Platform\Bridge\Albert;
+
+use PhpLlm\LlmChain\Platform\Bridge\Albert\PlatformFactory;
+use PhpLlm\LlmChain\Platform\Bridge\OpenAI\Platform;
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\Attributes\Small;
+use PHPUnit\Framework\Attributes\Test;
+use PHPUnit\Framework\TestCase;
+
+#[CoversClass(PlatformFactory::class)]
+#[Small]
+final class PlatformFactoryTest extends TestCase
+{
+    #[Test]
+    public function createsPlatformWithCorrectBaseUrl(): void
+    {
+        $platform = PlatformFactory::create('test-key', 'https://albert.example.com');
+
+        self::assertInstanceOf(Platform::class, $platform);
+    }
+
+    #[Test]
+    public function trimsTrailingSlashFromUrl(): void
+    {
+        $platform1 = PlatformFactory::create('test-key', 'https://albert.example.com/');
+        $platform2 = PlatformFactory::create('test-key', 'https://albert.example.com');
+
+        // Both should create the same platform configuration
+        self::assertInstanceOf(Platform::class, $platform1);
+        self::assertInstanceOf(Platform::class, $platform2);
+    }
+}