cachepreload

type FolderPreloadTask struct {
	FolderID          int64
	SessionID         string
	ETagVersion       string
	PreferredEncoding string // from triggering request's Accept-Encoding (normalized)
	CacheableRoutes   []string
	DBRoPool          *dbconnpool.DbSQLConnPool
	TaskTracker       *TaskTracker
	Scheduler         *scheduler.Scheduler
	RequestConfig     InternalRequestConfig
	Metrics           *PreloadMetrics
	GetQueries        func(*dbconnpool.CpConn) interfaces.HandlerQueries
}

type InternalRequestConfig struct {
	// Handler is the HTTP handler wrapped with full middleware chain
	// (cache middleware, compression middleware, etc.)
	Handler http.Handler

	// ETagVersion for cache key query string
	ETagVersion string
}

type PreloadConfig struct {
	TaskTracker    *TaskTracker
	SessionTracker *SessionTracker
	DBRoPool       *dbconnpool.DbSQLConnPool
	GetQueries     func(*dbconnpool.CpConn) interfaces.HandlerQueries
	GetHandler     func() http.Handler // Lazy: full middleware chain
	GetETagVersion func() string
	Metrics        *PreloadMetrics
}

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

type PreloadMetrics struct {
	TasksScheduled atomic.Int64
	TasksCompleted atomic.Int64
	TasksFailed    atomic.Int64
	TasksCancelled atomic.Int64
	TasksSkipped   atomic.Int64 // Due to deduplication or existing cache
	TotalDuration  atomic.Int64 // Nanoseconds
	// contains filtered or unexported fields
}

type PreloadMetricsSnapshot struct {
	TasksScheduled int64
	TasksCompleted int64
	TasksFailed    int64
	TasksCancelled int64
	TasksSkipped   int64
	TotalDuration  time.Duration
}

type PreloadService interface {
	// ScheduleFolderPreload schedules background cache preload for a folder.
	// acceptEncoding is the triggering request's Accept-Encoding header; its
	// normalized value (br/gzip/identity) is used for preload keys so they match
	// that client's subsequent requests. sessionID is used for task cancellation
	// when user navigates away. Non-blocking (fire-and-forget).
	ScheduleFolderPreload(ctx context.Context, folderID int64, sessionID string, acceptEncoding string)

	// SetEnabled dynamically enables or disables cache preloading.
	// When disabled, all pending tasks are cancelled.
	SetEnabled(enabled bool)

	// IsEnabled returns whether cache preloading is currently enabled.
	IsEnabled() bool
}

type PreloadTask struct {
	CacheKey      string
	Path          string
	HXTarget      string // optional; when set, request uses HX-Request/HX-Target and Encoding
	Encoding      string // optional; used with HXTarget (e.g. "gzip")
	TaskTracker   *TaskTracker
	RequestConfig InternalRequestConfig
	Metrics       *PreloadMetrics
}

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

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