haylan
4ff45b7c46
Bound each provider's startFetch()/resolveFetch() to an optional since/until window, wire a SQLite-backed ContributionStore into ContributionAggregator (fetch only the trailing window past the last stored date, merge into the store, prune by CONTRIBUTIONS_RETENTION_DAYS), and add a graph:contributions:refetch command to force a full or ranged re-fetch in <=365-day chunks. This is the root fix for the full 365-day-refetch timeout that used to hit on every cache miss.
106 lines
3.3 KiB
PHP
106 lines
3.3 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace GitContributionGraph\Service\Provider;
|
|
|
|
use Psr\Log\LoggerInterface;
|
|
use Symfony\Contracts\HttpClient\HttpClientInterface;
|
|
use Symfony\Contracts\HttpClient\ResponseInterface;
|
|
|
|
/**
|
|
* Fetches contribution data from the Gitea heatmap endpoint.
|
|
*
|
|
* Endpoint: GET /api/v1/users/{username}/heatmap
|
|
* Returns: [{"timestamp": 1234567890, "contributions": 3}, ...]
|
|
*
|
|
* Required token scopes: read:user
|
|
*/
|
|
final class GiteaProvider implements ProviderInterface
|
|
{
|
|
use ProbeTrait;
|
|
|
|
private readonly string $baseUrl;
|
|
|
|
public function __construct(
|
|
private readonly HttpClientInterface $client,
|
|
private readonly string $username,
|
|
private readonly string $token,
|
|
string $baseUrl,
|
|
private readonly LoggerInterface $logger,
|
|
) {
|
|
$this->baseUrl = rtrim($baseUrl, '/');
|
|
}
|
|
|
|
public function getName(): string
|
|
{
|
|
return 'gitea';
|
|
}
|
|
|
|
public function isConfigured(): bool
|
|
{
|
|
return $this->username !== '' && $this->token !== '' && $this->baseUrl !== '';
|
|
}
|
|
|
|
public function ping(): void
|
|
{
|
|
|
|
|
|
$this->client->request('GET', "$this->baseUrl/api/v1/user", [
|
|
'headers' => ['Authorization' => "token {$this->token}"],
|
|
])->getContent();
|
|
}
|
|
|
|
/**
|
|
* Fires a single heatmap request; $since/$until are carried through unused for client-side filtering in resolveFetch().
|
|
*
|
|
* @return array{response: ResponseInterface, since: ?\DateTimeImmutable, until: ?\DateTimeImmutable}
|
|
*/
|
|
public function startFetch(?\DateTimeImmutable $since = null, ?\DateTimeImmutable $until = null): array
|
|
{
|
|
$this->logger->debug('GiteaProvider: fetching contributions', ['user' => $this->username, 'url' => $this->baseUrl]);
|
|
|
|
$response = $this->client->request('GET', "$this->baseUrl/api/v1/users/{$this->username}/heatmap", [
|
|
'headers' => ['Authorization' => "token {$this->token}"],
|
|
]);
|
|
|
|
return ['response' => $response, 'since' => $since, 'until' => $until];
|
|
}
|
|
|
|
/**
|
|
* Filters the heatmap entries to the [$since, $until] window and sums contributions per day.
|
|
*
|
|
* @param array{response: ResponseInterface, since: ?\DateTimeImmutable, until: ?\DateTimeImmutable} $handle
|
|
* @return array<string, int> date (Y-m-d) => contribution count
|
|
*/
|
|
public function resolveFetch(mixed $handle): array
|
|
{
|
|
['response' => $response, 'since' => $since, 'until' => $until] = $handle;
|
|
|
|
/** @var ResponseInterface $response */
|
|
$data = $response->toArray();
|
|
$cutoff = ($since ?? new \DateTimeImmutable('-365 days'))->getTimestamp();
|
|
$ceiling = $until?->getTimestamp();
|
|
$result = [];
|
|
|
|
foreach ($data as $entry) {
|
|
if ($entry['timestamp'] < $cutoff) {
|
|
continue;
|
|
}
|
|
if ($ceiling !== null && $entry['timestamp'] > $ceiling) {
|
|
continue;
|
|
}
|
|
$date = date('Y-m-d', $entry['timestamp']);
|
|
$result[$date] = ($result[$date] ?? 0) + (int) $entry['contributions'];
|
|
}
|
|
|
|
$this->logger->info('GiteaProvider: fetched contributions', [
|
|
'user' => $this->username,
|
|
'days' => count($result),
|
|
'total' => array_sum($result),
|
|
]);
|
|
|
|
return $result;
|
|
}
|
|
}
|