@withbuddi/buddi 0.1.0-pre.27 → 0.1.0-pre.29

package/packages/tools/email/dist/imap/fake.d.ts

@@ -7,10 +7,14 @@
  * that makes stored UIDs meaningful — so a regression in either shows up as a
  * failing test rather than as silently-read mail.
  */
-import type { FetchedMessage, ImapClient, ImapClientFactory, MailboxInfo } from '../ports.js';
+import type { FetchedMessage, IdleChange, ImapClientFactory, ImapIdleFactory, ImapIdleSession, ImapWriter, MailboxInfo, MoveResult } from '../ports.js';
+/** A message as this server holds it: what the port hands over, and Gmail's labels. */
+type HeldMessage = FetchedMessage & {
+    labels?: string[];
+};
 export interface FakeMailbox {
     uidValidity: number;
-    messages: FetchedMessage[];
+    messages: HeldMessage[];
     /** The SPECIAL-USE attribute this folder is listed with, e.g. `\\Sent`. */
     specialUse?: string | null;
     /**
@@ -22,6 +26,14 @@ export interface FakeMailbox {
     condstore?: boolean;
     /** The mailbox's current HIGHESTMODSEQ. Maintained by the server. */
     highestModseq?: number;
+    /** The highest uid ever assigned here: a uid is never reused, even after a move out. */
+    uidNextFloor?: number;
+    /**
+     * Whether this mailbox answers QRESYNC (RFC 7162): with `condstore` too, a
+     * message leaving it bumps the mod-sequence and is remembered, so
+     * `departures` with `changedSince` answers VANISHED instead of a search.
+     */
+    qresync?: boolean;
 }
 /**
  * The bytes this server will hand over for one body part, keyed
@@ -60,13 +72,105 @@ export declare class FakeImapServer {
         changedSince: string | null;
         returned: number;
     }>;
+    /** Every bulk-headers fetch served (`fetchBulk`): which uids were asked for. */
+    readonly bulkFetches: Array<{
+        mailbox: string;
+        uids: number[];
+    }>;
     /** Each message's mod-sequence, keyed `<mailbox>/<uid>`, for a CONDSTORE mailbox. */
     readonly modseqs: Map<string, number>;
+    /**
+     * What CAPABILITY answers. A plain server by default (MOVE and UIDPLUS, as
+     * Dovecot, Fastmail and iCloud have); `gmail()` adds `X-GM-EXT-1`. A test
+     * about a server without MOVE or UIDPLUS takes them out.
+     */
+    capabilities: string[];
+    /**
+     * Every write this server accepted, in order. There is no `expunge` and no
+     * `\\Deleted` here because the client never sends one — a test asserting
+     * that reads this log.
+     */
+    readonly writes: Array<{
+        op: 'store';
+        mailbox: string;
+        uids: number[];
+        flags: string[];
+        how: 'add' | 'remove';
+    } | {
+        op: 'move';
+        mailbox: string;
+        uids: number[];
+        destination: string;
+    } | {
+        op: 'labels';
+        mailbox: string;
+        uids: number[];
+        labels: string[];
+    } | {
+        op: 'store-labels';
+        mailbox: string;
+        uids: number[];
+        labels: string[];
+        how: 'add' | 'remove';
+    }>;
+    /** Every presence question served: how it was answered (`vanished` or `search`) and over which range. */
+    readonly departureChecks: Array<{
+        mailbox: string;
+        via: 'vanished' | 'search';
+        fromUid: number;
+        toUid: number;
+    }>;
+    /** Uids that left a QRESYNC mailbox, with the mod-sequence they left at. */
+    readonly vanishedLog: Array<{
+        mailbox: string;
+        uid: number;
+        modseq: number;
+    }>;
+    /** How many times an IDLE session asked for Sent's UIDNEXT. */
+    sentChecks: number;
+    /**
+     * IDLE (RFC 2177): sessions open on this server, every IDLE login it
+     * accepted or refused, and the switches a test flips. A server without
+     * `IDLE` in `capabilities` answers the IDLE factory with 'unsupported'.
+     */
+    readonly idlers: Set<FakeIdleSession>;
+    idleConnects: number;
+    /** When set, an IDLE login is refused the way a provider refuses a revoked app password. */
+    refuseIdleLogin: boolean;
+    /** When set, an IDLE connect fails like a network that is down (not a refusal). */
+    idleUnreachable: boolean;
     constructor(seed?: Record<string, FakeMailbox>);
