@wirecat/mail-cli 0.4.0 → 0.6.0

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"}

package/dist/mail/backend.d.ts

@@ -1,10 +1,13 @@
-import type { MailSource } from "@wirecat/cli-core/mail";
+import type { MailCriteria, MailSource, Searched } from "@wirecat/cli-core/mail";
+import type { SearchSyntax } from "./imap/search.js";
 export interface MailEndpoint {
     host: string;
     port: number;
     /** `plain` is for a local test server only; no profile can ask for it. */
     security: "tls" | "starttls" | "plain";
     login: string;
+    /** The submission server; without it the backend cannot send. */
+    smtp?: Pick<MailEndpoint, "host" | "port" | "security">;
 }
 /** What the run lets a backend spend: a retry is a request of its budget, and none outlives its deadline. */
 export interface RunBounds {
@@ -25,10 +28,87 @@ export interface AccountCheck {
     features: Record<"idle" | "condstore" | "qresync" | "move" | "uidplus" | "compress" | "x_gm_ext_1" | "objectid", boolean>;
     folders: number;
 }
+/** A message's flags as the server holds them now; `labels` only on Gmail, in its own spelling (`\Inbox`, `Work`). */
+export interface ServerState {
+    flags: string[];
+    labels?: string[];
+    /** The Message-ID, to find the message again on a server that gives no new UID after a move. */
+    messageId?: string;
+}
+/** Where a move or copy put the messages: their UIDs in the target, and its UIDVALIDITY, where the server says. */
+export interface Moved {
+    uids: Map<number, number>;
+    validity?: string;
+}
+/**
+ * The changes a command makes to a mailbox. Every call on messages names the folder's UIDVALIDITY as it was read with
+ * the UIDs: a server that changed it since is refused, so no UID lands on another message. None of these is retried:
+ * a write that may have reached the server is not sent twice.
+ */
+export interface MailWrites {
+    /**
+     * The folder's UIDVALIDITY, and the UID there of each Gmail id (`emailIds`) or Message-ID (`messageIds`)
+     * asked for, keyed by what was asked; one not there is left out.
+     */
+    locate(folder: string, ids: {
+        emailIds?: readonly string[];
+        messageIds?: readonly string[];
+    }): Promise<{
+        validity: string;
+        uids: Map<string, number>;
+    }>;
+    state(folder: string, validity: string, uids: readonly number[]): Promise<Map<number, ServerState>>;
+    flag(folder: string, validity: string, uids: readonly number[], change: {
+        add?: string[];
+        remove?: string[];
+    }): Promise<void>;
+    /** Gmail labels, by `X-GM-LABELS`. */
+    label(folder: string, validity: string, uids: readonly number[], change: {
+        add?: string[];
+        remove?: string[];
+    }): Promise<void>;
+    /** Each moved UID's new UID in `to`, where the server says (UIDPLUS). */
+    move(folder: string, validity: string, uids: readonly number[], to: string): Promise<Moved>;
+    copy(folder: string, validity: string, uids: readonly number[], to: string): Promise<Moved>;
+    /** `\Deleted` and UID EXPUNGE of exactly these UIDs: gone for good. Undoing a copy, drafts delete and drafts send. */
+    expunge(folder: string, validity: string, uids: readonly number[]): Promise<void>;
+    /** Stores a message the tool built, with its flags; the new UID and UIDVALIDITY where the server says (APPENDUID). */
+    append(folder: string, raw: Uint8Array, flags: readonly string[]): Promise<{
+        uid?: number;
+        validity?: string;
+    }>;
+    createFolder(path: string): Promise<void>;
+    renameFolder(path: string, to: string): Promise<void>;
+    deleteFolder(path: string): Promise<void>;
+}
+/** One message to hand the submission server: the envelope says who receives it, Bcc included; `raw` has no Bcc line. */
+export interface Submission {
+    from: string;
+    recipients: readonly string[];
+    raw: Uint8Array;
+}
+export interface Submitted {
+    /** The envelope recipients the server took, and those it refused; a send with none taken fails instead. */
+    accepted: string[];
+    rejected: string[];
+}
+/**
+ * Sends over SMTP. Never retried: a server that took the message and then lost the line has sent it, so a failure
+ * after the message left is `outcome_unknown`, and one before it is marked `sent: false`.
+ */
+export interface MailSubmit {
+    send(message: Submission): Promise<Submitted>;
+}
 /** Everything a command asks of one mailbox. cli-core's sync reads it as a `MailSource`. */
 export interface MailBackend extends MailSource {
     check(): Promise<AccountCheck>;
     folderList(): Promise<FolderInfo[]>;
+    /** The UIDs the server's own search finds in `folder`, in the provider's syntax. */
+    serverQuery?(criteria: MailCriteria, folder: string, syntax: SearchSyntax): Promise<Searched>;
+    /** Absent on a backend that cannot change the mailbox. */
+    writes?: MailWrites;
+    /** Absent where the profile names no submission server. */
+    submit?: MailSubmit;
     /** After this, every call fails; nothing reconnects. */
     close(): Promise<void>;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/mail/backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAExD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,0EAA0E;IAC1E,QAAQ,EAAE,KAAK,GAAG,UAAU,GAAG,OAAO,CAAA;IACtC,KAAK,EAAE,MAAM,CAAA;CACd;AAED,6GAA6G;AAC7G,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAA;IACxB,UAAU,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAA;IACrC,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,QAAQ,EAAE,MAAM,CACd,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,UAAU,EAC9F,OAAO,CACR,CAAA;IACD,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,4FAA4F;AAC5F,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC,CAAA;IAC9B,UAAU,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;IACnC,wDAAwD;IACxD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,KAAK,WAAW,CAAA"}
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/mail/backend.ts"],"names":[],"mappings":"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"}

package/dist/mail/changes.d.ts

@@ -0,0 +1,91 @@
+/** What one step did to the mailbox; its inverse is what `messages restore` does. */
+export type ChangeOp = "flag" | "label" | "move" | "copy" | "trash";
+export interface ChangedItem {
+    /** The stored email's id: Gmail's X-GM-MSGID, or the hash of its Message-ID. */
+    id: string;
+    uid: number;
+    /** Of the flags or labels this step changes, the ones the message had before it. */
+    had?: string[];
+    /** On Gmail, every label the message had before it went to Trash, so a restore puts them back. */
+    labels?: string[];
+    /** The Message-ID, to find the message again where the server gives no new UID. */
+    mid?: string;
+}
+/** Written before the server is asked: a step the server made without answering is still undone. */
+export interface StepLine {
+    type: "step";
+    step: number;
+    op: ChangeOp;
+    folder: string;
+    validity: string;
+    to?: string;
+    change?: {
+        add?: string[];
+        remove?: string[];
+    };
+    items: ChangedItem[];
+}
+export interface DoneLine {
+    type: "done";
+    step: number;
+    ids: string[];
+    /** The UIDs the moved or copied messages have in `to`, by id, where the server said. */
+    uids?: Record<string, number>;
+    to_validity?: string;
+}
+export interface RunLine {
+    type: "run";
+    id: string;
+    account: string;
+    command: string;
+    started_at: string;
+    /** Gmail empties Trash after 30 days; a run that trashed mail there can be undone until then. */
+    restorable_until?: string;
+}
+export interface RestoreLine {
+    type: "restore";
+    at: string;
+    ids: string[];
+}
+export interface ChangeRun {
+    run: RunLine;
+    steps: {
+        step: StepLine;
+        done?: DoneLine;
+    }[];
+    restored: Set<string>;
+}
+/** One command's record of what it changed, appended as it goes; the file is the owner's only. */
+export declare class ChangeLog {
+    readonly run: RunLine;
+    readonly path: string;
+    private step;
+    constructor(env: NodeJS.ProcessEnv, run: RunLine);
+    private write;
+    begin(step: Omit<StepLine, "type" | "step">): number;
+    done(step: number, ids: string[], moved?: {
+        uids: Map<string, number>;
+        validity?: string;
+    }): void;
+    end(at: number): void;
+}
+export declare const appendRestore: (path: string, ids: string[], at: number) => void;
+/** A run of this mailbox, by the id its answer gave; memo's cleanup runs are found too. */
+export declare const readRun: (env: NodeJS.ProcessEnv, account: string, id: string) => {
+    path: string;
+    run: ChangeRun;
+};
+export interface RunSummary {
+    id: string;
+    account: string;
+    command: string;
+    started_at: string;
+    /** No end line: the process stopped part way, so some steps may be done and others not. */
+    unfinished: boolean;
+    restorable_until: string | null;
+    /** Moved to Trash and not restored since. */
+    in_trash: number;
+}
+/** Every recorded run on this computer, of every mailbox, memo's cleanup runs included; newest first. */
+export declare const runSummaries: (env: NodeJS.ProcessEnv) => RunSummary[];
+//# sourceMappingURL=changes.d.ts.map

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

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

package/dist/mail/changes.js

@@ -0,0 +1,198 @@
+import { appendFileSync, existsSync, mkdirSync, readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { CliError, resolvePaths } from "@wirecat/cli-base";
+const RUN_ID = /^[\w.:-]+$/;
+const runsDir = (env, account) => join(resolvePaths({ appName: "mail-cli", prefix: "MAIL", env }).state, "changes", account.toLowerCase());
+const readLines = (path) => readFileSync(path, "utf8")
+    .split("\n")
+    .filter(Boolean)
+    .flatMap((text) => {
+    try {
+        return [JSON.parse(text)];
+    }
+    catch {
+        // A torn last line from a run that died; the lines before it still say what happened.
+        return [];
+    }
+});
+/** One command's record of what it changed, appended as it goes; the file is the owner's only. */
+export class ChangeLog {
+    run;
+    path;
+    step = 0;
+    constructor(env, run) {
+        this.run = run;
+        const dir = runsDir(env, run.account);
+        mkdirSync(dir, { recursive: true, mode: 0o700 });
+        this.path = join(dir, `${run.id.replace(/[^\w.-]/g, "_")}.jsonl`);
+        this.write(run);
+    }
+    write(line) {
+        appendFileSync(this.path, `${JSON.stringify(line)}\n`, { mode: 0o600 });
+    }
+    begin(step) {
+        this.step++;
+        this.write({ type: "step", step: this.step, ...step });
+        return this.step;
+    }
+    done(step, ids, moved) {
+        this.write({
+            type: "done",
+            step,
+            ids,
+            ...(moved?.uids.size ? { uids: Object.fromEntries(moved.uids) } : {}),
+            ...(moved?.validity ? { to_validity: moved.validity } : {}),
+        });
+    }
+    end(at) {
+        this.write({ type: "end", ended_at: new Date(at).toISOString() });
+    }
+}
+export const appendRestore = (path, ids, at) => {
+    // A file another program wrote may end without a newline, and the line would join its last one and be lost.
+    const lead = readFileSync(path, "utf8").endsWith("\n") ? "" : "\n";
+    appendFileSync(path, `${lead}${JSON.stringify({ type: "restore", at: new Date(at).toISOString(), ids })}\n`);
+};
+/** Gmail's own names for its system labels, as `X-GM-LABELS` takes them. */
+const SYSTEM_LABELS = new Set(["Inbox", "Important", "Starred", "Sent", "Drafts", "Spam", "Trash"]);
+const gmailLabel = (label) => (SYSTEM_LABELS.has(label) ? `\\${label}` : label);
+/** What came back from a memo run: memo wrote `restored`, a restore made here writes `ids`. */
+const memoRestored = (lines) => new Set(lines
+    .filter(({ type }) => type === "restore")
+    .flatMap((line) => [...(line.restored ?? []), ...(line.ids ?? [])]));
+/**
+ * A cleanup run memo made before the cleanup moved here: memo kept it under its own state folder, one file per run,
+ * with every email's labels. It reads as one Gmail step from All Mail to Trash.
+ */
+const memoRun = (env, account, id) => {
+    const root = join(resolvePaths({ appName: "cli-memo", prefix: "MEMO", env }).state, "mail-trash");
+    if (!existsSync(root))
+        return undefined;
+    for (const name of readdirSync(root)) {
+        const path = join(root, name, `${id}.jsonl`);
+        if (!existsSync(path))
+            continue;
+        const lines = readLines(path);
+        const head = lines.find(({ type }) => type === "run");
+        if (String(head?.account ?? "").toLowerCase() !== account.toLowerCase())
+            continue;
+        const started = String(head?.started_at ?? "");
+        const emails = lines.filter(({ type }) => type === "email");
+        const step = {
+            type: "step",
+            step: 1,
+            op: "trash",
+            folder: "",
+            validity: "",
+            items: emails.map((line) => ({
+                id: String(line.message_id),
+                uid: 0,
+                labels: (line.labels ?? []).map(gmailLabel),
+            })),
+        };
+        return {
+            path,
+            run: {
+                run: {
+                    type: "run",
+                    id,
+                    account,
+                    command: "memo mail delete",
+                    started_at: started,
+                    restorable_until: new Date(Date.parse(started) + 30 * 86_400_000).toISOString(),
+                },
+                // Every logged email, not only those a batch line confirms: a move Gmail made but did not answer leaves none.
+                steps: [{ step }],
+                restored: memoRestored(lines),
+            },
+        };
+    }
+    return undefined;
+};
+/** A run of this mailbox, by the id its answer gave; memo's cleanup runs are found too. */
+export const readRun = (env, account, id) => {
+    if (!RUN_ID.test(id))
+        throw new CliError("validation_error", "a run id is letters, digits, dots, colons and dashes");
+    const path = join(runsDir(env, account), `${id.replace(/[^\w.-]/g, "_")}.jsonl`);
+    if (!existsSync(path)) {
+        const memo = memoRun(env, account, id);
+        if (memo)
+            return memo;
+        throw new CliError("not_found", `no change run ${id} for ${account}`, { reason: "mail.run-unknown" });
+    }
+    const lines = readLines(path);
+    const run = lines.find((line) => line.type === "run");
+    if (!run)
+        throw new CliError("invalid_response", `the record of run ${id} has no start line`);
+    const done = new Map(lines.filter((line) => line.type === "done").map((line) => [line.step, line]));
+    return {
+        path,
+        run: {
+            run,
+            steps: lines
+                .filter((line) => line.type === "step")
+                .map((step) => ({ step, ...(done.has(step.step) ? { done: done.get(step.step) } : {}) })),
+            restored: new Set(lines.filter((line) => line.type === "restore").flatMap(({ ids }) => ids)),
+        },
+    };
+};
+const summaryOf = (lines) => {
+    const run = lines.find((line) => line.type === "run");
+    if (!run)
+        return undefined;
+    const done = new Set(lines
+        .filter((line) => line.type === "done")
+        .flatMap(({ step, ids }) => ids.map((one) => `${step}:${one}`)));
+    const restored = new Set(lines.filter((line) => line.type === "restore").flatMap(({ ids }) => ids));
+    const trashed = new Set(lines
+        .filter((line) => line.type === "step" && line.op === "trash")
+        .flatMap(({ step, items }) => items.filter(({ id }) => done.has(`${step}:${id}`)).map(({ id }) => id)));
+    return {
+        id: run.id,
+        account: run.account,
+        command: run.command,
+        started_at: run.started_at,
+        unfinished: !lines.some(({ type }) => type === "end"),
+        restorable_until: run.restorable_until ?? null,
+        in_trash: [...trashed].filter((one) => !restored.has(one)).length,
+    };
+};
+/** memo's cleanup runs, from before the cleanup moved here: `email` lines are what it moved, `restore` what came back. */
+const memoSummaries = (env) => {
+    const root = join(resolvePaths({ appName: "cli-memo", prefix: "MEMO", env }).state, "mail-trash");
+    if (!existsSync(root))
+        return [];
+    return readdirSync(root).flatMap((name) => readdirSync(join(root, name))
+        .filter((file) => file.endsWith(".jsonl"))
+        .flatMap((file) => {
+        const lines = readLines(join(root, name, file));
+        const head = lines.find(({ type }) => type === "run");
+        if (!head)
+            return [];
+        const started = String(head.started_at ?? "");
+        const restored = memoRestored(lines);
+        const moved = lines.filter(({ type }) => type === "batch").flatMap((line) => line.moved ?? []);
+        return [
+            {
+                id: file.replace(/\.jsonl$/, ""),
+                account: String(head.account ?? name),
+                command: "memo mail delete",
+                started_at: started,
+                unfinished: !lines.some(({ type }) => type === "end"),
+                restorable_until: new Date(Date.parse(started) + 30 * 86_400_000).toISOString(),
+                in_trash: moved.filter((one) => !restored.has(one)).length,
+            },
+        ];
+    }));
+};
+/** Every recorded run on this computer, of every mailbox, memo's cleanup runs included; newest first. */
+export const runSummaries = (env) => {
+    const root = join(resolvePaths({ appName: "mail-cli", prefix: "MAIL", env }).state, "changes");
+    const own = existsSync(root)
+        ? readdirSync(root).flatMap((account) => readdirSync(join(root, account))
+            .filter((file) => file.endsWith(".jsonl"))
+            .flatMap((file) => summaryOf(readLines(join(root, account, file))) ?? []))
+        : [];
+    return [...own, ...memoSummaries(env)].sort((a, b) => b.started_at.localeCompare(a.started_at));
+};
+//# sourceMappingURL=changes.js.map

package/dist/mail/changes.js.map

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

package/dist/mail/cleanup.d.ts

@@ -0,0 +1,41 @@
+import { type MailRule } from "@wirecat/cli-core/mail";
+import type { Mailbox } from "./organise.js";
+/** A first cleanup moves few, so the owner can check them by hand before trusting the rules with more. */
+export declare const FIRST_RUN_LIMIT = 100;
+export declare const CLEANUP_LIMIT = 5000;
+export type KeptReason = "no_rule" | "protected" | "rule_changed" | "replied" | "starred" | "sent" | "labelled" | "too_new" | "before_since";
+export interface RuleTotals {
+    rule: string;
+    candidates: number;
+    bytes: number;
+}
+export interface Cleanup {
+    ids: string[];
+    /** Envelopes in the store for this mailbox. */
+    envelopes: number;
+    candidates: number;
+    bytes: number;
+    kept: Partial<Record<KeptReason, number>>;
+    rules: RuleTotals[];
+    limit: number;
+    first_run: boolean;
+    backup: {
+        at: string | null;
+        fresh: boolean;
+        marker: string;
+    };
+}
+/** The weekly store backup's marker, written by the backup script when a copy passed its check. */
+export declare const backupOf: (env: NodeJS.ProcessEnv, now: number) => Cleanup["backup"];
+/** No cleanup has moved mail of this mailbox before, here or in memo. */
+export declare const firstCleanup: (env: NodeJS.ProcessEnv, account: string) => boolean;
+/**
+ * The envelopes the owner's rules would have the mailbox let go, each decided again with today's rules, labels and
+ * flags as the last sync stored them; oldest first, at most `limit`.
+ */
+export declare const cleanupOf: (mailbox: Mailbox, rules: readonly MailRule[], { limit, since, env }: {
+    limit: number;
+    since?: Date;
+    env: NodeJS.ProcessEnv;
+}) => Promise<Cleanup>;
+//# sourceMappingURL=cleanup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../src/mail/cleanup.ts"],"names":[],"mappings":"AAGA,OAAO,EAAmE,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAEvH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAK5C,0GAA0G;AAC1G,eAAO,MAAM,eAAe,MAAM,CAAA;AAClC,eAAO,MAAM,aAAa,OAAQ,CAAA;AAKlC,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,WAAW,GACX,cAAc,GACd,SAAS,GACT,SAAS,GACT,MAAM,GACN,UAAU,GACV,SAAS,GACT,cAAc,CAAA;AAElB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,EAAE,CAAA;IACb,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAA;IACzC,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,OAAO,CAAA;IAClB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAC9D;AAwBD,mGAAmG;AACnG,eAAO,MAAM,QAAQ,QAAS,MAAM,CAAC,UAAU,OAAO,MAAM,KAAG,OAAO,CAAC,QAAQ,CAQ9E,CAAA;AAED,yEAAyE;AACzE,eAAO,MAAM,YAAY,QAAS,MAAM,CAAC,UAAU,WAAW,MAAM,KAAG,OAyBtE,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,YACX,OAAO,SACT,SAAS,QAAQ,EAAE,yBACH;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,KAC7E,OAAO,CAAC,OAAO,CA6CjB,CAAA"}

package/dist/mail/cleanup.js

@@ -0,0 +1,119 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { resolvePaths } from "@wirecat/cli-base";
+import { decide, describeMatch, ENVELOPE, factsOf, listedOf } from "@wirecat/cli-core/mail";
+import { storePath } from "@wirecat/cli-core/store";
+const DAY = 86_400_000;
+const MIN_AGE_DAYS = 30;
+const BACKUP_DAYS = 8;
+/** A first cleanup moves few, so the owner can check them by hand before trusting the rules with more. */
+export const FIRST_RUN_LIMIT = 100;
+export const CLEANUP_LIMIT = 5_000;
+/** Labels Gmail sets itself; any other label on a message is the owner's, and keeps it out of the trash. */
+const SYSTEM_LABELS = new Set(["Inbox", "Important", "Starred", "Sent", "Drafts", "Spam", "Trash"]);
+const userLabels = (item) => (item.labels ?? []).filter((label) => !SYSTEM_LABELS.has(label));
+/** Why an envelope stays, or undefined when the cleanup may trash it. Moved from memo's `mail delete`. */
+const keptBecause = (item, rule, replied, now) => {
+    if (rule === undefined)
+        return "no_rule";
+    if (rule.protected || rule.action === "keep")
+        return "protected";
+    if (rule.action !== ENVELOPE && rule.action !== "skip")
+        return "rule_changed";
+    const from = item.headers?.from;
+    if (from !== undefined && replied.has(from))
+        return "replied";
+    const labels = item.labels ?? [];
+    if (item.flagged || labels.includes("Starred") || labels.includes("Important"))
+        return "starred";
+    if (labels.includes("Sent") || labels.includes("Drafts"))
+        return "sent";
+    if (userLabels(item).some((label) => !rule.tags?.includes(label)))
+        return "labelled";
+    if (now - Date.parse(item.receivedAt) < MIN_AGE_DAYS * DAY)
+        return "too_new";
+    return undefined;
+};
+/** The weekly store backup's marker, written by the backup script when a copy passed its check. */
+export const backupOf = (env, now) => {
+    const marker = join(dirname(storePath(env)), "backups", "last.json");
+    let at = null;
+    try {
+        const value = JSON.parse(readFileSync(marker, "utf8")).at;
+        if (typeof value === "string" && !Number.isNaN(Date.parse(value)))
+            at = value;
+    }
+    catch { }
+    return { at, fresh: at !== null && now - Date.parse(at) < BACKUP_DAYS * DAY, marker };
+};
+/** No cleanup has moved mail of this mailbox before, here or in memo. */
+export const firstCleanup = (env, account) => {
+    const own = join(resolvePaths({ appName: "mail-cli", prefix: "MAIL", env }).state, "changes", account.toLowerCase());
+    const memo = join(resolvePaths({ appName: "cli-memo", prefix: "MEMO", env }).state, "mail-trash");
+    const moved = (path, test) => {
+        try {
+            return test(readFileSync(path, "utf8"));
+        }
+        catch {
+            return false;
+        }
+    };
+    if (existsSync(own))
+        for (const name of readdirSync(own))
+            if (moved(join(own, name), (text) => text.includes("delete --rules") && text.includes('"type":"done"')))
+                return false;
+    if (existsSync(memo))
+        for (const folder of readdirSync(memo))
+            for (const name of existsSync(join(memo, folder)) ? readdirSync(join(memo, folder)) : [])
+                if (moved(join(memo, folder, name), (text) => text.includes(`"account":"${account.toLowerCase()}"`) && /"moved":\["/.test(text)))
+                    return false;
+    return true;
+};
+/**
+ * The envelopes the owner's rules would have the mailbox let go, each decided again with today's rules, labels and
+ * flags as the last sync stored them; oldest first, at most `limit`.
+ */
+export const cleanupOf = async (mailbox, rules, { limit, since, env }) => {
+    const now = mailbox.now();
+    const first = firstCleanup(env, mailbox.key.account);
+    const cap = first ? Math.min(limit, FIRST_RUN_LIMIT) : limit;
+    const facts = (await mailbox.store.mail.emailFacts({ accountId: mailbox.accountId })).map(listedOf);
+    const envelopes = facts.filter(({ envelope }) => envelope);
+    const replied = new Set(facts.filter(({ labels }) => labels?.includes("Sent")).flatMap(({ headers }) => headers?.to ?? []));
+    const factsFor = factsOf(facts, rules);
+    const kept = {};
+    const totals = new Map();
+    const chosen = [];
+    let candidates = 0;
+    let bytes = 0;
+    for (const item of envelopes) {
+        const rule = decide(rules, factsFor(item));
+        const reason = since !== undefined && Date.parse(item.receivedAt) < since.getTime()
+            ? "before_since"
+            : keptBecause(item, rule, replied, now);
+        if (reason !== undefined) {
+            kept[reason] = (kept[reason] ?? 0) + 1;
+            continue;
+        }
+        const name = describeMatch(rule.match);
+        const total = totals.get(name) ?? { rule: name, candidates: 0, bytes: 0 };
+        total.candidates++;
+        total.bytes += item.size ?? 0;
+        totals.set(name, total);
+        candidates++;
+        bytes += item.size ?? 0;
+        chosen.push(item.messageId);
+    }
+    return {
+        ids: chosen.slice(0, cap),
+        envelopes: envelopes.length,
+        candidates,
+        bytes,
+        kept,
+        rules: [...totals.values()].sort((a, b) => b.candidates - a.candidates),
+        limit: cap,
+        first_run: first,
+        backup: backupOf(env, now),
+    };
+};
+//# sourceMappingURL=cleanup.js.map