media

type Accessor interface {
	Handler
	// SignGetURL returns a time-limited absolute URL the model provider can fetch.
	SignGetURL(ctx context.Context, fileID string, ttl time.Duration) (string, error)
	// OpenByID opens stored bytes by file id.
	OpenByID(ctx context.Context, fileID string) (*types.FileDef, ReadSeekCloser, error)
}

type FileMetaStore interface {
	FileStartUpload(ctx context.Context, fd *types.FileDef) error
	FileFinishUpload(ctx context.Context, fd *types.FileDef, success bool, size int64) (*types.FileDef, error)
	FileGet(ctx context.Context, fid string) (*types.FileDef, error)
}

type Handler interface {
	// Init initializes the media upload handler.
	Init(jsconf string) error

	// Headers checks if the handler wants to provide additional HTTP headers for the request.
	// It could be CORS headers, redirect to serve files from another URL, cache-control headers.
	// It returns headers as a map, HTTP status code to stop processing or 0 to continue, error.
	Headers(req *http.Request, serve bool) (http.Header, int, error)

	// Upload processes request for file upload. Returns file URL, file size, error.
	Upload(fdef *types.FileDef, file io.ReadSeeker) (string, int64, error)

	// Download processes request for file download.
	Download(url string) (*types.FileDef, ReadSeekCloser, error)

	// Delete deletes file from storage.
	Delete(locations []string) error

	// GetIdFromUrl extracts file ID from download URL.
	GetIdFromUrl(url string) types.Uid
}

type ReadSeekCloser interface {
	io.Reader
	io.Seeker
	io.Closer
}