webhooker/internal/logger/logger.go

// Package logger provides structured logging with dynamic level
// control.
package logger

import (
	"io"
	"log/slog"
	"os"
	"time"

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

//nolint:revive // LoggerParams is a standard fx naming convention.
type LoggerParams struct {
	fx.In

	Globals *globals.Globals
}

// Logger wraps slog with dynamic level control and structured
// output.
type Logger struct {
	logger   *slog.Logger
	levelVar *slog.LevelVar
	params   LoggerParams
}

// New creates a Logger that outputs text (TTY) or JSON (non-TTY)
// to stdout.
//
//nolint:revive // lc parameter is required by fx even if unused.
func New(lc fx.Lifecycle, params LoggerParams) (*Logger, error) {
	l := new(Logger)
	l.params = params

	// Use slog.LevelVar for dynamic log level changes
	l.levelVar = new(slog.LevelVar)
	l.levelVar.Set(slog.LevelInfo)

	// Determine if we're running in a terminal
	tty := false
	if fileInfo, _ := os.Stdout.Stat(); (fileInfo.Mode() & os.ModeCharDevice) != 0 {
		tty = true
	}

	//nolint:revive // groups param unused but required by slog ReplaceAttr signature.
	replaceAttr := func(_ []string, a slog.Attr) slog.Attr {
		// Always use UTC for timestamps
		if a.Key == slog.TimeKey {
			if t, ok := a.Value.Any().(time.Time); ok {
				return slog.Time(slog.TimeKey, t.UTC())
			}

			return a
		}

		return a
	}

	var handler slog.Handler

	opts := &slog.HandlerOptions{
		Level:       l.levelVar,
		ReplaceAttr: replaceAttr,
	}

	if tty {
		// Use text handler for terminal output (human-readable)
		handler = slog.NewTextHandler(os.Stdout, opts)
	} else {
		// Use JSON handler for production (machine-readable)
		handler = slog.NewJSONHandler(os.Stdout, opts)
	}

	l.logger = slog.New(handler)

	// Set as default logger
	slog.SetDefault(l.logger)

	return l, nil
}

// EnableDebugLogging switches the log level to debug.
func (l *Logger) EnableDebugLogging() {
	l.levelVar.Set(slog.LevelDebug)
	l.logger.Debug("debug logging enabled", "debug", true)
}

// Get returns the underlying slog.Logger.
func (l *Logger) Get() *slog.Logger {
	return l.logger
}

// Identify logs the application name and version at startup.
func (l *Logger) Identify() {
	l.logger.Info("starting",
		"appname", l.params.Globals.Appname,
		"version", l.params.Globals.Version,
	)
}

// Writer returns an io.Writer suitable for standard library
// loggers.
func (l *Logger) Writer() io.Writer {
	return os.Stdout
}