@wirecat/mail-cli 0.1.1 → 0.3.0

package/dist/mail/imap/account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../../../src/mail/imap/account.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAEtC,2FAA2F;AAC3F,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,IAAiB,EACjB,KAAa,EACuE,EAAE;IACtF,MAAM,UAAU,GAAG,GAA0B,EAAE,CAC7C,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAC3B,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;SACjE,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;SACtF,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACf,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC;QACnB,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,IAAI,IAAI;QACxC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,IAAI,IAAI;KACrC,CAAC,CAAC,CACN,CAAA;IAEH,OAAO;QACL,UAAU;QAEV,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,OAAO,GAAG,MAAM,UAAU,EAAE,CAAA;YAClC,MAAM,IAAI,GAAG,CAAC,GAAG,KAAe,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAA;YAC5G,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,OAAO,EAAE,CAAA;QACpF,CAAC;QAED,KAAK,EAAE,GAAG,EAAE,CACV,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAyB,EAAE;YAClD,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YACzD,MAAM,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAA;YAC1C,OAAO;gBACL,KAAK;gBACL,YAAY,EAAE,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;gBAClD,QAAQ,EAAE;oBACR,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC;oBACjB,SAAS,EAAE,GAAG,CAAC,WAAW,CAAC;oBAC3B,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC;oBACvB,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC;oBACjB,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC;oBACvB,QAAQ,EAAE,GAAG,CAAC,kBAAkB,CAAC;oBACjC,UAAU,EAAE,GAAG,CAAC,YAAY,CAAC;oBAC7B,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC;iBAC1B;gBACD,OAAO;aACR,CAAA;QACH,CAAC,CAAC;KACL,CAAA;AACH,CAAC,CAAA"}

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

@@ -0,0 +1,62 @@
+import { ImapFlow } from "imapflow";
+import type { MailEndpoint, RunBounds } from "../backend.js";
+/**
+ * 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 extends RunBounds {
+    /** Messages in one FETCH command. */
+    listSize?: number;
+    /** UIDs in one FETCH that asks only for flags, date and size. */
+    quickSize?: number;
+    fetchSize?: number;
+    /** Bytes of message bodies one FETCH asks for, by RFC822.SIZE; a single larger message still goes alone. */
+    fetchBytes?: 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;
+    /** Full-jitter backoff before each retry of a command. */
+    backoff?: {
+        baseDelayMs: number;
+        maxDelayMs: number;
+    };
+    /** A hard ceiling per command; the budget and the deadline usually stop the retries first. */
+    maxAttempts?: number;
+    sleep?: (ms: number, signal?: AbortSignal) => Promise<void>;
+    random?: () => number;
+    /** Calls `fire` after `ms` unless the returned cancel runs first. */
+    expireAfter?: (ms: number, fire: () => void) => () => void;
+}
+export declare const IMAP_DEFAULTS: {
+    readonly listSize: 15;
+    readonly quickSize: 500;
+    readonly fetchSize: 15;
+    readonly fetchBytes: number;
+    readonly connections: 4;
+    readonly requestTimeoutMs: 90000;
+    readonly backoff: {
+        readonly baseDelayMs: 1000;
+        readonly maxDelayMs: 10000;
+    };
+    readonly maxAttempts: 8;
+};
+type Work<T> = (open: ImapFlow, validity: string) => Promise<T>;
+export interface Connections {
+    connections: number;
+    /** Each folder's UIDVALIDITY as the run first saw it; a reconnect that finds another one stops the run. */
+    validities: Map<string, string>;
+    /** `work` on a connection with no folder selected, retried like every read. */
+    onServer<T>(work: (open: ImapFlow) => Promise<T>): Promise<T>;
+    inFolder<T>(folder: string, work: Work<T>, expected?: string, slot?: number): Promise<T>;
+    /** Runs `work` over the batches on up to `connections` connections; the first failure stops the others. */
+    spread<I, O, E = never>(folder: string, batches: I[], work: (open: ImapFlow, batch: I) => Promise<O>, expected: string | undefined, onError?: (error: unknown, batch: I) => E): Promise<(O | E)[]>;
+    close(): Promise<void>;
+}
+/** The connections of one source, opened on first use; the password never leaves this closure. */
+export declare const imapConnections: (endpoint: MailEndpoint, password: string, tuning?: ImapTuning) => Connections;
+export {};
+//# sourceMappingURL=connection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../src/mail/imap/connection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAG5D;;;;;;GAMG;AACH,MAAM,WAAW,UAAW,SAAQ,SAAS;IAC3C,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4GAA4G;IAC5G,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,oFAAoF;IACpF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,0DAA0D;IAC1D,OAAO,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;IACrD,8FAA8F;IAC9F,WAAW,CAAC,EAAE,MAAM,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;IACrB,qEAAqE;IACrE,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAA;CAC3D;AAED,eAAO,MAAM,aAAa;aACxB,QAAQ,EAAE,EAAE;aACZ,SAAS,EAAE,GAAG;aACd,SAAS,EAAE,EAAE;aACb,UAAU;aACV,WAAW,EAAE,CAAC;aACd,gBAAgB,EAAE,KAAM;aACxB,OAAO;iBAAI,WAAW,EAAE,IAAK;iBAAE,UAAU,EAAE,KAAM;;aACjD,WAAW,EAAE,CAAC;CACN,CAAA;AAOV,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;AAE/D,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAA;IACnB,2GAA2G;IAC3G,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,+EAA+E;IAC/E,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IAC7D,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IACxF,2GAA2G;IAC3G,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,KAAK,EACpB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,CAAC,EAAE,EACZ,IAAI,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAC9C,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,GACxC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAA;IACrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED,kGAAkG;AAClG,eAAO,MAAM,eAAe,aAAc,YAAY,YAAY,MAAM,WAAU,UAAU,KAAQ,WA4KnG,CAAA"}

