this repo has no description
tangled.org
1package pages
2
3import (
4 "crypto/sha256"
5 "embed"
6 "encoding/hex"
7 "fmt"
8 "html/template"
9 "io"
10 "io/fs"
11 "log/slog"
12 "net/http"
13 "os"
14 "path/filepath"
15 "strings"
16 "sync"
17 "time"
18
19 "tangled.org/core/api/tangled"
20 "tangled.org/core/appview/commitverify"
21 "tangled.org/core/appview/config"
22 "tangled.org/core/appview/models"
23 "tangled.org/core/appview/oauth"
24 "tangled.org/core/appview/pages/markup"
25 "tangled.org/core/appview/pages/repoinfo"
26 "tangled.org/core/appview/pagination"
27 "tangled.org/core/idresolver"
28 "tangled.org/core/patchutil"
29 "tangled.org/core/types"
30
31 "github.com/bluesky-social/indigo/atproto/identity"
32 "github.com/bluesky-social/indigo/atproto/syntax"
33 "github.com/go-git/go-git/v5/plumbing"
34 "github.com/go-git/go-git/v5/plumbing/object"
35)
36
37//go:embed templates/* static legal
38var Files embed.FS
39
40type Pages struct {
41 mu sync.RWMutex
42 cache *TmplCache[string, *template.Template]
43
44 avatar config.AvatarConfig
45 resolver *idresolver.Resolver
46 dev bool
47 embedFS fs.FS
48 templateDir string // Path to templates on disk for dev mode
49 rctx *markup.RenderContext
50 logger *slog.Logger
51}
52
53func NewPages(config *config.Config, res *idresolver.Resolver, logger *slog.Logger) *Pages {
54 // initialized with safe defaults, can be overriden per use
55 rctx := &markup.RenderContext{
56 IsDev: config.Core.Dev,
57 CamoUrl: config.Camo.Host,
58 CamoSecret: config.Camo.SharedSecret,
59 Sanitizer: markup.NewSanitizer(),
60 Files: Files,
61 }
62
63 p := &Pages{
64 mu: sync.RWMutex{},
65 cache: NewTmplCache[string, *template.Template](),
66 dev: config.Core.Dev,
67 avatar: config.Avatar,
68 rctx: rctx,
69 resolver: res,
70 templateDir: "appview/pages",
71 logger: logger,
72 }
73
74 if p.dev {
75 p.embedFS = os.DirFS(p.templateDir)
76 } else {
77 p.embedFS = Files
78 }
79
80 return p
81}
82
83// reverse of pathToName
84func (p *Pages) nameToPath(s string) string {
85 return "templates/" + s + ".html"
86}
87
88func (p *Pages) fragmentPaths() ([]string, error) {
89 var fragmentPaths []string
90 err := fs.WalkDir(p.embedFS, "templates", func(path string, d fs.DirEntry, err error) error {
91 if err != nil {
92 return err
93 }
94 if d.IsDir() {
95 return nil
96 }
97 if !strings.HasSuffix(path, ".html") {
98 return nil
99 }
100 if !strings.Contains(path, "fragments/") {
101 return nil
102 }
103 fragmentPaths = append(fragmentPaths, path)
104 return nil
105 })
106 if err != nil {
107 return nil, err
108 }
109
110 return fragmentPaths, nil
111}
112
113// parse without memoization
114func (p *Pages) rawParse(stack ...string) (*template.Template, error) {
115 paths, err := p.fragmentPaths()
116 if err != nil {
117 return nil, err
118 }
119 for _, s := range stack {
120 paths = append(paths, p.nameToPath(s))
121 }
122
123 funcs := p.funcMap()
124 top := stack[len(stack)-1]
125 parsed, err := template.New(top).
126 Funcs(funcs).
127 ParseFS(p.embedFS, paths...)
128 if err != nil {
129 return nil, err
130 }
131
132 return parsed, nil
133}
134
135func (p *Pages) parse(stack ...string) (*template.Template, error) {
136 key := strings.Join(stack, "|")
137
138 // never cache in dev mode
139 if cached, exists := p.cache.Get(key); !p.dev && exists {
140 return cached, nil
141 }
142
143 result, err := p.rawParse(stack...)
144 if err != nil {
145 return nil, err
146 }
147
148 p.cache.Set(key, result)
149 return result, nil
150}
151
152func (p *Pages) parseBase(top string) (*template.Template, error) {
153 stack := []string{
154 "layouts/base",
155 top,
156 }
157 return p.parse(stack...)
158}
159
160func (p *Pages) parseRepoBase(top string) (*template.Template, error) {
161 stack := []string{
162 "layouts/base",
163 "layouts/repobase",
164 top,
165 }
166 return p.parse(stack...)
167}
168
169func (p *Pages) parseProfileBase(top string) (*template.Template, error) {
170 stack := []string{
171 "layouts/base",
172 "layouts/profilebase",
173 top,
174 }
175 return p.parse(stack...)
176}
177
178func (p *Pages) executePlain(name string, w io.Writer, params any) error {
179 tpl, err := p.parse(name)
180 if err != nil {
181 return err
182 }
183
184 return tpl.Execute(w, params)
185}
186
187func (p *Pages) execute(name string, w io.Writer, params any) error {
188 tpl, err := p.parseBase(name)
189 if err != nil {
190 return err
191 }
192
193 return tpl.ExecuteTemplate(w, "layouts/base", params)
194}
195
196func (p *Pages) executeRepo(name string, w io.Writer, params any) error {
197 tpl, err := p.parseRepoBase(name)
198 if err != nil {
199 return err
200 }
201
202 return tpl.ExecuteTemplate(w, "layouts/base", params)
203}
204
205func (p *Pages) executeProfile(name string, w io.Writer, params any) error {
206 tpl, err := p.parseProfileBase(name)
207 if err != nil {
208 return err
209 }
210
211 return tpl.ExecuteTemplate(w, "layouts/base", params)
212}
213
214func (p *Pages) Favicon(w io.Writer) error {
215 return p.executePlain("fragments/dolly/silhouette", w, nil)
216}
217
218type LoginParams struct {
219 ReturnUrl string
220 ErrorCode string
221}
222
223func (p *Pages) Login(w io.Writer, params LoginParams) error {
224 return p.executePlain("user/login", w, params)
225}
226
227type SignupParams struct {
228 CloudflareSiteKey string
229}
230
231func (p *Pages) Signup(w io.Writer, params SignupParams) error {
232 return p.executePlain("user/signup", w, params)
233}
234
235func (p *Pages) CompleteSignup(w io.Writer) error {
236 return p.executePlain("user/completeSignup", w, nil)
237}
238
239type TermsOfServiceParams struct {
240 LoggedInUser *oauth.User
241 Content template.HTML
242}
243
244func (p *Pages) TermsOfService(w io.Writer, params TermsOfServiceParams) error {
245 filename := "terms.md"
246 filePath := filepath.Join("legal", filename)
247
248 file, err := p.embedFS.Open(filePath)
249 if err != nil {
250 return fmt.Errorf("failed to read %s: %w", filename, err)
251 }
252 defer file.Close()
253
254 markdownBytes, err := io.ReadAll(file)
255 if err != nil {
256 return fmt.Errorf("failed to read %s: %w", filename, err)
257 }
258
259 p.rctx.RendererType = markup.RendererTypeDefault
260 htmlString := p.rctx.RenderMarkdown(string(markdownBytes))
261 sanitized := p.rctx.SanitizeDefault(htmlString)
262 params.Content = template.HTML(sanitized)
263
264 return p.execute("legal/terms", w, params)
265}
266
267type PrivacyPolicyParams struct {
268 LoggedInUser *oauth.User
269 Content template.HTML
270}
271
272func (p *Pages) PrivacyPolicy(w io.Writer, params PrivacyPolicyParams) error {
273 filename := "privacy.md"
274 filePath := filepath.Join("legal", filename)
275
276 file, err := p.embedFS.Open(filePath)
277 if err != nil {
278 return fmt.Errorf("failed to read %s: %w", filename, err)
279 }
280 defer file.Close()
281
282 markdownBytes, err := io.ReadAll(file)
283 if err != nil {
284 return fmt.Errorf("failed to read %s: %w", filename, err)
285 }
286
287 p.rctx.RendererType = markup.RendererTypeDefault
288 htmlString := p.rctx.RenderMarkdown(string(markdownBytes))
289 sanitized := p.rctx.SanitizeDefault(htmlString)
290 params.Content = template.HTML(sanitized)
291
292 return p.execute("legal/privacy", w, params)
293}
294
295type BrandParams struct {
296 LoggedInUser *oauth.User
297}
298
299func (p *Pages) Brand(w io.Writer, params BrandParams) error {
300 return p.execute("brand/brand", w, params)
301}
302
303type TimelineParams struct {
304 LoggedInUser *oauth.User
305 Timeline []models.TimelineEvent
306 Repos []models.Repo
307 GfiLabel *models.LabelDefinition
308}
309
310func (p *Pages) Timeline(w io.Writer, params TimelineParams) error {
311 return p.execute("timeline/timeline", w, params)
312}
313
314type GoodFirstIssuesParams struct {
315 LoggedInUser *oauth.User
316 Issues []models.Issue
317 RepoGroups []*models.RepoGroup
318 LabelDefs map[string]*models.LabelDefinition
319 GfiLabel *models.LabelDefinition
320 Page pagination.Page
321}
322
323func (p *Pages) GoodFirstIssues(w io.Writer, params GoodFirstIssuesParams) error {
324 return p.execute("goodfirstissues/index", w, params)
325}
326
327type UserProfileSettingsParams struct {
328 LoggedInUser *oauth.User
329 Tabs []map[string]any
330 Tab string
331}
332
333func (p *Pages) UserProfileSettings(w io.Writer, params UserProfileSettingsParams) error {
334 return p.execute("user/settings/profile", w, params)
335}
336
337type NotificationsParams struct {
338 LoggedInUser *oauth.User
339 Notifications []*models.NotificationWithEntity
340 UnreadCount int
341 Page pagination.Page
342 Total int64
343}
344
345func (p *Pages) Notifications(w io.Writer, params NotificationsParams) error {
346 return p.execute("notifications/list", w, params)
347}
348
349type NotificationItemParams struct {
350 Notification *models.Notification
351}
352
353func (p *Pages) NotificationItem(w io.Writer, params NotificationItemParams) error {
354 return p.executePlain("notifications/fragments/item", w, params)
355}
356
357type NotificationCountParams struct {
358 Count int64
359}
360
361func (p *Pages) NotificationCount(w io.Writer, params NotificationCountParams) error {
362 return p.executePlain("notifications/fragments/count", w, params)
363}
364
365type UserKeysSettingsParams struct {
366 LoggedInUser *oauth.User
367 PubKeys []models.PublicKey
368 Tabs []map[string]any
369 Tab string
370}
371
372func (p *Pages) UserKeysSettings(w io.Writer, params UserKeysSettingsParams) error {
373 return p.execute("user/settings/keys", w, params)
374}
375
376type UserEmailsSettingsParams struct {
377 LoggedInUser *oauth.User
378 Emails []models.Email
379 Tabs []map[string]any
380 Tab string
381}
382
383func (p *Pages) UserEmailsSettings(w io.Writer, params UserEmailsSettingsParams) error {
384 return p.execute("user/settings/emails", w, params)
385}
386
387type UserNotificationSettingsParams struct {
388 LoggedInUser *oauth.User
389 Preferences *models.NotificationPreferences
390 Tabs []map[string]any
391 Tab string
392}
393
394func (p *Pages) UserNotificationSettings(w io.Writer, params UserNotificationSettingsParams) error {
395 return p.execute("user/settings/notifications", w, params)
396}
397
398type UpgradeBannerParams struct {
399 Registrations []models.Registration
400 Spindles []models.Spindle
401}
402
403func (p *Pages) UpgradeBanner(w io.Writer, params UpgradeBannerParams) error {
404 return p.executePlain("banner", w, params)
405}
406
407type KnotsParams struct {
408 LoggedInUser *oauth.User
409 Registrations []models.Registration
410 Tabs []map[string]any
411 Tab string
412}
413
414func (p *Pages) Knots(w io.Writer, params KnotsParams) error {
415 return p.execute("knots/index", w, params)
416}
417
418type KnotParams struct {
419 LoggedInUser *oauth.User
420 Registration *models.Registration
421 Members []string
422 Repos map[string][]models.Repo
423 IsOwner bool
424 Tabs []map[string]any
425 Tab string
426}
427
428func (p *Pages) Knot(w io.Writer, params KnotParams) error {
429 return p.execute("knots/dashboard", w, params)
430}
431
432type KnotListingParams struct {
433 *models.Registration
434}
435
436func (p *Pages) KnotListing(w io.Writer, params KnotListingParams) error {
437 return p.executePlain("knots/fragments/knotListing", w, params)
438}
439
440type SpindlesParams struct {
441 LoggedInUser *oauth.User
442 Spindles []models.Spindle
443 Tabs []map[string]any
444 Tab string
445}
446
447func (p *Pages) Spindles(w io.Writer, params SpindlesParams) error {
448 return p.execute("spindles/index", w, params)
449}
450
451type SpindleListingParams struct {
452 models.Spindle
453 Tabs []map[string]any
454 Tab string
455}
456
457func (p *Pages) SpindleListing(w io.Writer, params SpindleListingParams) error {
458 return p.executePlain("spindles/fragments/spindleListing", w, params)
459}
460
461type SpindleDashboardParams struct {
462 LoggedInUser *oauth.User
463 Spindle models.Spindle
464 Members []string
465 Repos map[string][]models.Repo
466 Tabs []map[string]any
467 Tab string
468}
469
470func (p *Pages) SpindleDashboard(w io.Writer, params SpindleDashboardParams) error {
471 return p.execute("spindles/dashboard", w, params)
472}
473
474type NewRepoParams struct {
475 LoggedInUser *oauth.User
476 Knots []string
477}
478
479func (p *Pages) NewRepo(w io.Writer, params NewRepoParams) error {
480 return p.execute("repo/new", w, params)
481}
482
483type ForkRepoParams struct {
484 LoggedInUser *oauth.User
485 Knots []string
486 RepoInfo repoinfo.RepoInfo
487}
488
489func (p *Pages) ForkRepo(w io.Writer, params ForkRepoParams) error {
490 return p.execute("repo/fork", w, params)
491}
492
493type ProfileCard struct {
494 UserDid string
495 FollowStatus models.FollowStatus
496 Punchcard *models.Punchcard
497 Profile *models.Profile
498 Stats ProfileStats
499 Active string
500}
501
502type ProfileStats struct {
503 RepoCount int64
504 StarredCount int64
505 StringCount int64
506 FollowersCount int64
507 FollowingCount int64
508}
509
510func (p *ProfileCard) GetTabs() [][]any {
511 tabs := [][]any{
512 {"overview", "overview", "square-chart-gantt", nil},
513 {"repos", "repos", "book-marked", p.Stats.RepoCount},
514 {"starred", "starred", "star", p.Stats.StarredCount},
515 {"strings", "strings", "line-squiggle", p.Stats.StringCount},
516 }
517
518 return tabs
519}
520
521type ProfileOverviewParams struct {
522 LoggedInUser *oauth.User
523 Repos []models.Repo
524 CollaboratingRepos []models.Repo
525 ProfileTimeline *models.ProfileTimeline
526 Card *ProfileCard
527 Active string
528}
529
530func (p *Pages) ProfileOverview(w io.Writer, params ProfileOverviewParams) error {
531 params.Active = "overview"
532 return p.executeProfile("user/overview", w, params)
533}
534
535type ProfileReposParams struct {
536 LoggedInUser *oauth.User
537 Repos []models.Repo
538 Card *ProfileCard
539 Active string
540}
541
542func (p *Pages) ProfileRepos(w io.Writer, params ProfileReposParams) error {
543 params.Active = "repos"
544 return p.executeProfile("user/repos", w, params)
545}
546
547type ProfileStarredParams struct {
548 LoggedInUser *oauth.User
549 Repos []models.Repo
550 Card *ProfileCard
551 Active string
552}
553
554func (p *Pages) ProfileStarred(w io.Writer, params ProfileStarredParams) error {
555 params.Active = "starred"
556 return p.executeProfile("user/starred", w, params)
557}
558
559type ProfileStringsParams struct {
560 LoggedInUser *oauth.User
561 Strings []models.String
562 Card *ProfileCard
563 Active string
564}
565
566func (p *Pages) ProfileStrings(w io.Writer, params ProfileStringsParams) error {
567 params.Active = "strings"
568 return p.executeProfile("user/strings", w, params)
569}
570
571type FollowCard struct {
572 UserDid string
573 LoggedInUser *oauth.User
574 FollowStatus models.FollowStatus
575 FollowersCount int64
576 FollowingCount int64
577 Profile *models.Profile
578}
579
580type ProfileFollowersParams struct {
581 LoggedInUser *oauth.User
582 Followers []FollowCard
583 Card *ProfileCard
584 Active string
585}
586
587func (p *Pages) ProfileFollowers(w io.Writer, params ProfileFollowersParams) error {
588 params.Active = "overview"
589 return p.executeProfile("user/followers", w, params)
590}
591
592type ProfileFollowingParams struct {
593 LoggedInUser *oauth.User
594 Following []FollowCard
595 Card *ProfileCard
596 Active string
597}
598
599func (p *Pages) ProfileFollowing(w io.Writer, params ProfileFollowingParams) error {
600 params.Active = "overview"
601 return p.executeProfile("user/following", w, params)
602}
603
604type FollowFragmentParams struct {
605 UserDid string
606 FollowStatus models.FollowStatus
607}
608
609func (p *Pages) FollowFragment(w io.Writer, params FollowFragmentParams) error {
610 return p.executePlain("user/fragments/follow", w, params)
611}
612
613type EditBioParams struct {
614 LoggedInUser *oauth.User
615 Profile *models.Profile
616}
617
618func (p *Pages) EditBioFragment(w io.Writer, params EditBioParams) error {
619 return p.executePlain("user/fragments/editBio", w, params)
620}
621
622type EditPinsParams struct {
623 LoggedInUser *oauth.User
624 Profile *models.Profile
625 AllRepos []PinnedRepo
626}
627
628type PinnedRepo struct {
629 IsPinned bool
630 models.Repo
631}
632
633func (p *Pages) EditPinsFragment(w io.Writer, params EditPinsParams) error {
634 return p.executePlain("user/fragments/editPins", w, params)
635}
636
637type StarBtnFragmentParams struct {
638 IsStarred bool
639 SubjectAt syntax.ATURI
640 StarCount int
641}
642
643func (p *Pages) StarBtnFragment(w io.Writer, params StarBtnFragmentParams) error {
644 return p.executePlain("fragments/starBtn", w, params)
645}
646
647type RepoIndexParams struct {
648 LoggedInUser *oauth.User
649 RepoInfo repoinfo.RepoInfo
650 Active string
651 TagMap map[string][]string
652 CommitsTrunc []*object.Commit
653 TagsTrunc []*types.TagReference
654 BranchesTrunc []types.Branch
655 // ForkInfo *types.ForkInfo
656 HTMLReadme template.HTML
657 Raw bool
658 EmailToDid map[string]string
659 VerifiedCommits commitverify.VerifiedCommits
660 Languages []types.RepoLanguageDetails
661 Pipelines map[string]models.Pipeline
662 NeedsKnotUpgrade bool
663 types.RepoIndexResponse
664}
665
666func (p *Pages) RepoIndexPage(w io.Writer, params RepoIndexParams) error {
667 params.Active = "overview"
668 if params.IsEmpty {
669 return p.executeRepo("repo/empty", w, params)
670 }
671
672 if params.NeedsKnotUpgrade {
673 return p.executeRepo("repo/needsUpgrade", w, params)
674 }
675
676 p.rctx.RepoInfo = params.RepoInfo
677 p.rctx.RepoInfo.Ref = params.Ref
678 p.rctx.RendererType = markup.RendererTypeRepoMarkdown
679
680 if params.ReadmeFileName != "" {
681 ext := filepath.Ext(params.ReadmeFileName)
682 switch ext {
683 case ".md", ".markdown", ".mdown", ".mkdn", ".mkd":
684 params.Raw = false
685 htmlString := p.rctx.RenderMarkdown(params.Readme)
686 sanitized := p.rctx.SanitizeDefault(htmlString)
687 params.HTMLReadme = template.HTML(sanitized)
688 default:
689 params.Raw = true
690 }
691 }
692
693 return p.executeRepo("repo/index", w, params)
694}
695
696type RepoLogParams struct {
697 LoggedInUser *oauth.User
698 RepoInfo repoinfo.RepoInfo
699 TagMap map[string][]string
700 Active string
701 EmailToDid map[string]string
702 VerifiedCommits commitverify.VerifiedCommits
703 Pipelines map[string]models.Pipeline
704
705 types.RepoLogResponse
706}
707
708func (p *Pages) RepoLog(w io.Writer, params RepoLogParams) error {
709 params.Active = "overview"
710 return p.executeRepo("repo/log", w, params)
711}
712
713type RepoCommitParams struct {
714 LoggedInUser *oauth.User
715 RepoInfo repoinfo.RepoInfo
716 Active string
717 EmailToDid map[string]string
718 Pipeline *models.Pipeline
719 DiffOpts types.DiffOpts
720
721 // singular because it's always going to be just one
722 VerifiedCommit commitverify.VerifiedCommits
723
724 types.RepoCommitResponse
725}
726
727func (p *Pages) RepoCommit(w io.Writer, params RepoCommitParams) error {
728 params.Active = "overview"
729 return p.executeRepo("repo/commit", w, params)
730}
731
732type RepoTreeParams struct {
733 LoggedInUser *oauth.User
734 RepoInfo repoinfo.RepoInfo
735 Active string
736 BreadCrumbs [][]string
737 TreePath string
738 Raw bool
739 HTMLReadme template.HTML
740 types.RepoTreeResponse
741}
742
743type RepoTreeStats struct {
744 NumFolders uint64
745 NumFiles uint64
746}
747
748func (r RepoTreeParams) TreeStats() RepoTreeStats {
749 numFolders, numFiles := 0, 0
750 for _, f := range r.Files {
751 if !f.IsFile() {
752 numFolders += 1
753 } else if f.IsFile() {
754 numFiles += 1
755 }
756 }
757
758 return RepoTreeStats{
759 NumFolders: uint64(numFolders),
760 NumFiles: uint64(numFiles),
761 }
762}
763
764func (p *Pages) RepoTree(w io.Writer, params RepoTreeParams) error {
765 params.Active = "overview"
766
767 p.rctx.RepoInfo = params.RepoInfo
768 p.rctx.RepoInfo.Ref = params.Ref
769 p.rctx.RendererType = markup.RendererTypeRepoMarkdown
770
771 if params.ReadmeFileName != "" {
772 ext := filepath.Ext(params.ReadmeFileName)
773 switch ext {
774 case ".md", ".markdown", ".mdown", ".mkdn", ".mkd":
775 params.Raw = false
776 htmlString := p.rctx.RenderMarkdown(params.Readme)
777 sanitized := p.rctx.SanitizeDefault(htmlString)
778 params.HTMLReadme = template.HTML(sanitized)
779 default:
780 params.Raw = true
781 }
782 }
783
784 return p.executeRepo("repo/tree", w, params)
785}
786
787type RepoBranchesParams struct {
788 LoggedInUser *oauth.User
789 RepoInfo repoinfo.RepoInfo
790 Active string
791 types.RepoBranchesResponse
792}
793
794func (p *Pages) RepoBranches(w io.Writer, params RepoBranchesParams) error {
795 params.Active = "overview"
796 return p.executeRepo("repo/branches", w, params)
797}
798
799type RepoTagsParams struct {
800 LoggedInUser *oauth.User
801 RepoInfo repoinfo.RepoInfo
802 Active string
803 types.RepoTagsResponse
804 ArtifactMap map[plumbing.Hash][]models.Artifact
805 DanglingArtifacts []models.Artifact
806}
807
808func (p *Pages) RepoTags(w io.Writer, params RepoTagsParams) error {
809 params.Active = "overview"
810 return p.executeRepo("repo/tags", w, params)
811}
812
813type RepoArtifactParams struct {
814 LoggedInUser *oauth.User
815 RepoInfo repoinfo.RepoInfo
816 Artifact models.Artifact
817}
818
819func (p *Pages) RepoArtifactFragment(w io.Writer, params RepoArtifactParams) error {
820 return p.executePlain("repo/fragments/artifact", w, params)
821}
822
823type RepoBlobParams struct {
824 LoggedInUser *oauth.User
825 RepoInfo repoinfo.RepoInfo
826 Active string
827 BreadCrumbs [][]string
828 BlobView models.BlobView
829 *tangled.RepoBlob_Output
830}
831
832func (p *Pages) RepoBlob(w io.Writer, params RepoBlobParams) error {
833 switch params.BlobView.ContentType {
834 case models.BlobContentTypeMarkup:
835 p.rctx.RepoInfo = params.RepoInfo
836 }
837
838 params.Active = "overview"
839 return p.executeRepo("repo/blob", w, params)
840}
841
842type Collaborator struct {
843 Did string
844 Role string
845}
846
847type RepoSettingsParams struct {
848 LoggedInUser *oauth.User
849 RepoInfo repoinfo.RepoInfo
850 Collaborators []Collaborator
851 Active string
852 Branches []types.Branch
853 Spindles []string
854 CurrentSpindle string
855 Secrets []*tangled.RepoListSecrets_Secret
856
857 // TODO: use repoinfo.roles
858 IsCollaboratorInviteAllowed bool
859}
860
861func (p *Pages) RepoSettings(w io.Writer, params RepoSettingsParams) error {
862 params.Active = "settings"
863 return p.executeRepo("repo/settings", w, params)
864}
865
866type RepoGeneralSettingsParams struct {
867 LoggedInUser *oauth.User
868 RepoInfo repoinfo.RepoInfo
869 Labels []models.LabelDefinition
870 DefaultLabels []models.LabelDefinition
871 SubscribedLabels map[string]struct{}
872 ShouldSubscribeAll bool
873 Active string
874 Tabs []map[string]any
875 Tab string
876 Branches []types.Branch
877}
878
879func (p *Pages) RepoGeneralSettings(w io.Writer, params RepoGeneralSettingsParams) error {
880 params.Active = "settings"
881 return p.executeRepo("repo/settings/general", w, params)
882}
883
884type RepoAccessSettingsParams struct {
885 LoggedInUser *oauth.User
886 RepoInfo repoinfo.RepoInfo
887 Active string
888 Tabs []map[string]any
889 Tab string
890 Collaborators []Collaborator
891}
892
893func (p *Pages) RepoAccessSettings(w io.Writer, params RepoAccessSettingsParams) error {
894 params.Active = "settings"
895 return p.executeRepo("repo/settings/access", w, params)
896}
897
898type RepoPipelineSettingsParams struct {
899 LoggedInUser *oauth.User
900 RepoInfo repoinfo.RepoInfo
901 Active string
902 Tabs []map[string]any
903 Tab string
904 Spindles []string
905 CurrentSpindle string
906 Secrets []map[string]any
907}
908
909func (p *Pages) RepoPipelineSettings(w io.Writer, params RepoPipelineSettingsParams) error {
910 params.Active = "settings"
911 return p.executeRepo("repo/settings/pipelines", w, params)
912}
913
914type RepoIssuesParams struct {
915 LoggedInUser *oauth.User
916 RepoInfo repoinfo.RepoInfo
917 Active string
918 Issues []models.Issue
919 IssueCount int
920 LabelDefs map[string]*models.LabelDefinition
921 Page pagination.Page
922 FilteringByOpen bool
923 FilterQuery string
924}
925
926func (p *Pages) RepoIssues(w io.Writer, params RepoIssuesParams) error {
927 params.Active = "issues"
928 return p.executeRepo("repo/issues/issues", w, params)
929}
930
931type RepoSingleIssueParams struct {
932 LoggedInUser *oauth.User
933 RepoInfo repoinfo.RepoInfo
934 Active string
935 Issue *models.Issue
936 CommentList []models.CommentListItem
937 Backlinks []models.RichReferenceLink
938 LabelDefs map[string]*models.LabelDefinition
939
940 OrderedReactionKinds []models.ReactionKind
941 Reactions map[models.ReactionKind]models.ReactionDisplayData
942 UserReacted map[models.ReactionKind]bool
943}
944
945func (p *Pages) RepoSingleIssue(w io.Writer, params RepoSingleIssueParams) error {
946 params.Active = "issues"
947 return p.executeRepo("repo/issues/issue", w, params)
948}
949
950type EditIssueParams struct {
951 LoggedInUser *oauth.User
952 RepoInfo repoinfo.RepoInfo
953 Issue *models.Issue
954 Action string
955}
956
957func (p *Pages) EditIssueFragment(w io.Writer, params EditIssueParams) error {
958 params.Action = "edit"
959 return p.executePlain("repo/issues/fragments/putIssue", w, params)
960}
961
962type ThreadReactionFragmentParams struct {
963 ThreadAt syntax.ATURI
964 Kind models.ReactionKind
965 Count int
966 Users []string
967 IsReacted bool
968}
969
970func (p *Pages) ThreadReactionFragment(w io.Writer, params ThreadReactionFragmentParams) error {
971 return p.executePlain("repo/fragments/reaction", w, params)
972}
973
974type RepoNewIssueParams struct {
975 LoggedInUser *oauth.User
976 RepoInfo repoinfo.RepoInfo
977 Issue *models.Issue // existing issue if any -- passed when editing
978 Active string
979 Action string
980}
981
982func (p *Pages) RepoNewIssue(w io.Writer, params RepoNewIssueParams) error {
983 params.Active = "issues"
984 params.Action = "create"
985 return p.executeRepo("repo/issues/new", w, params)
986}
987
988type EditIssueCommentParams struct {
989 LoggedInUser *oauth.User
990 RepoInfo repoinfo.RepoInfo
991 Issue *models.Issue
992 Comment *models.IssueComment
993}
994
995func (p *Pages) EditIssueCommentFragment(w io.Writer, params EditIssueCommentParams) error {
996 return p.executePlain("repo/issues/fragments/editIssueComment", w, params)
997}
998
999type ReplyIssueCommentPlaceholderParams struct {
1000 LoggedInUser *oauth.User
1001 RepoInfo repoinfo.RepoInfo
1002 Issue *models.Issue
1003 Comment *models.IssueComment
1004}
1005
1006func (p *Pages) ReplyIssueCommentPlaceholderFragment(w io.Writer, params ReplyIssueCommentPlaceholderParams) error {
1007 return p.executePlain("repo/issues/fragments/replyIssueCommentPlaceholder", w, params)
1008}
1009
1010type ReplyIssueCommentParams struct {
1011 LoggedInUser *oauth.User
1012 RepoInfo repoinfo.RepoInfo
1013 Issue *models.Issue
1014 Comment *models.IssueComment
1015}
1016
1017func (p *Pages) ReplyIssueCommentFragment(w io.Writer, params ReplyIssueCommentParams) error {
1018 return p.executePlain("repo/issues/fragments/replyComment", w, params)
1019}
1020
1021type IssueCommentBodyParams struct {
1022 LoggedInUser *oauth.User
1023 RepoInfo repoinfo.RepoInfo
1024 Issue *models.Issue
1025 Comment *models.IssueComment
1026}
1027
1028func (p *Pages) IssueCommentBodyFragment(w io.Writer, params IssueCommentBodyParams) error {
1029 return p.executePlain("repo/issues/fragments/issueCommentBody", w, params)
1030}
1031
1032type RepoNewPullParams struct {
1033 LoggedInUser *oauth.User
1034 RepoInfo repoinfo.RepoInfo
1035 Branches []types.Branch
1036 Strategy string
1037 SourceBranch string
1038 TargetBranch string
1039 Title string
1040 Body string
1041 Active string
1042}
1043
1044func (p *Pages) RepoNewPull(w io.Writer, params RepoNewPullParams) error {
1045 params.Active = "pulls"
1046 return p.executeRepo("repo/pulls/new", w, params)
1047}
1048
1049type RepoPullsParams struct {
1050 LoggedInUser *oauth.User
1051 RepoInfo repoinfo.RepoInfo
1052 Pulls []*models.Pull
1053 Active string
1054 FilteringBy models.PullState
1055 FilterQuery string
1056 Stacks map[string]models.Stack
1057 Pipelines map[string]models.Pipeline
1058 LabelDefs map[string]*models.LabelDefinition
1059}
1060
1061func (p *Pages) RepoPulls(w io.Writer, params RepoPullsParams) error {
1062 params.Active = "pulls"
1063 return p.executeRepo("repo/pulls/pulls", w, params)
1064}
1065
1066type ResubmitResult uint64
1067
1068const (
1069 ShouldResubmit ResubmitResult = iota
1070 ShouldNotResubmit
1071 Unknown
1072)
1073
1074func (r ResubmitResult) Yes() bool {
1075 return r == ShouldResubmit
1076}
1077func (r ResubmitResult) No() bool {
1078 return r == ShouldNotResubmit
1079}
1080func (r ResubmitResult) Unknown() bool {
1081 return r == Unknown
1082}
1083
1084type RepoSinglePullParams struct {
1085 LoggedInUser *oauth.User
1086 RepoInfo repoinfo.RepoInfo
1087 Active string
1088 Pull *models.Pull
1089 Stack models.Stack
1090 AbandonedPulls []*models.Pull
1091 Backlinks []models.RichReferenceLink
1092 BranchDeleteStatus *models.BranchDeleteStatus
1093 MergeCheck types.MergeCheckResponse
1094 ResubmitCheck ResubmitResult
1095 Pipelines map[string]models.Pipeline
1096
1097 OrderedReactionKinds []models.ReactionKind
1098 Reactions map[models.ReactionKind]models.ReactionDisplayData
1099 UserReacted map[models.ReactionKind]bool
1100
1101 LabelDefs map[string]*models.LabelDefinition
1102}
1103
1104func (p *Pages) RepoSinglePull(w io.Writer, params RepoSinglePullParams) error {
1105 params.Active = "pulls"
1106 return p.executeRepo("repo/pulls/pull", w, params)
1107}
1108
1109type RepoPullPatchParams struct {
1110 LoggedInUser *oauth.User
1111 RepoInfo repoinfo.RepoInfo
1112 Pull *models.Pull
1113 Stack models.Stack
1114 Diff *types.NiceDiff
1115 Round int
1116 Submission *models.PullSubmission
1117 OrderedReactionKinds []models.ReactionKind
1118 DiffOpts types.DiffOpts
1119}
1120
1121// this name is a mouthful
1122func (p *Pages) RepoPullPatchPage(w io.Writer, params RepoPullPatchParams) error {
1123 return p.execute("repo/pulls/patch", w, params)
1124}
1125
1126type RepoPullInterdiffParams struct {
1127 LoggedInUser *oauth.User
1128 RepoInfo repoinfo.RepoInfo
1129 Pull *models.Pull
1130 Round int
1131 Interdiff *patchutil.InterdiffResult
1132 OrderedReactionKinds []models.ReactionKind
1133 DiffOpts types.DiffOpts
1134}
1135
1136// this name is a mouthful
1137func (p *Pages) RepoPullInterdiffPage(w io.Writer, params RepoPullInterdiffParams) error {
1138 return p.execute("repo/pulls/interdiff", w, params)
1139}
1140
1141type PullPatchUploadParams struct {
1142 RepoInfo repoinfo.RepoInfo
1143}
1144
1145func (p *Pages) PullPatchUploadFragment(w io.Writer, params PullPatchUploadParams) error {
1146 return p.executePlain("repo/pulls/fragments/pullPatchUpload", w, params)
1147}
1148
1149type PullCompareBranchesParams struct {
1150 RepoInfo repoinfo.RepoInfo
1151 Branches []types.Branch
1152 SourceBranch string
1153}
1154
1155func (p *Pages) PullCompareBranchesFragment(w io.Writer, params PullCompareBranchesParams) error {
1156 return p.executePlain("repo/pulls/fragments/pullCompareBranches", w, params)
1157}
1158
1159type PullCompareForkParams struct {
1160 RepoInfo repoinfo.RepoInfo
1161 Forks []models.Repo
1162 Selected string
1163}
1164
1165func (p *Pages) PullCompareForkFragment(w io.Writer, params PullCompareForkParams) error {
1166 return p.executePlain("repo/pulls/fragments/pullCompareForks", w, params)
1167}
1168
1169type PullCompareForkBranchesParams struct {
1170 RepoInfo repoinfo.RepoInfo
1171 SourceBranches []types.Branch
1172 TargetBranches []types.Branch
1173}
1174
1175func (p *Pages) PullCompareForkBranchesFragment(w io.Writer, params PullCompareForkBranchesParams) error {
1176 return p.executePlain("repo/pulls/fragments/pullCompareForksBranches", w, params)
1177}
1178
1179type PullResubmitParams struct {
1180 LoggedInUser *oauth.User
1181 RepoInfo repoinfo.RepoInfo
1182 Pull *models.Pull
1183 SubmissionId int
1184}
1185
1186func (p *Pages) PullResubmitFragment(w io.Writer, params PullResubmitParams) error {
1187 return p.executePlain("repo/pulls/fragments/pullResubmit", w, params)
1188}
1189
1190type PullActionsParams struct {
1191 LoggedInUser *oauth.User
1192 RepoInfo repoinfo.RepoInfo
1193 Pull *models.Pull
1194 RoundNumber int
1195 MergeCheck types.MergeCheckResponse
1196 ResubmitCheck ResubmitResult
1197 BranchDeleteStatus *models.BranchDeleteStatus
1198 Stack models.Stack
1199}
1200
1201func (p *Pages) PullActionsFragment(w io.Writer, params PullActionsParams) error {
1202 return p.executePlain("repo/pulls/fragments/pullActions", w, params)
1203}
1204
1205type PullNewCommentParams struct {
1206 LoggedInUser *oauth.User
1207 RepoInfo repoinfo.RepoInfo
1208 Pull *models.Pull
1209 RoundNumber int
1210}
1211
1212func (p *Pages) PullNewCommentFragment(w io.Writer, params PullNewCommentParams) error {
1213 return p.executePlain("repo/pulls/fragments/pullNewComment", w, params)
1214}
1215
1216type RepoCompareParams struct {
1217 LoggedInUser *oauth.User
1218 RepoInfo repoinfo.RepoInfo
1219 Forks []models.Repo
1220 Branches []types.Branch
1221 Tags []*types.TagReference
1222 Base string
1223 Head string
1224 Diff *types.NiceDiff
1225 DiffOpts types.DiffOpts
1226
1227 Active string
1228}
1229
1230func (p *Pages) RepoCompare(w io.Writer, params RepoCompareParams) error {
1231 params.Active = "overview"
1232 return p.executeRepo("repo/compare/compare", w, params)
1233}
1234
1235type RepoCompareNewParams struct {
1236 LoggedInUser *oauth.User
1237 RepoInfo repoinfo.RepoInfo
1238 Forks []models.Repo
1239 Branches []types.Branch
1240 Tags []*types.TagReference
1241 Base string
1242 Head string
1243
1244 Active string
1245}
1246
1247func (p *Pages) RepoCompareNew(w io.Writer, params RepoCompareNewParams) error {
1248 params.Active = "overview"
1249 return p.executeRepo("repo/compare/new", w, params)
1250}
1251
1252type RepoCompareAllowPullParams struct {
1253 LoggedInUser *oauth.User
1254 RepoInfo repoinfo.RepoInfo
1255 Base string
1256 Head string
1257}
1258
1259func (p *Pages) RepoCompareAllowPullFragment(w io.Writer, params RepoCompareAllowPullParams) error {
1260 return p.executePlain("repo/fragments/compareAllowPull", w, params)
1261}
1262
1263type RepoCompareDiffFragmentParams struct {
1264 Diff types.NiceDiff
1265 DiffOpts types.DiffOpts
1266}
1267
1268func (p *Pages) RepoCompareDiffFragment(w io.Writer, params RepoCompareDiffFragmentParams) error {
1269 return p.executePlain("repo/fragments/diff", w, []any{¶ms.Diff, ¶ms.DiffOpts})
1270}
1271
1272type LabelPanelParams struct {
1273 LoggedInUser *oauth.User
1274 RepoInfo repoinfo.RepoInfo
1275 Defs map[string]*models.LabelDefinition
1276 Subject string
1277 State models.LabelState
1278}
1279
1280func (p *Pages) LabelPanel(w io.Writer, params LabelPanelParams) error {
1281 return p.executePlain("repo/fragments/labelPanel", w, params)
1282}
1283
1284type EditLabelPanelParams struct {
1285 LoggedInUser *oauth.User
1286 RepoInfo repoinfo.RepoInfo
1287 Defs map[string]*models.LabelDefinition
1288 Subject string
1289 State models.LabelState
1290}
1291
1292func (p *Pages) EditLabelPanel(w io.Writer, params EditLabelPanelParams) error {
1293 return p.executePlain("repo/fragments/editLabelPanel", w, params)
1294}
1295
1296type PipelinesParams struct {
1297 LoggedInUser *oauth.User
1298 RepoInfo repoinfo.RepoInfo
1299 Pipelines []models.Pipeline
1300 Active string
1301}
1302
1303func (p *Pages) Pipelines(w io.Writer, params PipelinesParams) error {
1304 params.Active = "pipelines"
1305 return p.executeRepo("repo/pipelines/pipelines", w, params)
1306}
1307
1308type LogBlockParams struct {
1309 Id int
1310 Name string
1311 Command string
1312 Collapsed bool
1313 StartTime time.Time
1314}
1315
1316func (p *Pages) LogBlock(w io.Writer, params LogBlockParams) error {
1317 return p.executePlain("repo/pipelines/fragments/logBlock", w, params)
1318}
1319
1320type LogBlockEndParams struct {
1321 Id int
1322 StartTime time.Time
1323 EndTime time.Time
1324}
1325
1326func (p *Pages) LogBlockEnd(w io.Writer, params LogBlockEndParams) error {
1327 return p.executePlain("repo/pipelines/fragments/logBlockEnd", w, params)
1328}
1329
1330type LogLineParams struct {
1331 Id int
1332 Content string
1333}
1334
1335func (p *Pages) LogLine(w io.Writer, params LogLineParams) error {
1336 return p.executePlain("repo/pipelines/fragments/logLine", w, params)
1337}
1338
1339type WorkflowParams struct {
1340 LoggedInUser *oauth.User
1341 RepoInfo repoinfo.RepoInfo
1342 Pipeline models.Pipeline
1343 Workflow string
1344 LogUrl string
1345 Active string
1346}
1347
1348func (p *Pages) Workflow(w io.Writer, params WorkflowParams) error {
1349 params.Active = "pipelines"
1350 return p.executeRepo("repo/pipelines/workflow", w, params)
1351}
1352
1353type PutStringParams struct {
1354 LoggedInUser *oauth.User
1355 Action string
1356
1357 // this is supplied in the case of editing an existing string
1358 String models.String
1359}
1360
1361func (p *Pages) PutString(w io.Writer, params PutStringParams) error {
1362 return p.execute("strings/put", w, params)
1363}
1364
1365type StringsDashboardParams struct {
1366 LoggedInUser *oauth.User
1367 Card ProfileCard
1368 Strings []models.String
1369}
1370
1371func (p *Pages) StringsDashboard(w io.Writer, params StringsDashboardParams) error {
1372 return p.execute("strings/dashboard", w, params)
1373}
1374
1375type StringTimelineParams struct {
1376 LoggedInUser *oauth.User
1377 Strings []models.String
1378}
1379
1380func (p *Pages) StringsTimeline(w io.Writer, params StringTimelineParams) error {
1381 return p.execute("strings/timeline", w, params)
1382}
1383
1384type SingleStringParams struct {
1385 LoggedInUser *oauth.User
1386 ShowRendered bool
1387 RenderToggle bool
1388 RenderedContents template.HTML
1389 String *models.String
1390 Stats models.StringStats
1391 IsStarred bool
1392 StarCount int
1393 Owner identity.Identity
1394}
1395
1396func (p *Pages) SingleString(w io.Writer, params SingleStringParams) error {
1397 return p.execute("strings/string", w, params)
1398}
1399
1400func (p *Pages) Home(w io.Writer, params TimelineParams) error {
1401 return p.execute("timeline/home", w, params)
1402}
1403
1404func (p *Pages) Static() http.Handler {
1405 if p.dev {
1406 return http.StripPrefix("/static/", http.FileServer(http.Dir("appview/pages/static")))
1407 }
1408
1409 sub, err := fs.Sub(p.embedFS, "static")
1410 if err != nil {
1411 p.logger.Error("no static dir found? that's crazy", "err", err)
1412 panic(err)
1413 }
1414 // Custom handler to apply Cache-Control headers for font files
1415 return Cache(http.StripPrefix("/static/", http.FileServer(http.FS(sub))))
1416}
1417
1418func Cache(h http.Handler) http.Handler {
1419 return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
1420 path := strings.Split(r.URL.Path, "?")[0]
1421
1422 if strings.HasSuffix(path, ".css") {
1423 // on day for css files
1424 w.Header().Set("Cache-Control", "public, max-age=86400")
1425 } else {
1426 w.Header().Set("Cache-Control", "public, max-age=31536000, immutable")
1427 }
1428 h.ServeHTTP(w, r)
1429 })
1430}
1431
1432func (p *Pages) CssContentHash() string {
1433 cssFile, err := p.embedFS.Open("static/tw.css")
1434 if err != nil {
1435 slog.Debug("Error opening CSS file", "err", err)
1436 return ""
1437 }
1438 defer cssFile.Close()
1439
1440 hasher := sha256.New()
1441 if _, err := io.Copy(hasher, cssFile); err != nil {
1442 slog.Debug("Error hashing CSS file", "err", err)
1443 return ""
1444 }
1445
1446 return hex.EncodeToString(hasher.Sum(nil))[:8] // Use first 8 chars of hash
1447}
1448
1449func (p *Pages) Error500(w io.Writer) error {
1450 return p.execute("errors/500", w, nil)
1451}
1452
1453func (p *Pages) Error404(w io.Writer) error {
1454 return p.execute("errors/404", w, nil)
1455}
1456
1457func (p *Pages) ErrorKnot404(w io.Writer) error {
1458 return p.execute("errors/knot404", w, nil)
1459}
1460
1461func (p *Pages) Error503(w io.Writer) error {
1462 return p.execute("errors/503", w, nil)
1463}