feat: implement multi-provider architecture for contribution fetching and add Docker support

src/Service/GitHubProvider.php

@@ -11,19 +11,26 @@ use Symfony\Contracts\HttpClient\HttpClientInterface;
  *
  * Required token scopes: read:user
  */
-class GitHubProvider
+class GitHubProvider implements ProviderInterface
 {
     private const GRAPHQL_URL = 'https://api.github.com/graphql';
 
     public function __construct(
         private readonly HttpClientInterface $client,
         private readonly GraphQLApiClientRegistryInterface $registry,
+        private readonly string $username,
+        private readonly string $token,
     ) {}
 
+    public function isConfigured(): bool
+    {
+        return $this->username !== '' && $this->token !== '';
+    }
+
     /**
      * @return array<string, int>  date (Y-m-d) => contribution count
      */
-    public function fetch(string $username, string $token): array
+    public function fetch(): array
     {
         $from = (new \DateTimeImmutable('-365 days'))->format('Y-m-d\T00:00:00\Z');
         $to   = (new \DateTimeImmutable())->format('Y-m-d\T23:59:59\Z');
@@ -32,7 +39,7 @@ class GitHubProvider
         $graphqlClient = $this->registry->get('github');
 
         $query = $graphqlClient->buildQuery(
-            ['user' => ['login' => $username]],
+            ['user' => ['login' => $this->username]],
             [
                 'contributionsCollection' => [
                     '_parameters' => ['from' => $from, 'to' => $to],
@@ -49,7 +56,7 @@ class GitHubProvider
         // transport sends form_params, so we use Symfony HttpClient here instead.
         $response = $this->client->request('POST', self::GRAPHQL_URL, [
             'headers' => [
-                'Authorization' => "Bearer $token",
+                'Authorization' => "Bearer {$this->token}",
                 'Content-Type'  => 'application/json',
             ],
             'json' => ['query' => $query],

src/Service/GitLabProvider.php

@@ -10,26 +10,36 @@ use Symfony\Contracts\HttpClient\HttpClientInterface;
  * Required token scopes: read_user, read_api
  * Works with both gitlab.com and self-hosted instances.
  */
-class GitLabProvider
+class GitLabProvider implements ProviderInterface
 {
-    public function __construct(private readonly HttpClientInterface $client) {}
+    public function __construct(
+        private readonly HttpClientInterface $client,
+        private readonly string $username,
+        private readonly string $token,
+        private readonly string $baseUrl = '',
+    ) {}
+
+    public function isConfigured(): bool
+    {
+        return $this->username !== '' && $this->token !== '';
+    }
 
     /**
      * @return array<string, int>  date (Y-m-d) => event count
      */
-    public function fetch(string $username, string $token, string $baseUrl = 'https://gitlab.com'): array
+    public function fetch(): array
     {
-        $baseUrl = rtrim($baseUrl, '/');
+        $baseUrl = rtrim($this->baseUrl !== '' ? $this->baseUrl : 'https://gitlab.com', '/');
 
         // Resolve numeric user ID from username
         $userResponse = $this->client->request('GET', "$baseUrl/api/v4/users", [
-            'headers' => ['PRIVATE-TOKEN' => $token],
-            'query'   => ['username' => $username],
+            'headers' => ['PRIVATE-TOKEN' => $this->token],
+            'query'   => ['username' => $this->username],
         ]);
 
         $users = $userResponse->toArray();
         if (empty($users)) {
-            throw new \RuntimeException("GitLab: user '$username' not found on $baseUrl");
+            throw new \RuntimeException("GitLab: user '{$this->username}' not found on $baseUrl");
         }
         $userId = $users[0]['id'];
 
@@ -39,7 +49,7 @@ class GitLabProvider
 
         do {
             $response = $this->client->request('GET', "$baseUrl/api/v4/users/$userId/events", [
-                'headers' => ['PRIVATE-TOKEN' => $token],
+                'headers' => ['PRIVATE-TOKEN' => $this->token],
                 'query'   => [
                     'after'    => $after,
                     'per_page' => 100,

src/Service/GiteaProvider.php

@@ -12,18 +12,28 @@ use Symfony\Contracts\HttpClient\HttpClientInterface;
  *
  * Required token scopes: read:user
  */
-class GiteaProvider
+class GiteaProvider implements ProviderInterface
 {
-    public function __construct(private readonly HttpClientInterface $client) {}
+    public function __construct(
+        private readonly HttpClientInterface $client,
+        private readonly string $username,
+        private readonly string $token,
+        private readonly string $baseUrl,
+    ) {}
+
+    public function isConfigured(): bool
+    {
+        return $this->username !== '' && $this->token !== '' && $this->baseUrl !== '';
+    }
 
     /**
      * @return array<string, int>  date (Y-m-d) => contribution count
      */
-    public function fetch(string $username, string $token, string $baseUrl): array
+    public function fetch(): array
     {
-        $baseUrl  = rtrim($baseUrl, '/');
-        $response = $this->client->request('GET', "$baseUrl/api/v1/users/$username/heatmap", [
-            'headers' => ['Authorization' => "token $token"],
+        $baseUrl  = rtrim($this->baseUrl, '/');
+        $response = $this->client->request('GET', "$baseUrl/api/v1/users/{$this->username}/heatmap", [
+            'headers' => ['Authorization' => "token {$this->token}"],
         ]);
 
         $data   = $response->toArray();

src/Service/ProviderInterface.php

@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Service;
+
+interface ProviderInterface
+{
+    /** @return array<string, int>  date (Y-m-d) => contribution count */
+    public function fetch(): array;
+
+    public function isConfigured(): bool;
+}