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