pipework 0.69.0 → 0.71.0

package/dist/infra/email/mail.js

@@ -8,7 +8,18 @@ import { getBaseLogger } from '../../core/logging/index.js';
 import { __flowStep } from '../../trace/runtime/flow-step.js';
 import { auditEmail } from './audit.js';
 export const SEND_JOB = 'pipework.email.send';
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const MAX_REFERENCES = 20;
+const MAX_REFERENCES_CHARS = 900;
 const ADDRESS_RE = /^[^\s@<>,;"]+@[^\s@<>,;"]+$/;
+/** The reply headers for a message answering a received one: In-Reply-To, and References capped to 20 ids and the provider's header length. */
+export function replyHeaders(messageId, references) {
+    const ids = [...references, messageId].filter(id => /^[\x21-\x7e]+$/.test(id) && !/[<>]/.test(id));
+    const unique = ids.filter((id, i) => ids.lastIndexOf(id) === i).slice(-MAX_REFERENCES);
+    while (unique.length > 1 && unique.map(i => `<${i}>`).join(' ').length > MAX_REFERENCES_CHARS)
+        unique.shift();
+    return { 'In-Reply-To': `<${messageId}>`, 'References': unique.map(i => `<${i}>`).join(' ') };
+}
 export function normalizeAddress(address) {
     return address.trim().toLowerCase();
 }
