asset

type FileGetter interface {
	GetFileReader(name string) (io.ReadCloser, error)
}

type FilePostRequestGenerator interface {
	GeneratePostFileRequest(
		name string,
		contentType string,
		length int64,
	) (*PostFileRequest, error)
}

type FilePutter interface {
	PutFileReader(
		name string,
		src io.Reader,
		length int64,
		contentType string,
	) error
}

type FileRange struct {
	From int64
	To   int64
}

type FileRangeNotAcceptedError struct {
	Range FileRange
}

type FileRangedGetResult struct {
	ReadCloser    io.ReadCloser
	AcceptedRange FileRange
	TotalSize     int64
}

type FileRangedGetter interface {
	GetRangedFileReader(
		name string,
		fileRange FileRange,
	) (*FileRangedGetResult, error)
}

type PostFileRequest struct {
	Action      string                 `json:"action"`
	ExtraFields map[string]interface{} `json:"extra-fields,omitempty"`
}

type SignatureParser interface {
	ParseSignature(signed string, name string, expiredAt time.Time) (valid bool, err error)
}

type Store interface {
	FileGetter
	FilePutter
	FilePostRequestGenerator
}

type URLSigner interface {
	// SignedURL returns a url with access to the named file. If asset
	// store is private, the returned URL is a signed one, allowing access
	// to asset for a short period.
	SignedURL(name string) (string, error)
	IsSignatureRequired() bool
}

type URLSignerStore interface {
	Store
	URLSigner
}