output

type AsyncConfig struct {
	// BufferSize is the size of the message buffer channel.
	BufferSize int
	// WaitTimeout is the maximum time to wait for all logs to be written during Flush.
	WaitTimeout time.Duration
	// ErrorHandler is called when an error occurs during async writing.
	ErrorHandler func(error)
	// OverflowStrategy controls what happens when the buffer is full.
	OverflowStrategy AsyncOverflowStrategy
	// DropHandler is invoked with the dropped payload when overflow strategy discards logs.
	DropHandler func([]byte)
	// DropPayloadHandler receives drop notifications with ownership semantics.
	DropPayloadHandler hyperlogger.DropPayloadHandler
	// MetricsReporter receives periodic metrics about the async writer state.
	MetricsReporter func(AsyncMetrics)
	// RetryEnabled enables retry attempts on write failures.
	RetryEnabled bool
	// MaxRetries defines the number of retry attempts after the initial write.
	MaxRetries int
	// RetryBackoff is the base backoff duration between retries.
	RetryBackoff time.Duration
	// RetryBackoffMultiplier scales the backoff after each retry.
	RetryBackoffMultiplier float64
	// RetryMaxBackoff caps the retry backoff duration.
	RetryMaxBackoff time.Duration
}

type AsyncMetrics struct {
	Enqueued   uint64
	Processed  uint64
	Dropped    uint64
	WriteError uint64
	Retried    uint64
	QueueDepth int
	Bypassed   uint64
}

type AsyncOverflowStrategy int

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

type BufferSize int

type ColorCode int

type ColorMode int

type CompressionAlgorithm string

type CompressionConfig struct {
	// Algorithm is the compression algorithm to use.
	Algorithm CompressionAlgorithm
	// Level is the compression level to use.
	Level int
	// DeleteOriginal determines if the original file should be deleted after compression.
	DeleteOriginal bool
	// Extension is the file extension to use for compressed files (default: .gz).
	Extension string
}

type CompressionLevel int

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

type FileConfig struct {
	// Path is the log file path
	Path string
	// MaxSize is the maximum size in bytes before rotation
	MaxSize int64
	// Compress determines if rotated files should be compressed
	Compress bool
	// FileMode sets the permissions for new log files
	FileMode os.FileMode
	// CompressionConfig provides detailed compression options
	CompressionConfig *CompressionConfig
	// RotationCallback is called after rotation with the path of the rotated file
	RotationCallback func(string)
	// ErrorHandler is called when errors occur during file operations
	ErrorHandler func(error)
}

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

type MultiWriter struct {
	Writers []Writer
	// contains filtered or unexported fields
}

type Style int

type WriteResult struct {
	Writer Writer // The writer instance
	Name   string // A descriptive name of the writer
	Bytes  int    // Number of bytes written
	Err    error  // Any error encountered during write
}

type Writer interface {
	// Write writes the given bytes to the underlying output.
	Write(p []byte) (n int, err error)
	// Sync ensures that all data has been written.
	Sync() error
	// Close closes the writer and releases any resources.
	Close() error
}