logger

type AdapterConfig struct {
	// Type 适配器类型: zap, zerolog, logrus, slog, default
	Type string `json:"type" yaml:"type"`

	// Zap Zap 特定配置
	Zap *ZapConfig `json:"zap,omitempty" yaml:"zap,omitempty"`

	// Zerolog Zerolog 特定配置
	Zerolog *ZerologConfig `json:"zerolog,omitempty" yaml:"zerolog,omitempty"`

	// Logrus Logrus 特定配置
	Logrus *LogrusConfig `json:"logrus,omitempty" yaml:"logrus,omitempty"`
}

type AdapterFactory func(opts ...Option) Logger

type AsyncConfig struct {
	// BufferSize 缓冲区大小（队列长度）
	BufferSize int
	// FlushInterval 刷新间隔（定时批量写入）
	FlushInterval time.Duration
	// OnDropped 队列满时回调（用于监控丢弃的日志）
	OnDropped func(level Level, msg string)
	// DropPolicy 队列满时策略
	// - "drop": 丢弃新日志（默认）
	// - "block": 阻塞等待
	// - "sample": 降级采样（每10条记录1条）
	DropPolicy string
}

type AsyncPluginConfig struct {
	// Enabled 是否启用
	Enabled bool `json:"enabled" yaml:"enabled"`

	// BufferSize 缓冲区大小
	BufferSize int `json:"bufferSize" yaml:"bufferSize"`

	// FlushInterval 刷新间隔
	FlushInterval time.Duration `json:"flushInterval" yaml:"flushInterval"`

	// DropOnFull 缓冲区满时丢弃日志（否则阻塞）
	DropOnFull bool `json:"dropOnFull" yaml:"dropOnFull"`
}

type CallerHook struct {
	// contains filtered or unexported fields
}

type Config struct {
	// Core 核心配置
	Core CoreConfig `json:"core" yaml:"core"`

	// Adapter 适配器配置
	Adapter AdapterConfig `json:"adapter" yaml:"adapter"`

	// Output 输出配置
	Output OutputConfig `json:"output" yaml:"output"`

	// Plugins 插件配置
	Plugins PluginsConfig `json:"plugins" yaml:"plugins"`
}

type ConsoleConfig struct {
	// Enabled 是否启用
	Enabled bool `json:"enabled" yaml:"enabled"`

	// Color 是否启用彩色输出
	Color bool `json:"color" yaml:"color"`

	// Level 控制台日志级别（可与文件不同）
	Level string `json:"level" yaml:"level"`
}

type ConsoleFormatter struct {
	TimestampFormat string
	ForceColors     bool
}

type CoreConfig struct {
	// Level 日志级别: trace, debug, info, warn, error, fatal
	Level string `json:"level" yaml:"level"`

	// EnableCaller 是否启用调用者信息（文件名:行号）
	EnableCaller bool `json:"enableCaller" yaml:"enableCaller"`

	// CallerSkip 跳过的调用栈层数
	CallerSkip int `json:"callerSkip" yaml:"callerSkip"`

	// EnableStacktrace 是否启用堆栈跟踪（Error 级别以上）
	EnableStacktrace bool `json:"enableStacktrace" yaml:"enableStacktrace"`

	// Name Logger 名称（用于区分不同模块）
	Name string `json:"name" yaml:"name"`

	// Fields 默认字段（所有日志都会包含）
	Fields map[string]interface{} `json:"fields" yaml:"fields"`
}

type ElasticsearchHook struct {
	// contains filtered or unexported fields
}

type Field struct {
	Key    string
	Type   FieldType
	Int64  int64       // 存储 int、bool、duration、time
	String string      // 存储 string
	Any    interface{} // 存储 error、复杂类型
}

type FieldType uint8

type FileConfig struct {
	// Enabled 是否启用
	Enabled bool `json:"enabled" yaml:"enabled"`

	// Path 日志文件路径
	Path string `json:"path" yaml:"path"`

	// Level 文件日志级别
	Level string `json:"level" yaml:"level"`

	// MaxSize 单个文件最大大小（MB）
	MaxSize int `json:"maxSize" yaml:"maxSize"`

	// MaxAge 文件最大保留天数
	MaxAge int `json:"maxAge" yaml:"maxAge"`

	// MaxBackups 最大备份数量
	MaxBackups int `json:"maxBackups" yaml:"maxBackups"`

	// Compress 是否压缩旧日志
	Compress bool `json:"compress" yaml:"compress"`

	// LocalTime 使用本地时间（而非 UTC）
	LocalTime bool `json:"localTime" yaml:"localTime"`
}

