@wirecat/mail-cli 0.0.0-stage → 0.1.0

package/dist/mail/imap-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imap-errors.js","sourceRoot":"","sources":["../../src/mail/imap-errors.ts"],"names":[],"mappings":"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"}

package/dist/mail/imap-messages.d.ts

@@ -0,0 +1,18 @@
+import type { Listed, Quick } from "@wirecat/cli-core/mail";
+import type { FetchMessageObject, ListResponse } from "imapflow";
+/** The header fields a listing asks for, so a mailing list is told apart from a person's mail. */
+export declare const HEADER_FIELDS: string[];
+export declare const quickOf: (message: FetchMessageObject, folder: string) => Quick;
+/** Without a stable id the Message-ID is the identity; without that, the UID, which means nothing without UIDVALIDITY. */
+export declare const idsOf: (messageId: string | undefined, folder: string, validity: string, uid: string) => {
+    messageId: string;
+    threadId: string;
+};
+export declare const listedOf: (message: FetchMessageObject, folder: string, validity: string) => Listed;
+/**
+ * The Message-ID as the server's ENVELOPE gives it (imapflow trims the value of the first header), so the id of a
+ * message read as bytes is the id `list` gives it.
+ */
+export declare const messageIdOf: (raw: Uint8Array) => string | undefined;
+export declare const roleOf: (entry: ListResponse) => string | null;
+//# sourceMappingURL=imap-messages.d.ts.map

package/dist/mail/imap-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imap-messages.d.ts","sourceRoot":"","sources":["../../src/mail/imap-messages.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAe,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAEhE,kGAAkG;AAClG,eAAO,MAAM,aAAa,UAAgD,CAAA;AA0B1E,eAAO,MAAM,OAAO,YAAa,kBAAkB,UAAU,MAAM,KAAG,KAYrE,CAAA;AAED,0HAA0H;AAC1H,eAAO,MAAM,KAAK,cAAe,MAAM,GAAG,SAAS,UAAU,MAAM,YAAY,MAAM,OAAO,MAAM;IAEvF,SAAS;IAAoB,QAAQ;CAC/C,CAAA;AAED,eAAO,MAAM,QAAQ,YAAa,kBAAkB,UAAU,MAAM,YAAY,MAAM,KAAG,MAQxF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,QAAS,UAAU,KAAG,MAAM,GAAG,SAOtD,CAAA;AAED,eAAO,MAAM,MAAM,UAAW,YAAY,KAAG,MAAM,GAAG,IAGrD,CAAA"}

package/dist/mail/imap-messages.js

