Skip to main content

Interface: IDownloadService

Defined in: Services/IDownloadService.ts:22

Download service interface Handles HTTP downloads with progress tracking, pause/resume, and verification

Methods

cancelDownload()

cancelDownload(queueId): void

Defined in: Services/IDownloadService.ts:54

Cancel a download

Parameters

queueId

number

Download queue ID

Returns

void


clearCompleted()

clearCompleted(): void

Defined in: Services/IDownloadService.ts:103

Clear completed downloads from tracking

Returns

void


getActiveDownloads()

getActiveDownloads(): DownloadProgress[]

Defined in: Services/IDownloadService.ts:98

Get all active downloads

Returns

DownloadProgress[]


getProgress()

getProgress(queueId): DownloadProgress | undefined

Defined in: Services/IDownloadService.ts:60

Get current download progress

Parameters

queueId

number

Download queue ID

Returns

DownloadProgress | undefined


offProgress()

offProgress(callback): void

Defined in: Services/IDownloadService.ts:83

Unregister a progress callback previously passed to onProgress.

Required for any caller that subscribes per-download rather than once at startup (the feature-pack installer does): without it every install leaks a closure, and later installs fan their progress out to the stale callbacks of earlier ones. Passing a callback that was never registered is a no-op.

Parameters

callback

DownloadProgressCallback

Returns

void


onComplete()

onComplete(callback): void

Defined in: Services/IDownloadService.ts:88

Register completion callback

Parameters

callback

DownloadCompleteCallback

Returns

void


onError()

onError(callback): void

Defined in: Services/IDownloadService.ts:93

Register error callback

Parameters

callback

DownloadErrorCallback

Returns

void


onProgress()

onProgress(callback): void

Defined in: Services/IDownloadService.ts:73

Register progress callback

Parameters

callback

DownloadProgressCallback

Returns

void


pauseDownload()

pauseDownload(queueId): void

Defined in: Services/IDownloadService.ts:42

Pause a download

Parameters

queueId

number

Download queue ID

Returns

void


resumeDownload()

resumeDownload(queueId): Promise<void>

Defined in: Services/IDownloadService.ts:48

Resume a paused download

Parameters

queueId

number

Download queue ID

Returns

Promise<void>


startDownload()

startDownload(queueId, url, destination, expectedChecksum?): Promise<string>

Defined in: Services/IDownloadService.ts:31

Start a download

Parameters

queueId

number

Download queue ID

url

string

URL to download from

destination

string

Local file path to save to

expectedChecksum?

string

Expected SHA-256 checksum (optional)

Returns

Promise<string>

Promise that resolves with the downloaded file path


verifyChecksum()

verifyChecksum(filePath, expectedChecksum): Promise<boolean>

Defined in: Services/IDownloadService.ts:68

Verify file checksum

Parameters

filePath

string

Path to file

expectedChecksum

string

Expected SHA-256 checksum

Returns

Promise<boolean>

True if checksum matches