@@ -22,13 +33,14 @@ export function normalizeAddress(address) {
  * provider call is a trace step and `Email:sent` / `Email:suppressed` / `Email:failed`
  * audit records are written under it, in the trace of the flow that called `send`.
  *
- * Needs blueprint `email: {}` (tables `pipework_email_messages`, `pipework_email_suppressions`).
+ * Needs blueprint `email: {}` (tables `pipework_email_messages`, `pipework_email_suppressions`, `pipework_email_inbound`).
  * A provider error returns the message to `queued` with `error` set and rethrows, so the
  * queue retries (set `maxAttempts` on the queue); if the queue gives up the row keeps the error.
  * A run claims the message with a conditional update (`status` `queued`, or `sending` for longer than
  * `sendingStaleSeconds`), so a re-run of a job whose first run is still in flight does not call the provider.
  * Residual window: a crash mid-send leaves the message `sending` for the stale window, after which a retry
  * may send it once more; likewise if the provider accepted it and the process died before the row was marked `sent`. SES v2 has no idempotency token to close it.
+ * With `conversationId` / `inReplyTo` the message joins a conversation and carries reply headers (see `SendInput`).
  * Message bodies and template data are never logged.
  */
 export function createMail(config) {
@@ -59,6 +71,14 @@ export function createMail(config) {
             getBaseLogger().info({ event: 'email suppressed send', messageId }, 'email skipped: address is suppressed');
             return { status: 'suppressed' };
         }
+        let headers;
+        const inReplyToInbound = row['in_reply_to_inbound'];
+        if (inReplyToInbound !== null) {
+            const parent = (await db.execute(sql `SELECT message_id_header, "references" FROM pipework_email_inbound WHERE id = ${inReplyToInbound}::uuid`))[0];
+            const parentId = parent?.['message_id_header'] ?? null;
+            if (parentId !== null)
+                headers = replyHeaders(parentId, parent['references'] ?? []);
+        }
         const templateName = row['template'];
         const template = config.templates[templateName];
         let rendered = null;
@@ -95,6 +115,7 @@ export function createMail(config) {
                 subject: rendered.subject, text: rendered.text,
                 ...(rendered.html !== undefined ? { html: rendered.html } : {}),
                 ...(config.configurationSet !== undefined ? { configurationSet: config.configurationSet } : {}),
+                ...(headers !== undefined ? { headers } : {}),
             });
             await db.execute(sql `
         UPDATE pipework_email_messages
@@ -124,10 +145,25 @@ export function createMail(config) {
             if (input.key.trim() === '') {
                 throw new ValidationError({ key: ['must not be empty'] }, 'mail.send: "key" must not be empty.');
             }
+            if (input.conversationId !== undefined && !UUID_RE.test(input.conversationId)) {
+                throw new ValidationError({ conversationId: ['must be a UUID'] }, 'mail.send: "conversationId" must be a UUID.');
+            }
+            let conversationId = input.conversationId ?? null;
+            if (input.inReplyTo !== undefined) {
+                if (!UUID_RE.test(input.inReplyTo)) {
+                    throw new ValidationError({ inReplyTo: ['must be a received message id'] }, 'mail.send: "inReplyTo" must be a received message id.');
+                }
+                const parent = (await db.execute(sql `SELECT conversation_id FROM pipework_email_inbound WHERE id = ${input.inReplyTo}::uuid`))[0];
+                if (parent === undefined) {
+                    throw new ValidationError({ inReplyTo: ['no received message has this id'] }, `mail.send: no received message ${input.inReplyTo}.`);
+                }
+                conversationId ??= parent['conversation_id'] ?? null;
+            }
             const traceId = getContext()?.trace?.id ?? null;
             const inserted = await db.execute(sql `
-        INSERT INTO pipework_email_messages (key, to_address, template, data, trace_id)
-        VALUES (${input.key}, ${input.to.trim()}, ${input.template}, ${JSON.stringify(input.data ?? null)}::jsonb, ${traceId}::uuid)
+        INSERT INTO pipework_email_messages (key, to_address, template, data, trace_id, conversation_id, in_reply_to_inbound)
+        VALUES (${input.key}, ${input.to.trim()}, ${input.template}, ${JSON.stringify(input.data ?? null)}::jsonb, ${traceId}::uuid,
+          ${conversationId}::uuid, ${input.inReplyTo ?? null}::uuid)
         ON CONFLICT (key) DO NOTHING
         RETURNING id`);
             if (inserted.length === 0) {

package/dist/infra/email/mail.js.map

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

package/dist/infra/email/mime.d.ts

@@ -0,0 +1,38 @@
+export interface ParsedAddress {
+    readonly address: string;
+    readonly name: string;
+}
+export interface ParsedAttachment {
+    readonly filename: string | null;
+    readonly mediaType: string;
+    readonly size: number;
+    readonly contentId: string | null;
+    readonly inline: boolean;
+    readonly content: Buffer;
+}
+export interface ParsedMessage {
+    /** Message-ID without angle brackets, or null. */
+    readonly messageId: string | null;
+    /** The first In-Reply-To id without angle brackets, or null. */
+    readonly inReplyTo: string | null;
+    /** In-Reply-To ids (first) then References ids, without angle brackets, duplicates removed. */
+    readonly threadIds: readonly string[];
+    /** References ids without angle brackets, in order. */
+    readonly references: readonly string[];
+    readonly from: ParsedAddress | null;
+    readonly to: readonly ParsedAddress[];
+    readonly cc: readonly ParsedAddress[];
+    readonly replyTo: readonly ParsedAddress[];
+    readonly subject: string;
+    readonly date: Date | null;
+    readonly text: string | null;
+    readonly html: string | null;
+    readonly attachments: readonly ParsedAttachment[];
+}
+/** Decodes RFC 2047 encoded words in `text`. Adjacent words are joined without the whitespace between them, and words in the same charset are decoded together so a multibyte character split across words survives. */
+export declare function decodeWords(text: string): string;
+/** Parses an address list (RFC 5322 mailboxes, groups, quoted names, comments, encoded words). */
+export declare function parseAddresses(text: string | undefined): ParsedAddress[];
+/** Parses a raw RFC 5322 message. Never throws; unreadable input yields as much as could be read. */
+export declare function parseMime(raw: Buffer): ParsedMessage;
+//# sourceMappingURL=mime.d.ts.map

package/dist/infra/email/mime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime.d.ts","sourceRoot":"","sources":["../../../src/infra/email/mime.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,+FAA+F;IAC/F,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC,uDAAuD;IACvD,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;IACtC,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAAA;IACnC,QAAQ,CAAC,EAAE,EAAE,SAAS,aAAa,EAAE,CAAA;IACrC,QAAQ,CAAC,EAAE,EAAE,SAAS,aAAa,EAAE,CAAA;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAA;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,QAAQ,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAA;CAClD;AAyED,wNAAwN;AACxN,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA2BhD;AA6ED,kGAAkG;AAClG,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,EAAE,CAsCxE;AAiJD,qGAAqG;AACrG,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CA4BpD"}

package/dist/infra/email/mime.js

@@ -0,0 +1,474 @@
+// A hand-written MIME parser for received mail. Pure: bytes in, a plain object out.
+// It never throws; malformed input degrades to the best reading. Internal to the
+// inbound pipeline (not public API); exported for its tests.
+//
+// The message is held as a latin1 string (one char per byte) while it is split, so
+// offsets are byte offsets and slices convert back losslessly; charsets are decoded
+// only on the final text of a header or body.
+const MAX_DEPTH = 20;
+function header(entity, name) {
+    return entity.headers.find(h => h.name === name)?.value;
+}
+function splitEntity(raw) {
+    let at = -1;
+    let bodyAt = 0;
+    if (raw.startsWith('\r\n')) {
+        at = 0;
+        bodyAt = 2;
+    }
+    else if (raw.startsWith('\n')) {
+        at = 0;
+        bodyAt = 1;
+    }
+    else {
+        const m = /\r?\n\r?\n/.exec(raw);
+        if (m !== null) {
+            at = m.index;
+            bodyAt = m.index + m[0].length;
+        }
+    }
+    const head = at < 0 ? raw : raw.slice(0, at);
+    const body = at < 0 ? '' : raw.slice(bodyAt);
+    const headers = [];
+    let current = null;
+    for (const line of head.split(/\r?\n/)) {
+        if (/^[ \t]/.test(line)) {
+            if (current !== null)
+                current.value += ` ${line.trim()}`;
+            continue;
+        }
+        const colon = line.indexOf(':');
+        if (colon <= 0 || /[\s\x00-\x1f]/.test(line.slice(0, colon))) {
+            current = null;
+            continue;
+        }
+        current = { name: line.slice(0, colon).toLowerCase(), value: line.slice(colon + 1).trim() };
+        headers.push(current);
+    }
+    // A header with 8-bit bytes is UTF-8 when it is valid UTF-8, otherwise latin1 as read.
+    return { headers: headers.map(h => ({ name: h.name, value: decodeRawHeader(h.value) })), body };
+}
+function decodeRawHeader(value) {
+    if (!/[^\x00-\x7f]/.test(value))
+        return value;
+    try {
+        return new TextDecoder('utf-8', { fatal: true }).decode(Buffer.from(value, 'latin1'));
+    }
+    catch {
+        return value;
+    }
+}
+function decodeCharset(bytes, charset) {
+    const label = (charset ?? 'utf-8').trim().replace(/^"|"$/g, '').toLowerCase();
+    try {
+        return new TextDecoder(label === '' ? 'utf-8' : label).decode(bytes);
+    }
+    catch {
+        return new TextDecoder('utf-8').decode(bytes);
+    }
+}
+// ---- RFC 2047 encoded words ----
+function decodeQ(text) {
+    const bytes = [];
+    for (let i = 0; i < text.length; i++) {
+        const c = text[i];
+        if (c === '_')
+            bytes.push(0x20);
+        else if (c === '=' && /^[0-9a-fA-F]{2}$/.test(text.slice(i + 1, i + 3))) {
+            bytes.push(parseInt(text.slice(i + 1, i + 3), 16));
+            i += 2;
+        }
+        else
+            bytes.push(c.charCodeAt(0) & 0xff);
+    }
+    return Buffer.from(bytes);
+}
+const ENCODED_WORD = /=\?([^?\s]+)\?([bBqQ])\?([^?\s]*)\?=/g;
+/** Decodes RFC 2047 encoded words in `text`. Adjacent words are joined without the whitespace between them, and words in the same charset are decoded together so a multibyte character split across words survives. */
+export function decodeWords(text) {
+    if (!text.includes('=?'))
+        return text;
+    const out = [];
+    let run = null;
+    const flush = () => {
+        if (run !== null)
+            out.push(decodeCharset(Buffer.concat(run.bytes), run.charset));
+        run = null;
+    };
+    let last = 0;
+    for (const m of text.matchAll(ENCODED_WORD)) {
+        const between = text.slice(last, m.index);
+        if (run !== null && between.trim() === '') {
+            // whitespace between adjacent encoded words is dropped
+        }
+        else {
+            flush();
+            out.push(between);
+        }
+        const charset = m[1].split('*')[0].toLowerCase();
+        const bytes = m[2].toLowerCase() === 'b' ? Buffer.from(m[3], 'base64') : decodeQ(m[3]);
+        if (run !== null && run.charset !== charset)
+            flush();
+        if (run === null)
+            run = { charset, bytes: [] };
+        run.bytes.push(bytes);
+        last = m.index + m[0].length;
+    }
+    flush();
+    out.push(text.slice(last));
+    return out.join('');
+}
+// ---- structured header values ----
+function unquote(text) {
+    const t = text.trim();
+    if (t.length >= 2 && t.startsWith('"') && t.endsWith('"'))
+        return t.slice(1, -1).replace(/\\(.)/g, '$1');
+    return t;
+}
+function splitTop(text, separator) {
+    const parts = [];
+    let cur = '';
+    let quoted = false;
+    for (let i = 0; i < text.length; i++) {
+        const c = text[i];
+        if (quoted) {
+            cur += c;
+            if (c === '\\' && i + 1 < text.length)
+                cur += text[++i];
+            else if (c === '"')
+                quoted = false;
+            continue;
+        }
+        if (c === '"') {
+            quoted = true;
+            cur += c;
+            continue;
+        }
+        if (c === separator) {
+            parts.push(cur);
+            cur = '';
+            continue;
+        }
+        cur += c;
+    }
+    parts.push(cur);
+    return parts;
+}
+function percentBytes(text) {
+    const bytes = [];
+    for (let i = 0; i < text.length; i++) {
+        if (text[i] === '%' && /^[0-9a-fA-F]{2}$/.test(text.slice(i + 1, i + 3))) {
+            bytes.push(parseInt(text.slice(i + 1, i + 3), 16));
+            i += 2;
+        }
+        else
+            bytes.push(text.charCodeAt(i) & 0xff);
+    }
+    return Buffer.from(bytes);
+}
+/** Parses `value; name=param; name*=utf-8''enc; name*0*=...` and resolves RFC 2231 extended and continued parameters. */
+function parseStructured(text) {
+    if (text === undefined)
+        return { value: '', params: new Map() };
+    const [first, ...rest] = splitTop(text, ';');
+    const plain = new Map();
+    const groups = new Map();
+    for (const part of rest) {
+        const eq = part.indexOf('=');
+        if (eq <= 0)
+            continue;
+        const key = part.slice(0, eq).trim().toLowerCase();
+        const value = unquote(part.slice(eq + 1));
+        const m = /^([^*]+)(?:\*(\d+))?(\*)?$/.exec(key);
+        if (m === null || (m[2] === undefined && m[3] === undefined)) {
+            plain.set(key, value);
+            continue;
+        }
+        const list = groups.get(m[1]) ?? [];
+        list.push({ n: m[2] === undefined ? 0 : Number(m[2]), ext: m[3] !== undefined, value });
+        groups.set(m[1], list);
+    }
+    const params = new Map(plain);
+    for (const [name, list] of groups) {
+        list.sort((a, b) => a.n - b.n);
+        let charset;
+        const chunks = [];
+        list.forEach((seg, i) => {
+            let v = seg.value;
+            if (i === 0 && seg.ext) {
+                const m = /^([^']*)'[^']*'(.*)$/s.exec(v);
+                if (m !== null) {
+                    charset = m[1] === '' ? undefined : m[1];
+                    v = m[2];
+                }
+            }
+            chunks.push(seg.ext ? percentBytes(v) : Buffer.from(v, 'latin1'));
+        });
+        params.set(name, decodeCharset(Buffer.concat(chunks), charset));
+    }
+    return { value: (first ?? '').trim(), params };
+}
+// ---- addresses ----
+/** Parses an address list (RFC 5322 mailboxes, groups, quoted names, comments, encoded words). */
+export function parseAddresses(text) {
+    if (text === undefined || text.trim() === '')
+        return [];
+    const mailboxes = [];
+    let cur = '';
+    let quoted = false;
+    let angle = false;
+    let comment = 0;
+    for (let i = 0; i < text.length; i++) {
+        const c = text[i];
+        if (quoted) {
+            cur += c;
+            if (c === '\\' && i + 1 < text.length)
+                cur += text[++i];
+            else if (c === '"')
+                quoted = false;
+            continue;
+        }
+        if (comment > 0) {
+            cur += c;
+            if (c === '\\' && i + 1 < text.length)
+                cur += text[++i];
+            else if (c === '(')
+                comment++;
+            else if (c === ')')
+                comment--;
+            continue;
+        }
+        if (c === '"') {
+            quoted = true;
+            cur += c;
+            continue;
+        }
+        if (c === '(') {
+            comment = 1;
+            cur += c;
+            continue;
+        }
+        if (c === '<')
+            angle = true;
+        else if (c === '>')
+            angle = false;
+        if (!angle && c === ':') {
+            cur = '';
+            continue;
+        } // group name
+        if (!angle && (c === ',' || c === ';')) {
+            mailboxes.push(cur);
+            cur = '';
+            continue;
+        }
+        cur += c;
+    }
+    mailboxes.push(cur);
+    const result = [];
+    for (const box of mailboxes) {
+        const parsed = parseMailbox(box);
+        if (parsed !== null)
+            result.push(parsed);
+    }
+    return result;
+}
+function stripComments(text) {
+    const comments = [];
+    let out = '';
+    let depth = 0;
+    let quoted = false;
+    let current = '';
+    for (let i = 0; i < text.length; i++) {
+        const c = text[i];
+        if (quoted) {
+            out += c;
+            if (c === '\\' && i + 1 < text.length)
+                out += text[++i];
+            else if (c === '"')
+                quoted = false;
+            continue;
+        }
+        if (depth > 0) {
+            if (c === '\\' && i + 1 < text.length) {
+                current += text[++i];
+                continue;
+            }
+            if (c === '(')
+                depth++;
+            else if (c === ')') {
+                depth--;
+                if (depth === 0) {
+                    comments.push(current);
+                    current = '';
+                    continue;
+                }
+            }
+            current += c;
+            continue;
+        }
+        if (c === '"') {
+            quoted = true;
+            out += c;
+            continue;
+        }
+        if (c === '(') {
+            depth = 1;
+            continue;
+        }
+        out += c;
+    }
+    return { text: out, comments };
+}
+function parseMailbox(box) {
+    const { text, comments } = stripComments(box);
+    const t = text.trim();
+    if (t === '')
+        return null;
+    const lt = t.lastIndexOf('<');
+    const gt = t.lastIndexOf('>');
+    if (lt >= 0 && gt > lt) {
+        const address = t.slice(lt + 1, gt).trim().replace(/^.*:/, '');
+        const name = decodeWords(unquote(t.slice(0, lt)));
+        return address === '' ? null : { address, name };
+    }
+    const address = unquote(t);
+    if (!address.includes('@'))
+        return null;
+    return { address, name: comments.length > 0 ? decodeWords(comments[0].trim()) : '' };
+}
+function idsOf(text) {
+    if (text === undefined)
+        return [];
+    return [...text.matchAll(/<([^<>\s]+)>/g)].map(m => m[1]);
+}
+// ---- bodies ----
+function decodeTransfer(body, encoding) {
+    const e = (encoding ?? '7bit').trim().toLowerCase();
+    if (e === 'base64')
+        return Buffer.from(body.replace(/[^A-Za-z0-9+/=_-]/g, ''), 'base64');
+    if (e === 'quoted-printable') {
+        const joined = body.replace(/[ \t]+(?=\r?\n)/g, '').replace(/=\r?\n/g, '');
+        const bytes = [];
+        for (let i = 0; i < joined.length; i++) {
+            const c = joined[i];
+            if (c === '=' && /^[0-9a-fA-F]{2}$/.test(joined.slice(i + 1, i + 3))) {
+                bytes.push(parseInt(joined.slice(i + 1, i + 3), 16));
+                i += 2;
+            }
+            else
+                bytes.push(joined.charCodeAt(i) & 0xff);
+        }
+        return Buffer.from(bytes);
+    }
+    return Buffer.from(body, 'latin1');
+}
+function splitMultipart(body, boundary) {
+    const delim = `--${boundary}`;
+    const parts = [];
+    let start = -1;
+    let pos = 0;
+    for (;;) {
+        const idx = body.indexOf(delim, pos);
+        if (idx < 0)
+            break;
+        pos = idx + 1;
+        if (idx > 0 && body[idx - 1] !== '\n')
+            continue;
+        const after = idx + delim.length;
+        const eol = body.indexOf('\n', after);
+        const rest = body.slice(after, eol < 0 ? body.length : eol);
+        const closing = rest.startsWith('--');
+        if (!closing && !/^[ \t]*\r?$/.test(rest))
+            continue;
+        if (start >= 0) {
+            let end = idx;
+            if (body[end - 1] === '\n')
+                end--;
+            if (body[end - 1] === '\r')
+                end--;
+            parts.push(body.slice(start, Math.max(start, end)));
+            start = -1;
+        }
+        if (closing || eol < 0)
+            return parts;
+        start = eol + 1;
+        pos = start;
+    }
+    if (start >= 0)
+        parts.push(body.slice(start)); // no closing boundary
+    return parts;
+}
+function walk(entity, depth, out) {
+    const type = parseStructured(header(entity, 'content-type'));
+    const mediaType = (type.value === '' ? 'text/plain' : type.value).toLowerCase();
+    const disposition = parseStructured(header(entity, 'content-disposition'));
+    const disp = disposition.value.toLowerCase();
+    const contentId = idsOf(header(entity, 'content-id'))[0] ?? null;
+    if (mediaType.startsWith('multipart/') && depth < MAX_DEPTH) {
+        const boundary = type.params.get('boundary');
+        if (boundary !== undefined && boundary !== '') {
+            for (const part of splitMultipart(entity.body, boundary))
+                walk(splitEntity(part), depth + 1, out);
+            return;
+        }
+    }
+    const rawName = disposition.params.get('filename') ?? type.params.get('name');
+    const filename = rawName === undefined ? null : decodeWords(rawName);
+    const isText = mediaType === 'text/plain' || mediaType === 'text/html';
+    const attached = disp === 'attachment' || filename !== null || !isText || mediaType.startsWith('multipart/');
+    const content = decodeTransfer(entity.body, header(entity, 'content-transfer-encoding'));
+    if (!attached) {
+        const decoded = decodeCharset(content, type.params.get('charset'));
+        if (mediaType === 'text/html') {
+            if (out.html === null)
+                out.html = decoded;
+        }
+        else if (out.text === null)
+            out.text = decoded;
+        return;
+    }
+    out.attachments.push({
+        filename,
+        mediaType: mediaType.startsWith('multipart/') ? 'application/octet-stream' : mediaType,
+        size: content.length,
+        contentId,
+        inline: disp === 'inline' || (disp === '' && contentId !== null),
+        content,
+    });
+}
+const EMPTY = {
+    messageId: null, inReplyTo: null, threadIds: [], references: [], from: null, to: [], cc: [], replyTo: [],
+    subject: '', date: null, text: null, html: null, attachments: [],
+};
+/** Parses a raw RFC 5322 message. Never throws; unreadable input yields as much as could be read. */
+export function parseMime(raw) {
+    try {
+        const entity = splitEntity(raw.toString('latin1'));
+        const out = { text: null, html: null, attachments: [] };
+        walk(entity, 0, out);
+        const inReplyToIds = idsOf(header(entity, 'in-reply-to'));
+        const references = idsOf(header(entity, 'references'));
+        const threadIds = [...new Set([...inReplyToIds, ...references])];
+        const date = header(entity, 'date');
+        const parsedDate = date === undefined ? null : new Date(date);
+        return {
+            messageId: idsOf(header(entity, 'message-id'))[0] ?? null,
+            inReplyTo: inReplyToIds[0] ?? null,
+            threadIds,
+            references,
+            from: parseAddresses(header(entity, 'from'))[0] ?? null,
+            to: parseAddresses(header(entity, 'to')),
+            cc: parseAddresses(header(entity, 'cc')),
+            replyTo: parseAddresses(header(entity, 'reply-to')),
+            subject: decodeWords(header(entity, 'subject') ?? ''),
+            date: parsedDate === null || Number.isNaN(parsedDate.getTime()) ? null : parsedDate,
+            text: out.text,
+            html: out.html,
+            attachments: out.attachments,
+        };
+    }
+    catch {
+        return EMPTY;
+    }
+}
+//# sourceMappingURL=mime.js.map