@@ -0,0 +1,66 @@
+import { createHash } from "node:crypto";
+/** The header fields a listing asks for, so a mailing list is told apart from a person's mail. */
+export const HEADER_FIELDS = ["list-id", "list-unsubscribe", "precedence"];
+const digest = (id) => `imap:${createHash("sha256").update(id).digest("hex")}`;
+const headersOf = (message) => {
+    const from = message.envelope?.from?.[0];
+    const raw = message.headers ? message.headers.toString("utf8") : "";
+    const field = (name) => new RegExp(`^${name}:[ \\t]*(.*)$`, "im").exec(raw.replace(/\r?\n[ \t]+/g, " "))?.[1]?.trim();
+    const listId = field("list-id");
+    const bulk = listId !== undefined ||
+        field("list-unsubscribe") !== undefined ||
+        /^(bulk|list|junk)$/i.test(field("precedence") ?? "");
+    return {
+        ...(from?.address ? { from: from.address.toLowerCase() } : {}),
+        ...(from?.name ? { fromName: from.name } : {}),
+        ...(message.envelope?.subject ? { subject: message.envelope.subject } : {}),
+        to: [...(message.envelope?.to ?? []), ...(message.envelope?.cc ?? [])].flatMap((a) => a.address ? [a.address.toLowerCase()] : []),
+        ...(listId ? { listId } : {}),
+        bulk,
+    };
+};
+export const quickOf = (message, folder) => {
+    const flags = message.flags ?? new Set();
+    const received = message.internalDate instanceof Date ? message.internalDate : new Date(message.internalDate ?? 0);
+    return {
+        uid: String(message.uid),
+        receivedAt: received.toISOString(),
+        folder,
+        ...(message.size === undefined ? {} : { size: message.size }),
+        seen: flags.has("\\Seen"),
+        flagged: flags.has("\\Flagged"),
+        labels: message.labels ? [...message.labels] : flags.has("\\Flagged") ? ["Starred"] : [],
+    };
+};
+/** Without a stable id the Message-ID is the identity; without that, the UID, which means nothing without UIDVALIDITY. */
+export const idsOf = (messageId, folder, validity, uid) => {
+    const identity = messageId ?? `uid:${folder}:${validity}:${uid}`;
+    return { messageId: digest(identity), threadId: digest(identity) };
+};
+export const listedOf = (message, folder, validity) => {
+    const ids = idsOf(message.envelope?.messageId, folder, validity, String(message.uid));
+    return {
+        ...quickOf(message, folder),
+        ...(message.emailId ? { messageId: String(message.emailId) } : { messageId: ids.messageId }),
+        threadId: message.threadId ? String(message.threadId) : ids.threadId,
+        headers: headersOf(message),
+    };
+};
+/**
+ * The Message-ID as the server's ENVELOPE gives it (imapflow trims the value of the first header), so the id of a
+ * message read as bytes is the id `list` gives it.
+ */
+export const messageIdOf = (raw) => {
+    const bytes = Buffer.from(raw.buffer, raw.byteOffset, raw.byteLength);
+    const end = [bytes.indexOf("\r\n\r\n"), bytes.indexOf("\n\n")]
+        .filter((at) => at !== -1)
+        .reduce((first, at) => Math.min(first, at), bytes.length);
+    const head = bytes.subarray(0, end).toString("utf8");
+    return /^message-id:[ \t]*(.*)$/im.exec(head.replace(/\r?\n[ \t]+/g, " "))?.[1]?.trim() || undefined;
+};
+export const roleOf = (entry) => {
+    if (entry.path.toUpperCase() === "INBOX")
+        return "inbox";
+    return entry.specialUse ? entry.specialUse.replace(/^\\/, "").toLowerCase() : null;
+};
+//# sourceMappingURL=imap-messages.js.map

package/dist/mail/imap-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imap-messages.js","sourceRoot":"","sources":["../../src/mail/imap-messages.ts"],"names":[],"mappings":"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"}

package/dist/mail/imap.d.ts

@@ -0,0 +1,67 @@
+import type { MailSource } from "@wirecat/cli-core/mail";
+export interface ImapEndpoint {
+    host: string;
+    port: number;
+    /** `plain` is for a local test server only; no profile can ask for it. */
+    security: "tls" | "starttls" | "plain";
+    login: string;
+}
+export interface FolderInfo {
+    path: string;
+    name: string;
+    role: string | null;
+    messages: number | null;
+    unseen: number | null;
+}
+export interface AccountCheck {
+    login: string;
+    capabilities: string[];
+    features: Record<"idle" | "condstore" | "qresync" | "move" | "uidplus" | "compress" | "x_gm_ext_1" | "objectid", boolean>;
+    folders: number;
+}
+export type ImapMailSource = MailSource & {
+    check(): Promise<AccountCheck>;
+    folderList(): Promise<FolderInfo[]>;
+    close(): Promise<void>;
+};
+/**
+ * How the source spends a connection. The defaults come from measuring Yandex 360 (cli-testing,
+ * performance/mail/yandex-imap-sync): a header FETCH takes 0.1 to 0.7 s per message and the time per message grows with
+ * the size of the command, four connections read 2 to 3 times faster than one, and the server sometimes answers one
+ * message with `NO [UNAVAILABLE]` and then closes the connection. So a call reads 15 messages on each of 4 connections:
+ * a request of the budget (listBatch, fetchBatch) is 60 messages and takes about 9 s.
+ */
+export interface ImapTuning {
+    /** Messages in one FETCH command. */
+    listSize?: number;
+    /** UIDs in one FETCH that asks only for flags, date and size. */
+    quickSize?: number;
+    fetchSize?: number;
+    /** Parallel connections one `list` or `fetchRaw` call spreads its commands over. */
+    connections?: number;
+    /** One command's own limit; the socket limit only catches a dead line. */
+    requestTimeoutMs?: number;
+    /** Waits before each retry of a command, jittered; the last one repeats. */
+    backoffMs?: readonly number[];
+    /** A hard ceiling per command; the budget and the deadline usually stop the retries first. */
+    maxAttempts?: number;
+    /** A retry is a request of the run's budget: false stops the retries. */
+    canRetry?: () => boolean;
+    /** Time left to the run's deadline; a retry that would not fit is not made. */
+    timeLeftMs?: () => number | undefined;
+    signal?: AbortSignal;
+    sleep?: (ms: number, signal?: AbortSignal) => Promise<void>;
+    random?: () => number;
+}
+export declare const IMAP_DEFAULTS: {
+    readonly listSize: 15;
+    readonly quickSize: 500;
+    readonly fetchSize: 15;
+    readonly connections: 4;
+    readonly requestTimeoutMs: 90000;
+    readonly backoffMs: readonly [1000, 3000, 10000];
+    readonly maxAttempts: 8;
+};
+/** One IMAP source, its connections opened on first use and closed by `close`; the password never leaves this closure. */
+export declare const imapSource: (endpoint: ImapEndpoint, password: string, tuning?: ImapTuning) => ImapMailSource;
+//# sourceMappingURL=imap.d.ts.map