type Helper struct {
	Logger
	// contains filtered or unexported fields
}

type LegacyConfig struct {
	Path      string `json:"path" yaml:"path"`
	Stdout    string `json:"stdout" yaml:"stdout"`
	Level     string `json:"level" yaml:"level"`
	EnabledDB bool   `json:"enableddb" yaml:"enableddb"`
}

type Level int8

type Logger interface {
	// Init initialises options
	Init(options ...Option) error
	// Options The Logger options
	Options() Options
	// Fields set fields to always be logged
	Fields(fields map[string]interface{}) Logger
	// Log writes a log entry
	Log(level Level, v ...interface{})
	// Logf writes a formatted log entry
	Logf(level Level, format string, v ...interface{})
	// String returns the name of logger
	String() string
}

type LogrusConfig struct {
	// Formatter 格式化器: json, text
	Formatter string `json:"formatter" yaml:"formatter"`
}

type MetricsHook struct {
	// contains filtered or unexported fields
}

type MetricsPluginConfig struct {
	// Enabled 是否启用
	Enabled bool `json:"enabled" yaml:"enabled"`

	// Namespace Prometheus Namespace
	Namespace string `json:"namespace" yaml:"namespace"`

	// Subsystem Prometheus Subsystem
	Subsystem string `json:"subsystem" yaml:"subsystem"`
}

type NetworkConfig struct {
	// Type 类型: kafka, elasticsearch, fluentd, syslog
	Type string `json:"type" yaml:"type"`

	// Endpoints 端点列表
	Endpoints []string `json:"endpoints" yaml:"endpoints"`

	// Topic Kafka Topic
	Topic string `json:"topic" yaml:"topic"`

	// Index Elasticsearch Index
	Index string `json:"index" yaml:"index"`

	// BufferSize 缓冲区大小
	BufferSize int `json:"bufferSize" yaml:"bufferSize"`

	// FlushInterval 刷新间隔
	FlushInterval time.Duration `json:"flushInterval" yaml:"flushInterval"`
}

type Option func(*Options)

type Options struct {
	// Level is the logging level the logger should log at. default is `InfoLevel`
	// Level 是日志记录器的日志级别，默认是 `InfoLevel`
	Level Level
	// Fields are fields to always be logged
	// Fields 是始终要记录的字段
	Fields map[string]interface{}
	// Out is the output writer for the logger. default is `os.Stderr`
	// Out 是日志记录器的输出写入器，默认是 `os.Stderr`
	Out io.Writer
	// CallerSkipCount is the frame count to skip for file:line info
	// CallerSkipCount 是跳过的帧数，用于文件:行信息
	CallerSkipCount int
	// Context is alternative options
	// Context 是替代选项
	Context context.Context
	// Name is the logger name
	// Name 是日志记录器的名称
	Name string
	// Path is the log file path (optional)
	// Path 是日志文件路径（可选）
	Path string
	// Stdout enables console output
	// Stdout 启用控制台输出
	Stdout bool

	// --- 日志轮转配置 ---
	// MaxSize 单个文件最大大小（MB），默认 100
	MaxSize int
	// MaxAge 文件最大保留天数，默认 30
	MaxAge int
	// MaxBackups 最大备份数量，默认 7
	MaxBackups int
	// Compress 是否压缩旧日志，默认 true
	Compress bool
	// LocalTime 使用本地时间（而非 UTC），默认 true
	LocalTime bool
}

type OutputConfig struct {
	// Console 控制台输出配置
	Console *ConsoleConfig `json:"console,omitempty" yaml:"console,omitempty"`

	// File 文件输出配置
	File *FileConfig `json:"file,omitempty" yaml:"file,omitempty"`

	// Network 网络输出配置（Kafka、Elasticsearch 等）
	Network *NetworkConfig `json:"network,omitempty" yaml:"network,omitempty"`

	// Format 输出格式: json, text, console
	Format string `json:"format" yaml:"format"`

	// Encoding 编码格式: json, console, text
	Encoding string `json:"encoding" yaml:"encoding"`
}

