TODO(bwplotka): Added size to method, upstream this.

NewLazyBinaryReader makes a new LazyBinaryReader.

NewLazyBinaryReaderMetrics makes new LazyBinaryReaderMetrics.

NewReaderPool makes a new ReaderPool.

NewReaderPoolMetrics makes new ReaderPoolMetrics.

NewStreamBinaryReader loads or builds new index-header if not present on disk.

WriteBinary build index-header file from the pieces of index in object storage.

BinaryFormatV1 represents first version of index-header file.

MagicIndex are 4 bytes at the head of an index-header file.

nolint:revive.

BinaryTOC is a table of content for index-header file.

LazyBinaryReader wraps BinaryReader and loads (mmap or streaming read) the index-header only upon the first Reader function is called.

LazyBinaryReaderMetrics holds metrics tracked by LazyBinaryReader.

ReaderPool is used to istantiate new index-header readers and keep track of them.

ReaderPoolMetrics holds metrics tracked by ReaderPool.

Snapshotter manages the snapshots of lazy loaded blocks.

Reader is an interface allowing to read essential, minimal number of index fields from the small portion of index file called header.