type CompilationStats struct {
	FromCache bool
	Duration  time.Duration
	CPUTime   time.Duration
}

type OperationStats struct {
	Rows  uint64
	Bytes uint64
}

type Phase struct {
	Duration       time.Duration
	TableAccess    []TableAccess
	CPUTime        time.Duration
	AffectedShards uint64
	LiteralPhase   bool
}

type QueryPhase interface {
	// NextTableAccess returns next accessed table within query execution phase.
	// If ok flag is false, then there are no more accessed tables and t is invalid.
	NextTableAccess() (t *TableAccess, ok bool)
	// TableAccess is a range iterator over query execution phase's accessed tables.
	TableAccess() xiter.Seq[*TableAccess]
	Duration() time.Duration
	CPUTime() time.Duration
	AffectedShards() uint64
	IsLiteralPhase() bool
}

type QueryStats interface {
	ProcessCPUTime() time.Duration
	Compilation() (c *CompilationStats)
	QueryPlan() string
	QueryAST() string
	TotalCPUTime() time.Duration
	TotalDuration() time.Duration

	// NextPhase returns next execution phase within query.
	// If ok flag is false, then there are no more phases and p is invalid.
	NextPhase() (p QueryPhase, ok bool)

	// QueryPhases is a range iterator over query phases.
	QueryPhases() xiter.Seq[QueryPhase]
}

type TableAccess struct {
	Name            string
	Reads           OperationStats
	Updates         OperationStats
	Deletes         OperationStats
	PartitionsCount uint64
}