Enum MailboxChangeKind

Namespace

MailFathom.Domain.Mutations

Assembly

MailFathom.Domain.dll

Names one kind of change to a mailbox that synchronization discovers and rule evaluation would act on.

public enum MailboxChangeKind

Fields

EmailAppearedInFolder = 0

A folder holds an occurrence of an email it did not hold before.

EmailLeftFolder = 1

A folder no longer holds an occurrence of an email it did hold.

FlaggedStateChanged = 3

The remote \Flagged flag of a stored email stands at a different value than the one last observed.

KeywordsChanged = 4

The keywords a stored email carries are no longer the ones last observed on it.

The comparison is of the whole set, because that is what a server reports and what a replacement writes; which keyword joined or left it is not a distinction any mutation asks for.

SeenStateChanged = 2

The remote \Seen flag of a stored email stands at a different value than the one last observed.

Remarks

The kinds are what a mail server can tell MailFathom has happened to a message that is already stored: it is somewhere it was not, it is no longer where it was, or one of the values a STORE writes stands elsewhere. Every mutation MailFathom is permitted to make arrives back as one of them, which is what lets provenance be decided once for the whole set rather than per mutation.

A flag has one kind per value rather than one for every flag together, because the question a suppression answers is asked per value: a record that set \Flagged accounts for the star standing where it put it and for nothing about whether the message was read. The keywords are the one exception and are a single kind, because the three keyword mutations write one set between them and a server reports that set whole.

The kind says what changed and never who caused it. That second question is answered from the durable mutation record, and keeping the two apart is the point: a person moving mail by hand produces exactly the same kind as a rule that files it, and only the record tells them apart.