webhooker/internal/healthcheck/healthcheck.go

// Package healthcheck provides application health status reporting.
package healthcheck

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

	"go.uber.org/fx"
	"sneak.berlin/go/webhooker/internal/config"
	"sneak.berlin/go/webhooker/internal/database"
	"sneak.berlin/go/webhooker/internal/globals"
	"sneak.berlin/go/webhooker/internal/logger"
)

//nolint:revive // HealthcheckParams is a standard fx naming convention.
type HealthcheckParams struct {
	fx.In
	Globals  *globals.Globals
	Config   *config.Config
	Logger   *logger.Logger
	Database *database.Database
}

// Healthcheck tracks application uptime and reports health status.
type Healthcheck struct {
	StartupTime time.Time
	log         *slog.Logger
	params      *HealthcheckParams
}

// New creates a Healthcheck that records the startup time on fx start.
func New(lc fx.Lifecycle, params HealthcheckParams) (*Healthcheck, error) {
	s := new(Healthcheck)
	s.params = &params
	s.log = params.Logger.Get()

	lc.Append(fx.Hook{
		//nolint:revive // ctx unused but required by fx.
		OnStart: func(_ context.Context) error {
			s.StartupTime = time.Now()
			return nil
		},
		OnStop: func(_ context.Context) error {
			return nil
		},
	})
	return s, nil
}

//nolint:revive // HealthcheckResponse is a clear, descriptive name.
type HealthcheckResponse struct {
	Status        string `json:"status"`
	Now           string `json:"now"`
	UptimeSeconds int64  `json:"uptime_seconds"`
	UptimeHuman   string `json:"uptime_human"`
	Version       string `json:"version"`
	Appname       string `json:"appname"`
	Maintenance   bool   `json:"maintenance_mode"`
}

func (s *Healthcheck) uptime() time.Duration {
	return time.Since(s.StartupTime)
}

// Healthcheck returns the current health status of the application.
func (s *Healthcheck) Healthcheck() *HealthcheckResponse {
	resp := &HealthcheckResponse{
		Status:        "ok",
		Now:           time.Now().UTC().Format(time.RFC3339Nano),
		UptimeSeconds: int64(s.uptime().Seconds()),
		UptimeHuman:   s.uptime().String(),
		Appname:       s.params.Globals.Appname,
		Version:       s.params.Globals.Version,
		Maintenance:   s.params.Config.MaintenanceMode,
	}
	return resp
}