type PluginsConfig struct {
	// Sampling 采样配置
	Sampling *SamplingPluginConfig `json:"sampling,omitempty" yaml:"sampling,omitempty"`

	// Metrics 监控配置
	Metrics *MetricsPluginConfig `json:"metrics,omitempty" yaml:"metrics,omitempty"`

	// Tracing 链路追踪配置
	Tracing *TracingPluginConfig `json:"tracing,omitempty" yaml:"tracing,omitempty"`

	// Sanitize 脱敏配置
	Sanitize *SanitizePluginConfig `json:"sanitize,omitempty" yaml:"sanitize,omitempty"`

	// Async 异步写入配置
	Async *AsyncPluginConfig `json:"async,omitempty" yaml:"async,omitempty"`
}

type SamplingConfig struct {
	// Initial 每个 Tick 周期内前 N 条日志必须记录
	Initial int
	// Thereafter 超过 Initial 后，每 M 条记录 1 条
	Thereafter int
	// Tick 采样周期（例如：每秒、每分钟重置计数器）
	Tick time.Duration
}

type SamplingPluginConfig struct {
	// Enabled 是否启用
	Enabled bool `json:"enabled" yaml:"enabled"`

	// Initial 每个周期前 N 条必记录
	Initial int `json:"initial" yaml:"initial"`

	// Thereafter 之后每 M 条记录 1 条
	Thereafter int `json:"thereafter" yaml:"thereafter"`

	// Tick 采样周期
	Tick time.Duration `json:"tick" yaml:"tick"`

	// ExcludeLevels 排除的日志级别（Error 级别不采样）
	ExcludeLevels []string `json:"excludeLevels" yaml:"excludeLevels"`
}

type SanitizePluginConfig struct {
	// Enabled 是否启用
	Enabled bool `json:"enabled" yaml:"enabled"`

	// Rules 脱敏规则
	Rules []SanitizeRule `json:"rules" yaml:"rules"`
}

type SanitizeRule struct {
	// FieldPattern 字段名正则（如 password|token|secret）
	FieldPattern string `json:"fieldPattern" yaml:"fieldPattern"`

	// Strategy 脱敏策略: mask_all, mask_partial, hash
	Strategy string `json:"strategy" yaml:"strategy"`

	// MaskChar 掩码字符
	MaskChar string `json:"maskChar" yaml:"maskChar"`
}

type SanitizerConfig struct {
	// Enabled 是否启用脱敏
	Enabled bool
	// Rules 脱敏规则列表
	Rules []SanitizerRule
	// CustomMatcher 自定义字段匹配函数（可选）
	CustomMatcher func(fieldName string) *SanitizerRule
}

type SanitizerRule struct {
	// FieldPattern 字段名匹配（精确匹配或后缀匹配）
	// 例如："phone", "idcard", "*_token"（*表示后缀匹配）
	FieldPattern string
	// Strategy 脱敏策略
	// - "mask": 掩码（保留前后，中间替换为 *）
	// - "hash": SHA256 哈希
	// - "remove": 完全删除字段
	Strategy string
	// MaskChar 掩码字符（默认 "*"）
	MaskChar string
	// KeepPrefix 保留前缀长度（mask 策略）
	KeepPrefix int
	// KeepSuffix 保留后缀长度（mask 策略）
	KeepSuffix int
}

type SentryHook struct {
	// contains filtered or unexported fields
}

type TracingPluginConfig struct {
	// Enabled 是否启用
	Enabled bool `json:"enabled" yaml:"enabled"`

	// Provider 追踪提供商: opentelemetry, jaeger, zipkin
	Provider string `json:"provider" yaml:"provider"`

	// AutoExtract 自动从 context 提取 trace_id/span_id
	AutoExtract bool `json:"autoExtract" yaml:"autoExtract"`
}

type ZapConfig struct {
	// Development 开发模式（更友好的输出格式）
	Development bool `json:"development" yaml:"development"`

	// DisableCaller 禁用调用者信息
	DisableCaller bool `json:"disableCaller" yaml:"disableCaller"`

	// DisableStacktrace 禁用堆栈跟踪
	DisableStacktrace bool `json:"disableStacktrace" yaml:"disableStacktrace"`

	// Sampling 采样配置（Zap 内置）
	Sampling *ZapSamplingConfig `json:"sampling,omitempty" yaml:"sampling,omitempty"`
}

type ZapSamplingConfig struct {
	Initial    int `json:"initial" yaml:"initial"`
	Thereafter int `json:"thereafter" yaml:"thereafter"`
}

type ZerologConfig struct {
	// TimeFormat 时间格式: unix, unixms, rfc3339
	TimeFormat string `json:"timeFormat" yaml:"timeFormat"`
}