codec

type Annotation interface {
	// Timestamp returns the timestamp of the annotation.
	Timestamp() time.Time
	// Value returns the value of the annotation.
	Value() string
	// Host returns the endpoint associated with the annotation.
	Host() Endpoint
}

type BinaryAnnotation interface {
	// Key returns the key of the binary annotation.
	Key() string
	// Value returns the value of the binary annotation.
	Value() string
	// Host returns the endpoint associated with the binary annotation.
	Host() Endpoint
}

type Decoder interface {
	// Decode decodes the given byte slice into a slice of Spans.
	Decode(octets []byte) ([]Span, error)
}

type Endpoint interface {
	// Host returns the host address of the endpoint.
	Host() string
	// Name returns the name of the service associated with the endpoint.
	Name() string
}

type Span interface {
	// Trace returns the trace ID of the span.
	Trace() (string, error)
	// SpanID returns the span ID.
	SpanID() (string, error)
	// Parent returns the parent span ID.
	Parent() (string, error)
	// Name returns the name of the span.
	Name() string
	// Annotations returns the annotations of the span.
	Annotations() []Annotation
	// BinaryAnnotations returns the binary annotations of the span.
	BinaryAnnotations() ([]BinaryAnnotation, error)
	// Timestamp returns the timestamp of the span.
	Timestamp() time.Time
	// Duration returns the duration of the span.
	Duration() time.Duration
}