package/dist/mail/imap/connection.js

@@ -0,0 +1,188 @@
+import { backoffMs, CliError, realSleep } from "@wirecat/cli-base";
+import { ImapFlow } from "imapflow";
+import { mapImapError } from "./errors.js";
+export const IMAP_DEFAULTS = {
+    listSize: 15,
+    quickSize: 500,
+    fetchSize: 15,
+    fetchBytes: 20 * 1024 * 1024,
+    connections: 4,
+    requestTimeoutMs: 90_000,
+    backoff: { baseDelayMs: 1_000, maxDelayMs: 10_000 },
+    maxAttempts: 8,
+};
+const realTimer = (ms, fire) => {
+    const timer = setTimeout(fire, ms);
+    return () => clearTimeout(timer);
+};
+/** The connections of one source, opened on first use; the password never leaves this closure. */
+export const imapConnections = (endpoint, password, tuning = {}) => {
+    const { connections, requestTimeoutMs, backoff, maxAttempts } = { ...IMAP_DEFAULTS, ...tuning };
+    const { canRetry, timeLeftMs, signal, sleep = realSleep, random = Math.random, expireAfter = realTimer } = tuning;
+    const clients = [];
+    const validities = new Map();
+    let closed = false;
+    const connect = async (slot) => {
+        if (closed)
+            throw new CliError("cancelled", "the mail connection is already closed");
+        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();
+        // A close that ran while this one was logging in found nothing to close.
+        if (closed) {
+            next.close();
+            throw new CliError("cancelled", "the mail connection is already closed");
+        }
+        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 cancel = () => { };
+        const expired = new Promise((_, reject) => {
+            cancel = expireAfter(ms, () => {
+                drop(slot);
+                reject(Object.assign(new Error("request timed out"), { code: "RequestTimeout" }));
+            });
+        });
+        work.catch(() => { });
+        try {
+            return await Promise.race([work, expired]);
+        }
+        finally {
+            cancel();
+        }
+    };
+    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 and tries on a fresh one, for as long as the run's budget and deadline allow.
+     */
+    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 || closed || attempt >= maxAttempts || signal?.aborted)
+                    throw error;
+                const wait = backoffMs(attempt, { ...backoff, retries: maxAttempts, maxRetryAfterMs: 0 }, random);
+                const left = timeLeftMs?.();
+                if (left !== undefined && left <= wait)
+                    throw error;
+                if (canRetry && !canRetry())
+                    throw error;
+                await sleep(wait, signal).catch(() => Promise.reject(signal?.reason ?? error));
+            }
+        }
+    };
+    const inFolder = (folder, work, expected, slot = 0) => retrying(slot, () => once(slot, folder, expected, work));
+    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;
+    };
+    return {
+        connections,
+        validities,
+        onServer: (work) => retrying(0, () => once(0, undefined, undefined, (open) => work(open))),
+        inFolder,
+        spread,
+        close: async () => {
+            closed = true;
+            const open = clients.splice(0);
+            await Promise.all(open.map(async (one) => {
+                if (!one)
+                    return;
+                try {
+                    await one.logout();
+                }
+                catch {
+                    one.close();
+                }
+            }));
+        },
+    };
+};
+//# sourceMappingURL=connection.js.map

