history.go RawHistoryFolder

1package repository
2
3import (
4	"context"
5	"time"
6
7	"github.com/bnema/dumber/internal/domain/entity"
8)
9
10// HistoryRepository defines operations for browsing history persistence.
11type HistoryRepository interface {
12	// Save creates or updates a history entry (upsert).
13	Save(ctx context.Context, entry *entity.HistoryEntry) error
14
15	// FindByURL retrieves a history entry by its URL.
16	FindByURL(ctx context.Context, url string) (*entity.HistoryEntry, error)
17
18	// Search performs a fuzzy search on history entries.
19	Search(ctx context.Context, query string, limit int) ([]entity.HistoryMatch, error)
20
21	// GetRecent retrieves recent history entries with pagination.
22	GetRecent(ctx context.Context, limit, offset int) ([]*entity.HistoryEntry, error)
23
24	// IncrementVisitCount increments the visit count for a URL.
25	IncrementVisitCount(ctx context.Context, url string) error
26
27	// Delete removes a single history entry by ID.
28	Delete(ctx context.Context, id int64) error
29
30	// DeleteOlderThan removes entries older than the given time.
31	DeleteOlderThan(ctx context.Context, before time.Time) error
32
33	// DeleteAll removes all history entries.
34	DeleteAll(ctx context.Context) error
35
36	// DeleteByDomain removes all history entries for a domain.
37	DeleteByDomain(ctx context.Context, domain string) error
38
39	// GetStats retrieves overall history statistics.
40	GetStats(ctx context.Context) (*entity.HistoryStats, error)
41
42	// GetDomainStats retrieves per-domain statistics.
43	GetDomainStats(ctx context.Context, limit int) ([]*entity.DomainStat, error)
44
45	// GetHourlyDistribution retrieves hourly visit distribution.
46	GetHourlyDistribution(ctx context.Context) ([]*entity.HourlyDistribution, error)
47
48	// GetDailyVisitCount retrieves daily visit counts for the given period.
49	GetDailyVisitCount(ctx context.Context, daysAgo string) ([]*entity.DailyVisitCount, error)
50}