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// Tokens returns the TokenService client.
69func (c *Client) Tokens() ermiteconnect.TokenServiceClient {
70 return ermiteconnect.NewTokenServiceClient(c.http, c.base, c.opts...)
71}
72
73// Events returns the EventService client.
74func (c *Client) Events() ermiteconnect.EventServiceClient {
75 return ermiteconnect.NewEventServiceClient(c.http, c.base, c.opts...)
76}
77
78// Server returns the ServerService client.
79func (c *Client) Server() ermiteconnect.ServerServiceClient {
80 return ermiteconnect.NewServerServiceClient(c.http, c.base, c.opts...)
81}
82
83// headers sets the credentials and the user agent on every call and bounds the
84// unary ones.
85type headers struct {
86 token string
87 agent string
88 timeout time.Duration
89}
90
91func (h headers) set(hd http.Header) {
92 if h.token != "" {
93 hd.Set("Authorization", "Bearer "+h.token)
94 }
95 if h.agent != "" {
96 hd.Set("User-Agent", h.agent)
97 }
98}
99
100func (h headers) WrapUnary(next connect.UnaryFunc) connect.UnaryFunc {
101 return func(ctx context.Context, req connect.AnyRequest) (connect.AnyResponse, error) {
102 if req.Spec().IsClient {
103 h.set(req.Header())
104 if h.timeout > 0 {
105 var cancel context.CancelFunc
106 ctx, cancel = context.WithTimeout(ctx, h.timeout)
107 defer cancel()
108 }
109 }
110 return next(ctx, req)
111 }
112}
113
114func (h headers) WrapStreamingClient(next connect.StreamingClientFunc) connect.StreamingClientFunc {
115 return func(ctx context.Context, spec connect.Spec) connect.StreamingClientConn {
116 conn := next(ctx, spec)
117 h.set(conn.RequestHeader())
118 return conn
119 }
120}
121
122func (headers) WrapStreamingHandler(next connect.StreamingHandlerFunc) connect.StreamingHandlerFunc {
123 return next
124}