@wirecat/mail-cli 0.5.0 → 0.7.0

package/dist/commands/export.js

@@ -0,0 +1,278 @@
+import { resolve } from "node:path";
+import { CliError } from "@wirecat/cli-base";
+import { annotate } from "@wirecat/cli-base/commands";
+import { answerEntity, baseContext, environmentOf, FETCH, itemOf, outputFor, positiveCount, renderAnswer, runBudgetOf, } from "@wirecat/cli-core/cli";
+import { searchMail } from "@wirecat/cli-core/mail";
+import { refusedPlace } from "@wirecat/cli-core/sends";
+import { Command, Option } from "commander";
+import * as v from "valibot";
+import { configuration } from "../config.js";
+import { doneKey, openJournal } from "../export/journal.js";
+import { writeBatch } from "../export/write.js";
+import { IDENTITY } from "../identity.js";
+import { DEFAULT_SYNC, providerFor } from "../providers.js";
+import { openMailStore } from "../store.js";
+import { contextOf, openMail, refuseOffline, repeatable } from "./context.js";
+import { foldersFor } from "./sync.js";
+const PAGE = 100;
+const FETCH_SLICE = 50;
+const mailExport = v.strictObject({
+    address: v.string(),
+    format: v.picklist(["mbox", "maildir"]),
+    destination: v.string(),
+    folders: v.array(v.string()),
+    state: v.picklist(["partial", "complete"]),
+    stopped: v.optional(v.picklist(["requests", "deadline", "cancelled", "limit"])),
+    matched: v.number(),
+    exported: v.number(),
+    already_exported: v.number(),
+    not_on_server: v.number(),
+    unreadable: v.number(),
+    complete: v.boolean(),
+    hint: v.optional(v.string()),
+});
+export const exportLeaf = () => answerEntity(annotate(new Command("export"), {
+    effects: FETCH,
+    cooperative: true,
+    partial: true,
+    examples: [
+        `${IDENTITY.command} ya messages export 'from:ann@example.com' --output ~/mail-backup`,
+        `${IDENTITY.command} ya messages export --folder INBOX --format maildir --output ~/Maildir`,
+        `${IDENTITY.command} ya messages export 'date>30d' --limit 500 --output ~/mail-backup --resume`,
+    ],
+}), "mail_export", mailExport)
+    .summary("write stored mail to mbox or Maildir files")
+    .description("copy the original messages of stored mail that match a query into mbox files (one per folder) or a Maildir++ " +
+    "tree, for backup or for mu and notmuch. The store keeps text, not the original source, so each message is " +
+    "read from the server again; the destination folder is private (mode 700, files 600)")
+    .argument("[query...]", "which stored mail: the same query as `search messages`; all of it if left out")
+    .addOption(new Option("--format <format>", "mbox files or a Maildir++ tree").choices(["mbox", "maildir"]).default("mbox"))
+    .requiredOption("--output <file>", "the folder to write the export into (not one file); made private if it does not exist")
+    .addOption(repeatable("--folder <folder>", "only mail filed in this folder; repeat it for more (default: the folders sync reads)"))
+    .option("--limit <n>", "write at most this many messages in this run, newest first", positiveCount("--limit"))
+    .option("--max-pages <pages>", "at most this many requests to the mail server in this run; as many as fit the deadline if not given", positiveCount("--max-pages"))
+    .option("--resume", "go on with the export already in the folder, skipping what it holds")
+    .option("--replace", "write into a folder that has something in it, over files of the same name")
+    .addHelpText("after", "\nWhat is written: the original bytes of each message, in each folder it is filed in, with its read and starred " +
+    "state in the Maildir file name. A message the server no longer has is counted as not_on_server, and one the " +
+    "store has no UID for (sync again) the same way. Gmail files a message under All Mail and INBOX both: pass " +
+    "--folder to export one. Without --resume or --replace a folder with something in it is refused.")
+    .action(async function (query, args) {
+    const context = contextOf(this);
+    refuseOffline(context.flags);
+    const address = context.settings.mailbox.address;
+    if (!address)
+        throw new CliError("configuration_error", `profile ${context.profile} has no address`);
+    if (args.resume && args.replace)
+        throw new CliError("validation_error", "--resume and --replace cannot be used together", { param: "replace" });
+    const destination = resolve(args.output);
+    if (refusedPlace(destination, IDENTITY, context.env))
+        throw new CliError("validation_error", `will not export into ${args.output}: credential folders and the WireCat apps' folders are not written to`, { param: "output" });
+    const account = address.toLowerCase();
+    const journal = await openJournal({
+        path: destination,
+        format: args.format,
+        account,
+        mode: args.resume ? "resume" : args.replace ? "replace" : "new",
+    });
+    const budget = runBudgetOf(this, args.maxPages);
+    const { backend } = await openMail(context, { canRetry: () => budget.take() === null });
+    try {
+        const result = await baseContext(this, configuration.resolveSettings).run(async () => {
+            const { mailbox } = context.settings;
+            const defaults = providerFor(address, mailbox.host)?.sync ?? DEFAULT_SYNC;
+            const folders = await foldersFor(args.folder, mailbox.folders, defaults, () => backend.folderList());
+            const store = await openMailStore(context.env);
+            environmentOf(this).trackCloseable?.(store);
+            try {
+                const stored = await store.accounts.storedAccount({ provider: "email", account }).catch(() => null);
+                if (stored === null)
+                    throw new CliError("not_found", `no mail is stored yet; run \`${IDENTITY.command} ${context.profile} sync\` first`);
+                const located = new Map();
+                for (const folder of folders) {
+                    const searched = await backend.search?.(new Date(0), folder);
+                    const validity = searched?.validity;
+                    if (!validity)
+                        continue;
+                    const byMessage = new Map();
+                    for (const email of await store.mail.folderEmails(stored.id, folder, validity)) {
+                        const list = byMessage.get(email.externalId);
+                        const entry = { folder, validity, email };
+                        if (list)
+                            list.push(entry);
+                        else
+                            byMessage.set(email.externalId, [entry]);
+                    }
+                    located.set(folder, byMessage);
+                }
+                let matched = 0;
+                let already = 0;
+                let absent = 0;
+                let unreadable = 0;
+                let exported = 0;
+                let stopped;
+                let more = false;
+                let waiting = [];
+                const room = () => args.limit === undefined ? Number.POSITIVE_INFINITY : args.limit - exported - waiting.length;
+                const flush = async () => {
+                    while (waiting.length > 0) {
+                        const reason = budget.take();
+                        if (reason) {
+                            stopped = reason;
+                            return false;
+                        }
+                        const slice = waiting.slice(0, FETCH_SLICE);
+                        waiting = waiting.slice(FETCH_SLICE);
+                        const items = slice.map(({ folder, email }) => ({
+                            uid: String(email.uid),
+                            folder,
+                            receivedAt: new Date(email.receivedAt ?? 0).toISOString(),
+                        }));
+                        const raws = await backend.fetchRaw(items);
+                        const byFolder = new Map();
+                        for (const [at, entry] of slice.entries()) {
+                            const raw = raws[at];
+                            if (!(raw instanceof Uint8Array)) {
+                                if (raw instanceof Error && raw.code === "not_found")
+                                    absent++;
+                                else
+                                    unreadable++;
+                                continue;
+                            }
+                            const group = byFolder.get(entry.folder) ?? [];
+                            group.push({
+                                folder: entry.folder,
+                                validity: entry.validity,
+                                uid: entry.email.uid,
+                                receivedAt: entry.email.receivedAt,
+                                read: entry.email.read,
+                                flagged: entry.email.flagged,
+                                raw,
+                            });
+                            byFolder.set(entry.folder, group);
+                        }
+                        for (const [folder, batch] of byFolder) {
+                            await writeBatch(args.format, destination, journal, folder, batch[0]?.validity, batch, Boolean(args.replace));
+                            exported += batch.length;
+                        }
+                    }
+                    return true;
+                };
+                const text = query.join(" ");
+                let offset = 0;
+                selecting: for (;;) {
+                    const page = text
+                        ? await searchMail(store, { provider: "email", account }, {
+                            text,
+                            limit: PAGE,
+                            offset,
+                            mailAccount: account,
+                            newest: true,
+                        })
+                        : await (async () => {
+                            const rows = await store.mail.emails({ accountId: stored.id, limit: PAGE + 1, offset });
+                            return {
+                                items: rows.slice(0, PAGE).map(({ externalId }) => ({ id: externalId })),
+                                hasMore: rows.length > PAGE,
+                                nextOffset: offset + PAGE,
+                            };
+                        })();
+                    for (const hit of page.items) {
+                        matched++;
+                        for (const folder of folders) {
+                            for (const entry of located.get(folder)?.get(hit.id) ?? []) {
+                                if (journal.done.has(doneKey(entry.folder, entry.validity, entry.email.uid))) {
+                                    already++;
+                                    continue;
+                                }
+                                if (room() <= 0) {
+                                    stopped = "limit";
+                                    more = true;
+                                    break selecting;
+                                }
+                                waiting.push(entry);
+                            }
+                        }
+                        if (waiting.length >= FETCH_SLICE && !(await flush())) {
+                            more = true;
+                            break selecting;
+                        }
+                    }
+                    if (!page.hasMore)
+                        break;
+                    offset = page.nextOffset ?? offset + PAGE;
+                }
+                if ((stopped === undefined || stopped === "limit") && !(await flush()))
+                    more = true;
+                if (stopped)
+                    more = true;
+                return { folders, matched, already, absent, unreadable, exported, stopped, more, left: waiting.length };
+            }
+            finally {
+                await store.close();
+            }
+        });
+        const partial = result.more;
+        const next = partial
+            ? [
+                {
+                    kind: "command",
+                    step: "mail.messages.export",
+                    command: "messages export",
+                    args: {
+                        query: query.join(" ") || undefined,
+                        format: args.format,
+                        output: args.output,
+                        resume: true,
+                        ...(args.folder?.length ? { folder: args.folder } : {}),
+                        ...(args.limit === undefined ? {} : { limit: args.limit }),
+                    },
+                    why: result.stopped === "limit"
+                        ? `the run wrote the ${args.limit} messages --limit allows; --resume writes the next ones`
+                        : "the export stopped before its end to answer in time; --resume goes on from where it stopped",
+                    safe_to_auto_execute: false,
+                },
+            ]
+            : [];
+        const hint = partial
+            ? result.stopped === "limit"
+                ? "more messages match; run it again with --resume to write the next ones"
+                : "run it again with --resume to go on"
+            : result.unreadable > 0
+                ? `${result.unreadable} messages could not be read; --resume tries them again`
+                : undefined;
+        const issues = [
+            ...(result.unreadable > 0
+                ? [{ code: "outcome_unknown", reason: "mail.export-unreadable", source: "export" }]
+                : []),
+            ...(result.stopped && result.stopped !== "limit"
+                ? [
+                    {
+                        code: { requests: "rate_limited", deadline: "timeout", cancelled: "cancelled" }[result.stopped],
+                        reason: `budget.${result.stopped}`,
+                        source: "export",
+                    },
+                ]
+                : []),
+        ];
+        renderAnswer(this, outputFor(this), itemOf({
+            address: account,
+            format: args.format,
+            destination,
+            folders: result.folders,
+            state: partial ? "partial" : "complete",
+            ...(result.stopped ? { stopped: result.stopped } : {}),
+            matched: result.matched,
+            exported: result.exported,
+            already_exported: result.already,
+            not_on_server: result.absent,
+            unreadable: result.unreadable,
+            complete: !partial && result.unreadable === 0,
+            ...(hint ? { hint } : {}),
+        }, { next, meta: { complete: !partial && issues.length === 0, ...(issues.length ? { issues } : {}) } }));
+    }
+    finally {
+        await backend.close();
+    }
+});
+//# sourceMappingURL=export.js.map