package/dist/mail/imap/connection.js.map

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

package/dist/mail/{imap-errors.d.ts → imap/errors.d.ts}

@@ -1,4 +1,4 @@
 import { CliError } from "@wirecat/cli-base";
 /** The server's error text can quote mail or names, so only its codes reach the caller. */
 export declare const mapImapError: (error: unknown) => CliError;
-//# sourceMappingURL=imap-errors.d.ts.map
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/mail/imap/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAK5C,2FAA2F;AAC3F,eAAO,MAAM,YAAY,UAAW,OAAO,KAAG,QAyD7C,CAAA"}

package/dist/mail/{imap-errors.js → imap/errors.js}

@@ -38,4 +38,4 @@ export const mapImapError = (error) => {
         });
     return new CliError("provider_error", `the mail server refused the request${e.responseStatus ? ` (${e.responseStatus})` : ""}`, causeOf(e.code ?? (responseCode || e.responseStatus)));
 };
-//# sourceMappingURL=imap-errors.js.map
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/mail/imap/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAE5C,4GAA4G;AAC5G,MAAM,OAAO,GAAG,CAAC,IAAwB,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;AAEvH,2FAA2F;AAC3F,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAc,EAAY,EAAE;IACvD,IAAI,KAAK,YAAY,QAAQ;QAAE,OAAO,KAAK,CAAA;IAC3C,mGAAmG;IACnG,MAAM,CAAC,GAAG,KAQT,CAAA;IACD,4GAA4G;IAC5G,iCAAiC;IACjC,MAAM,YAAY,GAChB,CAAC,CAAC,kBAAkB,IAAI,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;IACtG,IAAI,CAAC,CAAC,oBAAoB;QACxB,OAAO,IAAI,QAAQ,CACjB,sBAAsB,EACtB,0HAA0H,EAC1H,EAAE,MAAM,EAAE,oBAAoB,EAAE,CACjC,CAAA;IACH,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,YAAY,KAAK,WAAW,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,IAAI,EAAE,CAAC,CAAA;IACjH,IAAI,SAAS;QACX,OAAO,IAAI,QAAQ,CAAC,cAAc,EAAE,0EAA0E,EAAE;YAC9G,SAAS,EAAE,IAAI;YACf,GAAG,CAAC,OAAO,CAAC,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpF,CAAC,CAAA;IACJ,IACE,CAAC,CAAC,IAAI,KAAK,WAAW;QACtB,CAAC,CAAC,IAAI,KAAK,UAAU;QACrB,CAAC,CAAC,IAAI,KAAK,mBAAmB;QAC9B,CAAC,CAAC,IAAI,KAAK,iBAAiB;QAC5B,CAAC,CAAC,IAAI,KAAK,gBAAgB;QAC3B,CAAC,CAAC,IAAI,KAAK,iBAAiB;QAC5B,CAAC,CAAC,IAAI,KAAK,kBAAkB;QAC7B,CAAC,CAAC,IAAI,KAAK,iBAAiB;QAC5B,CAAC,CAAC,IAAI,KAAK,aAAa;QAExB,OAAO,IAAI,QAAQ,CAAC,SAAS,EAAE,wCAAwC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACnH,IACE,CAAC,CAAC,IAAI;QACN,0NAA0N,CAAC,IAAI,CAC7N,CAAC,CAAC,IAAI,CACP;QAED,OAAO,IAAI,QAAQ,CAAC,eAAe,EAAE,8BAA8B,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC/G,IAAI,YAAY,KAAK,aAAa;QAChC,OAAO,IAAI,QAAQ,CAAC,sBAAsB,EAAE,gDAAgD,EAAE;YAC5F,SAAS,EAAE,IAAI;YACf,GAAG,OAAO,CAAC,YAAY,CAAC;SACzB,CAAC,CAAA;IACJ,OAAO,IAAI,QAAQ,CACjB,gBAAgB,EAChB,sCAAsC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EACxF,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC,cAAc,CAAC,CAAC,CACtD,CAAA;AACH,CAAC,CAAA"}

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

