@wirecat/cli-core 0.533.0 → 0.535.0

package/CHANGELOG.md

@@ -7,6 +7,21 @@ shape of this file.
 
 ## Unreleased
 
+## 0.535.0 — 01.11.2026
+
+### Added
+
+- **`syncMail` takes `saveCoverage: false`** for a spot read, such as a CLI storing the copy of a message it just
+  sent: the mail is saved, and the coverage that memo reports for the archive stays what the last full run set.
+
+## 0.534.0 — 01.11.2026
+
+### Added
+
+- **`parseMail` also returns `messageId`, `references`, `replyTo` and `date`**, and takes a third argument, the most
+  attachments to keep (`MAX_ATTACHMENTS`, 50, by default), so a command that lists one message's files can ask for all
+  of them.
+
 ## 0.533.0 — 01.11.2026
 
 ### Added

package/dist/mail/index.d.ts

@@ -6,7 +6,7 @@ export { dropMissing, type Gone, tooManyGone } from "./gone.js";
 export { type AuthVerdicts, HEADER_FIELDS, headersOf, type MailHeaders, mailHeadersOf } from "./headers.js";
 export { type MailIdsInput, mailIds } from "./ids.js";
 export { decodedLabelName, decodeMailboxName, labelName, systemLabel } from "./labels.js";
-export { type Address, htmlToText, looksLikeHtml, MAX_BODY_CHARS, type ParsedMail, parseMail, } from "./parse.js";
+export { type Address, htmlToText, looksLikeHtml, MAX_ATTACHMENTS, MAX_BODY_CHARS, type ParsedMail, parseMail, } from "./parse.js";
 export { PRESET_NAMES, PRESETS, type PresetName, presetMatches } from "./presets.js";
 export { domainsToAge, groupKey, type Probe, type ProbeGroup, probeMail, SUGGEST_RULE } from "./probe.js";
 export { type MailFolderProgress, mailProgress } from "./progress.js";

package/dist/mail/index.js

@@ -6,7 +6,7 @@ export { dropMissing, tooManyGone } from "./gone.js";
 export { HEADER_FIELDS, headersOf, mailHeadersOf } from "./headers.js";
 export { mailIds } from "./ids.js";
 export { decodedLabelName, decodeMailboxName, labelName, systemLabel } from "./labels.js";
-export { htmlToText, looksLikeHtml, MAX_BODY_CHARS, parseMail, } from "./parse.js";
+export { htmlToText, looksLikeHtml, MAX_ATTACHMENTS, MAX_BODY_CHARS, parseMail, } from "./parse.js";
 export { PRESET_NAMES, PRESETS, presetMatches } from "./presets.js";
 export { domainsToAge, groupKey, probeMail, SUGGEST_RULE } from "./probe.js";
 export { mailProgress } from "./progress.js";

package/dist/mail/parse.d.ts