package/dist/mail/imap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imap.d.ts","sourceRoot":"","sources":["../../src/mail/imap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,wBAAwB,CAAA;AAKzE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,0EAA0E;IAC1E,QAAQ,EAAE,KAAK,GAAG,UAAU,GAAG,OAAO,CAAA;IACtC,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,QAAQ,EAAE,MAAM,CACd,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,UAAU,EAC9F,OAAO,CACR,CAAA;IACD,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG;IACxC,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC,CAAA;IAC9B,UAAU,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;IACnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB,CAAA;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,oFAAoF;IACpF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC7B,8FAA8F;IAC9F,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAA;IACxB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAA;IACrC,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3D,MAAM,CAAC,EAAE,MAAM,MAAM,CAAA;CACtB;AAED,eAAO,MAAM,aAAa;aACxB,QAAQ,EAAE,EAAE;aACZ,SAAS,EAAE,GAAG;aACd,SAAS,EAAE,EAAE;aACb,WAAW,EAAE,CAAC;aACd,gBAAgB,EAAE,KAAM;aACxB,SAAS,YAAG,IAAK,EAAE,IAAK,EAAE,KAAM;aAChC,WAAW,EAAE,CAAC;CACN,CAAA;AAgBV,0HAA0H;AAC1H,eAAO,MAAM,UAAU,aAAc,YAAY,YAAY,MAAM,WAAU,UAAU,KAAQ,cAkX9F,CAAA"}

package/dist/mail/imap.js