@@ -0,0 +1,7 @@
+import type { MailBackend, MailEndpoint } from "../backend.js";
+import { type ImapTuning } from "./connection.js";
+export { IMAP_DEFAULTS, type ImapTuning } from "./connection.js";
+export { mapImapError } from "./errors.js";
+/** The IMAP adapter of the mail backend: read only, its connections opened on first use and closed by `close`. */
+export declare const imapBackend: (endpoint: MailEndpoint, password: string, tuning?: ImapTuning) => MailBackend;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mail/imap/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAE9D,OAAO,EAAE,KAAK,UAAU,EAAmB,MAAM,iBAAiB,CAAA;AAGlE,OAAO,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,kHAAkH;AAClH,eAAO,MAAM,WAAW,aAAc,YAAY,YAAY,MAAM,WAAU,UAAU,KAAQ,WAG/F,CAAA"}

package/dist/mail/imap/index.js

@@ -0,0 +1,11 @@
+import { imapAccount } from "./account.js";
+import { imapConnections } from "./connection.js";
+import { imapReads } from "./read.js";
+export { IMAP_DEFAULTS } from "./connection.js";
+export { mapImapError } from "./errors.js";
+/** The IMAP adapter of the mail backend: read only, its connections opened on first use and closed by `close`. */
+export const imapBackend = (endpoint, password, tuning = {}) => {
+    const pool = imapConnections(endpoint, password, tuning);
+    return { ...imapReads(pool, tuning), ...imapAccount(pool, endpoint.login), close: pool.close };
+};
+//# sourceMappingURL=index.js.map

package/dist/mail/imap/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mail/imap/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAmB,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,OAAO,EAAE,aAAa,EAAmB,MAAM,iBAAiB,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,kHAAkH;AAClH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,QAAsB,EAAE,QAAgB,EAAE,MAAM,GAAe,EAAE,EAAe,EAAE;IAC5G,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;IACxD,OAAO,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,GAAG,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAA;AAChG,CAAC,CAAA"}

package/dist/mail/{imap-messages.d.ts → imap/messages.d.ts}

