@wirecat/mail-cli 0.5.0 → 0.7.0

package/dist/mail/compose.d.ts

@@ -0,0 +1,73 @@
+export interface Person {
+    address: string;
+    name?: string;
+}
+/** `ann@example.com`, `Ann <ann@example.com>` or several split by commas; each address checked and lower-cased. */
+export declare const peopleOf: (given: readonly string[], flag: string) => Person[];
+/** The message a reply or forward is built from, read from its raw bytes on the server. */
+export interface Original {
+    messageId?: string;
+    references: string[];
+    subject: string;
+    date?: string;
+    from?: Person;
+    replyTo: Person[];
+    to: Person[];
+    cc: Person[];
+    text: string;
+}
+export declare const originalOf: (raw: Uint8Array) => Promise<Original>;
+/**
+ * Who a reply goes to: Reply-To, else the sender. Answering one's own message goes to its recipients instead.
+ * `all` adds the other recipients; the owner never receives a copy of their own reply.
+ */
+export declare const replyPeople: (original: Original, owner: ReadonlySet<string>, all: boolean) => Person[];
+/** The rest after a reply's `to`, for reply-all's Cc. */
+export declare const replyCopies: (original: Original, owner: ReadonlySet<string>, to: readonly Person[]) => Person[];
+export declare const replySubject: (subject: string) => string;
+export declare const forwardSubject: (subject: string) => string;
+/** RFC 5322 §3.6.4: the parent's References and its Message-ID; only the newest are kept on a long thread. */
+export declare const referencesOf: (original: Original) => string[];
+/** The text above the quote and every line of the original behind `> `, as plain-text mail clients quote. */
+export declare const quoted: (text: string, original: Original) => string;
+export interface Draft {
+    from: Person;
+    to: Person[];
+    cc: Person[];
+    bcc: Person[];
+    subject: string;
+    text: string;
+    messageId: string;
+    date: Date;
+    inReplyTo?: string;
+    references?: string[];
+    files: {
+        name: string;
+        path: string;
+        bytes: number;
+    }[];
+    /** Attachments already in memory: those of a draft that is being replaced. */
+    parts?: {
+        name: string;
+        mime: string | null;
+        bytes: Uint8Array;
+    }[];
+    /** A forwarded message, attached whole as `message/rfc822`. */
+    message?: {
+        name: string;
+        raw: Uint8Array;
+    };
+}
+/**
+ * The bytes that go out, without a Bcc line, and the copy for Sent, which keeps it so the owner sees who had one.
+ * Both carry the same Message-ID, so the copy is found by it.
+ */
+export declare const build: (draft: Draft) => Promise<{
+    raw: Uint8Array;
+    copy: Uint8Array;
+}>;
+/** `<operation-id@domain>`: the same id on a retry with `--operation-id`, so Sent can tell whether it already went. */
+export declare const messageIdFor: (operationId: string, from: string) => string;
+/** The text says something is attached and nothing is: the mistake NeoMutt warns about. */
+export declare const forgotAttachment: (text: string, attached: boolean) => boolean;
+//# sourceMappingURL=compose.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../src/mail/compose.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,MAAM;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,mHAAmH;AACnH,eAAO,MAAM,QAAQ,UAAW,SAAS,MAAM,EAAE,QAAQ,MAAM,KAAG,MAAM,EAUrE,CAAA;AAOH,2FAA2F;AAC3F,MAAM,WAAW,QAAQ;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,EAAE,EAAE,MAAM,EAAE,CAAA;IACZ,EAAE,EAAE,MAAM,EAAE,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAID,eAAO,MAAM,UAAU,QAAe,UAAU,KAAG,OAAO,CAAC,QAAQ,CAkBlE,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,aAAc,QAAQ,SAAS,WAAW,CAAC,MAAM,CAAC,OAAO,OAAO,KAAG,MAAM,EAIhG,CAAA;AAED,yDAAyD;AACzD,eAAO,MAAM,WAAW,aAAc,QAAQ,SAAS,WAAW,CAAC,MAAM,CAAC,MAAM,SAAS,MAAM,EAAE,KAAG,MAAM,EACN,CAAA;AAKpG,eAAO,MAAM,YAAY,YAAa,MAAM,WAAqD,CAAA;AAEjG,eAAO,MAAM,cAAc,YAAa,MAAM,WAAkD,CAAA;AAEhG,8GAA8G;AAC9G,eAAO,MAAM,YAAY,aAAc,QAAQ,KAAG,MAAM,EACkC,CAAA;AAK1F,6GAA6G;AAC7G,eAAO,MAAM,MAAM,SAAU,MAAM,YAAY,QAAQ,KAAG,MAIzD,CAAA;AAED,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,EAAE,CAAA;IACZ,EAAE,EAAE,MAAM,EAAE,CAAA;IACZ,GAAG,EAAE,MAAM,EAAE,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,IAAI,CAAA;IACV,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACtD,8EAA8E;IAC9E,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,EAAE,CAAA;IAClE,+DAA+D;IAC/D,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,UAAU,CAAA;KAAE,CAAA;CAC5C;AAID;;;GAGG;AACH,eAAO,MAAM,KAAK,UAAiB,KAAK,KAAG,OAAO,CAAC;IAAE,GAAG,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAqCvF,CAAA;AAED,uHAAuH;AACvH,eAAO,MAAM,YAAY,gBAAiB,MAAM,QAAQ,MAAM,KAAG,MACgB,CAAA;AAEjF,2FAA2F;AAC3F,eAAO,MAAM,gBAAgB,SAAU,MAAM,YAAY,OAAO,KAAG,OACmB,CAAA"}

