@wirecat/mail-cli 0.5.0 → 0.7.0

package/dist/commands/tags.js

@@ -0,0 +1,144 @@
+import { CliError } from "@wirecat/cli-base";
+import { annotate } from "@wirecat/cli-base/commands";
+import { formatReference, normalizeTag, parseReference } from "@wirecat/cli-core";
+import { answerEntity, itemOf, LOCAL_READ, LOCAL_WRITE, listOf, outputFor, queryTerms, renderAnswer, termField, withQuery, } from "@wirecat/cli-core/cli";
+import { Command } from "commander";
+import * as v from "valibot";
+import { IDENTITY } from "../identity.js";
+import { openMailStore } from "../store.js";
+import { contextOf } from "./context.js";
+const TYPES = ["message", "chat"];
+const TAG_QUERY = {
+    entity: "mail_tag",
+    backend: "native",
+    fields: [termField("tag", "kw", "tag:work"), termField("type", "enum", "type:message", { values: TYPES })],
+};
+const mailTag = v.strictObject({
+    tag: v.string(),
+    type: v.picklist(TYPES),
+    target: v.string(),
+    name: v.nullable(v.string()),
+    created_at: v.string(),
+});
+const tagChange = v.strictObject({
+    target: v.string(),
+    added: v.optional(v.array(v.string())),
+    removed: v.optional(v.array(v.string())),
+    unchanged: v.array(v.string()),
+});
+const REF = "msg:email/me%40example.com/t1/m1";
+const LIST_LIMIT = 100;
+const MAX_LIST = 1_000;
+const limitOf = (value) => {
+    if (!/^\d+$/.test(value.trim()) || Number(value) < 1 || Number(value) > MAX_LIST)
+        throw new CliError("validation_error", `--limit takes a whole number from 1 to ${MAX_LIST}`, { param: "limit" });
+    return Number(value);
+};
+/** The profile's own mailbox in the shared store; the tags of mail go on its rows, as memo's do. */
+const withMailbox = async (command, work) => {
+    const context = contextOf(command);
+    const address = context.settings.mailbox.address;
+    if (!address)
+        throw new CliError("configuration_error", `profile ${context.profile} has no address`);
+    const store = await openMailStore(context.env);
+    try {
+        return await work(store, { provider: "email", account: address.toLowerCase() });
+    }
+    finally {
+        await store.close();
+    }
+};
+const targetOf = (key, { message, chat }) => {
+    if ((message === undefined) === (chat === undefined))
+        throw new CliError("validation_error", "name one email with --message, or one conversation with --chat");
+    const place = parseReference((message ?? chat));
+    if (message !== undefined && place.type !== "message")
+        throw new CliError("validation_error", `${message} names no email — give the msg:email/… reference`, {
+            param: "message",
+        });
+    if (chat !== undefined && place.type !== "chat")
+        throw new CliError("validation_error", `${chat} names no conversation — give the chat:email/… reference`, {
+            param: "chat",
+        });
+    if (place.type !== "message" && place.type !== "chat")
+        throw new CliError("validation_error", "no mail reference");
+    if (place.provider !== key.provider || place.account !== key.account)
+        throw new CliError("not_found", `${message ?? chat} is not mail of this profile's mailbox ${key.account}`);
+    return place.type === "message"
+        ? { type: "message", chatId: place.chat, messageId: place.message }
+        : { type: "chat", chatId: place.chat };
+};
+const shown = (key, target) => target.type === "message"
+    ? formatReference({ type: "message", ...key, chat: target.chatId, message: target.messageId })
+    : formatReference({ type: "chat", ...key, chat: target.chatId });
+const change = (operation) => answerEntity(annotate(new Command(operation), {
+    effects: LOCAL_WRITE,
+    examples: [`${IDENTITY.command} ya tags ${operation} invoices --message ${REF}`],
+}), "mail_tag_change", tagChange)
+    .summary(operation === "add" ? "tag one stored email or conversation" : "untag one stored email or conversation")
+    .description(operation === "add"
+    ? "put your own tags on one stored email or conversation; they stay in the local store, never on the server"
+    : "take your own tags off one stored email or conversation")
+    .argument("<tag...>", "one or more tags: 1–32 letters a–z, digits and hyphens; upper case is lowered")
+    .option("--message <message>", "the email: its msg:email/… reference, as search messages shows it")
+    .option("--chat <chat>", "the conversation: its chat:email/… reference, as conversations list shows it")
+    .action(async function (given, options) {
+    const tags = [...new Set(given.map(normalizeTag))];
+    const done = await withMailbox(this, async (store, key) => {
+        const target = targetOf(key, options);
+        const changed = operation === "add"
+            ? await store.tags.addTags(key, target, tags)
+            : await store.tags.removeTags(key, target, tags);
+        return { target: shown(key, target), changed };
+    });
+    const unchanged = tags.filter((tag) => !done.changed.includes(tag));
+    renderAnswer(this, outputFor(this), itemOf({
+        target: done.target,
+        ...(operation === "add" ? { added: done.changed } : { removed: done.changed }),
+        unchanged,
+    }), () => `${done.target}: ${done.changed.length ? done.changed.join(", ") : "no tags changed"}\n`);
+});
+const listCommand = () => withQuery(answerEntity(annotate(new Command("list"), {
+    effects: LOCAL_READ,
+    examples: [`${IDENTITY.command} ya tags list`, `${IDENTITY.command} ya tags list tag:invoices`],
+}), "mail_tag", mailTag)
+    .summary("your tagged emails and conversations")
+    .description("the emails and conversations of this mailbox you tagged; search messages tag:<tag> finds them too")
+    .option("--limit <n>", `at most this many (default ${LIST_LIMIT}, at most ${MAX_LIST})`, limitOf), TAG_QUERY).action(async function (words, options) {
+    const terms = queryTerms(words, TAG_QUERY, "tags list");
+    const tag = terms.get("tag");
+    const type = terms.get("type");
+    const limit = options.limit ?? LIST_LIMIT;
+    const items = await withMailbox(this, async (store, key) => {
+        const rows = (await Promise.all((type === undefined ? TYPES : [type]).map((one) => store.tags.tags(key, {
+            ...(tag === undefined ? {} : { tag: normalizeTag(tag) }),
+            type: one,
+            window: { limit: limit + 1, offset: 0 },
+        })))).flat();
+        return rows.map((row) => {
+            const target = row.type === "message"
+                ? { type: "message", chatId: row.chatId, messageId: row.messageId }
+                : { type: "chat", chatId: row.chatId };
+            return {
+                tag: row.tag,
+                type: target.type,
+                target: shown(key, target),
+                name: row.chatTitle ?? null,
+                created_at: row.createdAt,
+            };
+        });
+    });
+    renderAnswer(this, outputFor(this), listOf("tags list", { items: items.slice(0, limit), limit, has_more: items.length > limit }), () => items.length === 0
+        ? "nothing is tagged — tags add <tag> --message <ref> tags an email\n"
+        : `${items
+            .slice(0, limit)
+            .map((one) => `${one.tag}  ${one.type}  ${one.target}`)
+            .join("\n")}\n`);
+});
+export const tagsCommand = () => annotate(new Command("tags"), { effects: LOCAL_READ })
+    .summary("your own tags on stored mail, local only, shared with memo")
+    .description("your own tags on stored mail, kept in the local store and shared with memo; never sent to the server")
+    .addCommand(change("add"))
+    .addCommand(change("remove"))
+    .addCommand(listCommand());
+//# sourceMappingURL=tags.js.map

