object/store: Rename back from storer; rename Store to ReadingStore v0.1.118

8 files changed, 198 insertions, 0 deletions

diff --git a/object/store/chain/bytes.go b/object/store/chain/bytes.go
new file mode 100644
index 00000000..dc9b7906
--- /dev/null
+++ b/object/store/chain/bytes.go
@@ -0,0 +1,46 @@
+package chain
+
+import (
+	"errors"
+	"fmt"
+
+	objectid "codeberg.org/lindenii/furgit/object/id"
+	objectstore "codeberg.org/lindenii/furgit/object/store"
+	objecttype "codeberg.org/lindenii/furgit/object/type"
+)
+
+// ReadBytesFull reads a full serialized object from the first backend that has it.
+func (chain *Chain) ReadBytesFull(id objectid.ObjectID) ([]byte, error) {
+	for i, backend := range chain.backends {
+		full, err := backend.ReadBytesFull(id)
+		if err == nil {
+			return full, nil
+		}
+
+		if errors.Is(err, objectstore.ErrObjectNotFound) {
+			continue
+		}
+
+		return nil, fmt.Errorf("objectstore: backend %d read bytes full: %w", i, err)
+	}
+
+	return nil, objectstore.ErrObjectNotFound
+}
+
+// ReadBytesContent reads an object's type and content bytes from the first backend that has it.
+func (chain *Chain) ReadBytesContent(id objectid.ObjectID) (objecttype.Type, []byte, error) {
+	for i, backend := range chain.backends {
+		ty, content, err := backend.ReadBytesContent(id)
+		if err == nil {
+			return ty, content, nil
+		}
+
+		if errors.Is(err, objectstore.ErrObjectNotFound) {
+			continue
+		}
+
+		return objecttype.TypeInvalid, nil, fmt.Errorf("objectstore: backend %d read bytes content: %w", i, err)
+	}
+
+	return objecttype.TypeInvalid, nil, objectstore.ErrObjectNotFound
+}
diff --git a/object/store/chain/chain.go b/object/store/chain/chain.go
new file mode 100644
index 00000000..1fb7408a
--- /dev/null
+++ b/object/store/chain/chain.go
@@ -0,0 +1,12 @@
+// Package chain provides a wrapper object storage backend to query a chain of
+// backends.
+package chain
+
+import objectstore "codeberg.org/lindenii/furgit/object/store"
+
+// Chain queries multiple object databases in order.
+//
+// Chain borrows its backend stores.
+type Chain struct {
+	backends []objectstore.ReadingStore
+}
diff --git a/object/store/chain/close.go b/object/store/chain/close.go
new file mode 100644
index 00000000..6bd74565
--- /dev/null
+++ b/object/store/chain/close.go
@@ -0,0 +1,8 @@
+package chain
+
+// Close releases wrapper-local resources.
+//
+// Chain borrows its backends, so Close does not close them.
+//
+// Repeated calls to Close are undefined behavior.
+func (chain *Chain) Close() error { return nil }
diff --git a/object/store/chain/header.go b/object/store/chain/header.go
new file mode 100644
index 00000000..f6c92459
--- /dev/null
+++ b/object/store/chain/header.go
@@ -0,0 +1,28 @@
+package chain
+
+import (
+	"errors"
+	"fmt"
+
+	objectid "codeberg.org/lindenii/furgit/object/id"
+	objectstore "codeberg.org/lindenii/furgit/object/store"
+	objecttype "codeberg.org/lindenii/furgit/object/type"
+)
+
+// ReadHeader reads object header data from the first backend that has it.
+func (chain *Chain) ReadHeader(id objectid.ObjectID) (objecttype.Type, int64, error) {
+	for i, backend := range chain.backends {
+		ty, size, err := backend.ReadHeader(id)
+		if err == nil {
+			return ty, size, nil
+		}
+
+		if errors.Is(err, objectstore.ErrObjectNotFound) {
+			continue
+		}
+
+		return objecttype.TypeInvalid, 0, fmt.Errorf("objectstore: backend %d read header: %w", i, err)
+	}
+
+	return objecttype.TypeInvalid, 0, objectstore.ErrObjectNotFound
+}
diff --git a/object/store/chain/new.go b/object/store/chain/new.go
new file mode 100644
index 00000000..c78c7c98
--- /dev/null
+++ b/object/store/chain/new.go
@@ -0,0 +1,13 @@
+package chain
+
+import objectstore "codeberg.org/lindenii/furgit/object/store"
+
+// New creates an ordered object database chain.
+//
+// The provided backends must be non-nil and distinct.
+// Chain borrows the provided backends and does not close them in Close.
+func New(backends ...objectstore.ReadingStore) *Chain {
+	return &Chain{
+		backends: append([]objectstore.ReadingStore(nil), backends...),
+	}
+}
diff --git a/object/store/chain/reader.go b/object/store/chain/reader.go
new file mode 100644
index 00000000..3991ee9a
--- /dev/null
+++ b/object/store/chain/reader.go
@@ -0,0 +1,47 @@
+package chain
+
+import (
+	"errors"
+	"fmt"
+	"io"
+
+	objectid "codeberg.org/lindenii/furgit/object/id"
+	objectstore "codeberg.org/lindenii/furgit/object/store"
+	objecttype "codeberg.org/lindenii/furgit/object/type"
+)
+
+// ReadReaderFull reads a full serialized object stream from the first backend that has it.
+func (chain *Chain) ReadReaderFull(id objectid.ObjectID) (io.ReadCloser, error) {
+	for i, backend := range chain.backends {
+		reader, err := backend.ReadReaderFull(id)
+		if err == nil {
+			return reader, nil
+		}
+
+		if errors.Is(err, objectstore.ErrObjectNotFound) {
+			continue
+		}
+
+		return nil, fmt.Errorf("objectstore: backend %d read reader full: %w", i, err)
+	}
+
+	return nil, objectstore.ErrObjectNotFound
+}
+
+// ReadReaderContent reads an object's type, declared content length, and content stream from the first backend that has it.
+func (chain *Chain) ReadReaderContent(id objectid.ObjectID) (objecttype.Type, int64, io.ReadCloser, error) {
+	for i, backend := range chain.backends {
+		ty, size, reader, err := backend.ReadReaderContent(id)
+		if err == nil {
+			return ty, size, reader, nil
+		}
+
+		if errors.Is(err, objectstore.ErrObjectNotFound) {
+			continue
+		}
+
+		return objecttype.TypeInvalid, 0, nil, fmt.Errorf("objectstore: backend %d read reader content: %w", i, err)
+	}
+
+	return objecttype.TypeInvalid, 0, nil, objectstore.ErrObjectNotFound
+}
diff --git a/object/store/chain/refresh.go b/object/store/chain/refresh.go
new file mode 100644
index 00000000..c47352dc
--- /dev/null
+++ b/object/store/chain/refresh.go
@@ -0,0 +1,17 @@
+package chain
+
+import "errors"
+
+// Refresh forwards refresh calls to all backends.
+func (chain *Chain) Refresh() error {
+	var errs []error
+
+	for _, backend := range chain.backends {
+		err := backend.Refresh()
+		if err != nil {
+			errs = append(errs, err)
+		}
+	}
+
+	return errors.Join(errs...)
+}
diff --git a/object/store/chain/size.go b/object/store/chain/size.go
new file mode 100644
index 00000000..f0099028
--- /dev/null
+++ b/object/store/chain/size.go
@@ -0,0 +1,27 @@
+package chain
+
+import (
+	"errors"
+	"fmt"
+
+	objectid "codeberg.org/lindenii/furgit/object/id"
+	objectstore "codeberg.org/lindenii/furgit/object/store"
+)
+
+// ReadSize reads object content length from the first backend that has it.
+func (chain *Chain) ReadSize(id objectid.ObjectID) (int64, error) {
+	for i, backend := range chain.backends {
+		size, err := backend.ReadSize(id)
+		if err == nil {
+			return size, nil
+		}
+
+		if errors.Is(err, objectstore.ErrObjectNotFound) {
+			continue
+		}
+
+		return 0, fmt.Errorf("objectstore: backend %d read size: %w", i, err)
+	}
+
+	return 0, objectstore.ErrObjectNotFound
+}