@@ -0,0 +1,348 @@
+import { CliError } from "@wirecat/cli-base";
+import { ImapFlow } from "imapflow";
+import { mapImapError } from "./imap-errors.js";
+import { HEADER_FIELDS, idsOf, listedOf, messageIdOf, quickOf, roleOf } from "./imap-messages.js";
+export const IMAP_DEFAULTS = {
+    listSize: 15,
+    quickSize: 500,
+    fetchSize: 15,
+    connections: 4,
+    requestTimeoutMs: 90_000,
+    backoffMs: [1_000, 3_000, 10_000],
+    maxAttempts: 8,
+};
+const nap = (ms, signal) => new Promise((resolve, reject) => {
+    if (signal?.aborted)
+        return reject(signal.reason);
+    const timer = setTimeout(resolve, ms);
+    signal?.addEventListener("abort", () => {
+        clearTimeout(timer);
+        reject(signal.reason);
+    }, { once: true });
+});
+/** One IMAP source, its connections opened on first use and closed by `close`; the password never leaves this closure. */
+export const imapSource = (endpoint, password, tuning = {}) => {
+    const { listSize, quickSize, fetchSize, connections, requestTimeoutMs, backoffMs, maxAttempts } = {
+        ...IMAP_DEFAULTS,
+        ...tuning,
+    };
+    const { canRetry, timeLeftMs, signal, sleep = nap, random = Math.random } = tuning;
+    const clients = [];
+    /** Each folder's UIDVALIDITY as the run first saw it; a reconnect that finds another one stops the run. */
+    const validities = new Map();
+    const connect = async (slot) => {
+        const existing = clients[slot];
+        if (existing?.usable)
+            return existing;
+        const next = new ImapFlow({
+            host: endpoint.host,
+            port: endpoint.port,
+            secure: endpoint.security === "tls",
+            doSTARTTLS: endpoint.security === "starttls",
+            auth: { user: endpoint.login, pass: password },
+            logger: false,
+            disableAutoIdle: true,
+            connectionTimeout: 15000,
+            greetingTimeout: 15000,
+            socketTimeout: 120000,
+        });
+        // An 'error' event with no listener would end the process, and the failing call already rejects.
+        next.on("error", () => { });
+        await next.connect();
+        clients[slot] = next;
+        return next;
+    };
+    const drop = (slot) => {
+        const open = clients[slot];
+        clients[slot] = undefined;
+        try {
+            open?.close();
+        }
+        catch { }
+    };
+    /** One command's own deadline, cut to the run's: a stuck command closes its connection and fails as a timeout. */
+    const limited = async (slot, work) => {
+        const left = timeLeftMs?.();
+        const ms = left === undefined ? requestTimeoutMs : Math.max(1, Math.min(requestTimeoutMs, left));
+        let timer;
+        const expired = new Promise((_, reject) => {
+            timer = setTimeout(() => {
+                drop(slot);
+                reject(Object.assign(new Error("request timed out"), { code: "RequestTimeout" }));
+            }, ms);
+        });
+        work.catch(() => { });
+        try {
+            return await Promise.race([work, expired]);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    };
+    const once = async (slot, folder, expected, work) => {
+        const open = await limited(slot, connect(slot));
+        if (folder === undefined)
+            return limited(slot, work(open, ""));
+        const lock = await limited(slot, open.getMailboxLock(folder, { readOnly: true }));
+        try {
+            // imapflow clears the selection when a SELECT fails or the server closes the mailbox, and a connection
+            // in that state still counts as usable: a command sent on it fails with NoMailboxSelected.
+            if (!open.mailbox)
+                throw Object.assign(new Error("no mailbox is selected"), { code: "NoMailboxSelected" });
+            const validity = String(open.mailbox.uidValidity);
+            const was = expected ?? validities.get(folder);
+            if (was !== undefined && validity !== was)
+                throw new CliError("invalid_response", "UIDVALIDITY changed during the run; run it again", {
+                    reason: "mail.uidvalidity-changed",
+                });
+            return await limited(slot, work(open, validity));
+        }
+        finally {
+            try {
+                lock.release();
+            }
+            catch { }
+        }
+    };
+    /**
+     * Every call here only reads, so a failed command is safe to send again. A dropped line or a command that timed
+     * out closes its connection, waits (jittered backoff) and tries on a fresh one, for as long as the run's budget
+     * and deadline allow: a retry is a request of the budget, and none outlives the deadline.
+     */
+    const retrying = async (slot, command) => {
+        for (let attempt = 1;; attempt++) {
+            try {
+                return await command();
+            }
+            catch (raw) {
+                const error = mapImapError(raw);
+                const transient = error.code === "network_error" || error.code === "timeout" || error.code === "provider_unavailable";
+                if (transient)
+                    drop(slot);
+                if (!transient || attempt >= maxAttempts || signal?.aborted)
+                    throw error;
+                const base = backoffMs[Math.min(attempt, backoffMs.length) - 1] ?? 10_000;
+                const wait = Math.round(base * (0.5 + random()));
+                const left = timeLeftMs?.();
+                if (left !== undefined && left <= wait)
+                    throw error;
+                if (canRetry && !canRetry())
+                    throw error;
+                await sleep(wait, signal);
+            }
+        }
+    };
+    const inFolder = (folder, work, expected, slot = 0) => retrying(slot, () => once(slot, folder, expected, work));
+    /** Runs `work` over the batches on up to `connections` connections; the first failure stops the others. */
+    const spread = async (folder, batches, work, expected, onError) => {
+        const results = new Array(batches.length);
+        let next = 0;
+        let failure;
+        const worker = async (slot) => {
+            for (;;) {
+                const index = next++;
+                if (index >= batches.length || failure !== undefined)
+                    return;
+                const batch = batches[index];
+                try {
+                    results[index] = await inFolder(folder, (open) => work(open, batch), expected, slot);
+                }
+                catch (error) {
+                    if (onError === undefined) {
+                        failure ??= error;
+                        return;
+                    }
+                    try {
+                        results[index] = onError(error, batch);
+                    }
+                    catch (fatal) {
+                        failure ??= fatal;
+                        return;
+                    }
+                }
+            }
+        };
+        await Promise.all(Array.from({ length: Math.min(connections, batches.length) }, (_, slot) => worker(slot)));
+        if (failure !== undefined)
+            throw failure;
+        return results;
+    };
+    const chunks = (items, size) => {
+        const out = [];
+        for (let start = 0; start < items.length; start += size)
+            out.push(items.slice(start, start + size));
+        return out;
+    };
+    const search = async (since, folder) => {
+        const found = await inFolder(folder, async (open, validity) => {
+            const uids = await open.search({ since }, { uid: true });
+            // Message ids come free with OBJECTID and Gmail's extensions; without them the envelope costs a read per message.
+            const quick = !open.capabilities.has("OBJECTID") && !open.capabilities.has("X-GM-EXT-1");
+            return { ...(validity ? { validity } : {}), uids: (uids || []).map(String), ...(quick ? { quick } : {}) };
+        });
+        if (found.validity)
+            validities.set(folder, found.validity);
+        return found;
+    };
+    const folderList = () => retrying(0, async () => {
+        const entries = await limited(0, connect(0).then((open) => open.list({ statusQuery: { messages: true, unseen: true } })));
+        return entries
+            .filter((entry) => !entry.flags.has("\\Noselect") && !entry.flags.has("\\NonExistent"))
+            .map((entry) => ({
+            path: entry.path,
+            name: entry.name,
+            role: roleOf(entry),
+            messages: entry.status?.messages ?? null,
+            unseen: entry.status?.unseen ?? null,
+        }));
+    });
+    return {
+        listBatch: listSize * connections,
+        fetchBatch: fetchSize * connections,
+        search,
+        present: (uids, folder) => inFolder(folder, async (open) => {
+            if (uids.length === 0)
+                return [];
+            const held = new Set((await open.search({ uid: uids.join(",") }, { uid: true })) || []);
+            return uids.filter((uid) => held.has(Number(uid)));
+        }),
+        folders: async () => {
+            const entries = await folderList();
+            const role = (...names) => entries.find((entry) => entry.role && names.includes(entry.role))?.path;
+            return { all: role("all", "archive") ?? "INBOX", trash: role("trash") ?? "Trash" };
+        },
+        list: async (since, folder, options) => {
+            const searched = options?.searched ?? (await search(since, folder));
+            if (!searched.validity)
+                throw new CliError("invalid_response", "IMAP did not report UIDVALIDITY");
+            const validity = searched.validity;
+            validities.set(folder, validity);
+            // A message the server answers with `NO [UNAVAILABLE]` is simply absent here; the sync asks for it again later.
+            const listing = (batches) => spread(folder, batches, (open, batch) => open.fetchAll(batch.join(","), {
+                uid: true,
+                flags: true,
+                internalDate: true,
+                size: true,
+                envelope: true,
+                threadId: true,
+                labels: true,
+                headers: HEADER_FIELDS,
+            }, { uid: true }), validity, (error) => {
+                const mapped = mapImapError(error);
+                if (mapped.code !== "provider_unavailable")
+                    throw mapped;
+                return mapped;
+            });
+            const batches = chunks(searched.uids, listSize);
+            const parts = await listing(batches);
+            const messages = [];
+            for (const [index, part] of parts.entries()) {
+                if (!(part instanceof Error))
+                    for (const message of part)
+                        messages.push(message);
+                // Yandex refuses even the headers of a message it can never read, and with it the whole FETCH.
+                else if (batches[index].length > 1)
+                    for (const single of await listing(batches[index].map((uid) => [uid])))
+                        if (!(single instanceof Error))
+                            for (const message of single)
+                                messages.push(message);
+            }
+            return messages.map((message) => listedOf(message, folder, validity));
+        },
+        quick: async (_since, folder, { searched }) => {
+            if (!searched.validity)
+                throw new CliError("invalid_response", "IMAP did not report UIDVALIDITY");
+            const validity = searched.validity;
+            validities.set(folder, validity);
+            const parts = await spread(folder, chunks(searched.uids, quickSize), (open, batch) => open.fetchAll(batch.join(","), { uid: true, flags: true, internalDate: true, size: true }, { uid: true }), validity);
+            return parts.flat().map((message) => quickOf(message, folder));
+        },
+        identify: (raw, item) => {
+            const validity = validities.get(item.folder ?? "INBOX") ?? "";
+            return idsOf(messageIdOf(raw), item.folder ?? "INBOX", validity, item.uid);
+        },
+        fetchRaw: async (items) => {
+            const read = new Map();
+            const byFolder = new Map();
+            for (const item of items)
+                byFolder.set(item.folder ?? "INBOX", [...(byFolder.get(item.folder ?? "INBOX") ?? []), item]);
+            const bodies = (folder, batches) => spread(folder, batches, async (open, batch) => {
+                const found = new Map();
+                const messages = await open.fetchAll(batch.map(({ uid }) => uid).join(","), { uid: true, source: true }, { uid: true });
+                for (const message of messages)
+                    if (message.source)
+                        found.set(String(message.uid), message.source);
+                return found;
+            }, undefined, (error) => {
+                // A throttled or dropped connection fails the whole run; one unreadable batch costs only itself.
+                const mapped = mapImapError(error);
+                if (["rate_limited", "authentication_error", "network_error", "timeout"].includes(mapped.code))
+                    throw mapped;
+                return mapped;
+            });
+            for (const [folder, group] of byFolder) {
+                const batches = chunks(group, fetchSize);
+                const answers = await bodies(folder, batches);
+                for (const [index, batch] of batches.entries()) {
+                    let answer = answers[index];
+                    // Yandex refuses a whole FETCH when one of its messages cannot be read; one by one, only that one is lost.
+                    if (answer instanceof CliError && answer.code === "provider_unavailable" && batch.length > 1) {
+                        const singles = await bodies(folder, batch.map((item) => [item]));
+                        answer = new Map();
+                        for (const [at, item] of batch.entries()) {
+                            const single = singles[at];
+                            if (single instanceof Map && single.has(item.uid))
+                                answer.set(item.uid, single.get(item.uid));
+                            else if (single instanceof Error)
+                                read.set(item, single);
+                        }
+                    }
+                    for (const item of batch) {
+                        if (read.has(item))
+                            continue;
+                        const found = answer instanceof Map ? answer.get(item.uid) : undefined;
+                        read.set(item, found ??
+                            (answer instanceof Error ? answer : undefined) ??
+                            new CliError("not_found", `email ${item.uid} was not returned`, { reason: "mail.not-returned" }));
+                    }
+                }
+            }
+            return items.map((item) => read.get(item));
+        },
+        folderList,
+        check: () => retrying(0, async () => {
+            const open = await limited(0, connect(0));
+            const has = (name) => open.capabilities.has(name);
+            const folders = (await limited(0, open.list())).length;
+            return {
+                login: endpoint.login,
+                capabilities: [...open.capabilities.keys()].sort(),
+                features: {
+                    idle: has("IDLE"),
+                    condstore: has("CONDSTORE"),
+                    qresync: has("QRESYNC"),
+                    move: has("MOVE"),
+                    uidplus: has("UIDPLUS"),
+                    compress: has("COMPRESS=DEFLATE"),
+                    x_gm_ext_1: has("X-GM-EXT-1"),
+                    objectid: has("OBJECTID"),
+                },
+                folders,
+            };
+        }),
+        close: async () => {
+            const open = clients.splice(0);
+            await Promise.all(open.map(async (one) => {
+                if (!one)
+                    return;
+                try {
+                    await one.logout();
+                }
+                catch {
+                    one.close();
+                }
+            }));
+        },
+    };
+};
+//# sourceMappingURL=imap.js.map

package/dist/mail/imap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imap.js","sourceRoot":"","sources":["../../src/mail/imap.ts"],"names":[],"mappings":"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"}

package/dist/mail/parse.d.ts

@@ -0,0 +1,18 @@
+export interface Person {
+    address: string;
+    name: string | null;
+}
+export interface ParsedMail {
+    messageId: string | null;
+    subject: string | null;
+    from: Person | null;
+    to: Person[];
+    cc: Person[];
+    sentAt: number | null;
+    inReplyTo: string | null;
+    references: string[];
+    text: string;
+}
+export declare const MAX_BODY_CHARS = 1000000;
+export declare const parseMail: (raw: Uint8Array) => Promise<ParsedMail>;
+//# sourceMappingURL=parse.d.ts.map

package/dist/mail/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/mail/parse.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,MAAM;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,EAAE,EAAE,MAAM,EAAE,CAAA;IACZ,EAAE,EAAE,MAAM,EAAE,CAAA;IACZ,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;CACb;AAGD,eAAO,MAAM,cAAc,UAAY,CAAA;AAkBvC,eAAO,MAAM,SAAS,QAAe,UAAU,KAAG,OAAO,CAAC,UAAU,CAenE,CAAA"}

package/dist/mail/parse.js

@@ -0,0 +1,31 @@
+import PostalMime, {} from "postal-mime";
+// A guard against a pasted log, not a design limit.
+export const MAX_BODY_CHARS = 1_000_000;
+const people = (list) => (list ?? [])
+    .flatMap((entry) => entry.group ?? [entry])
+    .flatMap(({ address, name }) => (address ? [{ address: address.toLowerCase(), name: name || null }] : []));
+const ENTITIES = { nbsp: " ", amp: "&", lt: "<", gt: ">", quot: '"', "#39": "'" };
+// Mail without a text part is read as its HTML with the tags removed; nothing in it is rendered or followed.
+const htmlText = (html) => html
+    .replace(/<!--[\s\S]*?(-->|$)/g, "")
+    .replace(/<(script|style)[\s\S]*?(<\/\1>|$)/gi, "")
+    .replace(/<[^>]*>/g, " ")
+    .replace(/&(nbsp|amp|lt|gt|quot|#39);/g, (_, name) => ENTITIES[name] ?? "")
+    .replace(/[ \t]+/g, " ");
+export const parseMail = async (raw) => {
+    const mail = await PostalMime.parse(raw, { attachmentEncoding: "arraybuffer" });
+    const sent = mail.date ? Date.parse(mail.date) : Number.NaN;
+    const text = (mail.text ?? (mail.html ? htmlText(mail.html) : "")).slice(0, MAX_BODY_CHARS);
+    return {
+        messageId: mail.messageId ?? null,
+        subject: mail.subject ?? null,
+        from: people(mail.from ? [mail.from] : undefined)[0] ?? null,
+        to: people(mail.to),
+        cc: people(mail.cc),
+        sentAt: Number.isNaN(sent) ? null : sent,
+        inReplyTo: mail.inReplyTo ?? null,
+        references: mail.references?.match(/<[^>]+>/g) ?? [],
+        text,
+    };
+};
+//# sourceMappingURL=parse.js.map

package/dist/mail/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/mail/parse.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,EAAE,EAAgB,MAAM,aAAa,CAAA;AAmBtD,oDAAoD;AACpD,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAA;AAEvC,MAAM,MAAM,GAAG,CAAC,IAA2B,EAAY,EAAE,CACvD,CAAC,IAAI,IAAI,EAAE,CAAC;KACT,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC;KAC1C,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAE9G,MAAM,QAAQ,GAA2B,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAA;AAEzG,6GAA6G;AAC7G,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAU,EAAE,CACxC,IAAI;KACD,OAAO,CAAC,sBAAsB,EAAE,EAAE,CAAC;KACnC,OAAO,CAAC,qCAAqC,EAAE,EAAE,CAAC;KAClD,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;KACxB,OAAO,CAAC,8BAA8B,EAAE,CAAC,CAAC,EAAE,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;KAClF,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA;AAE5B,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,GAAe,EAAuB,EAAE;IACtE,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,kBAAkB,EAAE,aAAa,EAAE,CAAC,CAAA;IAC/E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAA;IAC3D,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAA;IAC3F,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;QACjC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI;QAC7B,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI;QAC5D,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACnB,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;QACxC,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;QACjC,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE;QACpD,IAAI;KACL,CAAA;AACH,CAAC,CAAA"}