store.go RawHistoryFolder

1package ports
2
3import "crypto/sha256"
4
5// Store is a small byte-key/value persistence port.
6//
7// Implementations may buffer writes; Sync is the durability barrier.
8type Store interface {
9	// Get returns a stable copy of the value for key. The caller owns the
10	// returned slice and may retain or mutate it.
11	Get(key []byte) ([]byte, bool)
12	Set(key, val []byte) error
13	Delete(key []byte) error
14	// Range iterates key/value pairs; fn returning false stops iteration early.
15	// Each key and value is a stable copy owned by the caller, which may retain
16	// or mutate either slice after Range returns.
17	Range(fn func(k, v []byte) bool)
18	Sync() error
19	// CloseWithoutSync releases the store without persisting buffered writes.
20	// Callers use it after a rejected durable mutation.
21	CloseWithoutSync() error
22	Close() error
23}
24
25// SnapshotDigest is the SHA-256 content address of a complete snapshot object.
26type SnapshotDigest [sha256.Size]byte
27
28type SnapshotObject struct {
29	Digest SnapshotDigest
30	Data   []byte
31}