package/dist/commands/export.js.map

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

package/dist/commands/folders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"folders.d.ts","sourceRoot":"","sources":["../../src/commands/folders.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAyCnC,eAAO,MAAM,cAAc,QAAO,OAGJ,CAAA"}
+{"version":3,"file":"folders.d.ts","sourceRoot":"","sources":["../../src/commands/folders.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAsNnC,eAAO,MAAM,cAAc,QAAO,OAMI,CAAA"}

package/dist/commands/folders.js

@@ -1,9 +1,12 @@
+import { CliError } from "@wirecat/cli-base";
 import { annotate } from "@wirecat/cli-base/commands";
-import { answerEntity, baseContext, LOCAL_READ, listOf, outputFor, REMOTE_READ, renderAnswer, } from "@wirecat/cli-core/cli";
+import { answerEntity, baseContext, itemOf, LOCAL_READ, listOf, outputFor, ownerOnlyOption, REMOTE_READ, REMOTE_WRITE, renderAnswer, terminalAsker, } from "@wirecat/cli-core/cli";
+import { guardedWrite, guardFor, newOperationId } from "@wirecat/cli-core/sends";
 import { Command } from "commander";
 import * as v from "valibot";
 import { configuration } from "../config.js";
 import { IDENTITY } from "../identity.js";
+import { folderNamed } from "../mail/organise.js";
 import { contextOf, openMail, refuseOffline } from "./context.js";
 const mailFolder = v.strictObject({
     path: v.string(),
@@ -30,7 +33,122 @@ const listCommand = () => answerEntity(annotate(new Command("list"), {
         await backend.close();
     }
 });
+const folderChange = v.strictObject({
+    action: v.picklist(["create", "rename", "delete"]),
+    folder: v.string(),
+    to: v.optional(v.string()),
+    messages: v.optional(v.nullable(v.number())),
+    applied: v.optional(v.boolean()),
+    hint: v.optional(v.string()),
+});
+const ACTIONS = { create: "folder-create", rename: "folder-update", delete: "folder-delete" };
+/** One change to the folders, under the write guard: the read-only lock, the profile's level and the journal. */
+const changeFolder = async (command, action, work, preview) => {
+    const context = contextOf(command);
+    refuseOffline(context.flags);
+    const { backend } = await openMail(context);
+    try {
+        const base = baseContext(command, configuration.resolveSettings);
+        const done = await base.run(async () => {
+            const writes = backend.writes;
+            if (!writes)
+                throw new CliError("provider_unavailable", "this mailbox cannot be changed from here");
+            const guard = guardFor(IDENTITY, { ...base.settings, permissionDefaults: configuration.permissions?.defaults ?? {} }, (message) => outputFor(command).renderer.warn(message), context.env, terminalAsker(command));
+            const folders = await backend.folderList();
+            const shown = preview?.(folders);
+            if (shown)
+                return { ...shown, applied: false, hint: "a preview: nothing changed; add --yes to delete it" };
+            return guardedWrite(guard, {
+                chatId: null,
+                kind: "account",
+                action: ACTIONS[action],
+                key: `folders.${action}`,
+                operationId: newOperationId(),
+            }, () => work(writes, folders));
+        });
+        renderAnswer(command, outputFor(command), itemOf({ action, ...done }));
+    }
+    finally {
+        await backend.close();
+    }
+};
+const existing = (folders, given) => {
+    const found = folderNamed(folders, given);
+    if (!found)
+        throw new CliError("not_found", `no folder "${given}"; folders list shows them`, { param: "folder" });
+    return found;
+};
+const createCommand = () => answerEntity(annotate(new Command("create"), {
+    effects: REMOTE_WRITE,
+    examples: [`${IDENTITY.command} ya folders create Receipts`, `${IDENTITY.command} ya folders create Work/2026`],
+}), "mail_folder_change", folderChange)
+    .summary("make a folder")
+    .description("make a folder on the server; on Gmail it is a label")
+    .argument("<folder>", "the folder's path; the server's separator (usually / or .) makes a subfolder")
+    .action(async function (folder) {
+    await changeFolder(this, "create", async (writes, folders) => {
+        if (folders.some(({ path }) => path === folder))
+            throw new CliError("validation_error", `folder "${folder}" already exists`, { param: "folder" });
+        await writes.createFolder(folder);
+        return { folder };
+    });
+});
+const renameCommand = () => answerEntity(annotate(new Command("rename"), {
+    effects: REMOTE_WRITE,
+    examples: [`${IDENTITY.command} ya folders rename Receipts Invoices`],
+}), "mail_folder_change", folderChange)
+    .summary("rename a folder")
+    .description("rename a folder of your own on the server; the inbox and the special folders keep their names")
+    .argument("<folder>", "the folder, by path or name")
+    .argument("<name>", "its new path")
+    .action(async function (folder, name) {
+    await changeFolder(this, "rename", async (writes, folders) => {
+        const found = existing(folders, folder);
+        if (found.role)
+            throw new CliError("validation_error", `${found.path} is the ${found.role} folder; it keeps its name`);
+        await writes.renameFolder(found.path, name);
+        return { folder: found.path, to: name };
+    });
+});
+const deleteFolderCommand = () => answerEntity(annotate(new Command("delete"), {
+    effects: REMOTE_WRITE,
+    examples: [`${IDENTITY.command} ya folders delete Old --yes`],
+}), "mail_folder_change", folderChange)
+    .summary("delete an empty folder")
+    .description("delete a folder of your own; it must be empty (move or delete its mail first), unless --allow-dangerous, " +
+    "which loses that mail for good; a preview without --yes")
+    .argument("<folder>", "the folder, by path or name")
+    .option("--yes", "delete it; without it, only a preview")
+    .option("--dry-run", "only preview, even with --yes")
+    .addOption(ownerOnlyOption("--allow-dangerous", "delete a folder that still holds mail: that mail is gone for good, no restore"))
+    .action(async function (folder, options) {
+    const given = this.optsWithGlobals();
+    const dangerous = given.allowDangerous === true;
+    const emptyOrAllowed = (folders) => {
+        const found = existing(folders, folder);
+        if (found.role)
+            throw new CliError("validation_error", `${found.path} is the ${found.role} folder; it stays`);
+        // A server that gives no count may still hold mail, so an unknown count is not taken for empty.
+        if (found.messages !== 0 && !dangerous)
+            throw new CliError("validation_error", `${found.path} holds ${found.messages ?? "an unknown number of"} messages; move them out first (messages move --filter 'mailbox:"${found.path}"' --folder …), or the owner adds --allow-dangerous to lose them`, { reason: "mail.folder-not-empty" });
+        return found;
+    };
+    const preview = options.dryRun === true || given.yes !== true;
+    await changeFolder(this, "delete", async (writes, folders) => {
+        const found = emptyOrAllowed(folders);
+        await writes.deleteFolder(found.path);
+        return { folder: found.path, messages: found.messages, applied: true };
+    }, preview
+        ? (folders) => {
+            const found = emptyOrAllowed(folders);
+            return { folder: found.path, messages: found.messages };
+        }
+        : undefined);
+});
 export const foldersCommand = () => annotate(new Command("folders"), { effects: LOCAL_READ })
     .description("the folders of this profile's mailbox")
-    .addCommand(listCommand());
+    .addCommand(listCommand())
+    .addCommand(createCommand())
+    .addCommand(renameCommand())
+    .addCommand(deleteFolderCommand());
 //# sourceMappingURL=folders.js.map

package/dist/commands/folders.js.map

@@ -1 +1 @@
-{"version":3,"file":"folders.js","sourceRoot":"","sources":["../../src/commands/folders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AACrD,OAAO,EACL,YAAY,EACZ,WAAW,EACX,UAAU,EACV,MAAM,EACN,SAAS,EACT,WAAW,EACX,YAAY,GACb,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjE,MAAM,UAAU,GAAG,CAAC,CAAC,YAAY,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC5B,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAChC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC/B,CAAC,CAAA;AAEF,MAAM,WAAW,GAAG,GAAG,EAAE,CACvB,YAAY,CACV,QAAQ,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE;IAC5B,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,OAAO,kBAAkB,EAAE,GAAG,QAAQ,CAAC,OAAO,yBAAyB,CAAC;CAChG,CAAC,EACF,aAAa,EACb,UAAU,CACX;KACE,OAAO,CAAC,gDAAgD,CAAC;KACzD,WAAW,CAAC,yFAAyF,CAAC;KACtG,MAAM,CAAC,KAAK;IACX,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAC/B,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAC5B,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC3C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;QACtG,YAAY,CACV,IAAI,EACJ,SAAS,CAAC,IAAI,CAAC,EACf,MAAM,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAChG,CAAA;IACH,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAA;IACvB,CAAC;AACH,CAAC,CAAC,CAAA;AAEN,MAAM,CAAC,MAAM,cAAc,GAAG,GAAY,EAAE,CAC1C,QAAQ,CAAC,IAAI,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;KACtD,WAAW,CAAC,uCAAuC,CAAC;KACpD,UAAU,CAAC,WAAW,EAAE,CAAC,CAAA"}
+{"version":3,"file":"folders.js","sourceRoot":"","sources":["../../src/commands/folders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AACrD,OAAO,EACL,YAAY,EACZ,WAAW,EACX,MAAM,EACN,UAAU,EACV,MAAM,EACN,SAAS,EACT,eAAe,EACf,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAChF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjE,MAAM,UAAU,GAAG,CAAC,CAAC,YAAY,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC5B,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAChC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC/B,CAAC,CAAA;AAEF,MAAM,WAAW,GAAG,GAAG,EAAE,CACvB,YAAY,CACV,QAAQ,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE;IAC5B,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,OAAO,kBAAkB,EAAE,GAAG,QAAQ,CAAC,OAAO,yBAAyB,CAAC;CAChG,CAAC,EACF,aAAa,EACb,UAAU,CACX;KACE,OAAO,CAAC,gDAAgD,CAAC;KACzD,WAAW,CAAC,yFAAyF,CAAC;KACtG,MAAM,CAAC,KAAK;IACX,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAC/B,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAC5B,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC3C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;QACtG,YAAY,CACV,IAAI,EACJ,SAAS,CAAC,IAAI,CAAC,EACf,MAAM,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAChG,CAAA;IACH,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAA;IACvB,CAAC;AACH,CAAC,CAAC,CAAA;AAEN,MAAM,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC;IAClC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAClD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC7B,CAAC,CAAA;AAIF,MAAM,OAAO,GAAG,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,EAAW,CAAA;AAEtG,iHAAiH;AACjH,MAAM,YAAY,GAAG,KAAK,EACxB,OAAgB,EAChB,MAAoB,EACpB,IAQE,EACF,OAA0F,EAC1F,EAAE;IACF,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;IAClC,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAC5B,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC3C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,aAAa,CAAC,eAAe,CAAC,CAAA;QAChE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;YACrC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;YAC7B,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,QAAQ,CAAC,sBAAsB,EAAE,0CAA0C,CAAC,CAAA;YACnG,MAAM,KAAK,GAAG,QAAQ,CACpB,QAAQ,EACR,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,kBAAkB,EAAE,aAAa,CAAC,WAAW,EAAE,QAAQ,IAAI,EAAE,EAAE,EACnF,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EACtD,OAAO,CAAC,GAAG,EACX,aAAa,CAAC,OAAO,CAAC,CACvB,CAAA;YACD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,CAAA;YAC1C,MAAM,KAAK,GAAG,OAAO,EAAE,CAAC,OAAO,CAAC,CAAA;YAChC,IAAI,KAAK;gBAAE,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,oDAAoD,EAAE,CAAA;YAC1G,OAAO,YAAY,CACjB,KAAK,EACL;gBACE,MAAM,EAAE,IAAI;gBACZ,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC;gBACvB,GAAG,EAAE,WAAW,MAAM,EAAE;gBACxB,WAAW,EAAE,cAAc,EAAE;aAC9B,EACD,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAC5B,CAAA;QACH,CAAC,CAAC,CAAA;QACF,YAAY,CAAC,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAA;IACxE,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAA;IACvB,CAAC;AACH,CAAC,CAAA;AAID,MAAM,QAAQ,GAAG,CAAC,OAAmB,EAAE,KAAa,EAAE,EAAE;IACtD,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IACzC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,cAAc,KAAK,4BAA4B,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;IACjH,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED,MAAM,aAAa,GAAG,GAAG,EAAE,CACzB,YAAY,CACV,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE;IAC9B,OAAO,EAAE,YAAY;IACrB,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,OAAO,6BAA6B,EAAE,GAAG,QAAQ,CAAC,OAAO,8BAA8B,CAAC;CAChH,CAAC,EACF,oBAAoB,EACpB,YAAY,CACb;KACE,OAAO,CAAC,eAAe,CAAC;KACxB,WAAW,CAAC,qDAAqD,CAAC;KAClE,QAAQ,CAAC,UAAU,EAAE,8EAA8E,CAAC;KACpG,MAAM,CAAC,KAAK,WAA0B,MAAc;IACnD,MAAM,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;QAC3D,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK,MAAM,CAAC;YAC7C,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,WAAW,MAAM,kBAAkB,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;QAClG,MAAM,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;QACjC,OAAO,EAAE,MAAM,EAAE,CAAA;IACnB,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEN,MAAM,aAAa,GAAG,GAAG,EAAE,CACzB,YAAY,CACV,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE;IAC9B,OAAO,EAAE,YAAY;IACrB,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,OAAO,sCAAsC,CAAC;CACtE,CAAC,EACF,oBAAoB,EACpB,YAAY,CACb;KACE,OAAO,CAAC,iBAAiB,CAAC;KAC1B,WAAW,CAAC,+FAA+F,CAAC;KAC5G,QAAQ,CAAC,UAAU,EAAE,6BAA6B,CAAC;KACnD,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;KAClC,MAAM,CAAC,KAAK,WAA0B,MAAc,EAAE,IAAY;IACjE,MAAM,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;QAC3D,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QACvC,IAAI,KAAK,CAAC,IAAI;YACZ,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,GAAG,KAAK,CAAC,IAAI,WAAW,KAAK,CAAC,IAAI,4BAA4B,CAAC,CAAA;QACxG,MAAM,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAC3C,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;IACzC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEN,MAAM,mBAAmB,GAAG,GAAG,EAAE,CAC/B,YAAY,CACV,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE;IAC9B,OAAO,EAAE,YAAY;IACrB,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,OAAO,8BAA8B,CAAC;CAC9D,CAAC,EACF,oBAAoB,EACpB,YAAY,CACb;KACE,OAAO,CAAC,wBAAwB,CAAC;KACjC,WAAW,CACV,2GAA2G;IACzG,yDAAyD,CAC5D;KACA,QAAQ,CAAC,UAAU,EAAE,6BAA6B,CAAC;KACnD,MAAM,CAAC,OAAO,EAAE,uCAAuC,CAAC;KACxD,MAAM,CAAC,WAAW,EAAE,+BAA+B,CAAC;KACpD,SAAS,CACR,eAAe,CACb,mBAAmB,EACnB,+EAA+E,CAChF,CACF;KACA,MAAM,CAAC,KAAK,WAA0B,MAAc,EAAE,OAA6B;IAClF,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,EAA+C,CAAA;IACjF,MAAM,SAAS,GAAG,KAAK,CAAC,cAAc,KAAK,IAAI,CAAA;IAC/C,MAAM,cAAc,GAAG,CAAC,OAAmB,EAAE,EAAE;QAC7C,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QACvC,IAAI,KAAK,CAAC,IAAI;YAAE,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,GAAG,KAAK,CAAC,IAAI,WAAW,KAAK,CAAC,IAAI,mBAAmB,CAAC,CAAA;QAC7G,gGAAgG;QAChG,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,SAAS;YACpC,MAAM,IAAI,QAAQ,CAChB,kBAAkB,EAClB,GAAG,KAAK,CAAC,IAAI,UAAU,KAAK,CAAC,QAAQ,IAAI,sBAAsB,oEAAoE,KAAK,CAAC,IAAI,kEAAkE,EAC/M,EAAE,MAAM,EAAE,uBAAuB,EAAE,CACpC,CAAA;QACH,OAAO,KAAK,CAAA;IACd,CAAC,CAAA;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,GAAG,KAAK,IAAI,CAAA;IAC7D,MAAM,YAAY,CAChB,IAAI,EACJ,QAAQ,EACR,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;QACrC,MAAM,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACrC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IACxE,CAAC,EACD,OAAO;QACL,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE;YACV,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;YACrC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAA;QACzD,CAAC;QACH,CAAC,CAAC,SAAS,CACd,CAAA;AACH,CAAC,CAAC,CAAA;AAEN,MAAM,CAAC,MAAM,cAAc,GAAG,GAAY,EAAE,CAC1C,QAAQ,CAAC,IAAI,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;KACtD,WAAW,CAAC,uCAAuC,CAAC;KACpD,UAAU,CAAC,WAAW,EAAE,CAAC;KACzB,UAAU,CAAC,aAAa,EAAE,CAAC;KAC3B,UAAU,CAAC,aAAa,EAAE,CAAC;KAC3B,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAA"}

package/dist/commands/messages.d.ts

@@ -0,0 +1,25 @@
+import { type SendGuard } from "@wirecat/cli-core/sends";
+import { Command } from "commander";
+import type { MailBackend } from "../mail/backend.js";
+import { ChangeLog } from "../mail/changes.js";
+import { type Mailbox } from "../mail/organise.js";
+type Action = "message-flag" | "message-move" | "message-copy" | "message-delete" | "message-restore";
+export interface Opened {
+    mailbox: Mailbox;
+    backend: MailBackend;
+    guard: SendGuard;
+    log: (action: Action, extra?: {
+        restorableUntil?: string;
+        command?: string;
+    }) => ChangeLog;
+    profile: string;
+    env: NodeJS.ProcessEnv;
+    line: string;
+    path: string;
+}
+/** Opens the store and the mailbox for one write command, and closes both after `work`. */
+export declare const organising: <T>(command: Command, work: (opened: Opened) => Promise<T>) => Promise<T>;
+/** The write commands of `messages`, mounted beside cli-core's `messages show`. */
+export declare const messageWrites: () => Command[];
+export {};
+//# sourceMappingURL=messages.d.ts.map

package/dist/commands/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/commands/messages.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAwB,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAC9E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAInC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,SAAS,EAAW,MAAM,oBAAoB,CAAA;AAEvD,OAAO,EAQL,KAAK,OAAO,EAOb,MAAM,qBAAqB,CAAA;AAK5B,KAAK,MAAM,GAAG,cAAc,GAAG,cAAc,GAAG,cAAc,GAAG,gBAAgB,GAAG,iBAAiB,CAAA;AA4ErG,MAAM,WAAW,MAAM;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,WAAW,CAAA;IACpB,KAAK,EAAE,SAAS,CAAA;IAChB,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,SAAS,CAAA;IAC1F,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,2FAA2F;AAC3F,eAAO,MAAM,UAAU,GAAU,CAAC,WAAW,OAAO,QAAQ,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAqErG,CAAA;AAgfD,mFAAmF;AACnF,eAAO,MAAM,aAAa,QAAO,OAAO,EAUvC,CAAA"}