Skip to content

History / Mailbox Folder Verification Developer Guide

Revisions

  • Gmail collection dev guide; correct the two now-false claims New: Gmail-Mail-Collection-Developer-Guide - the labels-not-folders model, the labelIds=INBOX bug and why an empty result set hid it, and the resultSizeEstimate trap with the measured numbers. Corrected in the existing pages, because #1173 made them untrue: - Verification guide s6 documented labelIds=INBOX as a known limitation deliberately not fixed. It is fixed, so the section is rewritten and the amber note it described is inverted. - Issue-45-Verify write-up claimed "201 messages - real account data". That number came from resultSizeEstimate and was fiction; INBOX actually holds 2.

    @edmozley edmozley committed Aug 24, 2026
  • Developer guide: verifying a mail folder across three providers There was no developer page covering the verify path - 57 other Developer Guides and none for mailboxes. Covers the shared contract and the one rule (verify through the reader's own code, per #77), why the provider branch must precede the OAuth-token gate, then each provider with real code: Graph's name-is-not-an-id resolver and why it cannot use $filter, IMAP's connection-string-as-API with modified UTF-7 and per-server delimiters, and Gmail's labels plus the labelIds=INBOX that is always ANDed in. Linked from both #45 write-ups and the sidebar.

    @edmozley edmozley committed Aug 24, 2026