+    /**
+     * A Gmail-shaped server: `X-GM-EXT-1`, INBOX, All Mail (`\\All`), Trash
+     * (`\\Trash`), Sent, and whatever labels a test adds as folders. Moving a
+     * message to Trash drops its labels, as Gmail does.
+     */
+    static gmail(labels?: string[]): FakeImapServer;
+    /** Whether this server says it is Gmail. */
+    get isGmail(): boolean;
+    /** The message at `<mailbox>/<uid>`, or undefined. */
+    find(name: string, uid: number): HeldMessage | undefined;
+    /** All Mail's alias uids for messages this fake keeps in another (label or inbox) folder. */
+    readonly allMailAliases: Map<number, {
+        mailbox: string;
+        uid: number;
+    }>;
+    /** An All Mail uid for a message held outside All Mail, Trash and Spam, or null. */
+    allMailAlias(messageId: string): number | null;
+    /** Where a message with this Message-ID is now: every `{ mailbox, uid }` holding it. */
+    whereIs(messageId: string): Array<{
+        mailbox: string;
+        uid: number;
+    }>;
+    /** `UID MOVE`, as a server does it: the next uid in the destination, gone from the source. */
+    moveMessages(source: string, uids: readonly number[], destination: string): MoveResult;
+    /** `UID STORE ±FLAGS`. */
+    storeFlags(name: string, uids: readonly number[], flags: readonly string[], how: 'add' | 'remove'): void;
     mailbox(name: string): FakeMailbox;
     /** Append a message, assigning the next uid. Returns the uid it got. */
     add(name: string, message: Omit<FetchedMessage, 'uid'> & {
         uid?: number;
+        labels?: string[];
     }): number;
     /**
      * What another mail client does: set this message's flags on the server.
@@ -75,6 +179,26 @@ export declare class FakeImapServer {
     setFlags(name: string, uid: number, flags: string[]): void;
     /** Archive or delete elsewhere: the message is simply not in this mailbox any more. */
     remove(name: string, uid: number): void;
+    /**
+     * What another mail app does when it moves a message: gone from `source`,
+     * in `destination` under the next uid there (labels as Gmail would leave
+     * them). Returns the new uid.
+     */
+    moveElsewhere(source: string, uid: number, destination: string): number;
+    /**
+     * Gmail's `UID STORE ±X-GM-LABELS`. `\\Inbox` is membership of INBOX,
+     * not a stored label here: taking it off moves the message to the label
+     * folder it was given last (else All Mail), putting it on brings it back to
+     * INBOX. Taking off the label of the folder it sits in moves it the same
+     * way. Other labels are just kept on the message.
+     */
+    storeLabels(name: string, uids: readonly number[], labels: readonly string[], how: 'add' | 'remove'): void;
+    /** The network drops every IDLE connection: each session ends with an error. */
+    dropIdle(): void;
+    /** The IDLE factory: a connection of its own on INBOX, as the real one opens. */
+    idleFactory(): ImapIdleFactory;
+    /** @internal */
+    forget(session: FakeIdleSession): void;
     /** Give one body part of one message its bytes. */
     putPart(mailbox: string, uid: number, part: string, bytes: Buffer): void;
     /**
@@ -84,11 +208,28 @@ export declare class FakeImapServer {
     resetUidValidity(name: string, uidValidity: number): void;
     /** What a LIST would return: every folder this server holds, in order. */
     listing(): MailboxInfo[];
