Class MailboxReconciliationResult

Namespace

MailFathom.Application.Synchronization.Reconciliation

Assembly

MailFathom.Application.dll

Summarizes one bounded reconciliation window.

public sealed record MailboxReconciliationResult : IEquatable<MailboxReconciliationResult>

Inheritance

object

MailboxReconciliationResult

Implements

IEquatable<MailboxReconciliationResult>

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.ReferenceEquals(object, object)

object.ToString()

Remarks

Every field is a count, a sequence number, or an identity MailFathom owns. Nothing derived from a message belongs in a result a worker logs, which is what makes the audit line this becomes safe to emit for a mailbox nobody may read.

Constructors

MailboxReconciliationResult(int, int, int, int, bool, ulong?, IReadOnlyList<SuppressedMailboxChange>)

Summarizes one bounded reconciliation window.

Properties

EmailsRemain

Whether occurrences still await reconciliation after this window.

NothingToReconcile

Gets the result of a run whose folder had nothing awaiting reconciliation.

ObservedEmailCount

How many stored occurrences the server still holds, whether it described them or only confirmed them.

OwnMutationCompletedEmailCount

How many stored occurrences left the folder because MailFathom relocated or deleted them. They are counted apart from the remotely deleted ones because they are the opposite finding: a change of the owner's own that has come back through synchronization, rather than one to react to.

ReconciledThroughModSeq

The folder modification sequence this pass covered the whole folder through, or null when the pass was partial or the server reports no sequence. A caller records it on the folder's checkpoint.

RemotelyDeletedEmailCount

How many stored occurrences the folder no longer holds and nothing MailFathom did accounts for.

SeenStateChangedEmailCount

How many stored emails the server reported a moved \Seen flag for that no mutation of MailFathom's accounts for. Those are the mailbox owner's own act — read in their client, or marked read there — and they stay a change to react to, which is what keeps the suppression beside them about provenance rather than about the flag.

SuppressedChanges

The changes this window found and did not raise, because MailFathom itself had made them. The list is bounded by the mutations MailFathom has in flight rather than by the size of the window, so it is a handful on the runs that have any and empty on every run of a mailbox nobody writes to.