<?php

/**
 * Minimal Gitea v1 REST client for the hyprcrd gitea plugin.
 *
 * Mirrors the Python `gitea_client.py` shape but only implements the
 * subset needed for MVP: connection test, search/list/get issues, list
 * comments. Write operations (create issue, comment, edit) are deferred
 * to a later iteration — see TODO.md.
 *
 * Authentication is via the standard Gitea token header:
 *   Authorization: token <TOKEN>
 *
 * Errors throw GiteaApiException with status code + body.
 */

class GiteaApiException extends RuntimeException
{
    public int $statusCode;
    public string $body;

    public function __construct(int $statusCode, string $body)
    {
        $this->statusCode = $statusCode;
        $this->body = $body;
        parent::__construct("Gitea API HTTP $statusCode: " . substr($body, 0, 200));
    }
}

class GiteaClient
{
    private string $baseUrl;
    private string $token;
    private int $timeout;

    public function __construct(string $baseUrl, string $token, int $timeout = 20)
    {
        $this->baseUrl = rtrim($baseUrl, '/');
        $this->token = $token;
        $this->timeout = $timeout;
    }

    /**
     * Verify the token works against the configured base URL by hitting
     * /user. Returns the authenticated user dict on success.
     * Throws GiteaApiException on failure.
     */
    public function testConnection(): array
    {
        $resp = $this->request('GET', '/user');
        return is_array($resp) ? $resp : [];
    }

    /**
     * Cross-repo issue search. Mirrors Python search_issues().
     * @param array $opts Any of: state, labels, milestones, q, type,
     *                    since, before, assigned, created, mentioned,
     *                    review_requested, reviewed, owner, team,
     *                    page, limit
     */
    public function searchIssues(array $opts = []): array
    {
        $resp = $this->request('GET', '/repos/issues/search', $opts);
        return is_array($resp) ? $resp : [];
    }

    public function listRepoIssues(string $owner, string $repo, array $opts = []): array
    {
        $path = '/repos/' . rawurlencode($owner) . '/' . rawurlencode($repo) . '/issues';
        $resp = $this->request('GET', $path, $opts);
        return is_array($resp) ? $resp : [];
    }

    public function getIssue(string $owner, string $repo, int $index): array
    {
        $path = '/repos/' . rawurlencode($owner) . '/' . rawurlencode($repo) . '/issues/' . $index;
        $resp = $this->request('GET', $path);
        return is_array($resp) ? $resp : [];
    }

    public function listIssueComments(string $owner, string $repo, int $index, array $opts = []): array
    {
        $path = '/repos/' . rawurlencode($owner) . '/' . rawurlencode($repo) . '/issues/' . $index . '/comments';
        $resp = $this->request('GET', $path, $opts);
        return is_array($resp) ? $resp : [];
    }

    // ── Low-level request ─────────────────────────────────────────

    private function request(string $method, string $path, array $query = [], ?array $payload = null)
    {
        $url = $this->baseUrl . '/api/v1' . $path;
        $cleanQuery = [];
        foreach ($query as $k => $v) {
            if ($v === null || $v === '') continue;
            if (is_bool($v)) $v = $v ? 'true' : 'false';
            $cleanQuery[$k] = $v;
        }
        if ($cleanQuery) {
            $url .= '?' . http_build_query($cleanQuery);
        }

        $ch = curl_init($url);
        $headers = [
            'Accept: application/json',
            'Authorization: token ' . $this->token,
            'User-Agent: hyprcrd-gitea-plugin/1.0',
        ];
        $opts = [
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_FOLLOWLOCATION => true,
            CURLOPT_TIMEOUT => $this->timeout,
            CURLOPT_CUSTOMREQUEST => $method,
            CURLOPT_SSL_VERIFYPEER => true,
            CURLOPT_SSL_VERIFYHOST => 2,
        ];
        if ($payload !== null) {
            $headers[] = 'Content-Type: application/json';
            $opts[CURLOPT_POSTFIELDS] = json_encode($payload);
        }
        $opts[CURLOPT_HTTPHEADER] = $headers;
        curl_setopt_array($ch, $opts);

        $body = curl_exec($ch);
        if ($body === false) {
            $err = curl_error($ch);
            curl_close($ch);
            throw new RuntimeException("Could not reach Gitea: $err");
        }
        $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        $contentType = curl_getinfo($ch, CURLINFO_CONTENT_TYPE) ?? '';
        curl_close($ch);

        if ($status >= 400) {
            throw new GiteaApiException((int)$status, (string)$body);
        }

        if ($body === '' || $body === null) return null;
        if (stripos($contentType, 'application/json') !== false || preg_match('/^\s*[\[\{]/', (string)$body)) {
            $decoded = json_decode((string)$body, true);
            return $decoded;
        }
        return $body;
    }
}