-    client(): ImapClient;
+    client(): ImapWriter;
     factory(): ImapClientFactory;
 }
+/** One IDLE connection on the fake server. */
+declare class FakeIdleSession implements ImapIdleSession {
+    #private;
+    private readonly server;
+    private readonly mailbox;
+    private readonly onChange;
+    readonly ended: Promise<{
+        error?: unknown;
+    }>;
+    constructor(server: FakeImapServer, mailbox: string, onChange: (change: IdleChange) => void);
+    push(mailbox: string, change: IdleChange): void;
+    /** `STATUS <Sent> (UIDNEXT)` over this connection, as the real session asks it. */
+    sentUidNext(folder: string): Promise<number | null>;
+    drop(error: unknown): void;
+    close(): Promise<void>;
+}
 /** A plausible message, so a test writes only the fields it cares about. */
 export declare function fakeMessage(over?: Partial<FetchedMessage>): Omit<FetchedMessage, 'uid'> & {
     uid?: number;
 };
+export {};
 //# sourceMappingURL=fake.d.ts.map

package/packages/tools/email/dist/imap/fake.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fake.d.ts","sourceRoot":"","sources":["../../src/imap/fake.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAEV,cAAc,EAEd,UAAU,EACV,iBAAiB,EACjB,WAAW,EAEZ,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAM5C,qBAAa,cAAc;;IACzB,QAAQ,CAAC,SAAS,2BAAkC;IACpD,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAM;IACrG,KAAK,SAAK;IACV,MAAM,SAAK;IACX,sEAAsE;IACtE,KAAK,SAAK;IACV,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAa;IACtC,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAM;IACjG,+FAA+F;IAC/F,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC;QAC1B,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAM;IACR,qFAAqF;IACrF,QAAQ,CAAC,OAAO,sBAA6B;gBAEjC,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAM;IAIlD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW;IASlC,wEAAwE;IACxE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IAQlF;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAO1D,uFAAuF;IACvF,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAcvC,mDAAmD;IACnD,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIxE;;;OAGG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAKzD,0EAA0E;IAC1E,OAAO,IAAI,WAAW,EAAE;IAaxB,MAAM,IAAI,UAAU;IAIpB,OAAO,IAAI,iBAAiB;CAG7B;AA8GD,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,IAAI,GAAE,OAAO,CAAC,cAAc,CAAM,GAAG,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,GAAG;IAC7F,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAsBA"}
+{"version":3,"file":"fake.d.ts","sourceRoot":"","sources":["../../src/imap/fake.ts"],"names":[],"mappings":"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"}

package/packages/tools/email/dist/imap/fake.js

@@ -1,3 +1,17 @@
+/**
+ * Gmail's labels after a MOVE. Into Trash: none (Gmail drops them). Out of a
+ * label folder: that label goes. Into a label folder: that label comes. INBOX
+ * and All Mail are not labels here; `\\Inbox` membership is the folder itself.
+ */
+function gmailLabelsAfterMove(labels, source, destination, server) {
+    const special = (name) => name === 'INBOX' || Boolean(server.mailboxes.get(name)?.specialUse);
+    if (server.mailboxes.get(destination)?.specialUse === '\\Trash')
+        return [];
+    const out = labels.filter((l) => l !== source);
+    if (!special(destination) && !out.includes(destination))
+        out.push(destination);
+    return out;
+}
 function partKey(mailbox, uid, part) {
     return `${mailbox}/${uid}/${part}`;
 }