package/dist/mail/compose.js

@@ -0,0 +1,110 @@
+import { CliError } from "@wirecat/cli-base";
+import { parseMail } from "@wirecat/cli-core/mail";
+import addressparser from "nodemailer/lib/addressparser";
+import MailComposer from "nodemailer/lib/mail-composer";
+const EMAIL = /^[^\s@<>()",;:]+@[^\s@<>()",;:]+\.[^\s@<>()",;:]+$/u;
+/** `ann@example.com`, `Ann <ann@example.com>` or several split by commas; each address checked and lower-cased. */
+export const peopleOf = (given, flag) => given.flatMap((one) => addressparser(one, { flatten: true }).map(({ name, address }) => {
+    const clean = address.trim().toLowerCase();
+    if (!EMAIL.test(clean))
+        throw new CliError("validation_error", `${flag} takes email addresses; ${JSON.stringify(one)} holds none`, {
+            param: flag.replace(/^--/, ""),
+        });
+    return { address: clean, ...(name.trim() ? { name: name.trim() } : {}) };
+}));
+const unique = (people, without = new Set()) => {
+    const seen = new Set(without);
+    return people.filter(({ address }) => !seen.has(address) && seen.add(address) !== undefined);
+};
+const personOf = ({ email, name }) => ({ address: email, ...(name ? { name } : {}) });
+export const originalOf = async (raw) => {
+    let mail;
+    try {
+        mail = await parseMail(raw, undefined, 0);
+    }
+    catch {
+        throw new CliError("invalid_response", "the original message on the server cannot be read");
+    }
+    return {
+        ...(mail.messageId ? { messageId: mail.messageId } : {}),
+        references: mail.references,
+        subject: mail.subject ?? "",
+        ...(mail.date ? { date: mail.date } : {}),
+        ...(mail.from ? { from: personOf(mail.from) } : {}),
+        replyTo: mail.replyTo.map(personOf),
+        to: mail.to.map(personOf),
+        cc: mail.cc.map(personOf),
+        text: mail.text,
+    };
+};
+/**
+ * Who a reply goes to: Reply-To, else the sender. Answering one's own message goes to its recipients instead.
+ * `all` adds the other recipients; the owner never receives a copy of their own reply.
+ */
+export const replyPeople = (original, owner, all) => {
+    const mine = original.from !== undefined && owner.has(original.from.address);
+    const first = mine ? original.to : original.replyTo.length ? original.replyTo : original.from ? [original.from] : [];
+    return unique([...first, ...(all ? [...original.to, ...original.cc] : [])], owner);
+};
+/** The rest after a reply's `to`, for reply-all's Cc. */
+export const replyCopies = (original, owner, to) => unique([...original.to, ...original.cc], new Set([...owner, ...to.map(({ address }) => address)]));
+const prefixed = (subject, prefix, already) => already.test(subject.trim()) ? subject.trim() : `${prefix} ${subject.trim()}`.trim();
+export const replySubject = (subject) => prefixed(subject, "Re:", /^(re|ha|aw|sv)\s*:/iu);
+export const forwardSubject = (subject) => prefixed(subject, "Fwd:", /^(fwd?|fw)\s*:/iu);
+/** RFC 5322 §3.6.4: the parent's References and its Message-ID; only the newest are kept on a long thread. */
+export const referencesOf = (original) => [...original.references, ...(original.messageId ? [original.messageId] : [])].slice(-20);
+const shown = (person) => person === undefined ? "someone" : person.name ? `${person.name} <${person.address}>` : person.address;
+/** The text above the quote and every line of the original behind `> `, as plain-text mail clients quote. */
+export const quoted = (text, original) => {
+    const when = original.date ? `On ${original.date}, ` : "";
+    const lines = original.text.split("\n").map((line) => (line.startsWith(">") ? `>${line}` : `> ${line}`));
+    return `${text.trimEnd()}\n\n${when}${shown(original.from)} wrote:\n${lines.join("\n")}\n`;
+};
+const header = (person) => (person.name ? { name: person.name, address: person.address } : person.address);
+/**
+ * The bytes that go out, without a Bcc line, and the copy for Sent, which keeps it so the owner sees who had one.
+ * Both carry the same Message-ID, so the copy is found by it.
+ */
+export const build = async (draft) => {
+    const options = {
+        from: header(draft.from),
+        to: draft.to.map(header),
+        ...(draft.cc.length ? { cc: draft.cc.map(header) } : {}),
+        ...(draft.bcc.length ? { bcc: draft.bcc.map(header) } : {}),
+        subject: draft.subject,
+        text: draft.text,
+        messageId: draft.messageId,
+        date: draft.date,
+        ...(draft.inReplyTo ? { inReplyTo: draft.inReplyTo } : {}),
+        ...(draft.references?.length ? { references: draft.references } : {}),
+        attachments: [
+            ...draft.files.map(({ name, path }) => ({ filename: name, path })),
+            ...(draft.parts ?? []).map(({ name, mime, bytes }) => ({
+                filename: name,
+                content: Buffer.from(bytes),
+                ...(mime ? { contentType: mime } : {}),
+            })),
+            ...(draft.message
+                ? [
+                    {
+                        filename: draft.message.name,
+                        content: Buffer.from(draft.message.raw),
+                        contentType: "message/rfc822",
+                        contentDisposition: "attachment",
+                    },
+                ]
+                : []),
+        ],
+        disableUrlAccess: true,
+        newline: "\r\n",
+    };
+    const sent = new MailComposer(options).compile();
+    const copy = new MailComposer(options).compile();
+    copy.keepBcc = true;
+    return { raw: new Uint8Array(await sent.build()), copy: new Uint8Array(await copy.build()) };
+};
+/** `<operation-id@domain>`: the same id on a retry with `--operation-id`, so Sent can tell whether it already went. */
+export const messageIdFor = (operationId, from) => `<${operationId.replace(/[^\w.-]/g, "")}@${from.split("@")[1] ?? "localhost"}>`;
+/** The text says something is attached and nothing is: the mistake NeoMutt warns about. */
+export const forgotAttachment = (text, attached) => !attached && /\battach(ed|ment|ing)?\b|влож(ени|ил|ен)|прилага|прикреп/iu.test(text);
+//# sourceMappingURL=compose.js.map

package/dist/mail/compose.js.map

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

package/dist/mail/doctor.d.ts

@@ -0,0 +1,67 @@
+/**
+ * What `doctor` reads of the change runs on disk, with no connection: a run that stopped part way, and Gmail Trash
+ * a run filled that Gmail empties within days. memo's doctor said this until the cleanup moved here (NEED-2111).
+ */
+export declare const changesCheck: (env: NodeJS.ProcessEnv, now?: number) => {
+    fields: {
+        changes: {
+            runs: number;
+            unfinished: {
+                id: string;
+                account: string;
+                command: string;
+                started_at: string;
+            }[];
+            expiring: {
+                id: string;
+                account: string;
+                restorable_until: string | null;
+                in_trash: number;
+            }[];
+        };
+    };
+    notes: string[];
+};
+export declare const oauthCheck: (env: NodeJS.ProcessEnv, now?: number) => {
+    fields: {
+        oauth: {
+            profile: string;
+            provider: "google" | "microsoft";
+            client: "own" | "wirecat" | null;
+            signed_in_at: string | null;
+            sends: boolean | null;
+            testing_expiry_risk?: boolean | undefined;
+        }[];
+    };
+    notes: string[];
+};
+/** Every check doctor reads from disk, as one `local` hook. */
+export declare const localChecks: (env: NodeJS.ProcessEnv) => {
+    fields: {
+        changes: {
+            runs: number;
+            unfinished: {
+                id: string;
+                account: string;
+                command: string;
+                started_at: string;
+            }[];
+            expiring: {
+                id: string;
+                account: string;
+                restorable_until: string | null;
+                in_trash: number;
+            }[];
+        };
+        oauth: {
+            profile: string;
+            provider: "google" | "microsoft";
+            client: "own" | "wirecat" | null;
+            signed_in_at: string | null;
+            sends: boolean | null;
+            testing_expiry_risk?: boolean | undefined;
+        }[];
+    };
+    notes: string[];
+};
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/mail/doctor.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,eAAO,MAAM,YAAY,QAAS,MAAM,CAAC,UAAU;IAU/C,MAAM;QACJ,OAAO;YACL,IAAI;YACJ,UAAU;;;;;;YACV,QAAQ;;;;;;;;IAQZ,KAAK;CAaR,CAAA;AASD,eAAO,MAAM,UAAU,QAAS,MAAM,CAAC,UAAU;IA6B7C,MAAM;QAAI,KAAK;;;;;;;;;IACf,KAAK;CAqBR,CAAA;AAED,+DAA+D;AAC/D,eAAO,MAAM,WAAW,QAAS,MAAM,CAAC,UAAU;;;YAtF1C,IAAI;YACJ,UAAU;;;;;;YACV,QAAQ;;;;;;;;;;;;;;;;;CA8Ff,CAAA"}

package/dist/mail/doctor.js

@@ -0,0 +1,115 @@
+import { configuration } from "../config.js";
+import { IDENTITY } from "../identity.js";
+import { GOOGLE_GUIDE, microsoftClient, OAUTH_GUIDE, sendScopeOf, signInRecords } from "../oauth.js";
+import { providerFor } from "../providers.js";
+import { runSummaries } from "./changes.js";
+const DAY_MS = 86_400_000;
+/** As memo's doctor warned: early enough to look at what a cleanup trashed before Gmail empties its Trash. */
+const WARN_DAYS = 5;
+/**
+ * What `doctor` reads of the change runs on disk, with no connection: a run that stopped part way, and Gmail Trash
+ * a run filled that Gmail empties within days. memo's doctor said this until the cleanup moved here (NEED-2111).
+ */
+export const changesCheck = (env, now = Date.now()) => {
+    const runs = runSummaries(env);
+    const restore = (id, account) => `\`${IDENTITY.command} <profile of ${account}> messages restore --run ${id} --yes\``;
+    const unfinished = runs.filter(({ unfinished }) => unfinished);
+    const expiring = runs.filter(({ restorable_until, in_trash }) => {
+        const left = restorable_until === null ? 0 : Date.parse(restorable_until) - now;
+        return in_trash > 0 && left > 0 && left < WARN_DAYS * DAY_MS;
+    });
+    return {
+        fields: {
+            changes: {
+                runs: runs.length,
+                unfinished: unfinished.map(({ id, account, command, started_at }) => ({ id, account, command, started_at })),
+                expiring: expiring.map(({ id, account, restorable_until, in_trash }) => ({
+                    id,
+                    account,
+                    restorable_until,
+                    in_trash,
+                })),
+            },
+        },
+        notes: [
+            ...unfinished.map(({ id, account, command }) => `run ${id} of ${account} (${command}) stopped before the end; ${restore(id, account)} undoes what it did, ` +
+                "or run the command again to finish it"),
+            ...expiring.map(({ id, account, restorable_until, in_trash }) => `run ${id} of ${account} left ${in_trash} emails in Gmail's Trash, which Gmail empties at ${restorable_until}; ` +
+                `${restore(id, account)} brings them back before then`),
+        ],
+    };
+};
+/**
+ * Each OAuth profile from disk alone: the app it signs in with and what its last sign-in allowed. The tokens are in
+ * the keyring, which doctor never opens; `session status --check` proves one still works.
+ */
+/** A Google app left in Testing ends its sign-ins after 7 days; from day 6 doctor says so. */
+const TESTING_WARN_DAYS = 6;
+export const oauthCheck = (env, now = Date.now()) => {
+    const { configuredProfiles } = configuration.resolveSettings({}, { env, needsProfile: false });
+    const records = signInRecords(env);
+    const profiles = configuredProfiles.flatMap((profile) => {
+        const { mailbox } = configuration.resolveSettings({ profile }, { env });
+        const kind = mailbox.address ? providerFor(mailbox.address, mailbox.host)?.oauth : undefined;
+        if (mailbox.auth !== "oauth" || !kind)
+            return [];
+        let client = "own";
+        if (kind === "microsoft")
+            try {
+                client = microsoftClient(mailbox).source;
+            }
+            catch {
+                client = null;
+            }
+        const record = records[profile];
+        const days = record ? Math.floor((now - Date.parse(record.signed_in_at)) / DAY_MS) : null;
+        return [
+            {
+                profile,
+                provider: kind,
+                client,
+                signed_in_at: record?.signed_in_at ?? null,
+                sends: record ? record.scopes.includes(sendScopeOf(kind)) : null,
+                ...(kind === "google" ? { testing_expiry_risk: days !== null && days >= TESTING_WARN_DAYS } : {}),
+            },
+        ];
+    });
+    const sign = (profile) => `\`${IDENTITY.command} ${profile} session start\``;
+    return {
+        fields: { oauth: profiles },
+        notes: profiles.flatMap(({ profile, client, signed_in_at, sends, ...rest }) => [
+            ...("testing_expiry_risk" in rest && rest.testing_expiry_risk
+                ? [
+                    `profile ${profile} signed in to Google ${TESTING_WARN_DAYS}+ days ago: if your Google app is still in ` +
+                        `Testing, Google ends the sign-in on day 7. Publish the app (${GOOGLE_GUIDE}), then ${sign(profile)}`,
+                ]
+                : []),
+            ...(client === null
+                ? [
+                    `profile ${profile} has no Microsoft app to sign in with again: set one with ` +
+                        `\`${IDENTITY.command} config set --defaults microsoft_client_id <id>\` (${OAUTH_GUIDE})`,
+                ]
+                : []),
+            ...(signed_in_at === null
+                ? [`profile ${profile} has no OAuth sign-in on record here; run ${sign(profile)}`]
+                : []),
+            ...(sends === false
+                ? [`profile ${profile} was not allowed to send at its last sign-in; ${sign(profile)} asks again`]
+                : []),
+        ]),
+    };
+};
+/** Every check doctor reads from disk, as one `local` hook. */
+export const localChecks = (env) => {
+    const changes = changesCheck(env);
+    let oauth;
+    try {
+        oauth = oauthCheck(env);
+    }
+    catch {
+        // A config file doctor cannot read is reported as `config.issues` already.
+        oauth = { fields: { oauth: [] }, notes: [] };
+    }
+    return { fields: { ...changes.fields, ...oauth.fields }, notes: [...changes.notes, ...oauth.notes] };
+};
+//# sourceMappingURL=doctor.js.map

package/dist/mail/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/mail/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AACpG,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAE3C,MAAM,MAAM,GAAG,UAAU,CAAA;AACzB,8GAA8G;AAC9G,MAAM,SAAS,GAAG,CAAC,CAAA;AAEnB;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAsB,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE;IACvE,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,CAAA;IAC9B,MAAM,OAAO,GAAG,CAAC,EAAU,EAAE,OAAe,EAAE,EAAE,CAC9C,KAAK,QAAQ,CAAC,OAAO,gBAAgB,OAAO,4BAA4B,EAAE,UAAU,CAAA;IACtF,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,CAAA;IAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,gBAAgB,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC9D,MAAM,IAAI,GAAG,gBAAgB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,GAAG,CAAA;QAC/E,OAAO,QAAQ,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,SAAS,GAAG,MAAM,CAAA;IAC9D,CAAC,CAAC,CAAA;IACF,OAAO;QACL,MAAM,EAAE;YACN,OAAO,EAAE;gBACP,IAAI,EAAE,IAAI,CAAC,MAAM;gBACjB,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;gBAC5G,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;oBACvE,EAAE;oBACF,OAAO;oBACP,gBAAgB;oBAChB,QAAQ;iBACT,CAAC,CAAC;aACJ;SACF;QACD,KAAK,EAAE;YACL,GAAG,UAAU,CAAC,GAAG,CACf,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAC3B,OAAO,EAAE,OAAO,OAAO,KAAK,OAAO,6BAA6B,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,uBAAuB;gBAC3G,uCAAuC,CAC1C;YACD,GAAG,QAAQ,CAAC,GAAG,CACb,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,EAAE,EAAE,CAC9C,OAAO,EAAE,OAAO,OAAO,SAAS,QAAQ,oDAAoD,gBAAgB,IAAI;gBAChH,GAAG,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,+BAA+B,CACzD;SACF;KACF,CAAA;AACH,CAAC,CAAA;AAED;;;GAGG;AACH,8FAA8F;AAC9F,MAAM,iBAAiB,GAAG,CAAC,CAAA;AAE3B,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAsB,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE;IACrE,MAAM,EAAE,kBAAkB,EAAE,GAAG,aAAa,CAAC,eAAe,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAA;IAC9F,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;IAClC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QACtD,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAA;QACvE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;QAC5F,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,CAAA;QAChD,IAAI,MAAM,GAA6B,KAAK,CAAA;QAC5C,IAAI,IAAI,KAAK,WAAW;YACtB,IAAI,CAAC;gBACH,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC,MAAM,CAAA;YAC1C,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,GAAG,IAAI,CAAA;YACf,CAAC;QACH,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;QAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QACzF,OAAO;YACL;gBACE,OAAO;gBACP,QAAQ,EAAE,IAAI;gBACd,MAAM;gBACN,YAAY,EAAE,MAAM,EAAE,YAAY,IAAI,IAAI;gBAC1C,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;gBAChE,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,IAAI,KAAK,IAAI,IAAI,IAAI,IAAI,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAClG;SACF,CAAA;IACH,CAAC,CAAC,CAAA;IACF,MAAM,IAAI,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,KAAK,QAAQ,CAAC,OAAO,IAAI,OAAO,kBAAkB,CAAA;IACpF,OAAO;QACL,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE;QAC3B,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC;YAC7E,GAAG,CAAC,qBAAqB,IAAI,IAAI,IAAI,IAAI,CAAC,mBAAmB;gBAC3D,CAAC,CAAC;oBACE,WAAW,OAAO,wBAAwB,iBAAiB,6CAA6C;wBACtG,+DAA+D,YAAY,WAAW,IAAI,CAAC,OAAO,CAAC,EAAE;iBACxG;gBACH,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,MAAM,KAAK,IAAI;gBACjB,CAAC,CAAC;oBACE,WAAW,OAAO,4DAA4D;wBAC5E,KAAK,QAAQ,CAAC,OAAO,sDAAsD,WAAW,GAAG;iBAC5F;gBACH,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,YAAY,KAAK,IAAI;gBACvB,CAAC,CAAC,CAAC,WAAW,OAAO,6CAA6C,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAClF,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,KAAK,KAAK,KAAK;gBACjB,CAAC,CAAC,CAAC,WAAW,OAAO,iDAAiD,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;gBACjG,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;KACH,CAAA;AACH,CAAC,CAAA;AAED,+DAA+D;AAC/D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAsB,EAAE,EAAE;IACpD,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAA;IACjC,IAAI,KAAoC,CAAA;IACxC,IAAI,CAAC;QACH,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAA;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,2EAA2E;QAC3E,KAAK,GAAG,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;IAC9C,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAA;AACtG,CAAC,CAAA"}

package/dist/mail/drafts.d.ts

@@ -0,0 +1,54 @@
+import type { Organise } from "../providers.js";
+import type { FolderInfo, MailBackend } from "./backend.js";
+import { type Draft as Outgoing, type Person } from "./compose.js";
+/** `\Seen` too: a draft is the owner's own text, and a mail app shows an unseen one as new mail. */
+export declare const DRAFT_FLAGS: readonly ["\\Draft", "\\Seen"];
+export declare const draftsFolderOf: (folders: readonly FolderInfo[], organise: Organise) => string;
+/** A draft is named by its Message-ID, which stays the same across its versions; the angle brackets are optional. */
+export declare const draftIdOf: (given: string) => string;
+export interface Draft {
+    id: string;
+    uid: number;
+    subject: string;
+    from: string | null;
+    to: string[];
+    cc: string[];
+    bcc: string[];
+    date: string | null;
+    in_reply_to: string | null;
+    attachments: {
+        name: string;
+        mime: string | null;
+    }[];
+    text: string;
+}
+/** A draft as the answer shows it, and what its next version carries over: thread, Bcc and attachments. */
+export interface ReadDraft {
+    draft: Draft;
+    references: string[];
+    parts: NonNullable<Outgoing["parts"]>;
+}
+export declare const readDraft: (raw: Uint8Array, uid: number) => Promise<ReadDraft>;
+type Reads = Pick<MailBackend, "search" | "fetchRaw">;
+/** The newest drafts first, at most `limit`; read from the server, since the store holds Drafts only if it syncs it. */
+export declare const listDrafts: (backend: Reads, folder: string, limit: number) => Promise<{
+    items: Draft[];
+    more: boolean;
+}>;
+/** The draft with this Message-ID now: its UID, the folder's UIDVALIDITY and what it holds. */
+export declare const findDraft: (backend: Pick<MailBackend, "writes" | "fetchRaw">, folder: string, id: string) => Promise<{
+    uid: number;
+    validity: string;
+    read: ReadDraft;
+}>;
+export interface Changes {
+    to?: Person[];
+    cc?: Person[];
+    bcc?: Person[];
+    subject?: string;
+    text?: string;
+}
+/** The next version of a draft: each given field replaces the old one; the rest, its thread and its id stay. */
+export declare const nextVersion: ({ draft, references, parts }: ReadDraft, given: Changes, owner: string) => Outgoing;
+export {};
+//# sourceMappingURL=drafts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"drafts.d.ts","sourceRoot":"","sources":["../../src/mail/drafts.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC3D,OAAO,EAAE,KAAK,KAAK,IAAI,QAAQ,EAAE,KAAK,MAAM,EAAY,MAAM,cAAc,CAAA;AAE5E,oGAAoG;AACpG,eAAO,MAAM,WAAW,YAAI,SAAS,EAAE,QAAQ,CAAU,CAAA;AAEzD,eAAO,MAAM,cAAc,YAAa,SAAS,UAAU,EAAE,YAAY,QAAQ,KAAG,MAUnF,CAAA;AAED,qHAAqH;AACrH,eAAO,MAAM,SAAS,UAAW,MAAM,KAAG,MAKzC,CAAA;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,EAAE,EAAE,MAAM,EAAE,CAAA;IACZ,EAAE,EAAE,MAAM,EAAE,CAAA;IACZ,GAAG,EAAE,MAAM,EAAE,CAAA;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,EAAE,CAAA;IACpD,IAAI,EAAE,MAAM,CAAA;CACb;AAeD,2GAA2G;AAC3G,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,KAAK,CAAA;IACZ,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,KAAK,EAAE,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAA;CACtC;AAED,eAAO,MAAM,SAAS,QAAe,UAAU,OAAO,MAAM,KAAG,OAAO,CAAC,SAAS,CAuB/E,CAAA;AAED,KAAK,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,UAAU,CAAC,CAAA;AAUrD,wHAAwH;AACxH,eAAO,MAAM,UAAU,YAAmB,KAAK,UAAU,MAAM,SAAS,MAAM;;;EAU7E,CAAA;AAED,+FAA+F;AAC/F,eAAO,MAAM,SAAS,YAAmB,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,UAAU,CAAC,UAAU,MAAM,MAAM,MAAM;;;;EAW5G,CAAA;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAA;IACb,EAAE,CAAC,EAAE,MAAM,EAAE,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,gHAAgH;AAChH,eAAO,MAAM,WAAW,iCAAkC,SAAS,SAAS,OAAO,SAAS,MAAM,KAAG,QAgBpG,CAAA"}

package/dist/mail/drafts.js

@@ -0,0 +1,104 @@
+import { CliError } from "@wirecat/cli-base";
+import { parseMail } from "@wirecat/cli-core/mail";
+import { peopleOf } from "./compose.js";
+/** `\Seen` too: a draft is the owner's own text, and a mail app shows an unseen one as new mail. */
+export const DRAFT_FLAGS = ["\\Draft", "\\Seen"];
+export const draftsFolderOf = (folders, organise) => {
+    const found = folders.find(({ role }) => role === "drafts") ?? folders.find(({ path }) => organise.drafts.includes(path));
+    if (!found)
+        throw new CliError("provider_unavailable", "the mailbox has no Drafts folder this tool can find; folders list shows the folders", { reason: "mail.no-drafts" });
+    return found.path;
+};
+/** A draft is named by its Message-ID, which stays the same across its versions; the angle brackets are optional. */
+export const draftIdOf = (given) => {
+    const bare = given.trim().replace(/^<|>$/g, "");
+    if (!/^[^\s<>]+@[^\s<>]+$/.test(bare))
+        throw new CliError("validation_error", `"${given}" is no draft id — drafts list shows them`, { param: "draft" });
+    return `<${bare}>`;
+};
+const dateOf = (raw) => {
+    const head = Buffer.from(raw)
+        .toString("latin1")
+        .split(/\r?\n\r?\n/)[0] ?? "";
+    const value = /^Date:[ \t]*(.+)$/im.exec(head)?.[1];
+    const at = value ? Date.parse(value) : Number.NaN;
+    return Number.isNaN(at) ? null : new Date(at).toISOString();
+};
+const shown = (people) => people.map(({ email, name }) => (name ? `${name} <${email}>` : email));
+export const readDraft = async (raw, uid) => {
+    const parsed = await parseMail(raw, undefined, Number.POSITIVE_INFINITY);
+    const head = Buffer.from(raw)
+        .toString("latin1")
+        .split(/\r?\n\r?\n/)[0] ?? "";
+    return {
+        draft: {
+            id: (parsed.messageId ?? "").replace(/^<|>$/g, ""),
+            uid,
+            subject: parsed.subject ?? "",
+            from: parsed.from ? shown([parsed.from])[0] : null,
+            to: shown(parsed.to),
+            cc: shown(parsed.cc),
+            bcc: shown(parsed.bcc),
+            date: dateOf(raw),
+            in_reply_to: /^In-Reply-To:[ \t]*(<[^<>\s]+>)/im.exec(head)?.[1] ?? null,
+            attachments: parsed.attachments.map(({ name, mime }) => ({ name, mime })),
+            text: parsed.text,
+        },
+        references: parsed.references,
+        parts: parsed.attachments.flatMap(({ name, mime, bytes }) => (bytes ? [{ name, mime, bytes }] : [])),
+    };
+};
+const rawOf = async (backend, folder, uids) => {
+    const read = await backend.fetchRaw(uids.map((uid) => ({ uid: String(uid), receivedAt: "", folder })));
+    return read.map((one) => {
+        if (one instanceof Error)
+            throw one;
+        return one;
+    });
+};
+/** The newest drafts first, at most `limit`; read from the server, since the store holds Drafts only if it syncs it. */
+export const listDrafts = async (backend, folder, limit) => {
+    if (!backend.search)
+        throw new CliError("provider_unavailable", "this mailbox cannot list a folder");
+    const { uids } = await backend.search(new Date(0), folder);
+    const newest = uids
+        .map(Number)
+        .sort((a, b) => b - a)
+        .slice(0, limit);
+    const raws = newest.length ? await rawOf(backend, folder, newest) : [];
+    const drafts = await Promise.all(raws.map((raw, at) => readDraft(raw, newest[at])));
+    return { items: drafts.map(({ draft }) => draft), more: uids.length > limit };
+};
+/** The draft with this Message-ID now: its UID, the folder's UIDVALIDITY and what it holds. */
+export const findDraft = async (backend, folder, id) => {
+    const writes = backend.writes;
+    if (!writes)
+        throw new CliError("provider_unavailable", "this mailbox cannot be changed from here");
+    const { validity, uids } = await writes.locate(folder, { messageIds: [id] });
+    const uid = uids.get(id);
+    if (uid === undefined)
+        throw new CliError("not_found", `no draft ${id.replace(/^<|>$/g, "")} in ${folder}; drafts list shows them`, {
+            reason: "mail.draft-unknown",
+        });
+    const [raw] = await rawOf(backend, folder, [uid]);
+    return { uid, validity, read: await readDraft(raw, uid) };
+};
+/** The next version of a draft: each given field replaces the old one; the rest, its thread and its id stay. */
+export const nextVersion = ({ draft, references, parts }, given, owner) => {
+    const people = (list, flag) => (list.length ? peopleOf(list, flag) : []);
+    return {
+        from: peopleOf([draft.from ?? owner], "from")[0],
+        to: given.to ?? people(draft.to, "--to"),
+        cc: given.cc ?? people(draft.cc, "--cc"),
+        bcc: given.bcc ?? people(draft.bcc, "--bcc"),
+        subject: given.subject ?? draft.subject,
+        text: given.text ?? draft.text,
+        messageId: `<${draft.id}>`,
+        date: new Date(),
+        ...(draft.in_reply_to ? { inReplyTo: draft.in_reply_to } : {}),
+        ...(references.length ? { references } : {}),
+        files: [],
+        parts,
+    };
+};
+//# sourceMappingURL=drafts.js.map

package/dist/mail/drafts.js.map

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

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

@@ -1,5 +1,5 @@
 import { ImapFlow } from "imapflow";
-import type { MailEndpoint, RunBounds } from "../backend.js";
+import type { MailCredential, 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
@@ -52,11 +52,21 @@ export interface Connections {
     /** `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>;
+    /**
+     * `work` with `folder` selected for writing, sent once: a write that may have reached the server is not sent again.
+     * With `expected`, a folder whose UIDVALIDITY is not that is refused before anything is sent.
+     */
+    writeIn<T>(folder: string, work: Work<T>, expected?: string): Promise<T>;
+    /** `work` on a connection with no folder selected, sent once, for a change to the folders themselves. */
+    writeOnServer<T>(work: (open: ImapFlow) => Promise<T>): 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;
+/**
+ * The connections of one source, opened on first use. Each login asks the credential, so a reconnect an hour later
+ * gets a refreshed token; the secret never leaves this closure.
+ */
+export declare const imapConnections: (endpoint: MailEndpoint, credential: MailCredential, tuning?: ImapTuning) => Connections;
 export {};
 //# sourceMappingURL=connection.d.ts.map

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

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