analytics

type AnalyticsBackgroundService struct {
	// contains filtered or unexported fields
}

type AnalyticsPeriod int32

type AnalyticsPeriods struct {
	Hour  AnalyticsPeriod
	Day   AnalyticsPeriod
	Week  AnalyticsPeriod
	Month AnalyticsPeriod
	Year  AnalyticsPeriod
}

type BookViewEntry struct {
	BookID int64
	Views  int64
}

type Counters interface {
	Namespace(name string) CountersNamespace
}

type CountersNamespace interface {
	Incr(ctx context.Context, key, uniqueId string, incrBy int64, expire time.Duration) error
	Get(ctx context.Context, key string) (int64, error)
	Delete(ctx context.Context, key string) error
	PullPendingCounters(ctx context.Context, delete bool) (map[string]int64, error)
}

type RedisCounters struct {
	// contains filtered or unexported fields
}

type ViewMetadata struct {
	UserID uuid.NullUUID
	IP     net.IP
}

type Views struct {
	Total int64 `json:"total"`
	Year  int64 `json:"year"`
	Month int64 `json:"month"`
	Week  int64 `json:"week"`
	Day   int64 `json:"day"`
	Hour  int64 `json:"hour"`
}

type ViewsService interface {
	IncrBookView(ctx context.Context, bookID int64, meta ViewMetadata) error
	IncrChapterView(ctx context.Context, bookID, chapterID int64, meta ViewMetadata) error
	GetBookViews(ctx context.Context, bookID int64) (Views, error)
	GetBooksViews(ctx context.Context, bookIDs []int64) (map[int64]Views, error)
	GetMostViewedBooks(ctx context.Context, period AnalyticsPeriod) ([]BookViewEntry, error)
	CommitPendingViewsToDB(ctx context.Context)
}