1// SPDX-License-Identifier: AGPL-3.0-or-later
2
3// Package web is the HTML front of ermite: the pages of the read-only
4// showcase, rendered with templ from the data of the use cases.
5//
6// Like every other inbound adapter, the package reads and writes through the
7// use case interfaces of package ports (ADR 0024), never through the API. The
8// caller of every use case call is passed explicitly: the principal of the
9// request, which is anonymous unless the request carries a valid owner session
10// (ServeHTTP sets it in the context, principal reads it). The use cases then
11// show public repositories only to an anonymous caller; a private repository
12// is indistinguishable from a missing one (domain.ErrNotFound), here as
13// everywhere.
14//
15// Adding a page: a handler on Server, a route in routes, a templ page in
16// pages.templ and its view model in view.go.
17package web
18
19import (
20 "bytes"
21 "context"
22 "crypto/rand"
23 "encoding/hex"
24 "errors"
25 "fmt"
26 "net/http"
27 "net/netip"
28 "net/url"
29 "strings"
30 "time"
31
32 "github.com/a-h/templ"
33 "github.com/bnema/zerowrap"
34
35 "bnema.dev/ermite/internal/domain"
36 "bnema.dev/ermite/internal/ports"
37)
38
39// Patterns are the ServeMux patterns the handler serves: everything. The
40// router of the package answers the paths it does not know with its 404
41// page, and the more specific patterns of the server (health, API, Git) win
42// over this one.
43var Patterns = []string{"/"}
44
45// requestTimeout bounds the use case calls that build one page.
46const requestTimeout = 30 * time.Second
47
48// Config configures a Server.
49type Config struct {
50 // Mirrors answers the push mirror badge shown to repository admins. Without it there is
51 // no badge. Leave it unset rather than assigning a typed nil pointer.
52 Mirrors ports.MirrorWarner
53 // Repos and Browse are the use cases the pages are built from.
54 Repos ports.RepoService
55 Browse ports.BrowseService
56 // MergeRequests serves the merge request pages (ADR 0017). Without it
57 // there are no such pages, nor section for them. Leave it unset rather
58 // than assigning a typed nil pointer.
59 MergeRequests ports.MergeRequestService
60 // Issues serves the issue pages (ADR 0031). Without it there are no such
61 // pages, nor tab for them. Leave it unset rather than assigning a typed
62 // nil pointer.
63 Issues ports.IssueService
64 // IssueNumbers tells whether a number names an issue or a merge request,
65 // so that the page of the wrong kind redirects to the right one. Without
66 // it there is no such redirect. Leave it unset rather than assigning a
67 // typed nil pointer.
68 IssueNumbers ports.IssueNumberResolver
69 // IssueForm serves the public issue form of repositories whose issues
70 // mode is public (GET and POST /<repo>/issues/new for a visitor). Without
71 // it there is no such form. Leave it unset rather than assigning a typed
72 // nil pointer.
73 IssueForm ports.IssueSubmissionService
74 // Moderation serves the Approve, Reject and Reject-and-ban buttons of the
75 // pending issues in the inbox. It needs Inbox. Without it there are no
76 // such routes. Leave it unset rather than assigning a typed nil pointer.
77 Moderation ports.IssueModerationService
78 // Inbox serves the owner's inbox page (/-/inbox) and the button that
79 // leads to it. Without it there is neither. Leave it unset rather than
80 // assigning a typed nil pointer.
81 Inbox ports.InboxService
82 // SigningKey tells the key that signs the squash and merge commits, shown
83 // in the merge box. Without it the box does not name the key. Leave it
84 // unset rather than assigning a typed nil pointer.
85 SigningKey ports.SigningKeyService
86 // Runs serves the CI pages (/<repo>/actions) and the checks shown next to
87 // commits and merge requests. Without it there are no such pages. Leave it
88 // unset rather than assigning a typed nil pointer.
89 Runs ports.RunService
90 // Artifacts serves the artifacts of the runs: a section of the run page,
91 // their download and their deletion. It needs Runs. Without it there is
92 // neither. Leave it unset rather than assigning a typed nil pointer.
93 Artifacts ports.ArtifactService
94 // Events is the source of the event stream behind /-/events. Without
95 // it the pages are not live and the route answers 404. Leave it unset
96 // rather than assigning a typed nil pointer.
97 Events ports.EventService
98 // Heartbeat is how often an idle event stream gets a comment line;
99 // DefaultHeartbeat when zero.
100 Heartbeat time.Duration
101 // Owner is the owner login the GitHub-shaped URLs of CI show
102 // (<server>/<owner>/<repo>/...). A GET or HEAD of /<owner>/<rest> is
103 // redirected to /<rest> unless a repository named like the owner is
104 // visible to the caller. Empty: no redirect.
105 Owner string
106 // PublicURL is the base URL of the instance, without a trailing slash:
107 // the clone URLs are built on it, and its host is the instance name.
108 PublicURL string
109 // SourceURL is the link to the source of the running version (AGPL §13).
110 SourceURL string
111 // Version is the version of the running server.
112 Version string
113 // Now is the clock of relative dates; time.Now when nil.
114 Now func() time.Time
115 // Sessions signs the owner in (ADR 0018). Without it there are no login
116 // routes and every visitor is anonymous.
117 Sessions ports.WebSessionService
118 // Passkeys signs the owner in with a passkey and manages the passkeys
119 // (ADR 0026). Without it, or without Sessions, there are no passkey
120 // routes and no link to them. Leave it unset rather than assigning a typed
121 // nil pointer.
122 Passkeys ports.WebPasskeyService
123 // Limiter counts the failed logins; required with Sessions. Share it with
124 // the API and Git, so that a client has one budget of failures.
125 Limiter ports.FailureLimiter
126 // TrustedProxies are the networks allowed to set X-Forwarded-For, to find
127 // the address of the client that fails a login.
128 TrustedProxies []netip.Prefix
129}
130
131// Server serves the pages. It is an http.Handler.
132type Server struct {
133 cfg Config
134 instance string
135 origin string // scheme://host of the public URL, what a POST must come from
136 assets *assetSet
137 md *markdown
138 // pathCache holds the path lists the file finder fetches.
139 pathCache *pathCache
140 // hl holds the colours of highlighted diffs.
141 hl *hlCache
142 mux *http.ServeMux
143 // ownerRepo is the owner login as a repository name, zero when it is not
144 // a valid one (then no repository can be named like the owner).
145 ownerRepo domain.RepoName
146 // refsFan shares the fragments of the refs page between the watchers of
147 // a push; entries are few and short-lived.
148 refsFan fanout
149 // pulses holds the activity curves of the home rows.
150 pulses pulseCache
151}
152
153// New builds the web handler.
154func New(cfg Config) (*Server, error) {
155 if cfg.Repos == nil || cfg.Browse == nil {
156 return nil, errors.New("web: the repository and browse use cases are required")
157 }
158 u, err := url.Parse(cfg.PublicURL)
159 if err != nil || u.Host == "" {
160 return nil, fmt.Errorf("web: public URL %q is not a valid base URL", cfg.PublicURL)
161 }
162 if cfg.Now == nil {
163 cfg.Now = time.Now
164 }
165 assets, err := loadAssets()
166 if err != nil {
167 return nil, fmt.Errorf("web: load assets: %w", err)
168 }
169 if cfg.Sessions != nil && cfg.Limiter == nil {
170 return nil, errors.New("web: sessions need a failure limiter")
171 }
172 s := &Server{
173 cfg: cfg, instance: u.Host, assets: assets, md: newMarkdown(),
174 pathCache: newPathCache(pathCacheBytes, pathBuilds),
175 hl: newHLCache(hlCacheBytes),
176 origin: originOf(u),
177 }
178 s.ownerRepo, _ = domain.ParseRepoName(cfg.Owner)
179 s.mux = s.routes()
180 return s, nil
181}
182
183// routes is the router of the web. Any path that is not a page is the 404
184// page.
185func (s *Server) routes() *http.ServeMux {
186 mux := http.NewServeMux()
187 mux.HandleFunc("GET "+StaticPrefix, s.assets.serve)
188 mux.HandleFunc("GET /-/events", s.events)
189 mux.HandleFunc("GET "+ServiceWorkerPath, s.assets.sw.serve)
190 if s.cfg.Sessions != nil {
191 mux.HandleFunc("GET "+loginPrefix+"{nonce}", s.loginConfirm)
192 mux.HandleFunc("POST "+loginPrefix+"{nonce}", s.loginPost)
193 mux.HandleFunc("POST /-/logout", s.logout)
194 }
195 if s.passkeysOn() {
196 s.passkeyRoutes(mux)
197 }
198 if s.cfg.Inbox != nil {
199 mux.HandleFunc("GET "+inboxPath, s.page(s.inbox))
200 if s.cfg.Moderation != nil {
201 mux.HandleFunc("POST "+inboxPath+"/pending/{repo}/{id}/approve", s.mrAction(s.pendingApprove))
202 mux.HandleFunc("POST "+inboxPath+"/pending/{repo}/{id}/reject", s.mrAction(s.pendingReject(false)))
203 mux.HandleFunc("POST "+inboxPath+"/pending/{repo}/{id}/ban", s.mrAction(s.pendingReject(true)))
204 }
205 }
206 mux.HandleFunc("GET /{$}", s.page(s.home))
207 mux.HandleFunc("GET /{repo}", s.page(s.summary))
208 mux.HandleFunc("GET /{repo}/{$}", s.page(s.summary))
209 mux.HandleFunc("GET /{repo}/refs", s.page(s.refs))
210 mux.HandleFunc("GET /{repo}/commits", s.page(s.commits))
211 mux.HandleFunc("GET /{repo}/commits/{rest...}", s.page(s.commits))
212 mux.HandleFunc("GET /{repo}/commit/{sha}", s.page(s.commit))
213 mux.HandleFunc("GET /{repo}/commit/{sha}/files", s.page(s.commitFiles))
214 mux.HandleFunc("GET /{repo}/tree", s.page(s.tree))
215 mux.HandleFunc("GET /{repo}/tree/{rest...}", s.page(s.tree))
216 mux.HandleFunc("GET /{repo}/blob/{rest...}", s.page(s.blob))
217 mux.HandleFunc("GET /{repo}/raw/{rest...}", s.raw)
218 mux.HandleFunc("GET /{repo}/paths/{sha}", s.paths)
219 mux.HandleFunc("GET /{repo}/context/{sha}", s.page(s.diffContext))
220 if s.cfg.MergeRequests != nil {
221 mux.HandleFunc("GET /{repo}/merge-requests", s.page(s.mrList))
222 mux.HandleFunc("GET /{repo}/merge-requests/{$}", s.page(s.mrList))
223 mux.HandleFunc("GET /{repo}/merge-requests/{n}", s.pageOrRedirect(s.mrShow, s.mrToIssue))
224 mux.HandleFunc("GET /{repo}/merge-requests/{n}/since", s.page(s.mrSince))
225 mux.HandleFunc("GET /{repo}/merge-requests/{n}/files", s.page(s.mrFiles))
226 mux.HandleFunc("GET /{repo}/compare/{rest...}", s.page(s.compare))
227 // The writes: POST only, behind the gate (ServeHTTP).
228 mux.HandleFunc("POST /{repo}/merge-requests", s.mrAction(s.mrCreate))
229 mux.HandleFunc("POST /{repo}/merge-requests/{n}/comments", s.mrAction(s.mrComment))
230 mux.HandleFunc("POST /{repo}/merge-requests/{n}/comments/{id}/resolve", s.mrAction(s.mrResolve))
231 mux.HandleFunc("POST /{repo}/merge-requests/{n}/comments/{id}/edit", s.mrAction(s.mrEditComment))
232 mux.HandleFunc("POST /{repo}/merge-requests/{n}/comments/{id}/delete", s.mrAction(s.mrDeleteComment))
233 mux.HandleFunc("POST /{repo}/merge-requests/{n}/merge", s.mrAction(s.mrMerge))
234 mux.HandleFunc("POST /{repo}/merge-requests/{n}/auto-merge", s.mrAction(s.mrAutoMerge))
235 mux.HandleFunc("POST /{repo}/merge-requests/{n}/auto-merge/cancel", s.mrAction(s.mrCancelAutoMerge))
236 mux.HandleFunc("POST /{repo}/merge-requests/{n}/close", s.mrAction(s.mrClose))
237 mux.HandleFunc("POST /{repo}/merge-requests/{n}/ready", s.mrAction(s.mrReady))
238 mux.HandleFunc("POST /{repo}/merge-requests/{n}/read", s.mrAction(s.mrRead))
239 }
240 if s.cfg.Issues != nil {
241 mux.HandleFunc("GET /{repo}/issues", s.page(s.issueList))
242 mux.HandleFunc("GET /{repo}/issues/{$}", s.page(s.issueList))
243 mux.HandleFunc("GET /{repo}/issues/new", s.issueNewRoute)
244 mux.HandleFunc("GET /{repo}/issues/{n}", s.pageOrRedirect(s.issueShow, s.issueToMR))
245 // The writes: POST only, behind the gate (ServeHTTP).
246 mux.HandleFunc("POST /{repo}/issues", s.issueAction(s.issueCreate))
247 mux.HandleFunc("POST /{repo}/issues/{n}/comments", s.issueAction(s.issueComment))
248 mux.HandleFunc("POST /{repo}/issues/{n}/close", s.issueAction(s.issueClose))
249 mux.HandleFunc("POST /{repo}/issues/{n}/reopen", s.issueAction(s.issueReopen))
250 }
251 if s.cfg.IssueForm != nil {
252 mux.HandleFunc("GET /{repo}/issues/submitted", s.issueSubmittedPage)
253 mux.HandleFunc("POST /{repo}/issues/new", s.issueFormPost)
254 }
255 if s.cfg.Runs != nil {
256 mux.HandleFunc("GET /{repo}/actions", s.page(s.actions))
257 mux.HandleFunc("GET /{repo}/actions/{$}", s.page(s.actions))
258 mux.HandleFunc("GET /{repo}/actions/runs/{id}", s.page(s.run))
259 mux.HandleFunc("GET /{repo}/actions/runs/{id}/job/{job}", s.page(s.job))
260 mux.HandleFunc("GET /{repo}/actions/runs/{id}/job/{job}/raw", s.rawLog)
261 mux.HandleFunc("GET /{repo}/actions/runs/{id}/job/{job}/stream", s.logStream)
262 mux.HandleFunc("POST /{repo}/actions/runs/{id}/cancel", s.ciAction(s.runCancel))
263 mux.HandleFunc("POST /{repo}/actions/runs/{id}/rerun", s.ciAction(s.runRerun(false)))
264 mux.HandleFunc("POST /{repo}/actions/runs/{id}/rerun-failed", s.ciAction(s.runRerun(true)))
265 if s.cfg.Artifacts != nil {
266 mux.HandleFunc("GET /{repo}/actions/runs/{id}/artifacts/{artifact}", s.artifactDownload)
267 mux.HandleFunc("POST /{repo}/actions/runs/{id}/artifacts/{artifact}/delete", s.ciAction(s.artifactDelete))
268 }
269 }
270 mux.HandleFunc(catchAll, s.page(s.notFound))
271 return mux
272}
273
274// ServeHTTP implements http.Handler.
275func (s *Server) ServeHTTP(w http.ResponseWriter, r *http.Request) {
276 // Whatever the context carried, the caller is anonymous until a valid
277 // session says otherwise (withSession).
278 r = r.WithContext(domain.ContextWithPrincipal(r.Context(), domain.Anonymous()))
279 r = s.withSession(w, r)
280 if !s.gate(w, r) {
281 return
282 }
283 if to, ok := s.ownerRedirect(r); ok {
284 http.Redirect(w, r, to, http.StatusPermanentRedirect)
285 return
286 }
287 s.mux.ServeHTTP(w, r)
288}
289
290// catchAll is the pattern of the paths that are no page.
291const catchAll = "GET /{repo}/{rest...}"
292
293// ownerRedirect maps /<owner>/<repo>[.git][/rest] to /<repo>[.git][/rest]: the
294// URLs that the github context of CI shows (html_url, commit and compare
295// URLs, clone_url) have the owner of the instance in front, like GitHub's.
296//
297// The rule is by repository, not by route: when no repository named like the
298// owner is visible to the caller, every GET or HEAD of /<owner>/<rest> is
299// redirected, so /<owner>/actions reaches the repository named "actions". A
300// repository named like the owner keeps its own pages. A private one is seen
301// as missing by an anonymous caller (the use case answers ErrNotFound), so the
302// redirect is the same as for a name nobody has and tells nothing.
303//
304// The target is built from a segment that parses as a repository name, which
305// has no slash, backslash, percent sign or dot-dot: it can only be a path on
306// this origin, never a "//host" one.
307func (s *Server) ownerRedirect(r *http.Request) (string, bool) {
308 if s.cfg.Owner == "" || (r.Method != http.MethodGet && r.Method != http.MethodHead) {
309 return "", false
310 }
311 first, rest, ok := strings.Cut(strings.TrimPrefix(r.URL.EscapedPath(), "/"), "/")
312 if !ok || !domain.OwnerMatches(s.cfg.Owner, first) || rest == "" {
313 return "", false
314 }
315 repo, _, _ := strings.Cut(rest, "/")
316 if _, err := domain.ParseRepoPath(repo); err != nil {
317 return "", false
318 }
319 if s.ownerNamesARepo(r) {
320 return "", false
321 }
322 to := "/" + rest
323 if r.URL.RawQuery != "" {
324 to += "?" + r.URL.RawQuery
325 }
326 return to, true
327}
328
329// ownerNamesARepo tells whether the caller can see a repository named like
330// the owner. A lookup that fails otherwise counts as yes: the request is then
331// served as it was before, without a redirect.
332func (s *Server) ownerNamesARepo(r *http.Request) bool {
333 if s.ownerRepo.IsZero() {
334 return false // the owner login is not a repository name
335 }
336 ctx := r.Context()
337 _, err := s.cfg.Repos.Get(ctx, principal(ctx), s.ownerRepo)
338 switch {
339 case err == nil:
340 return true
341 case errors.Is(err, domain.ErrNotFound):
342 return false
343 }
344 log := zerowrap.FromCtx(ctx)
345 log.Debug().Err(err).Msg("owner redirect: the lookup of the repository named like the owner failed")
346 return true
347}
348
349// handler builds a page. It returns the component and its status, or an
350// error, which becomes the 404 or 500 page.
351type handler func(ctx context.Context, r *http.Request) (templ.Component, int, error)
352
353// page adapts a handler: it bounds the use case calls, renders the component into
354// a buffer (so that a failure never leaves half a page), and maps errors to
355// the state pages.
356func (s *Server) page(h handler) http.HandlerFunc {
357 return func(w http.ResponseWriter, r *http.Request) {
358 ctx, cancel := context.WithTimeout(r.Context(), requestTimeout)
359 defer cancel()
360 c, status, err := h(ctx, r)
361 if err != nil {
362 s.fail(ctx, w, r, err)
363 return
364 }
365 s.write(ctx, w, r, status, c)
366 }
367}
368
369// write renders c with the given status.
370func (s *Server) write(ctx context.Context, w http.ResponseWriter, r *http.Request, status int, c templ.Component) {
371 var buf bytes.Buffer
372 if err := c.Render(ctx, &buf); err != nil {
373 // The error page itself failed: a bare answer is all that is left.
374 log := zerowrap.FromCtx(ctx)
375 log.Error().Err(err).Str("path", logPath(r.URL.Path)).Msg("render page")
376 http.Error(w, "internal error", http.StatusInternalServerError)
377 return
378 }
379 h := w.Header()
380 h.Set("Content-Type", "text/html; charset=utf-8")
381 // Links on this origin are prefetched on hover, so a click shows the page
382 // at once. Every GET page is safe to load (nothing is marked read on GET).
383 h.Set("Speculation-Rules", `"`+s.assets.urls.Rules+`"`)
384 // Public pages: the browser and any proxy revalidate each time. A page
385 // rendered for the owner is private and never stored; a handler that set
386 // its own Cache-Control keeps it.
387 if h.Get("Cache-Control") == "" {
388 cacheHeaders(ctx, h, "no-cache", sessionCache)
389 }
390 body := buf.Bytes()
391 // Whether the body is sent gzipped follows from its size and the request
392 // alone, so that the tag is known before the compression is spent.
393 gz := len(body) >= minCompress && acceptsGzip(r.Header) &&
394 !noTransform(h) && h.Get("Content-Encoding") == ""
395 addVary(h, "Accept-Encoding")
396 readOnly := r.Method == http.MethodGet || r.Method == http.MethodHead
397 // A page that may be stored gets a validator: the browser then
398 // revalidates with If-None-Match and a page that did not change costs a
399 // 304. A no-store page (the owner's) is never revalidated.
400 if readOnly && status == http.StatusOK && h.Get("ETag") == "" && !hasCacheDirective(h, noStore) {
401 tag := pageETag(body, SignedIn(ctx), gz)
402 h.Set("ETag", tag)
403 if etagMatches(strings.Join(r.Header.Values("If-None-Match"), ","), tag) {
404 h.Del("Content-Type")
405 w.WriteHeader(http.StatusNotModified)
406 return
407 }
408 }
409 if gz {
410 if z, err := gzipPage(body); err == nil && len(z) < len(body) {
411 body = z
412 h.Set("Content-Encoding", "gzip")
413 }
414 }
415 h.Set("Content-Length", itoa(len(body)))
416 w.WriteHeader(status)
417 if r.Method != http.MethodHead {
418 _, _ = w.Write(body)
419 }
420}
421
422// fail answers an error of a use case: not found (and a name or revision the
423// use case refuses, which no page can show either) gives the 404 page, a
424// visitor that left gives nothing, anything else gives the 500 page with an id
425// to find the cause in the log.
426func (s *Server) fail(ctx context.Context, w http.ResponseWriter, r *http.Request, err error) {
427 switch {
428 case errors.Is(err, domain.ErrNotFound), domain.IsInvalid(err):
429 s.write(ctx, w, r, http.StatusNotFound, s.notFoundPage())
430 case errors.Is(err, context.Canceled):
431 // The client is gone; there is nobody to answer.
432 default:
433 id := requestID()
434 log := zerowrap.FromCtx(ctx)
435 log.Error().Err(err).Str("request_id", id).Str("path", logPath(r.URL.Path)).Msg("web request failed")
436 s.write(ctx, w, r, http.StatusInternalServerError, s.errorPage(id))
437 }
438}
439
440// errNotFound is returned by handlers for a resource that does not exist
441// although the use case did not say so (a ref or a path that is not there).
442var errNotFound = domain.ErrNotFound
443
444// requestID is a short random id, shown on the 500 page and logged.
445func requestID() string {
446 var b [4]byte
447 _, _ = rand.Read(b[:])
448 return hex.EncodeToString(b[:])
449}
450
451// notFound is the handler of the paths without a page.
452func (s *Server) notFound(context.Context, *http.Request) (templ.Component, int, error) {
453 return nil, 0, errNotFound
454}
455
456// base is the Layout every page starts from.
457func (s *Server) base() Layout {
458 return Layout{
459 Owner: s.cfg.Owner,
460 Version: s.cfg.Version,
461 SourceURL: s.cfg.SourceURL,
462 Assets: s.assets.urls,
463 Passkeys: s.passkeysOn(),
464 }
465}
466
467// stateLayout is the layout of a state page: only the way home.
468func (s *Server) stateLayout(title string, crumbs []Crumb) Layout {
469 l := s.base()
470 l.Title = title + " · " + s.instance
471 l.Crumbs = crumbs
472 l.Cmd = []CmdItem{{Kind: "go", Label: "home", Href: "/"}}
473 return l
474}
475
476func (s *Server) notFoundPage() templ.Component {
477 l := s.stateLayout("404", []Crumb{{Label: "not found", Current: true}})
478 return State(l, StatePage{
479 Code: "404", Title: "not found",
480 Lines: []string{"no such page, ref or path.", "check the URL, or start from the repo list."},
481 Back: []Link{{Label: "home", Href: "/"}},
482 })
483}
484
485func (s *Server) errorPage(id string) templ.Component {
486 l := s.stateLayout("error", []Crumb{{Label: "error", Current: true}})
487 return State(l, StatePage{
488 Code: "500", Title: "internal error",
489 Lines: []string{
490 "the server failed to answer this request.",
491 "request id: " + id,
492 "retry in a moment; if it persists, the owner has the log.",
493 },
494 Back: []Link{{Label: "home", Href: "/"}},
495 })
496}
497
498// originOf is the origin of a URL as a browser writes it in the Origin
499// header: scheme and host in lower case, the port only when it is not the
500// default of the scheme.
501func originOf(u *url.URL) string {
502 scheme, host, port := strings.ToLower(u.Scheme), strings.ToLower(u.Hostname()), u.Port()
503 if strings.Contains(host, ":") {
504 host = "[" + host + "]"
505 }
506 defaultPort := (scheme == "http" && port == "80") || (scheme == "https" && port == "443")
507 if port != "" && !defaultPort {
508 host += ":" + port
509 }
510 return scheme + "://" + host
511}