package kspec

import (
	"gitp78su.ipnodns.ru/svi/kern/v4/lev0/defs"
	"gitp78su.ipnodns.ru/svi/kern/v4/lev0/quark"
)

// ILogMsg -- сообщение лога.
type ILogMsg interface {
	// CreateAt -- когда создано
	CreateAt() ITime
	// Level -- уровень сообщения
	Level() *quark.QStr[quark.Mut]
	// Msg -- текст сообщения
	Msg() *quark.QStr[quark.Fix]
	// String -- форматированная строка
	String() string
}

// ILogBus -- публикует в топики логи.
type ILogBus interface {
	// DebugAdd -- добавляет топик для отладочного сообщения
	DebugAdd(topic defs.Topic, bus IBusClient) IResult[bool]
}

// ILogBuf -- буферизованный лог для диагностики.
//
//	Буфер для Error -- отдельный.
type ILogBuf interface {
	// Debug -- сообщение отладки
	Debug(fMsg string, args ...any)
	// LogBus -- возвращает объект публикации в шину
	// LogBus()ILogBus
	// Info -- информационные сообщения
	Info(fMsg string, args ...any)
	// Warn -- предупреждающие сообщения
	Warn(fMsg string, args ...any)
	// Err -- сообщения об ошибках
	Err(fMsg string, args ...any)
	// Get -- возвращает сообщение по номеру (0..99)
	Get(num int) ILogMsg
	// GetErr -- возвращает сообщение ошибки по номеру (0..99)
	GetErr(num int) ILogMsg
	// Size -- возвращает размер лога
	Size() int
	// IsTerm -- возвращает признак логирования в терминал
	IsTerm() ISafeBool
}