logwisp/internal/sink/console/console.go

package console

import (
	"context"
	"fmt"
	"io"
	"os"
	"sync"
	"sync/atomic"
	"time"

	"github.com/lixenwraith/logwisp/internal/config"
	"github.com/lixenwraith/logwisp/internal/core"
	"github.com/lixenwraith/logwisp/internal/logline"
	"github.com/lixenwraith/logwisp/internal/plugin"
	"github.com/lixenwraith/logwisp/internal/session"
	"github.com/lixenwraith/logwisp/internal/sink"

	"github.com/lixenwraith/color"
	"github.com/lixenwraith/log"
	"github.com/lixenwraith/terminal/inline"
	"golang.org/x/term"
)

// init registers the component in plugin factory
func init() {
	if err := plugin.RegisterSink("console", NewConsoleSinkPlugin); err != nil {
		panic(fmt.Sprintf("failed to register console sink: %v", err))
	}
}

// ConsoleSink writes formatted entries to stdout or stderr
type ConsoleSink struct {
	// Plugin identity and session management
	id      string
	proxy   *session.Proxy
	session *session.Session

	// Configuration
	config  *config.ConsoleSinkOptions
	escape  bool
	painter *inline.Printer // paints level names; nil when color is off

	// Application
	input  chan core.TransportEvent
	output io.Writer
	logger *log.Logger // application logger

	// Runtime
	done      chan struct{}
	exited    chan struct{}
	started   atomic.Bool
	stopOnce  sync.Once
	startTime time.Time

	// Statistics
	totalProcessed atomic.Uint64
	lastProcessed  atomic.Value // time.Time
}

// levelStyles colors the levels in ANSI 16, so the terminal's theme picks the
// shades and a text console renders them; cyan, not blue, stays readable on black
var levelStyles = map[string]inline.Style{
	"ERROR": inline.FgANSI(color.ANSIRed).Bold(),
	"WARN":  inline.FgANSI(color.ANSIYellow),
	"INFO":  inline.FgANSI(color.ANSIGreen),
	"DEBUG": inline.FgANSI(color.ANSICyan),
	"TRACE": inline.FgANSI(color.ANSIBrightBlack),
}

// NewConsoleSinkPlugin creates a console sink through plugin factory
func NewConsoleSinkPlugin(
	id string,
	configMap map[string]any,
	logger *log.Logger,
	proxy *session.Proxy,
) (sink.Sink, error) {
	opts, err := config.Decode[config.ConsoleSinkOptions]("sink", "console", configMap)
	if err != nil {
		return nil, err
	}

	output := Stream(opts.Target)

	// inline decides auto: a terminal, NO_COLOR unset, TERM not dumb. Paint
	// returns its text unchanged exactly when color is off.
	printer := inline.New(output)
	if opts.Color != "auto" {
		printer.SetColor(opts.Color == "always")
	}
	var painter *inline.Printer
	if printer.Paint("x", inline.Style{}) != "x" {
		painter = printer
	}

	// Create and return plugin instance
	cs := &ConsoleSink{
		id:      id,
		proxy:   proxy,
		config:  opts,
		escape:  opts.Escape == "always" || opts.Escape == "auto" && term.IsTerminal(int(output.Fd())),
		painter: painter,
		input:   make(chan core.TransportEvent, opts.BufferSize),
		output:  output,
		done:    make(chan struct{}),
		exited:  make(chan struct{}),
		logger:  logger,
	}
	cs.lastProcessed.Store(time.Time{})

	// Create session for output
	cs.session = proxy.CreateSession(
		fmt.Sprintf("console:%s", opts.Target),
		map[string]any{
			"instance_id": id,
			"type":        "console",
			"target":      opts.Target,
		},
	)

	cs.logger.Info("msg", "Console sink initialized",
		"component", "console_sink",
		"instance_id", id,
		"target", opts.Target,
		"escape", cs.escape,
		"color", painter != nil,
	)

	return cs, nil
}

// Stream is the stream a console sink with target writes
func Stream(target string) *os.File {
	if target == "stderr" {
		return os.Stderr
	}
	return os.Stdout
}

// Capabilities returns supported capabilities
func (cs *ConsoleSink) Capabilities() []core.Capability {
	return []core.Capability{
		core.CapSessionAware, // Single output session
		core.CapBackpressure, // a slow reader slows the pipeline, as with any filter
	}
}

// Input returns the channel for sending transport events
func (cs *ConsoleSink) Input() chan<- core.TransportEvent {
	return cs.input
}

// Start begins the processing loop
func (cs *ConsoleSink) Start(ctx context.Context) error {
	cs.startTime = time.Now()
	cs.started.Store(true)
	go cs.processLoop(ctx)
	cs.logger.Info("msg", "Console sink started",
		"component", "console_sink",
		"target", cs.config.Target)
	return nil
}

// Stop writes what is queued, then returns
func (cs *ConsoleSink) Stop() {
	cs.logger.Info("msg", "Stopping console sink", "target", cs.config.Target)

	// Remove session
	if cs.session != nil {
		cs.proxy.RemoveSession(cs.session.ID)
	}

	cs.stopOnce.Do(func() { close(cs.done) })
	if cs.started.Load() {
		<-cs.exited
	}

	cs.logger.Info("msg", "Console sink stopped",
		"instance_id", cs.id,
		"target", cs.config.Target,
	)
}

// GetStats returns sink statistics
func (cs *ConsoleSink) GetStats() sink.SinkStats {
	lastProc, _ := cs.lastProcessed.Load().(time.Time)

	return sink.SinkStats{
		ID:             cs.id,
		Type:           "console",
		TotalProcessed: cs.totalProcessed.Load(),
		StartTime:      cs.startTime,
		LastProcessed:  lastProc,
		Details: map[string]any{
			"target":      cs.config.Target,
			"buffer_size": cs.config.BufferSize,
			"escape":      cs.escape,
			"color":       cs.painter != nil,
		},
	}
}

// processLoop writes transport events until stopped, then what is queued
func (cs *ConsoleSink) processLoop(ctx context.Context) {
	defer close(cs.exited)
	for {
		select {
		case event := <-cs.input:
			cs.write(event)
		case <-ctx.Done():
			cs.drain()
			return
		case <-cs.done:
			cs.drain()
			return
		}
	}
}

func (cs *ConsoleSink) drain() {
	for {
		select {
		case event := <-cs.input:
			cs.write(event)
		default:
			return
		}
	}
}

func (cs *ConsoleSink) write(event core.TransportEvent) {
	payload := event.Payload
	if cs.escape {
		payload = logline.EscapeControls(payload)
	}
	if cs.painter != nil {
		payload = paintLevel(cs.painter, payload, event.Entry.Level)
	}
	if _, err := cs.output.Write(payload); err != nil {
		cs.logger.Error("msg", "Failed to write to console",
			"component", "console_sink",
			"target", cs.config.Target,
			"error", err)
		return
	}
	cs.totalProcessed.Add(1)
	cs.lastProcessed.Store(time.Now())
}

// paintLevel colors the first word naming the entry's level, after escaping:
// the escape sequences are the sink's own
func paintLevel(p *inline.Printer, payload []byte, level string) []byte {
	level, _, _ = core.LevelWord(level, "")
	style, ok := levelStyles[level]
	if !ok {
		return payload
	}
	if _, i, j := core.LevelWord(payload, level); i < j {
		out := make([]byte, 0, len(payload)+16)
		out = append(out, payload[:i]...)
		out = append(out, p.Paint(string(payload[i:j]), style)...)
		return append(out, payload[j:]...)
	}
	return payload
}