@@ -8,6 +8,12 @@ export interface ParsedMail {
     to: Address[];
     cc: Address[];
     bcc: Address[];
+    replyTo: Address[];
+    date: string | null;
+    /** Message-ID as the first `<id>` the header holds, brackets kept; the header as written when it holds none. */
+    messageId: string | null;
+    /** Every `<id>` of References, in the header's order, brackets kept. */
+    references: string[];
     attachments: {
         id: number;
         name: string;
@@ -17,8 +23,10 @@ export interface ParsedMail {
     text: string;
 }
 export declare const MAX_BODY_CHARS = 1000000;
+/** What sync stores; a command that shows the files of one message passes its own limit. */
+export declare const MAX_ATTACHMENTS = 50;
 export declare const htmlToText: (html: string) => string;
 /** Some senders put their HTML in the text/plain part; its first tag gives it away. */
 export declare const looksLikeHtml: (text: string) => boolean;
 /** A raw RFC 5322 message, as IMAP's `BODY[]` holds it. */
-export declare const parseMail: (raw: Uint8Array, maxBodyChars?: number) => Promise<ParsedMail>;
+export declare const parseMail: (raw: Uint8Array, maxBodyChars?: number, maxAttachments?: number) => Promise<ParsedMail>;

package/dist/mail/parse.js

@@ -2,6 +2,9 @@ import { CliError } from "@wirecat/cli-base";
 import PostalMime, {} from "postal-mime";
 // The store cuts a body into pieces itself; this only guards against a pathological one, like a pasted log.
 export const MAX_BODY_CHARS = 1_000_000;
+/** What sync stores; a command that shows the files of one message passes its own limit. */
+export const MAX_ATTACHMENTS = 50;
+const BRACKETED_ID = /<[^<>\s]+>/g;
 const addresses = (list) => list
     .flatMap((entry) => entry.group ?? [entry])
     .flatMap(({ address, name }) => (address ? [{ email: address.toLowerCase(), name: name || null }] : []));
@@ -52,7 +55,7 @@ const bytesOf = (content) => typeof content === "string"
         ? content
         : new Uint8Array(content);
 /** A raw RFC 5322 message, as IMAP's `BODY[]` holds it. */
-export const parseMail = async (raw, maxBodyChars = MAX_BODY_CHARS) => {
+export const parseMail = async (raw, maxBodyChars = MAX_BODY_CHARS, maxAttachments = MAX_ATTACHMENTS) => {
     let email;
     try {
         email = await PostalMime.parse(raw);
@@ -68,7 +71,11 @@ export const parseMail = async (raw, maxBodyChars = MAX_BODY_CHARS) => {
         to: addresses(email.to ?? []),
         cc: addresses(email.cc ?? []),
         bcc: addresses(email.bcc ?? []),
-        attachments: email.attachments.slice(0, 50).map((part, id) => ({
+        replyTo: addresses(email.replyTo ?? []),
+        date: email.date ?? null,
+        messageId: email.messageId?.match(BRACKETED_ID)?.[0] ?? email.messageId ?? null,
+        references: email.references?.match(BRACKETED_ID) ?? [],
+        attachments: email.attachments.slice(0, maxAttachments).map((part, id) => ({
             id,
             name: (part.filename ?? `attachment-${id}`).slice(0, 200),
             mime: part.mimeType || null,

package/dist/mail/sync.d.ts

@@ -89,6 +89,8 @@ export interface MailSyncOptions {
     retryAttachments?: boolean;
     /** List every message in the window, not only those an earlier run left: proves deletions, refreshes labels. */
     rescan?: boolean;
+    /** `false` for a spot read, like the copy of a sent message: the run leaves the saved coverage as the last full run set it. */
+    saveCoverage?: boolean;
     /** A window smaller than this is listed whole every run: it costs seconds and keeps flags and deletions current. */
     resumeFrom?: number;
     /** Runs after the mail is saved, so chats and mail still waiting for vectors are indexed; its answer is `indexed`. */

package/dist/mail/sync.js

@@ -141,7 +141,7 @@ export const syncMail = async (source, store, options) => {
             : {}),
     };
 };
-const syncRound = async (source, store, { account, since, max = 200, maxBodyChars = MAX_BODY_CHARS, maxAttachmentChars = MAX_ATTACHMENT_CHARS, now = Date.now, ages, loadEngine = importEngine, retryAttachments = false, rescan = false, resumeFrom = RESUME_FROM, index, signal, }, plan) => {
+const syncRound = async (source, store, { account, since, max = 200, maxBodyChars = MAX_BODY_CHARS, maxAttachmentChars = MAX_ATTACHMENT_CHARS, now = Date.now, ages, loadEngine = importEngine, retryAttachments = false, rescan = false, saveCoverage = true, resumeFrom = RESUME_FROM, index, signal, }, plan) => {
     if (retryAttachments)
         return retryUnread({
             store,
@@ -777,7 +777,7 @@ const syncRound = async (source, store, { account, since, max = 200, maxBodyChar
         state: complete ? "window" : "partial",
         identity: account.mode === "imap" ? "message-id-or-uidvalidity-folder-uid" : "gmail-message-id",
     };
-    if (!snapshot)
+    if (!snapshot && saveCoverage)
         await store.sync.setSyncState(key, "mail_coverage", JSON.stringify(coverage));
     const tagging = tagger.outcome();
     await settleRuleTags(store, accountId, rules, tagging);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.533.0",
+  "version": "0.535.0",
   "description": "The messenger-neutral half of a messaging CLI: domain model, message locators, rendering, name resolution, the SQLite seam, the command skeleton and shared read commands, the send guard, run records and the message store",
   "license": "Apache-2.0",
   "author": "Viacheslav Ptsarev",