model

type Book struct {
	ID                     int
	Title                  string
	Authors                []string
	Pages                  int
	Slug                   string
	ImageURL               string
	Rating                 float64
	RatingsCount           int
	ReviewsCount           int
	UsersCount             int
	UsersReadCount         int
	ReleaseDate            string
	CachedTags             string // raw Hardcover cached_tags JSON (genres/moods/tags)
	FeaturedSeries         string
	FeaturedSeriesPosition int
}

type DayActivity struct {
	Date        time.Time
	Minutes     int
	HasActivity bool // progress update or finished book that day (no timer minutes required)
}

type Goal struct {
	ID        int
	Metric    string // "books", "pages", ...
	Target    int
	Progress  float64 // current progress toward Target, maintained server-side
	State     string  // "active", "completed", "failed"
	StartDate time.Time
	EndDate   time.Time
}

type JournalEntry struct {
	ID       int
	ActionAt time.Time
	Event    string
}

type LabelCount struct {
	Label string
	Count int
}

type PageUpdate struct {
	Absolute int  // target page (if not relative)
	Delta    int  // delta (if relative)
	Relative bool // true if +N or -N
}

type ReadingSession struct {
	ID        int
	BookID    int // 0 = no book associated
	StartedAt time.Time
	EndedAt   *time.Time // nil = still running (should not be stored without end)
	Notes     string
	BookTitle string // denormalized for display
}

type ReadingStats struct {
	Year    YearSummary
	Goal    *Goal        // active "books" goal, nil when none
	Months  [12]int      // books finished per month of Year (Jan=0)
	Years   []LabelCount // books finished per year, ascending
	Ratings [10]int      // count per half-star bucket: index i = (i+1)*0.5 stars
	Genres  []LabelCount // top genres across finished books, descending
	Heatmap []DayActivity
	Weekly  WeeklyStats // timer minutes for the current week
}

type SearchMode string

type SearchResult struct {
	ID       int
	Title    string
	Authors  []string
	Pages    int
	Slug     string
	ImageURL string
	Rating   float64
	Ratings  int
}

type Status int

type TimerState struct {
	BookID    int       `json:"book_id"`
	StartedAt time.Time `json:"started_at"`
}

type UserBook struct {
	ID            int
	BookID        int
	StatusID      Status
	Rating        float64
	Review        string
	ReviewedAt    *time.Time
	CurrentPage   int
	Book          Book
	UserBookReads []UserBookRead
	UpdatedAt     time.Time
}

type UserBookRead struct {
	ID            int
	UserBookID    int
	ProgressPages int
	StartedAt     *time.Time
	FinishedAt    *time.Time
}

type WeeklyStats struct {
	Days       [7]int // minutes per day (Mon=0 .. Sun=6)
	Total      int    // total minutes in the period
	Sessions   int    // total number of sessions
	LongestDay int    // index of day with most reading
}

type YearSummary struct {
	Year          int
	BooksFinished int
	PagesRead     int
	AvgRating     float64 // average of the user's ratings on books finished this year (0 = none rated)
	RatedCount    int
}