package segcore

/*
#cgo pkg-config: milvus_core

#include "common/type_c.h"

*/
import "C"

import "context"

// CSegment is the interface of a segcore segment.
// TODO: We should separate the interface of CGrowingSegment and CSealedSegment,
// Because they have different implementations, GrowingSegment will only be used at streamingnode, SealedSegment will only be used at querynode.
// But currently, we just use the same interface to represent them to keep compatible with querynode LocalSegment.
type CSegment interface {
	GrowingSegment

	SealedSegment
}

// GrowingSegment is the interface of a growing segment.
type GrowingSegment interface {
	basicSegmentMethodSet

	// Insert inserts data into the segment.
	Insert(ctx context.Context, request *InsertRequest) (*InsertResult, error)
}

// SealedSegment is the interface of a sealed segment.
type SealedSegment interface {
	basicSegmentMethodSet

	// LoadFieldData loads field data into the segment.
	LoadFieldData(ctx context.Context, request *LoadFieldDataRequest) (*LoadFieldDataResult, error)

	Reopen(ctx context.Context, request *ReopenRequest) error
}

// basicSegmentMethodSet is the basic method set of a segment.
type basicSegmentMethodSet interface {
	// ID returns the ID of the segment.
	ID() int64

	// RawPointer returns the raw pointer of the segment.
	// TODO: should be removed in future.
	RawPointer() CSegmentInterface

	// RawPointer returns the raw pointer of the segment.
	RowNum() int64

	// MemSize returns the memory size of the segment.
	MemSize() int64

	// HasRawData checks if the segment has raw data.
	HasRawData(fieldID int64) bool

	// HasFieldData checks if the segment has field data.
	HasFieldData(fieldID int64) bool

	// Search requests a search on the segment.
	// If searchReq.FilterOnly() is true, only executes the filter and returns valid_count (Stage 1 of two-stage search).
	Search(ctx context.Context, searchReq *SearchRequest) (*SearchResult, error)

	// Retrieve retrieves entities from the segment.
	Retrieve(ctx context.Context, plan *RetrievePlan) (*RetrieveResult, error)

	// RetrieveByOffsets retrieves entities from the segment by offsets.
	RetrieveByOffsets(ctx context.Context, plan *RetrievePlanWithOffsets) (*RetrieveResult, error)

	// Delete deletes data from the segment.
	Delete(ctx context.Context, request *DeleteRequest) (*DeleteResult, error)

	// Load invokes segment managed loading.
	Load(ctx context.Context) error

	// Release releases the segment.
	Release()
}
