dbcommon

type ChapterDetails struct {
	// [1..)
	Index   int
	Options uint32
	// [0..2024]
	Type uint16
}

type FileFormat uint16

type FormatOptions uint64

type PayloadBuilder interface {
	AddPrelude(bytes []byte, pos StorageEntryPosition) error
	AddConclude(bytes []byte, pos StorageEntryPosition, totalCount uint32) error
	AddChapter(bytes []byte, pos StorageEntryPosition, details ChapterDetails) error
	NeedsNextChapter() bool

	Finished() error
	Failed(error) error
}

type PayloadFactory interface {
	CreatePayloadBuilder(format FileFormat, sr StorageSeqReader) PayloadBuilder
}

type PayloadWriter interface {
	io.Closer
	WritePrelude(bytes []byte, concludeMaxLength int) (StorageEntryPosition, error)
	WriteConclude(bytes []byte) (StorageEntryPosition, error)
	WriteChapter(bytes []byte, details ChapterDetails) (StorageEntryPosition, error)
}

type ReadConfig struct {
	ReadAllEntries bool
	AlwaysCopy     bool
}

type StorageBlockReader interface {
	io.ReaderAt
	io.Closer
	ReadAtMapped(n int64, off int64) ([]byte, error)
}

type StorageEntryPosition struct {
	StorageOffset int64
	ByteOffset    int
}

type StorageSeqReader interface {
	io.ByteReader
	io.Reader
	io.Seeker
	CanSeek() bool
	CanReadMapped() bool
	Offset() int64
	ReadMapped(n int64) ([]byte, error)
}

type StorageSeqWriter interface {
	io.ByteWriter
	io.Writer
	Offset() int64
}