package/dist/commands/tags.js.map

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

package/dist/config.d.ts

@@ -1,13 +1,28 @@
 import { type Settings } from "@wirecat/cli-core/cli";
 import * as v from "valibot";
+/** Checked beside `messages.send` and `messages.forward` when the mail reaches anyone but the owner. */
+export declare const SEND_OTHERS_KEY = "messages.send.others";
+/** Where the app password goes, which app signs in, and who an agent may mail: an agent holding `mcp.authority` changes neither. */
+export declare const OWNER_ONLY: {
+    settings: string[];
+    permissions: string[];
+};
 export interface Mailbox {
     address?: string;
     login?: string;
     host?: string;
     port?: number;
     security?: "tls" | "starttls";
+    /** The submission server, for a mailbox whose provider the registry does not know. */
+    smtp?: {
+        host?: string;
+        port?: number;
+        security?: "tls" | "starttls";
+    };
     /** How the profile signs in; a profile saved before this key existed uses an app password. */
     auth: "app-password" | "oauth";
+    /** The owner's own Microsoft app, in place of WireCat's, for every OAuth sign-in after it is set. */
+    microsoftClientId?: string;
     folders?: string[];
 }
 export declare const configuration: {

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,QAAQ,EAAe,MAAM,uBAAuB,CAAA;AACtF,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAa5B,MAAM,WAAW,OAAO;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,KAAK,GAAG,UAAU,CAAA;IAC7B,8FAA8F;IAC9F,IAAI,EAAE,cAAc,GAAG,OAAO,CAAA;IAC9B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,eAAO,MAAM,aAAa;;iBAA0B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCzD,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAA"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,QAAQ,EAAe,MAAM,uBAAuB,CAAA;AACtF,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAG5B,wGAAwG;AACxG,eAAO,MAAM,eAAe,yBAAyB,CAAA;AAErD,oIAAoI;AACpI,eAAO,MAAM,UAAU;IACrB,QAAQ;IAYR,WAAW;CACZ,CAAA;AAgBD,MAAM,WAAW,OAAO;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,KAAK,GAAG,UAAU,CAAA;IAC7B,sFAAsF;IACtF,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,KAAK,GAAG,UAAU,CAAA;KAAE,CAAA;IACtE,8FAA8F;IAC9F,IAAI,EAAE,cAAc,GAAG,OAAO,CAAA;IAC9B,qGAAqG;IACrG,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,eAAO,MAAM,aAAa;;iBAA0B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiEzD,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAA"}

