skip to content

detached 8661704

docs(ports): clarify store slice ownership

commit: 8661704729a52061911fd8c58612de4f95448af9
author: brice · 3mo ago · 2026-07-15 04:57 UTC
parent: c3dcda7
signature: GPG VerifiedCD88F9E564E0102646FB6077A1A07C7C7C3E349D · arch-gpg Verified for the committer email

1 file · +4 -0

M internal/ports/store.go +4 -0


@@ -4,10 +4,14 @@ package ports
4	4		//
5	5		// Implementations may buffer writes; Sync is the durability barrier.
6	6		type Store interface {
	7	+	// Get returns a stable copy of the value for key. The caller owns the
	8	+	// returned slice and may retain or mutate it.
7	9		Get(key []byte) ([]byte, bool)
8	10		Set(key, val []byte) error
9	11		Delete(key []byte) error
10	12		// Range iterates key/value pairs; fn returning false stops iteration early.
	13	+	// Each key and value is a stable copy owned by the caller, which may retain
	14	+	// or mutate either slice after Range returns.
11	15		Range(fn func(k, v []byte) bool)
12	16		Sync() error
13	17		Close() error


@@ -4,10 +4,14 @@ package ports
4		//	4		//
5		// Implementations may buffer writes; Sync is the durability barrier.	5		// Implementations may buffer writes; Sync is the durability barrier.
6		type Store interface {	6		type Store interface {
			7	+	// Get returns a stable copy of the value for key. The caller owns the
			8	+	// returned slice and may retain or mutate it.
7		Get(key []byte) ([]byte, bool)	9		Get(key []byte) ([]byte, bool)
8		Set(key, val []byte) error	10		Set(key, val []byte) error
9		Delete(key []byte) error	11		Delete(key []byte) error
10		// Range iterates key/value pairs; fn returning false stops iteration early.	12		// Range iterates key/value pairs; fn returning false stops iteration early.
			13	+	// Each key and value is a stable copy owned by the caller, which may retain
			14	+	// or mutate either slice after Range returns.
11		Range(fn func(k, v []byte) bool)	15		Range(fn func(k, v []byte) bool)
12		Sync() error	16		Sync() error
13		Close() error	17		Close() error