@@ -15,12 +29,138 @@ export class FakeImapServer {
     downloads = [];
     /** Every FLAGS-only fetch served: which uids were asked for, since when, how many answered. */
     flagFetches = [];
+    /** Every bulk-headers fetch served (`fetchBulk`): which uids were asked for. */
+    bulkFetches = [];
     /** Each message's mod-sequence, keyed `<mailbox>/<uid>`, for a CONDSTORE mailbox. */
     modseqs = new Map();
+    /**
+     * What CAPABILITY answers. A plain server by default (MOVE and UIDPLUS, as
+     * Dovecot, Fastmail and iCloud have); `gmail()` adds `X-GM-EXT-1`. A test
+     * about a server without MOVE or UIDPLUS takes them out.
+     */
+    capabilities = ['IMAP4REV1', 'MOVE', 'UIDPLUS'];
+    /**
+     * Every write this server accepted, in order. There is no `expunge` and no
+     * `\\Deleted` here because the client never sends one — a test asserting
+     * that reads this log.
+     */
+    writes = [];
+    /** Every presence question served: how it was answered (`vanished` or `search`) and over which range. */
+    departureChecks = [];
+    /** Uids that left a QRESYNC mailbox, with the mod-sequence they left at. */
+    vanishedLog = [];
+    /** How many times an IDLE session asked for Sent's UIDNEXT. */
+    sentChecks = 0;
+    /**
+     * IDLE (RFC 2177): sessions open on this server, every IDLE login it
+     * accepted or refused, and the switches a test flips. A server without
+     * `IDLE` in `capabilities` answers the IDLE factory with 'unsupported'.
+     */
+    idlers = new Set();
+    idleConnects = 0;
+    /** When set, an IDLE login is refused the way a provider refuses a revoked app password. */
+    refuseIdleLogin = false;
+    /** When set, an IDLE connect fails like a network that is down (not a refusal). */
+    idleUnreachable = false;
     constructor(seed = {}) {
         for (const [name, box] of Object.entries(seed))
             this.mailboxes.set(name, box);
     }
+    /**
+     * A Gmail-shaped server: `X-GM-EXT-1`, INBOX, All Mail (`\\All`), Trash
+     * (`\\Trash`), Sent, and whatever labels a test adds as folders. Moving a
+     * message to Trash drops its labels, as Gmail does.
+     */
+    static gmail(labels = []) {
+        const server = new FakeImapServer({
+            INBOX: { uidValidity: 1, messages: [] },
+            '[Gmail]/All Mail': { uidValidity: 11, messages: [], specialUse: '\\All' },
+            '[Gmail]/Sent Mail': { uidValidity: 12, messages: [], specialUse: '\\Sent' },
+            '[Gmail]/Trash': { uidValidity: 13, messages: [], specialUse: '\\Trash' },
+        });
+        labels.forEach((label, i) => server.mailboxes.set(label, { uidValidity: 20 + i, messages: [] }));
+        server.capabilities = ['IMAP4REV1', 'MOVE', 'UIDPLUS', 'X-GM-EXT-1'];
+        return server;
+    }
+    /** Whether this server says it is Gmail. */
+    get isGmail() {
+        return this.capabilities.includes('X-GM-EXT-1');
+    }
+    /** The message at `<mailbox>/<uid>`, or undefined. */
+    find(name, uid) {
+        return this.mailboxes.get(name)?.messages.find((m) => m.uid === uid);
+    }
+    /** All Mail's alias uids for messages this fake keeps in another (label or inbox) folder. */
+    allMailAliases = new Map();
+    /** An All Mail uid for a message held outside All Mail, Trash and Spam, or null. */
+    allMailAlias(messageId) {
+        for (const [name, box] of this.mailboxes) {
+            if (box.specialUse === '\\Trash' || box.specialUse === '\\Junk' || box.specialUse === '\\All')
+                continue;
+            const m = box.messages.find((x) => x.messageId === messageId);
+            if (!m)
+                continue;
+            const uid = 1_000_000 + this.allMailAliases.size + 1;
+            this.allMailAliases.set(uid, { mailbox: name, uid: m.uid });
+            return uid;
+        }
+        return null;
+    }
+    /** Where a message with this Message-ID is now: every `{ mailbox, uid }` holding it. */
+    whereIs(messageId) {
+        const out = [];
+        for (const [name, box] of this.mailboxes) {
+            for (const m of box.messages)
+                if (m.messageId === messageId)
+                    out.push({ mailbox: name, uid: m.uid });
+        }
+        return out;
+    }
+    /** `UID MOVE`, as a server does it: the next uid in the destination, gone from the source. */
+    moveMessages(source, uids, destination) {
+        if (!this.capabilities.includes('MOVE'))
+            throw new Error('fake imap: MOVE is not supported here');
+        if (!this.mailboxes.has(destination))
+            throw new Error(`fake imap: [TRYCREATE] no mailbox ${destination}`);
+        const from = this.mailbox(source);
+        const to = this.mailbox(destination);
+        const uidMap = new Map();
+        for (const uid of [...uids].sort((a, b) => a - b)) {
+            const message = from.messages.find((m) => m.uid === uid);
+            if (!message)
+                continue;
+            const next = Math.max(0, ...to.messages.map((m) => m.uid), to.uidNextFloor ?? 0) + 1;
+            to.uidNextFloor = next;
+            const labels = this.isGmail ? gmailLabelsAfterMove(message.labels ?? [], source, destination, this) : message.labels;
+            to.messages.push({ ...message, uid: next, ...(labels ? { labels } : {}) });
+            from.messages = from.messages.filter((m) => m.uid !== uid);
+            this.#vanish(source, uid);
+            this.#touch(destination, next);
+            uidMap.set(uid, next);
+            this.#notify(source, 'expunge');
+            this.#notify(destination, 'exists');
+        }
+        this.writes.push({ op: 'move', mailbox: source, uids: [...uids], destination });
+        return {
+            uidValidity: this.capabilities.includes('UIDPLUS') ? to.uidValidity : null,
+            uidMap: this.capabilities.includes('UIDPLUS') ? uidMap : new Map(),
+        };
+    }
+    /** `UID STORE ±FLAGS`. */
+    storeFlags(name, uids, flags, how) {
+        const box = this.mailbox(name);
+        for (const m of box.messages) {
+            if (!uids.includes(m.uid))
+                continue;
+            const set = new Set(m.flags);
+            for (const f of flags)
+                how === 'add' ? set.add(f) : set.delete(f);
+            m.flags = [...set];
+            this.#touch(name, m.uid);
+            this.#notify(name, 'flags');
+        }
+        this.writes.push({ op: 'store', mailbox: name, uids: [...uids], flags: [...flags], how });
+    }
     mailbox(name) {
         let box = this.mailboxes.get(name);
         if (!box) {
@@ -32,9 +172,11 @@ export class FakeImapServer {
     /** Append a message, assigning the next uid. Returns the uid it got. */
     add(name, message) {
         const box = this.mailbox(name);
-        const uid = message.uid ?? Math.max(0, ...box.messages.map((m) => m.uid)) + 1;
+        const uid = message.uid ?? Math.max(0, ...box.messages.map((m) => m.uid), box.uidNextFloor ?? 0) + 1;
+        box.uidNextFloor = Math.max(box.uidNextFloor ?? 0, uid);
         box.messages.push({ ...message, uid });
         this.#touch(name, uid);
+        this.#notify(name, 'exists');
         return uid;
     }
     /**
@@ -47,12 +189,128 @@ export class FakeImapServer {
             throw new Error(`fake imap: no uid ${uid} in ${name}`);
         message.flags = [...flags];
         this.#touch(name, uid);
+        this.#notify(name, 'flags');
     }
     /** Archive or delete elsewhere: the message is simply not in this mailbox any more. */
     remove(name, uid) {
         const box = this.mailbox(name);
         box.messages = box.messages.filter((m) => m.uid !== uid);
+        this.#vanish(name, uid);
+        this.#notify(name, 'expunge');
+    }
+    /**
+     * What another mail app does when it moves a message: gone from `source`,
+     * in `destination` under the next uid there (labels as Gmail would leave
+     * them). Returns the new uid.
+     */
+    moveElsewhere(source, uid, destination) {
+        const caps = this.capabilities;
+        this.capabilities = caps.includes('MOVE') ? caps : [...caps, 'MOVE'];
+        try {
+            const result = this.moveMessages(source, [uid], destination);
+            this.writes.pop();
+            const to = result.uidMap.get(uid);
+            if (to !== undefined)
+                return to;
+            return Math.max(...this.mailbox(destination).messages.map((m) => m.uid));
+        }
+        finally {
+            this.capabilities = caps;
+        }
+    }
+    /** A message left `name`: forget its modseq, and on a QRESYNC mailbox remember it vanished. */
+    #vanish(name, uid) {
         this.modseqs.delete(`${name}/${uid}`);
+        const box = this.mailbox(name);
+        if (box.condstore && box.qresync) {
+            box.highestModseq = (box.highestModseq ?? 1) + 1;
+            this.vanishedLog.push({ mailbox: name, uid, modseq: box.highestModseq });
+        }
+    }
+    /**
+     * Gmail's `UID STORE ±X-GM-LABELS`. `\\Inbox` is membership of INBOX,
+     * not a stored label here: taking it off moves the message to the label
+     * folder it was given last (else All Mail), putting it on brings it back to
+     * INBOX. Taking off the label of the folder it sits in moves it the same
+     * way. Other labels are just kept on the message.
+     */
+    storeLabels(name, uids, labels, how) {
+        if (!this.isGmail)
+            throw new Error('fake imap: X-GM-LABELS on a server that is not Gmail');
+        const box = this.mailbox(name);
+        const allMail = [...this.mailboxes.entries()].find(([, b]) => b.specialUse === '\\All')?.[0] ?? null;
+        const isLabelFolder = (l) => this.mailboxes.has(l) && !this.mailboxes.get(l).specialUse && l !== 'INBOX';
+        for (const uid of [...uids]) {
+            const message = box.messages.find((m) => m.uid === uid);
+            if (!message)
+                continue;
+            const held = new Set((message.labels ?? []).filter((l) => l !== '\\Inbox'));
+            let inbox = name === 'INBOX';
+            for (const label of labels) {
+                if (label === '\\Inbox')
+                    inbox = how === 'add';
+                else if (how === 'add')
+                    held.add(label);
+                else
+                    held.delete(label);
+            }
+            message.labels = [...held];
+            let home = name;
+            if (inbox)
+                home = 'INBOX';
+            else if (name === 'INBOX' || (isLabelFolder(name) && !held.has(name))) {
+                // The label added last: the single copy here sits where the newest label puts it.
+                home = [...held].reverse().find(isLabelFolder) ?? allMail;
+            }
+            if (home && home !== name) {
+                const to = this.mailbox(home);
+                const next = Math.max(0, ...to.messages.map((m) => m.uid), to.uidNextFloor ?? 0) + 1;
+                to.uidNextFloor = next;
+                to.messages.push({ ...message, uid: next });
+                box.messages = box.messages.filter((m) => m.uid !== uid);
+                this.#vanish(name, uid);
+                this.#touch(home, next);
+                this.#notify(name, 'expunge');
+                this.#notify(home, 'exists');
+            }
+            else {
+                this.#touch(name, uid);
+            }
+        }
+        this.writes.push({ op: 'store-labels', mailbox: name, uids: [...uids], labels: [...labels], how });
+    }
+    /** Tell every session idling on this mailbox, as an untagged response would. */
+    #notify(name, change) {
+        for (const session of this.idlers)
+            session.push(name, change);
+    }
+    /** The network drops every IDLE connection: each session ends with an error. */
+    dropIdle() {
+        for (const session of [...this.idlers])
+            session.drop(new Error('fake imap: connection reset'));
+    }
+    /** The IDLE factory: a connection of its own on INBOX, as the real one opens. */
+    idleFactory() {
+        return async (_account, auth, onChange) => {
+            this.idleConnects += 1;
+            if (this.idleUnreachable)
+                throw Object.assign(new Error('fake imap: connect ECONNREFUSED'), { code: 'ECONNREFUSED' });
+            if (this.refuseIdleLogin || auth.pass === 'wrong') {
+                throw Object.assign(new Error('Command failed'), {
+                    authenticationFailed: true,
+                    responseText: 'Invalid credentials (Failure)',
+                });
+            }
+            if (!this.capabilities.includes('IDLE'))
+                return 'unsupported';
+            const session = new FakeIdleSession(this, 'INBOX', onChange);
+            this.idlers.add(session);
+            return session;
+        };
+    }
+    /** @internal */
+    forget(session) {
+        this.idlers.delete(session);
     }
     /** Bump the mailbox's mod-sequence and give it to this message, when the mailbox has one. */
     #touch(name, uid) {
@@ -82,7 +340,7 @@ export class FakeImapServer {
             flags: [],
             status: {
                 uidValidity: box.uidValidity,
-                uidNext: Math.max(0, ...box.messages.map((m) => m.uid)) + 1,
+                uidNext: Math.max(0, ...box.messages.map((m) => m.uid), box.uidNextFloor ?? 0) + 1,
                 exists: box.messages.length,
             },
         }));
