@wirecat/cli-core 0.533.0 → 0.534.0

package/CHANGELOG.md

@@ -7,6 +7,14 @@ shape of this file.
 
 ## Unreleased
 
+## 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.533.0",
+  "version": "0.534.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",