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
|
// Copyright (c) 2022 Tulir Asokan
//
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at http://mozilla.org/MPL/2.0/.
package mautrix
import (
"fmt"
"net/url"
"strconv"
"strings"
)
func ParseAndNormalizeBaseURL(homeserverURL string) (*url.URL, error) {
hsURL, err := url.Parse(homeserverURL)
if err != nil {
return nil, err
}
if hsURL.Scheme == "" {
hsURL.Scheme = "https"
fixedURL := hsURL.String()
hsURL, err = url.Parse(fixedURL)
if err != nil {
return nil, fmt.Errorf("failed to parse fixed URL '%s': %v", fixedURL, err)
}
}
hsURL.RawPath = hsURL.EscapedPath()
return hsURL, nil
}
// BuildURL builds a URL with the given path parts
func BuildURL(baseURL *url.URL, path ...any) *url.URL {
createdURL := *baseURL
rawParts := make([]string, len(path)+1)
rawParts[0] = strings.TrimSuffix(createdURL.RawPath, "/")
parts := make([]string, len(path)+1)
parts[0] = strings.TrimSuffix(createdURL.Path, "/")
for i, part := range path {
switch casted := part.(type) {
case string:
parts[i+1] = casted
case int:
parts[i+1] = strconv.Itoa(casted)
case fmt.Stringer:
parts[i+1] = casted.String()
default:
parts[i+1] = fmt.Sprint(casted)
}
rawParts[i+1] = url.PathEscape(parts[i+1])
}
createdURL.Path = strings.Join(parts, "/")
createdURL.RawPath = strings.Join(rawParts, "/")
return &createdURL
}
// BuildURL builds a URL with the Client's homeserver and appservice user ID set already.
func (cli *Client) BuildURL(urlPath PrefixableURLPath) string {
return cli.BuildURLWithQuery(urlPath, nil)
}
// BuildClientURL builds a URL with the Client's homeserver and appservice user ID set already.
// This method also automatically prepends the client API prefix (/_matrix/client).
func (cli *Client) BuildClientURL(urlPath ...any) string {
return cli.BuildURLWithQuery(ClientURLPath(urlPath), nil)
}
type PrefixableURLPath interface {
FullPath() []any
}
type BaseURLPath []any
func (bup BaseURLPath) FullPath() []any {
return bup
}
type ClientURLPath []any
func (cup ClientURLPath) FullPath() []any {
return append([]any{"_matrix", "client"}, []any(cup)...)
}
type MediaURLPath []any
func (mup MediaURLPath) FullPath() []any {
return append([]any{"_matrix", "media"}, []any(mup)...)
}
type SynapseAdminURLPath []any
func (saup SynapseAdminURLPath) FullPath() []any {
return append([]any{"_synapse", "admin"}, []any(saup)...)
}
// BuildURLWithQuery builds a URL with query parameters in addition to the Client's homeserver
// and appservice user ID set already.
func (cli *Client) BuildURLWithQuery(urlPath PrefixableURLPath, urlQuery map[string]string) string {
hsURL := *BuildURL(cli.HomeserverURL, urlPath.FullPath()...)
query := hsURL.Query()
if cli.SetAppServiceUserID {
query.Set("user_id", string(cli.UserID))
}
if cli.SetAppServiceDeviceID && cli.DeviceID != "" {
query.Set("device_id", string(cli.DeviceID))
query.Set("org.matrix.msc3202.device_id", string(cli.DeviceID))
}
if urlQuery != nil {
for k, v := range urlQuery {
query.Set(k, v)
}
}
hsURL.RawQuery = query.Encode()
return hsURL.String()
}
|