@@ -94,6 +352,52 @@ export class FakeImapServer {
         return async () => this.client();
     }
 }
+/** One IDLE connection on the fake server. */
+class FakeIdleSession {
+    server;
+    mailbox;
+    onChange;
+    ended;
+    #settle;
+    #done = false;
+    constructor(server, mailbox, onChange) {
+        this.server = server;
+        this.mailbox = mailbox;
+        this.onChange = onChange;
+        this.ended = new Promise((resolve) => {
+            this.#settle = resolve;
+        });
+    }
+    push(mailbox, change) {
+        if (this.#done || mailbox !== this.mailbox)
+            return;
+        this.onChange(change);
+    }
+    /** `STATUS <Sent> (UIDNEXT)` over this connection, as the real session asks it. */
+    async sentUidNext(folder) {
+        if (this.#done)
+            throw new Error('fake imap: IDLE connection is closed');
+        if (!this.server.mailboxes.has(folder))
+            return null;
+        this.server.sentChecks += 1;
+        const box = this.server.mailbox(folder);
+        return Math.max(0, ...box.messages.map((m) => m.uid), box.uidNextFloor ?? 0) + 1;
+    }
+    drop(error) {
+        if (this.#done)
+            return;
+        this.#done = true;
+        this.server.forget(this);
+        this.#settle({ error });
+    }
+    async close() {
+        if (this.#done)
+            return;
+        this.#done = true;
+        this.server.forget(this);
+        this.#settle({});
+    }
+}
 class FakeImapClient {
     server;
     #closed = false;
@@ -111,11 +415,19 @@ class FakeImapClient {
         const box = this.server.mailbox(mailbox);
         return {
             uidValidity: box.uidValidity,
-            uidNext: Math.max(0, ...box.messages.map((m) => m.uid)) + 1,
+            uidNext: Math.max(0, ...box.messages.map((m) => m.uid), box.uidNextFloor ?? 0) + 1,
             exists: box.messages.length,
             highestModseq: box.condstore ? String(box.highestModseq ?? 1) : null,
         };
     }
+    async fetchBulk(mailbox, uids) {
+        if (this.#closed)
+            throw new Error('fake imap: client is closed');
+        const box = this.server.mailbox(mailbox);
+        const wanted = new Set(uids);
+        this.server.bulkFetches.push({ mailbox, uids: [...uids] });
+        return new Map(box.messages.filter((m) => wanted.has(m.uid)).map((m) => [m.uid, m.bulk === true]));
+    }
     async fetchFlags(mailbox, uids, changedSince) {
         if (this.#closed)
             throw new Error('fake imap: client is closed');
@@ -151,7 +463,7 @@ class FakeImapClient {
         this.server.fetches.push({ mailbox, sinceUid, limit, returned: selected.length });
         // Deep-ish copy: a caller that mutates what it got must not reach into the
         // server's own flags, which is exactly the peek property under test.
-        return selected.map((m) => ({
+        return selected.map(({ labels: _labels, ...m }) => ({
             ...m,
             to: [...m.to],
             cc: [...m.cc],
@@ -188,6 +500,83 @@ class FakeImapClient {
         }
         return Buffer.from(bytes);
     }
+    async capabilities() {
+        if (this.#closed)
+            throw new Error('fake imap: client is closed');
+        return this.server.capabilities.map((c) => c.toUpperCase());
+    }
+    async storeFlags(mailbox, uids, flags, op) {
+        if (this.#closed)
+            throw new Error('fake imap: client is closed');
+        this.server.storeFlags(mailbox, uids, flags, op);
+    }
+    async move(mailbox, uids, destination) {
+        if (this.#closed)
+            throw new Error('fake imap: client is closed');
+        return this.server.moveMessages(mailbox, uids, destination);
+    }
+    async findByMessageId(mailbox, messageId) {
+        if (this.#closed)
+            throw new Error('fake imap: client is closed');
+        const found = this.server.mailbox(mailbox).messages.find((m) => m.messageId === messageId);
+        if (found)
+            return found.uid;
+        // Gmail's All Mail holds every message not in Trash or Spam, whichever
+        // label folder this fake keeps its one copy in: answer with an alias uid.
+        if (this.server.isGmail && this.server.mailboxes.get(mailbox)?.specialUse === '\\All') {
+            return this.server.allMailAlias(messageId);
+        }
+        return null;
+    }
+    async fetchLabels(mailbox, uids) {
+        if (!this.server.isGmail)
+            throw new Error('fake imap: X-GM-LABELS on a server that is not Gmail');
+        const out = new Map();
+        for (const uid of uids) {
+            const alias = this.server.allMailAliases.get(uid);
+            if (alias && this.server.mailboxes.get(mailbox)?.specialUse === '\\All') {
+                const m = this.server.find(alias.mailbox, alias.uid);
+                if (m)
+                    out.set(uid, [...(m.labels ?? [])]);
+            }
+        }
+        for (const m of this.server.mailbox(mailbox).messages) {
+            if (uids.includes(m.uid))
+                out.set(m.uid, [...(m.labels ?? [])]);
+        }
+        return out;
+    }
+    async departures(mailbox, range) {
+        if (this.#closed)
+            throw new Error('fake imap: client is closed');
+        const box = this.server.mailbox(mailbox);
+        const inRange = (uid) => uid >= range.fromUid && uid <= range.toUid;
+        if (range.changedSince && box.condstore && box.qresync) {
+            const since = Number(range.changedSince);
+            const vanished = this.server.vanishedLog
+                .filter((v) => v.mailbox === mailbox && v.modseq > since && inRange(v.uid))
+                .map((v) => v.uid);
+            this.server.departureChecks.push({ mailbox, via: 'vanished', fromUid: range.fromUid, toUid: range.toUid });
+            return { vanished };
+        }
+        this.server.departureChecks.push({ mailbox, via: 'search', fromUid: range.fromUid, toUid: range.toUid });
+        return { present: box.messages.map((m) => m.uid).filter(inRange).sort((a, b) => a - b) };
+    }
+    async storeLabels(mailbox, uids, labels, op) {
+        if (this.#closed)
+            throw new Error('fake imap: client is closed');
+        this.server.storeLabels(mailbox, uids, labels, op);
+    }
+    async addLabels(mailbox, uids, labels) {
+        if (!this.server.isGmail)
+            throw new Error('fake imap: X-GM-LABELS on a server that is not Gmail');
+        for (const m of this.server.mailbox(mailbox).messages) {
+            if (!uids.includes(m.uid))
+                continue;
+            m.labels = [...new Set([...(m.labels ?? []), ...labels])].filter((l) => l !== '\\Inbox');
+        }
+        this.server.writes.push({ op: 'labels', mailbox, uids: [...uids], labels: [...labels] });
+    }
     async close() {
         this.#closed = true;
         this.server.closes += 1;