blobserve

type Object struct {
	// Store is the blob store. A store that implements RangeReader can serve
	// a range; one that does not leaves the caller to serve the bytes itself.
	Store  any
	Bucket string
	Key    string
	Size   int64
}

type Options struct {
	// Name is the object's display filename. It is used for the
	// Content-Disposition filename and must not be empty for downloads.
	Name string

	// ContentType is the stored media type. It is sanitized before it reaches
	// the response; an empty or unparseable value serves as
	// application/octet-stream.
	ContentType string

	// ModTime is the object's last-modified time, used for If-Range and
	// conditional-request handling. The zero value disables both.
	ModTime time.Time

	// Data is the object's full content.
	Data []byte

	// Source serves the object's bytes without holding them, in place of
	// Data. Serve uses it when it is set, and Data is then ignored.
	//
	// It exists for a viewer that reads one object many times by byte range:
	// the Parquet viewer reads a footer and then a row group at a time
	// (#1833), and answering each of those from a whole-object read pulls the
	// file once per request. A Source reads the range asked for and nothing
	// else. It is for binary content only: a body the serving rewrite derives
	// from the stored bytes, and the ETag Revalidate takes over it, both need
	// the whole payload and go through Data.
	Source io.ReadSeeker

	// ForceAttachment serves the blob as a download regardless of family. Set
	// it on endpoints that exist to download, not to preview.
	ForceAttachment bool

	// Revalidate marks a body computed at serve time from more than the stored
	// object, so a browser must ask before reusing its copy. The response
	// carries `private, no-cache` and a strong ETag over Data, and no
	// Last-Modified: ModTime is ignored.
	//
	// It exists for textual asset content, which the serving rewrite derives from the
	// stored bytes AND the asset's references (#1835). A references change
	// alters the body without touching the object or its time, so a copy the
	// browser held under heuristic freshness kept rendering the raw mcp:// URIs
	// until a hard refresh. The ETag is taken over the bytes actually served,
	// so every input the body depends on, the rewrite's base URL included,
	// invalidates it, and an unchanged body still revalidates to a 304 with
	// nothing transferred. Last-Modified is withheld because a browser holding
	// only that validator would send If-Modified-Since alone, and the object's
	// time cannot see a references change. Binary content is never rewritten,
	// and is left to the default so a seek does not hash the whole object.
	Revalidate bool
}

type RangeReader interface {
	GetObjectRange(ctx context.Context, bucket, key string, offset, length int64) (body []byte, size int64, err error)
}

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

type ReadRange func(offset, length int64) ([]byte, error)