From 965c596f16fba5943c0ee0baa7522de31cdf1a12 Mon Sep 17 00:00:00 2001
From: Runxi Yu
Date: Fri, 6 Mar 2026 14:34:28 +0800
Subject: object: Consider using a streaming API for blobs

---
 object/blob.go       | 4 ++++
 objectstored/blob.go | 3 +++
 2 files changed, 7 insertions(+)

diff --git a/object/blob.go b/object/blob.go
index 9c507e1f..bd26ed1d 100644
--- a/object/blob.go
+++ b/object/blob.go
@@ -3,6 +3,10 @@ package object
 import "codeberg.org/lindenii/furgit/objecttype"
 
 // Blob represents a Git blob object.
+//
+// This Blob object is fully materialized in memory.
+// Consider using objectstore/Store.ReadReaderContent,
+// or appropriate streaming write APIs.
 type Blob struct {
 	Data []byte
 }
diff --git a/objectstored/blob.go b/objectstored/blob.go
index f87af561..26584ce5 100644
--- a/objectstored/blob.go
+++ b/objectstored/blob.go
@@ -6,6 +6,9 @@ import (
 )
 
 // StoredBlob is a parsed blob paired with its storage ID.
+//
+// This Blob object is fully materialized in memory.
+// Consider using objectstore/Store.ReadReaderContent.
 type StoredBlob struct {
 	id   objectid.ObjectID
 	blob *object.Blob
-- 
cgit v1.3.1-10-gc9f91