beacon-server/internal/background/background.go

// Copyright 2026 Beacon Contributors
// SPDX-License-Identifier: AGPL-3.0-or-later

// Package background runs periodic maintenance tasks on independent schedules.
package background

import (
	"context"
	"log/slog"
	"time"
)

// Task is a named unit of work that runs on a fixed interval.
type Task struct {
	Name     string
	Interval time.Duration
	Run      func(ctx context.Context) error
}

// Scheduler runs a set of tasks on independent tickers.
type Scheduler struct {
	tasks []Task
}

// New creates a Scheduler with the given tasks.
func New(tasks []Task) *Scheduler {
	return &Scheduler{tasks: tasks}
}

// Start launches each task in its own goroutine. Blocks until ctx is cancelled.
func (s *Scheduler) Start(ctx context.Context) {
	for _, t := range s.tasks {
		go func() {
			ticker := time.NewTicker(t.Interval)
			defer ticker.Stop()
			for {
				select {
				case <-ticker.C:
					slog.Debug("task running", "component", "background", "task", t.Name)
					if err := t.Run(ctx); err != nil {
						slog.Error("task failed", "component", "background", "task", t.Name, "error", err)
					} else {
						slog.Debug("task complete", "component", "background", "task", t.Name)
					}
				case <-ctx.Done():
					return
				}
			}
		}()
	}
}