Constructor MailboxFolderFreshness

Namespace

MailFathom.Application.Synchronization.Checkpoints

Assembly

MailFathom.Application.dll

MailboxFolderFreshness(MailAccountId, MailFolderAlias, DateTimeOffset?)

Reports how current the local copy of one folder is.

public MailboxFolderFreshness(MailAccountId AccountId, MailFolderAlias FolderAlias, DateTimeOffset? SynchronizedAt)

Parameters

AccountId MailAccountId

The account the folder belongs to.

FolderAlias MailFolderAlias

MailFathom's own name for the folder.

SynchronizedAt DateTimeOffset?

When synchronization last durably committed progress for the folder, or null when it never has.

Remarks

Every query result carries this, because a mailbox read is served from local state whether or not a mail server is reachable. Without it a caller cannot tell a folder that holds no matching mail from one whose synchronization has been failing for a week, and both look like an answer about the mailbox.

An alias can have been bound to several remote folders over time, and the timestamp is the most recent progress of any of those bindings. That is what "how current is this alias" means to a reader: the older bindings' emails are still listed under the same alias, and no reader is asking which generation produced them.