package/dist/config.js

@@ -1,17 +1,50 @@
 import { commandPermissions, settingsFor } from "@wirecat/cli-core/cli";
 import * as v from "valibot";
 import { IDENTITY } from "./identity.js";
+/** Checked beside `messages.send` and `messages.forward` when the mail reaches anyone but the owner. */
+export const SEND_OTHERS_KEY = "messages.send.others";
+/** Where the app password goes, which app signs in, and who an agent may mail: an agent holding `mcp.authority` changes neither. */
+export const OWNER_ONLY = {
+    settings: [
+        "address",
+        "login",
+        "imap_host",
+        "imap_port",
+        "imap_security",
+        "smtp_host",
+        "smtp_port",
+        "smtp_security",
+        "auth",
+        "microsoft_client_id",
+    ],
+    permissions: [SEND_OTHERS_KEY],
+};
 const PROFILE_ENTRIES = {
     address: v.optional(v.string()),
     login: v.optional(v.string()),
     imap_host: v.optional(v.string()),
     imap_port: v.optional(v.pipe(v.number(), v.integer(), v.minValue(1), v.maxValue(65535))),
     imap_security: v.optional(v.picklist(["tls", "starttls"])),
+    smtp_host: v.optional(v.string()),
+    smtp_port: v.optional(v.pipe(v.number(), v.integer(), v.minValue(1), v.maxValue(65535))),
+    smtp_security: v.optional(v.picklist(["tls", "starttls"])),
     auth: v.optional(v.picklist(["app-password", "oauth"])),
+    microsoft_client_id: v.optional(v.pipe(v.string(), v.trim(), v.minLength(1))),
     folders: v.optional(v.array(v.string())),
 };
 export const configuration = settingsFor(IDENTITY, {
-    permissions: commandPermissions(),
+    // An ordinary change goes ahead, as tg's and drive's do; a deletion or a change of many asks (WC-PERM-22, NEED-2067 A).
+    // Mail to anyone but the owner asks, and the owner may allow it (NEED-1898); WC-PERM-22 would make it deny.
+    permissions: commandPermissions({
+        extra: ["messages.bulk", "messages.server-search", SEND_OTHERS_KEY],
+        defaults: {
+            "messages.delete": "ask",
+            "folders.delete": "ask",
+            "messages.bulk": "ask",
+            "drafts.delete": "ask",
+            [SEND_OTHERS_KEY]: "ask",
+        },
+    }),
     profile: PROFILE_ENTRIES,
     resolve: ({ fromLayers }) => {
         const pick = (key) => fromLayers(key, undefined);
@@ -21,7 +54,11 @@ export const configuration = settingsFor(IDENTITY, {
         const port = pick("imap_port");
         const security = pick("imap_security");
         const folders = pick("folders");
+        const smtpHost = pick("smtp_host");
+        const smtpPort = pick("smtp_port");
+        const smtpSecurity = pick("smtp_security");
         const auth = pick("auth");
+        const microsoftClientId = pick("microsoft_client_id");
         const defined = (key, value) => (value === undefined ? {} : { [key]: value });
         return {
             values: {
@@ -32,7 +69,17 @@ export const configuration = settingsFor(IDENTITY, {
                     ...defined("port", port.value),
                     ...defined("security", security.value),
                     ...defined("folders", folders.value),
+                    ...(smtpHost.value === undefined && smtpPort.value === undefined && smtpSecurity.value === undefined
+                        ? {}
+                        : {
+                            smtp: {
+                                ...defined("host", smtpHost.value),
+                                ...defined("port", smtpPort.value),
+                                ...defined("security", smtpSecurity.value),
+                            },
+                        }),
                     auth: auth.value ?? "app-password",
+                    ...defined("microsoftClientId", microsoftClientId.value),
                 },
             },
             sources: {
@@ -42,7 +89,11 @@ export const configuration = settingsFor(IDENTITY, {
                 imap_port: port.from,
                 imap_security: security.from,
                 folders: folders.from,
+                smtp_host: smtpHost.from,
+                smtp_port: smtpPort.from,
+                smtp_security: smtpSecurity.from,
                 auth: auth.from,
+                microsoft_client_id: microsoftClientId.from,
             },
         };
     },

package/dist/config.js.map

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

package/dist/export/format.d.ts

@@ -0,0 +1,19 @@
+export type ExportFormat = "mbox" | "maildir";
+/**
+ * One message as mboxrd writes it (https://www.rfc-editor.org/rfc/rfc4155#appendix-A): a `From ` line, the bytes with
+ * every line that starts `From ` or `>…From ` pushed one `>` deeper so a reader can undo it, and a blank line after.
+ * The message keeps its own line endings, so a signature over the bytes still holds.
+ */
+export declare const mboxEntry: (raw: Uint8Array, receivedAt: number | null) => Buffer;
+/** `Archive/2025` becomes `Archive.2025.mbox`; one file per folder, flat in the destination. */
+export declare const mboxFile: (folder: string) => string;
+/**
+ * Maildir++ (as Dovecot, mbsync, mu and notmuch read it): INBOX is the top directory and every other folder a
+ * `.Name` directory beside it, with `.` between levels.
+ */
+export declare const maildirDir: (folder: string) => string;
+/** Windows file names cannot hold a colon, so the info separator is a semicolon there, as mbsync's Windows builds use. */
+export declare const INFO_SEPARATOR: string;
+/** Unique and the same on every run for one message, so a resumed export finds what it already wrote. */
+export declare const maildirName: (receivedAt: number | null, validity: string, uid: number, read: boolean | null, flagged: boolean | null) => string;
+//# sourceMappingURL=format.d.ts.map

package/dist/export/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/export/format.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,CAAA;AAa7C;;;;GAIG;AACH,eAAO,MAAM,SAAS,QAAS,UAAU,cAAc,MAAM,GAAG,IAAI,KAAG,MAQtE,CAAA;AAID,gGAAgG;AAChG,eAAO,MAAM,QAAQ,WAAY,MAAM,KAAG,MAA+C,CAAA;AAEzF;;;GAGG;AACH,eAAO,MAAM,UAAU,WAAY,MAAM,KAAG,MACmD,CAAA;AAE/F,0HAA0H;AAC1H,eAAO,MAAM,cAAc,QAA2C,CAAA;AAItE,yGAAyG;AACzG,eAAO,MAAM,WAAW,eACV,MAAM,GAAG,IAAI,YACf,MAAM,OACX,MAAM,QACL,OAAO,GAAG,IAAI,WACX,OAAO,GAAG,IAAI,KACtB,MAIF,CAAA"}

package/dist/export/format.js

@@ -0,0 +1,40 @@
+import { hostname } from "node:os";
+const ASCTIME_DAYS = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
+const ASCTIME_MONTHS = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
+const asctime = (at) => {
+    const two = (n) => String(n).padStart(2, "0");
+    return (`${ASCTIME_DAYS[at.getUTCDay()]} ${ASCTIME_MONTHS[at.getUTCMonth()]} ${String(at.getUTCDate()).padStart(2, " ")} ` +
+        `${two(at.getUTCHours())}:${two(at.getUTCMinutes())}:${two(at.getUTCSeconds())} ${at.getUTCFullYear()}`);
+};
+/**
+ * One message as mboxrd writes it (https://www.rfc-editor.org/rfc/rfc4155#appendix-A): a `From ` line, the bytes with
+ * every line that starts `From ` or `>…From ` pushed one `>` deeper so a reader can undo it, and a blank line after.
+ * The message keeps its own line endings, so a signature over the bytes still holds.
+ */
+export const mboxEntry = (raw, receivedAt) => {
+    const body = Buffer.from(raw)
+        .toString("latin1")
+        .replace(/^(>*From )/gm, ">$1");
+    const eol = body.includes("\r\n") ? "\r\n" : "\n";
+    const closed = body.endsWith("\n") ? body : body + eol;
+    const date = receivedAt === null ? new Date(0) : new Date(receivedAt);
+    return Buffer.from(`From MAILER-DAEMON ${asctime(date)}${eol}${closed}${eol}`, "latin1");
+};
+const unsafe = /[\0/\\:*?"<>|]/g;
+/** `Archive/2025` becomes `Archive.2025.mbox`; one file per folder, flat in the destination. */
+export const mboxFile = (folder) => `${folder.replace(unsafe, ".")}.mbox`;
+/**
+ * Maildir++ (as Dovecot, mbsync, mu and notmuch read it): INBOX is the top directory and every other folder a
+ * `.Name` directory beside it, with `.` between levels.
+ */
+export const maildirDir = (folder) => folder.toUpperCase() === "INBOX" ? "" : `.${folder.replace(unsafe, ".").replace(/^\.+/, "")}`;
+/** Windows file names cannot hold a colon, so the info separator is a semicolon there, as mbsync's Windows builds use. */
+export const INFO_SEPARATOR = process.platform === "win32" ? ";" : ":";
+const flagsOf = (read, flagged) => `${flagged ? "F" : ""}${read ? "S" : ""}`;
+/** Unique and the same on every run for one message, so a resumed export finds what it already wrote. */
+export const maildirName = (receivedAt, validity, uid, read, flagged) => {
+    const host = hostname().replace(/[^A-Za-z0-9-]/g, "-") || "localhost";
+    const seconds = Math.floor((receivedAt ?? 0) / 1000);
+    return `${seconds}.V${validity}U${uid}.${host}${INFO_SEPARATOR}2,${flagsOf(read, flagged)}`;
+};
+//# sourceMappingURL=format.js.map

package/dist/export/format.js.map

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

package/dist/export/journal.d.ts

@@ -0,0 +1,32 @@
+import type { ExportFormat } from "./format.js";
+export declare const JOURNAL = ".mail-export.jsonl";
+/** One finished batch: the messages now safely in the destination, and for mbox how long the folder's file is. */
+interface Batch {
+    folder: string;
+    validity: string;
+    uids: number[];
+    size?: number;
+}
+export declare const doneKey: (folder: string, validity: string, uid: number) => string;
+export interface ExportJournal {
+    done: Set<string>;
+    /** mbox: the length each folder's file had after its last finished batch. */
+    sizes: Map<string, number>;
+    record(batch: Batch): Promise<void>;
+}
+export interface Destination {
+    path: string;
+    format: ExportFormat;
+    account: string;
+    /** `resume` goes on in a folder that holds an export; `replace` writes into any folder, over what has the same name. */
+    mode: "new" | "resume" | "replace";
+}
+/**
+ * Decides whether the folder may be written into before anything is fetched. A folder with an export in it needs
+ * `--resume`; any other folder with something in it needs `--replace`.
+ */
+export declare const openJournal: ({ path, format, account, mode }: Destination) => Promise<ExportJournal>;
+/** A crash can leave bytes after the last finished batch; cutting back to it keeps every message whole. */
+export declare const cutTo: (file: string, size: number) => Promise<void>;
+export {};
+//# sourceMappingURL=journal.d.ts.map

package/dist/export/journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../../src/export/journal.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C,eAAO,MAAM,OAAO,uBAAuB,CAAA;AAQ3C,kHAAkH;AAClH,UAAU,KAAK;IACb,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,eAAO,MAAM,OAAO,WAAY,MAAM,YAAY,MAAM,OAAO,MAAM,KAAG,MAA0C,CAAA;AAkBlH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACjB,6EAA6E;IAC7E,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1B,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACpC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,YAAY,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,wHAAwH;IACxH,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAA;CACnC;AAQD;;;GAGG;AACH,eAAO,MAAM,WAAW,oCAA2C,WAAW,KAAG,OAAO,CAAC,aAAa,CAkDrG,CAAA;AAED,2GAA2G;AAC3G,eAAO,MAAM,KAAK,SAAU,MAAM,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAAyB,CAAA"}

package/dist/export/journal.js

@@ -0,0 +1,84 @@
+import { appendFile, mkdir, open, readdir, readFile, rm, truncate } from "node:fs/promises";
+import { join } from "node:path";
+import { CliError } from "@wirecat/cli-base";
+export const JOURNAL = ".mail-export.jsonl";
+export const doneKey = (folder, validity, uid) => `${folder}\0${validity}\0${uid}`;
+const parse = (text) => {
+    const lines = text.split("\n").filter(Boolean);
+    if (lines.length === 0)
+        return undefined;
+    const header = JSON.parse(lines[0]);
+    const batches = [];
+    for (const line of lines.slice(1)) {
+        try {
+            batches.push(JSON.parse(line));
+        }
+        catch {
+            // A line cut short by a crash is a batch that never finished; its messages are written again.
+            break;
+        }
+    }
+    return { header, batches };
+};
+const exists = async (path) => readdir(path).catch((error) => {
+    if (error.code === "ENOENT")
+        return undefined;
+    throw error;
+});
+/**
+ * Decides whether the folder may be written into before anything is fetched. A folder with an export in it needs
+ * `--resume`; any other folder with something in it needs `--replace`.
+ */
+export const openJournal = async ({ path, format, account, mode }) => {
+    const entries = await exists(path);
+    const journalPath = join(path, JOURNAL);
+    const text = entries?.includes(JOURNAL) ? await readFile(journalPath, "utf8") : undefined;
+    const found = text === undefined ? undefined : parse(text);
+    if (mode === "resume") {
+        if (!found)
+            throw new CliError("not_found", `${path} holds no export to resume`, { param: "resume" });
+        if (found.header.format !== format || found.header.account !== account)
+            throw new CliError("validation_error", `${path} holds ${found.header.format} of ${found.header.account}; resume it with the same --format and profile`, { param: "resume" });
+    }
+    else if (mode === "new" && entries && entries.length > 0) {
+        throw new CliError("validation_error", found
+            ? `${path} already holds an export; --resume goes on with it, --replace starts over in it`
+            : `${path} is not empty; --replace writes into it anyway, over files of the same name`, { param: "output", reason: "mail.export-destination-exists" });
+    }
+    await mkdir(path, { recursive: true, mode: 0o700 });
+    const start = mode === "resume" && found ? found : undefined;
+    if (!start) {
+        const head = { v: 1, format, account };
+        await rm(journalPath, { force: true });
+        await appendFile(journalPath, `${JSON.stringify(head)}\n`, { mode: 0o600 });
+    }
+    const done = new Set();
+    const sizes = new Map();
+    for (const batch of start?.batches ?? []) {
+        for (const uid of batch.uids)
+            done.add(doneKey(batch.folder, batch.validity, uid));
+        if (batch.size !== undefined)
+            sizes.set(batch.folder, batch.size);
+    }
+    return {
+        done,
+        sizes,
+        record: async (batch) => {
+            const handle = await open(journalPath, "a", 0o600);
+            try {
+                await handle.appendFile(`${JSON.stringify(batch)}\n`);
+                await handle.sync();
+            }
+            finally {
+                await handle.close();
+            }
+            for (const uid of batch.uids)
+                done.add(doneKey(batch.folder, batch.validity, uid));
+            if (batch.size !== undefined)
+                sizes.set(batch.folder, batch.size);
+        },
+    };
+};
+/** A crash can leave bytes after the last finished batch; cutting back to it keeps every message whole. */
+export const cutTo = (file, size) => truncate(file, size);
+//# sourceMappingURL=journal.js.map

package/dist/export/journal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.js","sourceRoot":"","sources":["../../src/export/journal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3F,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAG5C,MAAM,CAAC,MAAM,OAAO,GAAG,oBAAoB,CAAA;AAgB3C,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,MAAc,EAAE,QAAgB,EAAE,GAAW,EAAU,EAAE,CAAC,GAAG,MAAM,KAAK,QAAQ,KAAK,GAAG,EAAE,CAAA;AAElH,MAAM,KAAK,GAAG,CAAC,IAAY,EAAoD,EAAE;IAC/E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAC9C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IACxC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAW,CAAW,CAAA;IACvD,MAAM,OAAO,GAAY,EAAE,CAAA;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAU,CAAC,CAAA;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,8FAA8F;YAC9F,MAAK;QACP,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;AAC5B,CAAC,CAAA;AAiBD,MAAM,MAAM,GAAG,KAAK,EAAE,IAAY,EAAiC,EAAE,CACnE,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAA4B,EAAE,EAAE;IACnD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAA;IAC7C,MAAM,KAAK,CAAA;AACb,CAAC,CAAC,CAAA;AAEJ;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAe,EAA0B,EAAE;IACxG,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;IAClC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IACvC,MAAM,IAAI,GAAG,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IACzF,MAAM,KAAK,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC1D,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,GAAG,IAAI,4BAA4B,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;QACrG,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,KAAK,OAAO;YACpE,MAAM,IAAI,QAAQ,CAChB,kBAAkB,EAClB,GAAG,IAAI,UAAU,KAAK,CAAC,MAAM,CAAC,MAAM,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,gDAAgD,EAC/G,EAAE,KAAK,EAAE,QAAQ,EAAE,CACpB,CAAA;IACL,CAAC;SAAM,IAAI,IAAI,KAAK,KAAK,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,QAAQ,CAChB,kBAAkB,EAClB,KAAK;YACH,CAAC,CAAC,GAAG,IAAI,iFAAiF;YAC1F,CAAC,CAAC,GAAG,IAAI,6EAA6E,EACxF,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,gCAAgC,EAAE,CAC9D,CAAA;IACH,CAAC;IACD,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IACnD,MAAM,KAAK,GAAG,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;IAC5D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,GAAW,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;QAC9C,MAAM,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QACtC,MAAM,UAAU,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IAC7E,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAA;IACvC,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,OAAO,IAAI,EAAE,EAAE,CAAC;QACzC,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI;YAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAA;QAClF,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;YAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;IACnE,CAAC;IACD,OAAO;QACL,IAAI;QACJ,KAAK;QACL,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACtB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;YAClD,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;gBACrD,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;YACrB,CAAC;oBAAS,CAAC;gBACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;YACtB,CAAC;YACD,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI;gBAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAA;YAClF,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;gBAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;QACnE,CAAC;KACF,CAAA;AACH,CAAC,CAAA;AAED,2GAA2G;AAC3G,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,IAAY,EAAiB,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA"}

package/dist/export/write.d.ts

@@ -0,0 +1,14 @@
+import { type ExportFormat } from "./format.js";
+import { type ExportJournal } from "./journal.js";
+export interface Written {
+    folder: string;
+    validity: string;
+    uid: number;
+    receivedAt: number | null;
+    read: boolean | null;
+    flagged: boolean | null;
+    raw: Uint8Array;
+}
+/** Writes one folder's finished messages and only then notes them in the journal, so a crash repeats at most a batch. */
+export declare const writeBatch: (format: ExportFormat, root: string, journal: ExportJournal, folder: string, validity: string, batch: Written[], replace: boolean) => Promise<void>;
+//# sourceMappingURL=write.d.ts.map

package/dist/export/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/export/write.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,YAAY,EAAgD,MAAM,aAAa,CAAA;AAC7F,OAAO,EAAS,KAAK,aAAa,EAAE,MAAM,cAAc,CAAA;AAExD,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;IACpB,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IACvB,GAAG,EAAE,UAAU,CAAA;CAChB;AA6CD,yHAAyH;AACzH,eAAO,MAAM,UAAU,WACb,YAAY,QACd,MAAM,WACH,aAAa,UACd,MAAM,YACJ,MAAM,SACT,OAAO,EAAE,WACP,OAAO,KACf,OAAO,CAAC,IAAI,CAGoD,CAAA"}

package/dist/export/write.js

@@ -0,0 +1,42 @@
+import { chmod, mkdir, open, rename, stat, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { maildirDir, maildirName, mboxEntry, mboxFile } from "./format.js";
+import { cutTo } from "./journal.js";
+const exists = (path) => stat(path).then(() => true, () => false);
+const writeMbox = async (root, journal, folder, validity, batch) => {
+    const file = join(root, mboxFile(folder));
+    const size = journal.sizes.get(folder);
+    if (size !== undefined)
+        await cutTo(file, size);
+    const handle = await open(file, size === undefined ? "w" : "a", 0o600);
+    try {
+        await handle.appendFile(Buffer.concat(batch.map((one) => mboxEntry(one.raw, one.receivedAt))));
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+    await chmod(file, 0o600);
+    await journal.record({ folder, validity, uids: batch.map((one) => one.uid), size: (await stat(file)).size });
+};
+const writeMaildir = async (root, journal, folder, validity, batch, replace) => {
+    const base = join(root, maildirDir(folder));
+    for (const part of ["", "cur", "new", "tmp"])
+        await mkdir(join(base, part), { recursive: true, mode: 0o700 });
+    for (const one of batch) {
+        const name = maildirName(one.receivedAt, validity, one.uid, one.read, one.flagged);
+        const target = join(base, "cur", name);
+        // The name holds the folder's UIDVALIDITY and the UID, so a file already there is this message.
+        if (!replace && (await exists(target)))
+            continue;
+        const scratch = join(base, "tmp", name);
+        await writeFile(scratch, one.raw, { mode: 0o600 });
+        await rename(scratch, target);
+    }
+    await journal.record({ folder, validity, uids: batch.map((one) => one.uid) });
+};
+/** Writes one folder's finished messages and only then notes them in the journal, so a crash repeats at most a batch. */
+export const writeBatch = (format, root, journal, folder, validity, batch, replace) => format === "mbox"
+    ? writeMbox(root, journal, folder, validity, batch)
+    : writeMaildir(root, journal, folder, validity, batch, replace);
+//# sourceMappingURL=write.js.map

package/dist/export/write.js.map

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

package/dist/identity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGxD,eAAO,MAAM,OAAO,sBAAsB,CAAA;AAE1C,eAAO,MAAM,QAAQ,EAAE,WAWtB,CAAA;AAED,eAAO,MAAM,KAAK,mBAA0D,CAAA"}
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAIxD,eAAO,MAAM,OAAO,sBAAsB,CAAA;AAE1C,eAAO,MAAM,QAAQ,EAAE,WAatB,CAAA;AAED,eAAO,MAAM,KAAK,mBAA0D,CAAA"}

package/dist/identity.js

@@ -1,3 +1,4 @@
+import { REASONS } from "./reasons.js";
 import { VERSION } from "./version.js";
 export const PACKAGE = "@wirecat/mail-cli";
 export const IDENTITY = {
@@ -8,9 +9,11 @@ export const IDENTITY = {
     version: VERSION,
     issues: "https://github.com/WireCatLabs/mail-cli/issues/new",
     messenger: false,
+    sends: true,
     // One call to the source reads 60 messages on 4 connections: 5 to 12 s on Yandex 360 (cli-testing, performance/mail).
     requestMs: 9_000,
     contentLanguages: ["ru", "en"],
+    errors: { reasons: REASONS },
 };
 export const SKILL = new URL("../skills/mail-cli/SKILL.md", import.meta.url);
 //# sourceMappingURL=identity.js.map

package/dist/identity.js.map

@@ -1 +1 @@
-{"version":3,"file":"identity.js","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,MAAM,CAAC,MAAM,OAAO,GAAG,mBAAmB,CAAA;AAE1C,MAAM,CAAC,MAAM,QAAQ,GAAgB;IACnC,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,UAAU;IACnB,SAAS,EAAE,MAAM;IACjB,WAAW,EAAE,oGAAoG;IACjH,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,oDAAoD;IAC5D,SAAS,EAAE,KAAK;IAChB,sHAAsH;IACtH,SAAS,EAAE,KAAK;IAChB,gBAAgB,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;CAC/B,CAAA;AAED,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,6BAA6B,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAA"}
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,MAAM,CAAC,MAAM,OAAO,GAAG,mBAAmB,CAAA;AAE1C,MAAM,CAAC,MAAM,QAAQ,GAAgB;IACnC,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,UAAU;IACnB,SAAS,EAAE,MAAM;IACjB,WAAW,EAAE,oGAAoG;IACjH,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,oDAAoD;IAC5D,SAAS,EAAE,KAAK;IAChB,KAAK,EAAE,IAAI;IACX,sHAAsH;IACtH,SAAS,EAAE,KAAK;IAChB,gBAAgB,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;IAC9B,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE;CAC7B,CAAA;AAED,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,6BAA6B,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAA"}