storage

type Adapter ¶

type Adapter interface {
	PresignPut(ctx context.Context, key string, ttl time.Duration) (PresignedURL, error)
	PresignGet(ctx context.Context, key string, ttl time.Duration) (PresignedURL, error)
	Stat(ctx context.Context, key string) (ObjectInfo, error)
	// Peek returns up to n leading bytes for MIME sniffing (http.DetectContentType
	// reads at most 512). Returns KindNotFound if the object is absent.
	Peek(ctx context.Context, key string, n int) ([]byte, error)
	Delete(ctx context.Context, key string) error
}

Adapter is the object-storage port.

A tenant-prefixed Key ("<tenant>/<document>/<version>") is minted by the document service; the adapter treats keys as opaque. PresignPut/PresignGet return URLs valid for ttl. Stat and Peek support confirm-time verification (size + SHA-256 + a MIME-sniff prefix); a real adapter implements Stat via a HEAD and Peek via a ranged GET. Delete backs retention voiding.

type Memory ¶

type Memory struct {
	// contains filtered or unexported fields
}

Memory is an in-process Adapter for tests and local dev. Presigned URLs are synthetic ("mem://<key>?..."); the test/client uploads by calling Put with the bytes (standing in for the client's PUT to the presigned URL). Concurrency-safe.

func NewMemory() *Memory

func (m *Memory) Delete(_ context.Context, key string) error

func (m *Memory) Has(key string) bool

func (m *Memory) Peek(_ context.Context, key string, n int) ([]byte, error)

func (m *Memory) PresignGet(_ context.Context, key string, ttl time.Duration) (PresignedURL, error)

func (m *Memory) PresignPut(_ context.Context, key string, ttl time.Duration) (PresignedURL, error)

func (m *Memory) Put(key string, data []byte)

func (m *Memory) Stat(_ context.Context, key string) (ObjectInfo, error)

type ObjectInfo ¶

type ObjectInfo struct {
	Size     int64
	Checksum string
}

ObjectInfo is what the store reports about a stored blob at confirm time. Checksum is the lowercase hex SHA-256 of the bytes.

type PresignedURL ¶

type PresignedURL struct {
	URL       string
	Method    string
	ExpiresAt time.Time
}

PresignedURL is a time-boxed URL the client uses directly against the object store. Method is "PUT" (upload) or "GET" (download).