package sink

import (
	"context"

	"github.com/topfans/backend/services/statisticService/model"
)

// EventSink 事件 sink 接口
// 本期实现: ChannelEventSink（推到 channel，由 event_flusher 消费）
// 未来扩展: KafkaEventSink / ClickHouseDualWriteSink / SamplingEventSink
type EventSink interface {
	// Submit 提交单个事件；非阻塞，channel 满时返回 ErrChannelFull
	Submit(ctx context.Context, e *model.Event) error
	// SubmitBatch 批量提交；任一失败即停止
	SubmitBatch(ctx context.Context, es []*model.Event) error
	// Close 关闭 sink
	Close() error
}