tiledbgnss

type ConsolidationMode string

type DeleteDecision struct {
	Fragment FragmentDetail `json:"fragment"`
	Action   string         `json:"action"` // "keep" or "delete"
	Reason   string         `json:"reason"`
}

type DeleteGroupResult struct {
	Group     OverlapGroup     `json:"group"`
	Decisions []DeleteDecision `json:"decisions"`
}

type DeleteResult struct {
	Groups           []DeleteGroupResult `json:"groups"`
	TotalKeep        int                 `json:"total_keep"`
	TotalDelete      int                 `json:"total_delete"`
	ReclaimableBytes uint64              `json:"reclaimable_bytes"`
}

type FragmentConsolidationConfig struct {
	// Step parameters
	Steps        uint32
	StepMinFrags uint32
	StepMaxFrags uint32

	// Memory budget (zero = TileDB defaults: total=10GB, reader=3, writer=2, buffers=1)
	TotalBudgetBytes uint64 // sm.mem.total_budget
	ReaderWeight     uint32 // sm.mem.consolidation.reader_weight
	WriterWeight     uint32 // sm.mem.consolidation.writer_weight
	BuffersWeight    uint32 // sm.mem.consolidation.buffers_weight

	// Fragment size control (zero = unlimited / no restriction)
	MaxFragmentSizeBytes uint64  // sm.consolidation.max_fragment_size
	StepSizeRatio        float64 // sm.consolidation.step_size_ratio

	// Delete-cell purging — set true so array.Delete() tombstones are physically
	// removed during consolidation, not just suppressed in reads (experimental)
	PurgeDeletedCells bool // sm.consolidation.purge_deleted_cells
}

type FragmentDetail struct {
	Index      uint32 `json:"index"`
	URI        string `json:"uri"`
	TimeStart  int64  `json:"time_start"` // non-empty domain min on "time" dimension (ms)
	TimeEnd    int64  `json:"time_end"`   // non-empty domain max on "time" dimension (ms)
	CellCount  uint64 `json:"cell_count"`
	Size       uint64 `json:"size"`
	WriteStart uint64 `json:"write_start"` // fragment write timestamp
	WriteEnd   uint64 `json:"write_end"`   // fragment write timestamp
}

type FragmentReport struct {
	ArrayURI       string           `json:"array_uri"`
	TotalFragments uint32           `json:"total_fragments"`
	TotalCells     uint64           `json:"total_cells"`
	TotalSize      uint64           `json:"total_size"`
	Fragments      []FragmentDetail `json:"fragments"`
	OverlapGroups  []OverlapGroup   `json:"overlap_groups"` // only groups with 2+ fragments
}

type GroupingStrategy int

type MetQueryParams struct {
	EDID    []StringRange `json:"edid"`
	Time    []TimeRange   `json:"time"`
	Key     []StringRange `json:"key"`
	Ordered bool          `json:"ordered"` // Ignored: met reads always use ROW_MAJOR (variable-length buffers require it)
}

type MetV2QueryParams struct {
	Time    []TimeRange   `json:"time"`
	Key     []StringRange `json:"key"`
	Ordered bool          `json:"ordered"` // Ignored: met reads always use ROW_MAJOR (variable-length buffers require it)
}

type NavQueryParams struct {
	EDID    []StringRange `json:"edid"`
	Time    []TimeRange   `json:"time"`
	Key     []StringRange `json:"key"`
	Ordered bool          `json:"ordered"` // Ignored: nav reads always use ROW_MAJOR (variable-length buffers require it)
}

type NavV2QueryParams struct {
	Time    []TimeRange   `json:"time"`
	Sys     []Uint8Range  `json:"system"`
	SvID    []Uint8Range  `json:"svid"`
	Key     []StringRange `json:"key"`
	Ordered bool          `json:"ordered"` // Ignored: nav reads always use ROW_MAJOR (variable-length buffers require it)
}

type ObsQueryParams struct {
	Time    []TimeRange   `json:"time"`
	Sys     []Uint8Range  `json:"system"`
	SvID    []Uint8Range  `json:"svid"`
	Obs     []StringRange `json:"obs"`
	Ordered bool          `json:"ordered"` // Use ROW_MAJOR layout (enables C-level dedup, returns sorted by dims)
}

type ObsV2QueryParams struct {
	EDID      []StringRange `json:"edid"`
	Time      []TimeRange   `json:"time"`
	Satellite []StringRange `json:"sat"`
	Obs       []StringRange `json:"obs"`
	Ordered   bool          `json:"ordered"` // Use ROW_MAJOR layout (enables C-level dedup, returns sorted by dims)
}

type OverlapGroup struct {
	Fragments []FragmentDetail `json:"fragments"`
	TimeStart int64            `json:"time_start"` // group union start
	TimeEnd   int64            `json:"time_end"`   // group union end
}

type StringRange struct {
	Start string `json:"start"`
	End   string `json:"end"`
}

type TimeRange struct {
	Start time.Time `json:"start"`
	End   time.Time `json:"end"`
}

type Uint8Range struct {
	Start uint8 `json:"start"`
	End   uint8 `json:"end"`
}

type WriteOptions struct {
	Ordered bool // Use ROW_MAJOR layout instead of UNORDERED
}