download.go RawHistoryFolder

1package port
2
3import "context"
4
5// DownloadEventType represents the type of download event.
6type DownloadEventType int
7
8const (
9	// DownloadEventStarted indicates a download has begun.
10	DownloadEventStarted DownloadEventType = iota
11	// DownloadEventProgress indicates download progress has advanced.
12	DownloadEventProgress
13	// DownloadEventFinished indicates a download completed successfully.
14	DownloadEventFinished
15	// DownloadEventFailed indicates a download failed.
16	DownloadEventFailed
17)
18
19// DownloadEvent contains information about a download event.
20type DownloadEvent struct {
21	Type          DownloadEventType
22	Filename      string
23	Destination   string
24	Progress      float64 // Set when Type is DownloadEventProgress, normalized to 0.0-1.0.
25	BytesReceived int64   // Best-effort received byte count for progress updates.
26	BytesTotal    int64   // Best-effort total byte count for progress updates when known.
27	Error         error   // Set when Type is DownloadEventFailed
28}
29
30// DownloadEventHandler receives download event notifications.
31type DownloadEventHandler interface {
32	OnDownloadEvent(ctx context.Context, event DownloadEvent)
33}
34
35// DownloadResponse provides access to response metadata for downloads.
36// This abstracts the WebKit URIResponse to allow testing without CGO.
37type DownloadResponse interface {
38	GetMimeType() string
39	GetSuggestedFilename() string
40	GetUri() string
41}