otel

type Config struct {
	// ServiceName is the logical service identity exported on resources.
	ServiceName string
	// ServiceVersion is the service version exported on resources.
	ServiceVersion string
	// Environment is the deployment environment exported on resources.
	Environment string
	// ResourceAttributes are merged into the provider resource.
	ResourceAttributes []attribute.KeyValue
	// Propagators configures request propagation for traces and logs.
	Propagators propagation.TextMapPropagator
	// Traces configures trace provider bootstrap.
	Traces TraceConfig
	// Metrics configures metric provider bootstrap.
	Metrics MetricConfig
	// Logs configures log provider bootstrap.
	Logs LogConfig
}

type GRPCConfig struct {
	// TracerProvider overrides the trace provider used by otelgrpc.
	TracerProvider trace.TracerProvider
	// MeterProvider overrides the meter provider used by otelgrpc.
	MeterProvider metric.MeterProvider
	// Propagators overrides the propagators used by otelgrpc.
	Propagators propagation.TextMapPropagator
}

type HTTPAttributeSource interface {
	Attributes(*http.Request, HTTPRequestInfo) []attribute.KeyValue
}

type HTTPClientConfig struct {
	// ServiceName is the fallback operation name for client spans.
	ServiceName string
	// MetricMode selects otelhttp metrics or suppression for the client
	// transport.
	MetricMode HTTPMetricMode
	// TracerProvider overrides the trace provider used by otelhttp.
	TracerProvider trace.TracerProvider
	// MeterProvider overrides the meter provider used by otelhttp.
	MeterProvider metric.MeterProvider
	// Propagators overrides the propagators used by otelhttp.
	Propagators propagation.TextMapPropagator
}

type HTTPConfig struct {
	// ServiceName is the fallback operation name when no Loom route pattern is
	// available.
	ServiceName string
	// MetricMode selects otelhttp metrics, custom metrics, both, or neither.
	MetricMode HTTPMetricMode
	// TracerProvider overrides the trace provider used by otelhttp.
	TracerProvider trace.TracerProvider
	// MeterProvider overrides the meter provider used by otelhttp.
	MeterProvider metric.MeterProvider
	// Propagators overrides the propagators used by otelhttp.
	Propagators propagation.TextMapPropagator
	// AttributeSource returns post-response span attributes.
	AttributeSource HTTPAttributeSource
	// MetricsRecorder records custom post-response HTTP metrics.
	MetricsRecorder HTTPMetricsRecorder
}

type HTTPMetricMode string

type HTTPMetricsRecorder interface {
	Record(context.Context, *http.Request, HTTPRequestInfo)
}

type HTTPRequestInfo struct {
	// Method is the HTTP method.
	Method string
	// Route is the Loom route pattern or fallback method-path name.
	Route string
	// StatusCode is the final HTTP response status.
	StatusCode int
	// Duration is the total request duration observed by the middleware.
	Duration time.Duration
	// PathValues contains resolved path parameter values keyed by parameter
	// name when the route pattern contains named segments.
	PathValues map[string]string
	// Authenticated is reserved for consumers that want to project auth state
	// into the request info externally; the framework does not infer it.
	Authenticated bool
}

type LogConfig struct {
	// Enabled enables log provider bootstrap.
	Enabled bool
	// Endpoint is the OTLP HTTP endpoint host:port.
	Endpoint string
	// Insecure disables TLS for OTLP HTTP export.
	Insecure bool
	// Headers are sent on OTLP HTTP export requests.
	Headers map[string]string
}

type MetricConfig struct {
	// Enabled enables metric provider bootstrap.
	Enabled bool
	// Endpoint is the OTLP HTTP endpoint host:port.
	Endpoint string
	// Insecure disables TLS for OTLP HTTP export.
	Insecure bool
	// Headers are sent on OTLP HTTP export requests.
	Headers map[string]string
}

type Runtime struct {
	// TracerProvider is the initialized trace provider, if enabled.
	TracerProvider trace.TracerProvider
	// MeterProvider is the initialized metric provider, if enabled.
	MeterProvider metric.MeterProvider
	// LoggerProvider is the initialized log provider, if enabled.
	LoggerProvider log.LoggerProvider
	// Propagators is the propagator set used by this runtime.
	Propagators propagation.TextMapPropagator
	// Shutdown closes initialized providers in reverse initialization order.
	Shutdown func(context.Context) error
}

type TraceConfig struct {
	// Enabled enables trace provider bootstrap.
	Enabled bool
	// Endpoint is the OTLP HTTP endpoint host:port.
	Endpoint string
	// Insecure disables TLS for OTLP HTTP export.
	Insecure bool
	// Headers are sent on OTLP HTTP export requests.
	Headers map[string]string
	// SampleRatio controls TraceID-based head sampling.
	SampleRatio float64
}