@@ -1,18 +1,18 @@
-import type { Listed, Quick } from "@wirecat/cli-core/mail";
+import { type Listed, type 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. */
+/** cli-core's fields for the owner's rules and the probe, and the two that tie a reply to its thread. */
 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) => {
+export declare const idsOf: (messageId: string | undefined, folder: string, validity: string, uid: string, root?: string) => {
+    messageId: string;
+    threadId: string;
+};
+/** The ids of a message read as bytes, worked out as `listedOf` works them out from a listing. */
+export declare const rawIdsOf: (raw: Uint8Array, 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
+//# sourceMappingURL=messages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../src/mail/imap/messages.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,MAAM,EAGX,KAAK,KAAK,EACX,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAEhE,yGAAyG;AACzG,eAAO,MAAM,aAAa,UAAkE,CAAA;AA8B5F,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,SAAS,MAAM;IAEtG,SAAS;IAAoB,QAAQ;CAC/C,CAAA;AAED,kGAAkG;AAClG,eAAO,MAAM,QAAQ,QAAS,UAAU,UAAU,MAAM,YAAY,MAAM,OAAO,MAAM;;;CAGtF,CAAA;AAED,eAAO,MAAM,QAAQ,YAAa,kBAAkB,UAAU,MAAM,YAAY,MAAM,KAAG,MAUxF,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";
+import { headersOf, labelName, HEADER_FIELDS as MAIL_HEADER_FIELDS, } from "@wirecat/cli-core/mail";
+/** cli-core's fields for the owner's rules and the probe, and the two that tie a reply to its thread. */
+export const HEADER_FIELDS = [...MAIL_HEADER_FIELDS.split(" "), "IN-REPLY-TO", "REFERENCES"];
+const digest = (id) => `imap:${createHash("sha256").update(id).digest("hex")}`;
+const headTextOf = (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);
+    return bytes.subarray(0, end).toString("utf8");
+};
+const fieldOf = (head, name) => new RegExp(`^${name}:[ \\t]*(.*)$`, "im").exec(head.replace(/\r?\n[ \t]+/g, " "))?.[1]?.trim();
+/**
+ * The first Message-ID of References is the thread's first email (RFC 5322 §3.6.4); a reply with only In-Reply-To
+ * names its parent. A server without thread ids (Yandex, Mail.ru) then still keeps a conversation together.
+ */
+const threadRootOf = (head) => /<[^<>\s]+>/.exec(fieldOf(head, "references") ?? "")?.[0] ??
+    /<[^<>\s]+>/.exec(fieldOf(head, "in-reply-to") ?? "")?.[0];
+/** As memo names them, so the store's `label:Inbox` mailboxes keep matching; a flagged message is Starred anywhere. */
+const labelsOf = (raw, flagged) => {
+    const names = new Set([...(raw ?? [])].map(labelName));
+    if (flagged)
+        names.add("Starred");
+    return [...names].sort();
+};
+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: labelsOf(message.labels, flags.has("\\Flagged")),
+    };
+};
+/** 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, root) => {
+    const identity = messageId ?? `uid:${folder}:${validity}:${uid}`;
+    return { messageId: digest(identity), threadId: digest(root ?? identity) };
+};
+/** The ids of a message read as bytes, worked out as `listedOf` works them out from a listing. */
+export const rawIdsOf = (raw, folder, validity, uid) => {
+    const head = headTextOf(raw);
+    return idsOf(fieldOf(head, "message-id") || undefined, folder, validity, uid, threadRootOf(head));
+};
+export const listedOf = (message, folder, validity) => {
+    const head = message.headers ? message.headers.toString("utf8") : "";
+    const ids = idsOf(message.envelope?.messageId, folder, validity, String(message.uid), threadRootOf(head));
+    return {
+        ...quickOf(message, folder),
+        // Gmail's X-GM-MSGID and X-GM-THRID, or OBJECTID's: stored Gmail mail is keyed on them.
+        ...(message.emailId ? { messageId: String(message.emailId) } : { messageId: ids.messageId }),
+        threadId: message.threadId ? String(message.threadId) : ids.threadId,
+        headers: headersOf(head),
+    };
+};
+export const roleOf = (entry) => {
+    if (entry.path.toUpperCase() === "INBOX")
+        return "inbox";
+    return entry.specialUse ? entry.specialUse.replace(/^\\/, "").toLowerCase() : null;
+};
+//# sourceMappingURL=messages.js.map

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

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

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

