inital commit

models.go

@@ -0,0 +1,72 @@
+package fa
+
+import "time"
+
+// UserRef is a lightweight reference to a user that appears next to other
+// entities (a submission's author, a comment's author, etc.). Use [Client.GetUser]
+// to load the full [User].
+type UserRef struct {
+	// Name is the URL-safe login name FA uses for routing. Always lowercase.
+	Name string
+	// DisplayName preserves the user's chosen capitalisation and styling.
+	DisplayName string
+	// AvatarURL points to the user's avatar image on the CDN.
+	AvatarURL string
+}
+
+// SubmissionRef is a thin reference to another submission, used for things
+// like a user's featured submission preview where we only want a handful of
+// fields without paying for a full submission fetch.
+type SubmissionRef struct {
+	ID       SubmissionID
+	Title    string
+	ThumbURL string
+}
+
+// FolderRef identifies a gallery folder a submission appears in.
+type FolderRef struct {
+	Name string
+	URL  string
+}
+
+// SubmissionStats are the headline counts shown in the submission sidebar.
+type SubmissionStats struct {
+	Views     int
+	Favorites int
+	Comments  int
+}
+
+// UserStats are the per-user counts shown on the profile page.
+type UserStats struct {
+	Submissions int
+	Favorites   int
+	Views       int
+	Comments    int
+	Journals    int
+	Watchers    int
+	Watching    int
+}
+
+// UserContact is one row of the "Contact Information" table on a profile,
+// e.g. {Site: "Twitter", Handle: "@someone", URL: "https://twitter.com/someone"}.
+type UserContact struct {
+	Site   string
+	Handle string
+	URL    string
+}
+
+// Shout is one entry from the shouts/guestbook on a user's profile.
+type Shout struct {
+	Author   UserRef
+	PostedAt time.Time
+	BodyHTML string
+}
+
+// SiteBanner is the image rendered in the page header of a user's profile.
+// FA always shows one: either the artist's own banner uploaded via
+// /controls/profilebanner/, or if none is set FA's site-wide promo
+// banner. IsCustom distinguishes the two.
+type SiteBanner struct {
+	ImageURL string // absolute CDN URL of the banner image
+	IsCustom bool   // true when the artist set their own banner
+}