Constructor SearchEmailsResult

Namespace

MailFathom.Application.Emails.SearchEmails

Assembly

MailFathom.Application.dll

SearchEmailsResult(IReadOnlyList<EmailSearchMatch>, IReadOnlyList<MailboxFolderFreshness>)

One ranked window of search results, together with how current the mail behind them is.

public SearchEmailsResult(IReadOnlyList<EmailSearchMatch> Matches, IReadOnlyList<MailboxFolderFreshness> FolderFreshness)

Parameters

Matches IReadOnlyList<EmailSearchMatch>

The matches, most relevant first, holding no more than the effective result limit.

FolderFreshness IReadOnlyList<MailboxFolderFreshness>

How current the local copy of each folder in the request's scope is.

Remarks

The window is the whole result: nothing continues it, and a caller that needs different mail narrows the structured filters or writes a different query rather than paging. Relevance order is recomputed per query and moves as mail is indexed, so a boundary into it would name a position that had stopped meaning what it meant when it was handed out.

Freshness travels with every result for the reason it travels with every page: a search is answered from the local copy whether or not a mail server is reachable, and a folder whose synchronization has been failing for a week otherwise looks exactly like a folder holding nothing that matched.