trusty-common 0.19.0

Shared utilities and provider-agnostic streaming chat (ChatProvider, OllamaProvider, OpenRouter, tool-use) for trusty-* projects
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

//! GitHub backend — HTTP client methods.
//!
//! Why: Separates the low-level HTTP transport from the high-level Backend
//! trait impl so each file stays under the 500-SLOC cap.
//! What: Provides `GitHubBackend` constructor and the private REST/GraphQL
//! helper methods used by the Backend impl.
//! Test: exercised transitively by all Backend impl methods.

use anyhow::{Context, Result, anyhow, bail};
use reqwest::Client;
use serde_json::{Value, json};

use crate::tickets::api::config::GithubConfig;

use super::types::{GRAPHQL_URL, GitHubBackend, REST_BASE, USER_AGENT, ensure_ok};

impl GitHubBackend {
    /// Why: Caller has validated config; we just wire up the client.
    /// What: Constructs from `GithubConfig` after env-var fallback applied.
    /// Test: covered by `client.rs` construction tests.
    pub fn new(cfg: GithubConfig) -> Result<Self> {
        let token = cfg
            .token
            .ok_or_else(|| anyhow!("github: missing token (set GITHUB_TOKEN)"))?;
        let owner = cfg
            .owner
            .ok_or_else(|| anyhow!("github: missing owner (set GITHUB_OWNER)"))?;
        let repo = cfg
            .repo
            .ok_or_else(|| anyhow!("github: missing repo (set GITHUB_REPO)"))?;
        let http = Client::builder()
            .user_agent(USER_AGENT)
            .build()
            .context("build github http client")?;
        Ok(Self {
            token,
            owner,
            repo,
            http,
        })
    }

    pub(super) fn rest_url(&self, path: &str) -> String {
        format!("{REST_BASE}{path}")
    }

    pub(super) async fn rest_get(&self, path: &str) -> Result<Value> {
        let resp = self
            .http
            .get(self.rest_url(path))
            .bearer_auth(&self.token)
            .header("Accept", "application/vnd.github+json")
            .header("X-GitHub-Api-Version", "2022-11-28")
            .send()
            .await
            .with_context(|| format!("GET {path}"))?;
        ensure_ok(resp).await
    }

    pub(super) async fn rest_post(&self, path: &str, body: Value) -> Result<Value> {
        let resp = self
            .http
            .post(self.rest_url(path))
            .bearer_auth(&self.token)
            .header("Accept", "application/vnd.github+json")
            .header("X-GitHub-Api-Version", "2022-11-28")
            .json(&body)
            .send()
            .await
            .with_context(|| format!("POST {path}"))?;
        ensure_ok(resp).await
    }

    pub(super) async fn rest_patch(&self, path: &str, body: Value) -> Result<Value> {
        let resp = self
            .http
            .patch(self.rest_url(path))
            .bearer_auth(&self.token)
            .header("Accept", "application/vnd.github+json")
            .header("X-GitHub-Api-Version", "2022-11-28")
            .json(&body)
            .send()
            .await
            .with_context(|| format!("PATCH {path}"))?;
        ensure_ok(resp).await
    }

    pub(super) async fn rest_delete(&self, path: &str) -> Result<()> {
        let resp = self
            .http
            .delete(self.rest_url(path))
            .bearer_auth(&self.token)
            .header("Accept", "application/vnd.github+json")
            .header("X-GitHub-Api-Version", "2022-11-28")
            .send()
            .await
            .with_context(|| format!("DELETE {path}"))?;
        if !resp.status().is_success() {
            let status = resp.status();
            let text = resp.text().await.unwrap_or_default();
            bail!("github DELETE failed: {status}: {text}");
        }
        Ok(())
    }

    pub(super) async fn graphql(&self, query: &str, variables: Value) -> Result<Value> {
        let resp = self
            .http
            .post(GRAPHQL_URL)
            .bearer_auth(&self.token)
            .header("Accept", "application/vnd.github+json")
            .json(&json!({ "query": query, "variables": variables }))
            .send()
            .await
            .context("github graphql")?;
        let v = ensure_ok(resp).await?;
        if let Some(errors) = v.get("errors") {
            bail!("github graphql errors: {errors}");
        }
        Ok(v)
    }

    pub(super) fn issue_path(&self, number: &str) -> String {
        format!("/repos/{}/{}/issues/{number}", self.owner, self.repo)
    }
}