1// SPDX-License-Identifier: AGPL-3.0-or-later
2
3package client
4
5import (
6 "context"
7 "fmt"
8 "net"
9 "net/http"
10 "time"
11
12 "connectrpc.com/connect"
13
14 "bnema.dev/ermite-api/gen/ermite/ermiteconnect"
15)
16
17// Client gives access to the services of one ermite server. Every call carries
18// the bearer token and the user agent; unary calls are bounded by the timeout.
19// It is safe for concurrent use.
20type Client struct {
21 cfg Config
22 base string
23 http *http.Client
24 opts []connect.ClientOption
25}
26
27// New builds a Client from a validated configuration.
28func New(cfg Config) (*Client, error) {
29 u, err := ParseURL(cfg.URL)
30 if err != nil {
31 return nil, fmt.Errorf("%s: %w", EnvURL, err)
32 }
33 if cfg.Timeout <= 0 {
34 cfg.Timeout = DefaultTimeout
35 }
36 cfg.URL = u.String()
37 hc := &http.Client{
38 Transport: transport(),
39 // A redirect would replay a request elsewhere: report it instead.
40 CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse },
41 }
42 return &Client{
43 cfg: cfg,
44 base: u.JoinPath(APIPath).String(),
45 http: hc,
46 opts: []connect.ClientOption{connect.WithInterceptors(headers{token: cfg.Token, agent: cfg.UserAgent, timeout: cfg.Timeout})},
47 }, nil
48}
49
50// transport bounds connection setup but not the exchange, which may be a
51// long-lived stream. HTTP/2 pings detect a connection that died silently.
52func transport() *http.Transport {
53 t := http.DefaultTransport.(*http.Transport).Clone()
54 t.DialContext = (&net.Dialer{Timeout: 10 * time.Second, KeepAlive: 30 * time.Second}).DialContext
55 t.TLSHandshakeTimeout = 10 * time.Second
56 t.HTTP2 = &http.HTTP2Config{SendPingTimeout: 30 * time.Second, PingTimeout: 15 * time.Second}
57 return t
58}
59
60// URL is the server address the client talks to.
61func (c *Client) URL() string { return c.cfg.URL }
62
63// Repos returns the RepoService client.
64func (c *Client) Repos() ermiteconnect.RepoServiceClient {
65 return ermiteconnect.NewRepoServiceClient(c.http, c.base, c.opts...)
66}
67
68// Runs returns the RunService client.
69func (c *Client) Runs() ermiteconnect.RunServiceClient {
70 return ermiteconnect.NewRunServiceClient(c.http, c.base, c.opts...)
71}
72
73// Artifacts returns the ArtifactService client.
74func (c *Client) Artifacts() ermiteconnect.ArtifactServiceClient {
75 return ermiteconnect.NewArtifactServiceClient(c.http, c.base, c.opts...)
76}
77
78// Tokens returns the TokenService client.
79func (c *Client) Tokens() ermiteconnect.TokenServiceClient {
80 return ermiteconnect.NewTokenServiceClient(c.http, c.base, c.opts...)
81}
82
83// Sessions returns the SessionService client.
84func (c *Client) Sessions() ermiteconnect.SessionServiceClient {
85 return ermiteconnect.NewSessionServiceClient(c.http, c.base, c.opts...)
86}
87
88// Events returns the EventService client.
89func (c *Client) Events() ermiteconnect.EventServiceClient {
90 return ermiteconnect.NewEventServiceClient(c.http, c.base, c.opts...)
91}
92
93// MergeRequests returns the MergeRequestService client.
94func (c *Client) MergeRequests() ermiteconnect.MergeRequestServiceClient {
95 return ermiteconnect.NewMergeRequestServiceClient(c.http, c.base, c.opts...)
96}
97
98// Issues returns the IssueService client.
99func (c *Client) Issues() ermiteconnect.IssueServiceClient {
100 return ermiteconnect.NewIssueServiceClient(c.http, c.base, c.opts...)
101}
102
103// Secrets returns the SecretService client.
104func (c *Client) Secrets() ermiteconnect.SecretServiceClient {
105 return ermiteconnect.NewSecretServiceClient(c.http, c.base, c.opts...)
106}
107
108// Variables returns the VariableService client.
109func (c *Client) Variables() ermiteconnect.VariableServiceClient {
110 return ermiteconnect.NewVariableServiceClient(c.http, c.base, c.opts...)
111}
112
113// Environments returns the EnvironmentService client.
114func (c *Client) Environments() ermiteconnect.EnvironmentServiceClient {
115 return ermiteconnect.NewEnvironmentServiceClient(c.http, c.base, c.opts...)
116}
117
118// TrustedKeys returns the TrustedKeyService client.
119func (c *Client) TrustedKeys() ermiteconnect.TrustedKeyServiceClient {
120 return ermiteconnect.NewTrustedKeyServiceClient(c.http, c.base, c.opts...)
121}
122
123// Server returns the ServerService client.
124func (c *Client) Server() ermiteconnect.ServerServiceClient {
125 return ermiteconnect.NewServerServiceClient(c.http, c.base, c.opts...)
126}
127
128// headers sets the credentials and the user agent on every call and bounds the
129// unary ones.
130type headers struct {
131 token string
132 agent string
133 timeout time.Duration
134}
135
136func (h headers) set(hd http.Header) {
137 if h.token != "" {
138 hd.Set("Authorization", "Bearer "+h.token)
139 }
140 if h.agent != "" {
141 hd.Set("User-Agent", h.agent)
142 }
143}
144
145func (h headers) WrapUnary(next connect.UnaryFunc) connect.UnaryFunc {
146 return func(ctx context.Context, req connect.AnyRequest) (connect.AnyResponse, error) {
147 if req.Spec().IsClient {
148 h.set(req.Header())
149 if h.timeout > 0 {
150 var cancel context.CancelFunc
151 ctx, cancel = context.WithTimeout(ctx, h.timeout)
152 defer cancel()
153 }
154 }
155 return next(ctx, req)
156 }
157}
158
159func (h headers) WrapStreamingClient(next connect.StreamingClientFunc) connect.StreamingClientFunc {
160 return func(ctx context.Context, spec connect.Spec) connect.StreamingClientConn {
161 conn := next(ctx, spec)
162 h.set(conn.RequestHeader())
163 return conn
164 }
165}
166
167func (headers) WrapStreamingHandler(next connect.StreamingHandlerFunc) connect.StreamingHandlerFunc {
168 return next
169}