storage

type File struct {
	Key          string `json:"key"`
	Size         int64  `json:"size"`
	LastModified string `json:"last_modified,omitempty"`
	URL          string `json:"url,omitempty"`
}

type Scope struct {
	SessionID   string
	ExecutionID string
}

type Service interface {
	// Upload stores a file scoped to a session/execution and returns its key,
	// public URL, and path on the server host.
	Upload(scope Scope, name string, body io.Reader) (UploadResult, error)
	// List returns files scoped to a session/execution, optionally filtered by prefix.
	List(scope Scope, prefix string) ([]File, error)
	// GetURL returns the public URL for a file scoped to a session/execution.
	GetURL(scope Scope, key string) string
	// ServeFile serves a stored file over HTTP.
	ServeFile(w http.ResponseWriter, r *http.Request, filePath string)
}

type UploadResult struct {
	Key  string
	URL  string
	Path string
}