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