extension

type ByteRange struct {
	Offset int `json:"offset,omitempty"`
	Length int `json:"length,omitempty"`
}

type Continuation struct {
	// HasMore reports that more data is available beyond what was returned.
	HasMore bool `json:"hasMore,omitempty"`
	// Remaining is the estimated number of bytes (or units) not returned.
	Remaining int `json:"remaining,omitempty"`
	// Returned is the number of bytes (or units) included in this response.
	Returned int `json:"returned,omitempty"`
	// NextRange provides the next suggested byte/line window for continuation.
	NextRange *RangeHint `json:"nextRange,omitempty"`
	// PageToken is an opaque continuation token alternative to NextRange.
	PageToken string `json:"pageToken,omitempty"`
	// Mode optionally records the preview mode applied (e.g., head, tail).
	Mode string `json:"mode,omitempty"`
	// Binary indicates the returned content is a placeholder/preview for binary data.
	Binary bool `json:"binary,omitempty"`
}

type LineRange struct {
	Start int `json:"start,omitempty"`
	Count int `json:"count,omitempty"`
}

type RangeHint struct {
	Bytes *ByteRange `json:"bytes,omitempty"`
	Lines *LineRange `json:"lines,omitempty"`
}