objectstore

type ErrRangeNotSatisfiable struct {
	Range Range
}

type GetConfig interface {
	ProcessOptions([]GetOption)
	Range() Range
}

type GetOption func(cfg *options)

type ListableStore interface {
	Store
	// Exists checks if an object with the given key exists.
	Exists(ctx context.Context, key string) (bool, error)
	// ListPrefix returns an iterator over all object keys with the given prefix.
	// The iterator yields (key, error) pairs. Errors during listing are yielded
	// and iteration stops.
	ListPrefix(ctx context.Context, prefix string) iter.Seq2[string, error]
}

type Object interface {
	// Size returns the total size of the object in bytes.
	Size() int64
	Body() io.ReadCloser
}

type Range struct {
	// Start is the starting byte position (inclusive)
	Start uint64
	// End is the ending byte position (inclusive), nil means read to EOF
	End *uint64
}

type Store interface {
	// Put stores an object with the given key and size from the provided reader.
	// The size parameter should match the actual bytes to be read from data.
	Put(ctx context.Context, key string, size uint64, data io.Reader) error
	// Get retrieves the object identified by the given key.
	// Returns an Object for reading the data, or an error if retrieval fails.
	// Use GetOption functions like WithRange to retrieve partial objects.
	Get(ctx context.Context, key string, opts ...GetOption) (Object, error)
	// Delete an object from the store by the given key.
	Delete(ctx context.Context, key string) error
}