Speed up downloads by combining multiple network connections in parallel
TypeScript bandwidth-aggregationcross-platformdesktop-appdownloaderdownloadmanagerlinuxmacosmulticonnectionparallel-downloadswindows
/**
* Normalizes a search query by trimming whitespace and normalizing Unicode (NFC).
*/
export function normalizeSearchQuery(query: string): string {
return query.trim().normalize('NFC').toLowerCase()
}
/**
* Splits a search query into non-empty lowercase normalized tokens.
*/
export function searchTokens(query: string): string[] {
const normalized = normalizeSearchQuery(query)
return normalized ? normalized.split(/\s+/).filter(Boolean) : []
}
/**
* Checks whether a download item matches a search query or a pre-computed list of tokens.
* Matches case-insensitively across fileName and url.
* Multiple space-separated keywords must all match (AND search).
* An empty or whitespace-only query matches all items.
*/
export function matchesSearch(
item: { fileName: string; url?: string },
queryOrTokens: string | readonly string[]
): boolean {
const tokens = typeof queryOrTokens === 'string' ? searchTokens(queryOrTokens) : queryOrTokens
if (tokens.length === 0) return true
const name = item.fileName.normalize('NFC').toLowerCase()
const url = (item.url ?? '').normalize('NFC').toLowerCase()
const haystack = `${name} ${url}`
return tokens.every((token) => haystack.includes(token))
}
/**
* Filters an array of download items against a search query.
*/
export function filterDownloadsByQuery<T extends { fileName: string; url?: string }>(
items: readonly T[],
query: string
): T[] {
const tokens = searchTokens(query)
if (tokens.length === 0) return [...items]
return items.filter((item) => matchesSearch(item, tokens))
}