@@ -0,0 +1,7 @@
+import type { MailSource } from "@wirecat/cli-core/mail";
+import { type Connections, type ImapTuning } from "./connection.js";
+type Reads = Required<Pick<MailSource, "listBatch" | "fetchBatch" | "search" | "present" | "quick" | "identify">> & Pick<MailSource, "list" | "fetchRaw">;
+/** The calls cli-core's sync makes to read a folder; none of them changes the mailbox. */
+export declare const imapReads: (pool: Connections, tuning?: ImapTuning) => Reads;
+export {};
+//# sourceMappingURL=read.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/mail/imap/read.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,wBAAwB,CAAA;AAEzE,OAAO,EAAE,KAAK,WAAW,EAAiB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAwClF,KAAK,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,GAAG,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC,CAAC,GAC/G,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAAC,CAAA;AAEvC,0FAA0F;AAC1F,eAAO,MAAM,SAAS,SAAU,WAAW,WAAU,UAAU,KAAQ,KAuJtE,CAAA"}

package/dist/mail/imap/read.js

@@ -0,0 +1,164 @@
+import { CliError } from "@wirecat/cli-base";
+import { IMAP_DEFAULTS } from "./connection.js";
+import { mapImapError } from "./errors.js";
+import { HEADER_FIELDS, listedOf, quickOf, rawIdsOf } from "./messages.js";
+const chunks = (items, size) => {
+    const out = [];
+    for (let start = 0; start < items.length; start += size)
+        out.push(items.slice(start, start + size));
+    return out;
+};
+/** At most `count` messages and `bytes` of RFC822.SIZE per batch; a message larger than `bytes` goes alone. */
+const bodyBatches = (items, count, bytes) => {
+    const out = [];
+    let current = [];
+    let size = 0;
+    for (const item of items) {
+        const next = item.size ?? 0;
+        if (current.length > 0 && (current.length >= count || size + next > bytes)) {
+            out.push(current);
+            current = [];
+            size = 0;
+        }
+        current.push(item);
+        size += next;
+    }
+    if (current.length > 0)
+        out.push(current);
+    return out;
+};
+const groupByFolder = (items) => {
+    const byFolder = new Map();
+    for (const item of items) {
+        const folder = item.folder ?? "INBOX";
+        const group = byFolder.get(folder);
+        if (group)
+            group.push(item);
+        else
+            byFolder.set(folder, [item]);
+    }
+    return byFolder;
+};
+/** The calls cli-core's sync makes to read a folder; none of them changes the mailbox. */
+export const imapReads = (pool, tuning = {}) => {
+    const { listSize, quickSize, fetchSize, fetchBytes } = { ...IMAP_DEFAULTS, ...tuning };
+    const { validities, inFolder, spread, connections } = pool;
+    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 validityOf = (searched, folder) => {
+        if (!searched.validity)
+            throw new CliError("invalid_response", "IMAP did not report UIDVALIDITY");
+        validities.set(folder, searched.validity);
+        return searched.validity;
+    };
+    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)));
+        }),
+        list: async (since, folder, options) => {
+            const searched = options?.searched ?? (await search(since, folder));
+            const validity = validityOf(searched, folder);
+            // 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 }) => {
+            const validity = validityOf(searched, folder);
+            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 rawIdsOf(raw, item.folder ?? "INBOX", validity, item.uid);
+        },
+        fetchRaw: async (items) => {
+            const read = new Map();
+            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 groupByFolder(items)) {
+                const batches = bodyBatches(group, fetchSize, fetchBytes);
+                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));
+        },
+    };
+};
+//# sourceMappingURL=read.js.map