adapter

type Logger interface {
	Info(msg string, fields map[string]interface{})  // Info logs an informational message with optional fields.
	Error(msg string, fields map[string]interface{}) // Error logs an error message with optional fields.
	Debug(msg string, fields map[string]interface{}) // Debug logs a debug message with optional fields.
	WithSpanContext(spanContext SpanContext) Logger  // WithSpanContext returns a logger with span context for correlation.
}

type NoOpLogger struct{}

type NoOpSpan struct{}

type NoOpSpanAttribute struct{}

type NoOpSpanContext struct{}

type NoOpTracer struct{}

type Semaphore interface {
	Size() int // Size returns the size of the semaphore.
	Acquire()  // Acquire acquires a semaphore permit, blocking if necessary.
	Release()  // Release releases a semaphore permit.
}

type Span interface {
	End()                                         // End finishes the span.
	AddEvent(name string, attrs ...SpanAttribute) // AddEvent adds an event to the span.
	SetAttributes(attrs ...SpanAttribute)         // SetAttributes sets attributes on the span.
	SpanContext() SpanContext                     // SpanContext returns the span context for propagation.
}

type SpanAttribute interface{}

type SpanContext interface {
	TraceID() string // TraceID returns the trace ID.
	SpanID() string  // SpanID returns the span ID.
}

type Tracer interface {
	StartSpan(ctx context.Context, name string) (context.Context, Span)                    // StartSpan starts a new span with the given name. Returns a context with the span and the span itself.
	NewSpanFromSpan(ctx context.Context, name string, parent Span) (context.Context, Span) // NewSpanFromSpan creates a new span from an existing span (child span). Returns a context with the new span and the span itself.
}