observability

type Config struct {
	// ServiceName is the name of the service using the SDK
	ServiceName string

	// ServiceVersion is the version of the service using the SDK
	ServiceVersion string

	// SDKVersion is the version of the Midaz Go SDK
	SDKVersion string

	// Environment is the environment where the service is running
	Environment string

	// CollectorEndpoint is the endpoint for the OpenTelemetry collector
	CollectorEndpoint string

	// LogLevel is the minimum log level to record
	LogLevel LogLevel

	// LogOutput is where to write logs (defaults to os.Stderr)
	LogOutput io.Writer

	// TraceSampleRate is the sampling rate for traces (0.0 to 1.0)
	TraceSampleRate float64

	// EnabledComponents controls which observability components are enabled
	EnabledComponents EnabledComponents

	// Attributes are additional attributes to add to all telemetry
	Attributes []attribute.KeyValue

	// Propagators for context propagation
	Propagators []propagation.TextMapPropagator

	// Headers to extract for trace context propagation
	PropagationHeaders []string
}

type ContextKey string

type EnabledComponents struct {
	Tracing bool
	Metrics bool
	Logging bool
}

type HTTPOption func(*httpMiddleware) error

type LogLevel int

type Logger interface {
	// Debug logs a message at debug level
	Debug(args ...interface{})
	// Debugf logs a formatted message at debug level
	Debugf(format string, args ...interface{})
	// Info logs a message at info level
	Info(args ...interface{})
	// Infof logs a formatted message at info level
	Infof(format string, args ...interface{})
	// Warn logs a message at warn level
	Warn(args ...interface{})
	// Warnf logs a formatted message at warn level
	Warnf(format string, args ...interface{})
	// Error logs a message at error level
	Error(args ...interface{})
	// Errorf logs a formatted message at error level
	Errorf(format string, args ...interface{})
	// Fatal logs a message at fatal level
	Fatal(args ...interface{})
	// Fatalf logs a formatted message at fatal level
	Fatalf(format string, args ...interface{})
	// With returns a logger with added structured fields
	With(fields map[string]interface{}) Logger
	// WithContext returns a logger with context information (trace ID, etc.)
	WithContext(ctx trace.SpanContext) Logger
	// WithSpan returns a logger with span information (span ID, trace ID, etc.)
	WithSpan(span trace.Span) Logger
}

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

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

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

type NoopLogger struct{}

type Option func(*Config) error

type Provider interface {
	// Tracer returns a tracer for creating spans
	Tracer() trace.Tracer

	// Meter returns a meter for creating metrics
	Meter() metric.Meter

	// Logger returns a logger
	Logger() Logger

	// Shutdown gracefully shuts down the provider
	Shutdown(ctx context.Context) error

	// IsEnabled returns true if observability is enabled
	IsEnabled() bool
}

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