@blamejs/core 0.9.17 → 0.9.19

package/lib/safe-mime.js

@@ -0,0 +1,714 @@
+"use strict";
+/**
+ * @module     b.safeMime
+ * @nav        Parsers
+ * @title      Safe MIME
+ * @order      120
+ *
+ * @intro
+ *   Bounded MIME parser substrate for the mail stack. Walks RFC 5322 +
+ *   2045 / 2046 / 2047 / 6532 (EAI) / 6533 (i18n-DSN) message structure
+ *   into a part tree with caps on every dimension an attacker can grow
+ *   to DoS the framework.
+ *
+ *   Foundation for everything above:
+ *
+ *     - `b.mailStore.appendMessage` parses inbound bytes via
+ *       `b.safeMime.parse(...)` to extract headers + body parts before
+ *       sealing per-column.
+ *     - `b.mail.server.mx` runs every received message through
+ *       `b.safeMime.parse` before SPF / DKIM / DMARC / ARC verification.
+ *     - `b.guardEmail.validateMessage` already operates on raw bytes
+ *       at the line-shape level; `b.safeMime.parse` is the structured
+ *       follow-up that lets `b.guardHtml` / `b.guardArchive` /
+ *       `b.guardSvg` inspect individual MIME parts.
+ *     - `b.mail.crypto.{pgp,smime}` (v0.9.34a) parses signed/encrypted
+ *       containers via this primitive before reaching the underlying
+ *       crypto.
+ *
+ *   Defends `CVE-2024-39929` (Exim MIME multipart parser) and
+ *   `CVE-2025-30258` (gnumail truncated-MIME-tree class) by capping
+ *   total parts, nesting depth, boundary length, header bytes,
+ *   header-line bytes, decoded body bytes, message bytes — plus
+ *   charset + transfer-encoding allowlists.
+ *
+ *   Throws `SafeMimeError` on every cap exceeded, malformed boundary,
+ *   unknown charset, unknown transfer-encoding, NUL byte in headers,
+ *   bidi/control chars in header values.
+ *
+ *   The parser is purely functional — no I/O, no async, no side
+ *   effects. Operators run it in `b.workerPool` workers for any
+ *   incoming message above a threshold.
+ *
+ * @card
+ *   Bounded MIME parser — walks RFC 5322 + 2045 / 2046 / 2047 + EAI message structure into a part tree with hard caps on depth, part count, body size, header bytes, and charset / transfer-encoding allowlists. Defends CVE-2024-39929 + CVE-2025-30258.
+ */
+
+var C = require("./constants");
+var { defineClass } = require("./framework-error");
+
+var SafeMimeError = defineClass("SafeMimeError", { alwaysPermanent: true });
+
+var DEFAULT_MAX_PARTS         = 64;                          // allow:raw-byte-literal — total parts cap, not bytes
+var DEFAULT_MAX_NESTING_DEPTH = 16;
+var DEFAULT_MAX_BOUNDARY      = 70;                          // RFC 2046 §5.1.1
+var DEFAULT_MAX_HEADER_BYTES  = C.BYTES.kib(64);
+var DEFAULT_MAX_HEADER_LINE   = 998;                         // allow:raw-byte-literal — RFC 5322 §2.1.1 line cap
+var DEFAULT_MAX_BODY_BYTES    = C.BYTES.mib(25);
+var DEFAULT_MAX_MESSAGE_BYTES = C.BYTES.mib(50);
+
+var DEFAULT_CHARSETS = Object.freeze([
+  "utf-8", "us-ascii", "ascii",
+  "iso-8859-1", "latin1", "windows-1252", "cp1252",
+  "iso-8859-2", "iso-8859-15",
+  "utf-16", "utf-16le", "utf-16be",
+  "gb2312", "gbk", "big5",
+  "shift_jis", "shift-jis", "iso-2022-jp",
+  "euc-kr", "euc-jp",
+]);
+
+var DEFAULT_TRANSFER_ENCODINGS = Object.freeze([
+  "7bit", "8bit", "binary", "quoted-printable", "base64",
+]);
+
+/**
+ * @primitive b.safeMime.parse
+ * @signature b.safeMime.parse(bytes, opts?)
+ * @since     0.9.19
+ * @status    stable
+ * @related   b.safeMime.walk, b.safeMime.extractText, b.guardEmail.validateMessage
+ *
+ * Parse `bytes` into a MIME part tree. Returns
+ * `{ headers, parts, leaf, decoded }`. Multipart parts have non-null
+ * `parts`; leaf parts have non-null `leaf` carrying decoded body.
+ *
+ * Throws `SafeMimeError` with codes:
+ *   `safe-mime/oversize-message` / `oversize-part-count` /
+ *   `oversize-nesting` / `oversize-boundary` / `oversize-headers` /
+ *   `oversize-header-line` / `oversize-body` / `unknown-charset` /
+ *   `unknown-transfer-encoding` / `malformed-boundary` /
+ *   `malformed-headers` / `control-char-in-header` / `bad-input`.
+ *
+ * @opts
+ *   maxParts:                 number,     // default 64
+ *   maxNestingDepth:          number,     // default 16
+ *   maxBoundary:              number,     // default 70 (RFC 2046 §5.1.1)
+ *   maxHeaderBytes:           number,     // default 64 KiB
+ *   maxHeaderLineBytes:       number,     // default 998 (RFC 5322 §2.1.1)
+ *   maxBodyBytes:             number,     // default 25 MiB
+ *   maxMessageBytes:          number,     // default 50 MiB
+ *   charsetAllowlist:         string[],   // default UTF-8 / US-ASCII / common legacy 8-bit
+ *   transferEncodingAllowlist: string[],  // default 7bit/8bit/binary/qp/base64
+ *
+ * @example
+ *   var msg = b.safeMime.parse(messageBuffer);
+ *   msg.headers.get("subject");
+ *   msg.parts.length;
+ *   msg.parts[0].leaf.body.toString("utf8");
+ */
+function parse(bytes, opts) {
+  opts = opts || {};
+  var maxParts        = _intOpt(opts, "maxParts",        DEFAULT_MAX_PARTS);
+  var maxNestingDepth = _intOpt(opts, "maxNestingDepth", DEFAULT_MAX_NESTING_DEPTH);
+  var maxBoundary     = _intOpt(opts, "maxBoundary",     DEFAULT_MAX_BOUNDARY);
+  var maxHeaderBytes  = _intOpt(opts, "maxHeaderBytes",  DEFAULT_MAX_HEADER_BYTES);
+  var maxHeaderLine   = _intOpt(opts, "maxHeaderLineBytes", DEFAULT_MAX_HEADER_LINE);
+  var maxBodyBytes    = _intOpt(opts, "maxBodyBytes",    DEFAULT_MAX_BODY_BYTES);
+  var maxMessageBytes = _intOpt(opts, "maxMessageBytes", DEFAULT_MAX_MESSAGE_BYTES);
+  var charsets        = _normalizeStringSet(opts.charsetAllowlist || DEFAULT_CHARSETS);
+  var encodings       = _normalizeStringSet(opts.transferEncodingAllowlist || DEFAULT_TRANSFER_ENCODINGS);
+
+  var buf = _toBuffer(bytes);
+  if (buf.length > maxMessageBytes) {
+    throw new SafeMimeError("safe-mime/oversize-message",
+      "safeMime.parse: message size " + buf.length + " exceeds maxMessageBytes " + maxMessageBytes);
+  }
+
+  var ctx = {
+    maxParts:        maxParts,
+    maxNestingDepth: maxNestingDepth,
+    maxBoundary:     maxBoundary,
+    maxHeaderBytes:  maxHeaderBytes,
+    maxHeaderLine:   maxHeaderLine,
+    maxBodyBytes:    maxBodyBytes,
+    charsets:        charsets,
+    encodings:       encodings,
+    partCount:       0,
+  };
+
+  return _parsePart(buf, ctx, 0);
+}
+
+/**
+ * @primitive b.safeMime.walk
+ * @signature b.safeMime.walk(tree, visitor)
+ * @since     0.9.19
+ * @status    stable
+ * @related   b.safeMime.parse, b.safeMime.findFirst
+ *
+ * Depth-first walk. Invokes `visitor(part, path)` for every part where
+ * `path` is the position array (`[]` for root, `[0]` for first child).
+ * Visitor returning `false` short-circuits.
+ *
+ * @example
+ *   b.safeMime.walk(tree, function (part) {
+ *     if (part.leaf && part.leaf.contentType === "application/pdf") {
+ *       console.log("pdf", part.leaf.body.length);
+ *     }
+ *   });
+ */
+function walk(tree, visitor) {
+  if (!tree) return;
+  if (typeof visitor !== "function") {
+    throw new TypeError("safeMime.walk: visitor must be a function");
+  }
+  return _walkRec(tree, visitor, []);
+}
+
+function _walkRec(part, visitor, path) {
+  var result = visitor(part, path.slice());
+  if (result === false) return false;
+  if (part.parts) {
+    for (var i = 0; i < part.parts.length; i += 1) {
+      var sub = _walkRec(part.parts[i], visitor, path.concat([i]));
+      if (sub === false) return false;
+    }
+  }
+  return true;
+}
+
+/**
+ * @primitive b.safeMime.findFirst
+ * @signature b.safeMime.findFirst(tree, predicate)
+ * @since     0.9.19
+ * @status    stable
+ * @related   b.safeMime.walk
+ *
+ * Return the first part for which `predicate(part)` is truthy, or
+ * `null`. Common use: pull the first `text/plain` or `text/html`.
+ *
+ * @example
+ *   var t = b.safeMime.findFirst(tree, function (p) {
+ *     return p.leaf && p.leaf.contentType === "text/plain";
+ *   });
+ */
+function findFirst(tree, predicate) {
+  if (typeof predicate !== "function") {
+    throw new TypeError("safeMime.findFirst: predicate must be a function");
+  }
+  var found = null;
+  walk(tree, function (part) {
+    if (predicate(part)) { found = part; return false; }
+  });
+  return found;
+}
+
+/**
+ * @primitive b.safeMime.extractText
+ * @signature b.safeMime.extractText(tree, opts?)
+ * @since     0.9.19
+ * @status    stable
+ * @related   b.safeMime.parse, b.safeMime.findFirst
+ *
+ * Pull the rendering-preferred text payload. Honors RFC 2046 §5.1.4
+ * "last wins" semantics for `multipart/alternative`. Returns
+ * `{ contentType, charset, body }` (body is decoded string) or `null`.
+ *
+ * @opts
+ *   prefer:  "plain" | "html" | "any",   // default "plain"
+ *
+ * @example
+ *   var tree = b.safeMime.parse(messageBuffer);
+ *   var text = b.safeMime.extractText(tree, { prefer: "plain" });
+ *   text.body;          // → "Hello, world!"
+ *   text.contentType;   // → "text/plain"
+ */
+function extractText(tree, opts) {
+  opts = opts || {};
+  var prefer = opts.prefer || "plain";
+
+  if (tree && /^multipart\/alternative/i.test(_ct(tree))) {
+    var parts = tree.parts || [];
+    for (var i = parts.length - 1; i >= 0; i -= 1) {
+      var p = parts[i];
+      if (!p.leaf) continue;
+      var ct = p.leaf.contentType;
+      if (prefer === "plain" && ct === "text/plain") return _materializeText(p);
+      if (prefer === "html"  && ct === "text/html")  return _materializeText(p);
+      if (prefer === "any"   && /^text\//.test(ct))  return _materializeText(p);
+    }
+    for (var j = 0; j < parts.length; j += 1) {
+      var q = parts[j];
+      if (q.leaf && /^text\//.test(q.leaf.contentType)) return _materializeText(q);
+    }
+    return null;
+  }
+
+  var preferred = findFirst(tree, function (p) {
+    return p.leaf && p.leaf.contentType === (prefer === "html" ? "text/html" : "text/plain");
+  });
+  if (preferred) return _materializeText(preferred);
+  var anyText = findFirst(tree, function (p) {
+    return p.leaf && /^text\//.test(p.leaf.contentType);
+  });
+  return anyText ? _materializeText(anyText) : null;
+}
+
+/**
+ * @primitive b.safeMime.extractAttachments
+ * @signature b.safeMime.extractAttachments(tree, opts?)
+ * @since     0.9.19
+ * @status    stable
+ * @related   b.safeMime.parse, b.guardArchive, b.fileType
+ *
+ * Return array of attachment-shaped parts. Each entry is
+ * `{ filename, contentType, body, headers }`. Operators pipe each
+ * attachment through `b.fileType.detect` then through the per-type
+ * guard (`b.guardArchive` / `b.guardPdf` / etc.).
+ *
+ * @opts
+ *   includeInline: boolean,    // default false — Content-Disposition: inline skipped
+ *
+ * @example
+ *   var tree = b.safeMime.parse(messageBuffer);
+ *   var atts = b.safeMime.extractAttachments(tree);
+ *   atts[0].filename;       // → "report.pdf"
+ *   atts[0].contentType;    // → "application/pdf"
+ *   atts[0].body.length;    // → 12345 (decoded bytes)
+ */
+function extractAttachments(tree, opts) {
+  opts = opts || {};
+  var includeInline = opts.includeInline === true;
+  var out = [];
+  walk(tree, function (part) {
+    if (!part.leaf) return;
+    var cd = (part.headers.get("content-disposition") || "").toLowerCase();
+    var isAttachment = cd.indexOf("attachment") === 0;
+    var isInline     = cd.indexOf("inline") === 0;
+    if (!isAttachment && !includeInline) return;
+    if (!isAttachment && isInline && !includeInline) return;
+    out.push({
+      filename:    _filenameFromHeaders(part.headers),
+      contentType: part.leaf.contentType,
+      body:        part.leaf.body,
+      headers:     part.headers,
+    });
+  });
+  return out;
+}
+
+// ---- Internal --------------------------------------------------------------
+
+function _parsePart(buf, ctx, depth) {
+  if (depth > ctx.maxNestingDepth) {
+    throw new SafeMimeError("safe-mime/oversize-nesting",
+      "safeMime.parse: nesting depth exceeded maxNestingDepth=" + ctx.maxNestingDepth +
+      " (CVE-2024-39929-class defense)");
+  }
+  ctx.partCount += 1;
+  if (ctx.partCount > ctx.maxParts) {
+    throw new SafeMimeError("safe-mime/oversize-part-count",
+      "safeMime.parse: total parts exceeded maxParts=" + ctx.maxParts +
+      " (CVE-2024-39929-class defense)");
+  }
+
+  var sep = _findHeaderBodySep(buf);
+  if (sep < 0) sep = buf.length;
+  if (sep > ctx.maxHeaderBytes) {
+    throw new SafeMimeError("safe-mime/oversize-headers",
+      "safeMime.parse: header section " + sep + " bytes exceeds maxHeaderBytes=" + ctx.maxHeaderBytes);
+  }
+  var headerBytes = buf.subarray(0, sep);
+  // Skip the blank-line separator. `_findHeaderBodySep` returns the
+  // position of the FIRST CR (or LF) of the blank-line pair; the body
+  // starts AFTER both CRLFs (or both LFs).
+  var bodyStart = sep;
+  if (buf[bodyStart] === 0x0D && buf[bodyStart + 1] === 0x0A) bodyStart += 2;
+  else if (buf[bodyStart] === 0x0A) bodyStart += 1;
+  if (buf[bodyStart] === 0x0D && buf[bodyStart + 1] === 0x0A) bodyStart += 2;
+  else if (buf[bodyStart] === 0x0A) bodyStart += 1;
+  var bodyBytes = buf.subarray(bodyStart);
+
+  var headers = _parseHeaders(headerBytes, ctx);
+  var contentTypeHeader = headers.get("content-type") || "text/plain";
+  var ctInfo = _parseContentType(contentTypeHeader);
+  var contentType = ctInfo.type;
+  var params      = ctInfo.params;
+
+  if (contentType.indexOf("multipart/") === 0) {
+    var boundary = params.boundary;
+    if (typeof boundary !== "string" || boundary.length === 0) {
+      throw new SafeMimeError("safe-mime/malformed-boundary",
+        "safeMime.parse: multipart content-type lacks boundary param");
+    }
+    if (boundary.length > ctx.maxBoundary) {
+      throw new SafeMimeError("safe-mime/oversize-boundary",
+        "safeMime.parse: boundary length " + boundary.length + " exceeds maxBoundary=" + ctx.maxBoundary +
+        " (RFC 2046 §5.1.1)");
+    }
+    var partBuffers = _splitMultipart(bodyBytes, boundary);
+    var parts = [];
+    for (var i = 0; i < partBuffers.length; i += 1) {
+      parts.push(_parsePart(partBuffers[i], ctx, depth + 1));
+    }
+    return {
+      headers:    headers,
+      parts:      parts,
+      leaf:       null,
+      decoded:    null,
+      _contentType: contentType,
+    };
+  }
+
+  if (bodyBytes.length > ctx.maxBodyBytes) {
+    throw new SafeMimeError("safe-mime/oversize-body",
+      "safeMime.parse: body " + bodyBytes.length + " bytes exceeds maxBodyBytes=" + ctx.maxBodyBytes);
+  }
+  var encoding = String(headers.get("content-transfer-encoding") || "7bit").toLowerCase().trim();
+  if (!ctx.encodings[encoding]) {
+    throw new SafeMimeError("safe-mime/unknown-transfer-encoding",
+      "safeMime.parse: content-transfer-encoding '" + encoding + "' not in allowlist; refused");
+  }
+  var charset = String(params.charset || "us-ascii").toLowerCase();
+  if (!ctx.charsets[_normalizeCharsetName(charset)]) {
+    throw new SafeMimeError("safe-mime/unknown-charset",
+      "safeMime.parse: charset '" + charset + "' not in allowlist; refused");
+  }
+  var decodedBody = _decodeBody(bodyBytes, encoding);
+  if (decodedBody.length > ctx.maxBodyBytes) {
+    throw new SafeMimeError("safe-mime/oversize-body",
+      "safeMime.parse: decoded body " + decodedBody.length +
+      " bytes exceeds maxBodyBytes=" + ctx.maxBodyBytes);
+  }
+  return {
+    headers: headers,
+    parts:   null,
+    leaf:    {
+      contentType: contentType,
+      charset:     charset,
+      encoding:    encoding,
+      body:        decodedBody,
+    },
+    decoded:      _materializeTextValue(decodedBody, charset),
+    _contentType: contentType,
+  };
+}
+
+function _findHeaderBodySep(buf) {
+  for (var i = 0; i < buf.length - 1; i += 1) {
+    if (buf[i] === 0x0D && buf[i + 1] === 0x0A &&
+        buf[i + 2] === 0x0D && buf[i + 3] === 0x0A) {
+      return i;
+    }
+    if (buf[i] === 0x0A && buf[i + 1] === 0x0A) {
+      return i;
+    }
+  }
+  return -1;
+}
+
+function _parseHeaders(buf, ctx) {
+  var lines = _splitHeaderLines(buf, ctx);
+  var headerMap = Object.create(null);
+  for (var i = 0; i < lines.length; i += 1) {
+    var line = lines[i];
+    var colon = line.indexOf(":");
+    if (colon < 0) {
+      throw new SafeMimeError("safe-mime/malformed-headers",
+        "safeMime.parse: header line missing colon: " + _previewBytes(line));
+    }
+    var name  = line.slice(0, colon).toLowerCase().trim();
+    var value = line.slice(colon + 1).trim();
+    // Refuse NUL, CR, LF, and other C0 control chars in header values.
+    // Tab (0x09) is allowed (header folding). C1 control range
+    // (0x80-0x9F) NOT refused — legitimate non-ASCII via EAI/RFC 2047
+    // decoded-words can produce bytes in that range.
+    for (var hci = 0; hci < value.length; hci += 1) {
+      var hcc = value.charCodeAt(hci);
+      if ((hcc < 0x20 && hcc !== 0x09) || hcc === 0x7F) {                                          // allow:raw-byte-literal — C0 control char + DEL refusal
+        throw new SafeMimeError("safe-mime/control-char-in-header",
+          "safeMime.parse: header '" + name + "' contains control char 0x" + hcc.toString(16));
+      }
+    }
+    value = _decodeRfc2047Words(value);
+    if (name === "__proto__" || name === "constructor" || name === "prototype") continue;
+    if (!headerMap[name]) headerMap[name] = [];
+    headerMap[name].push(value);
+  }
+  return {
+    get:    function (n) {
+      var arr = headerMap[String(n).toLowerCase()];
+      return arr && arr.length > 0 ? arr[0] : null;
+    },
+    getAll: function (n) { return (headerMap[String(n).toLowerCase()] || []).slice(); },
+    names:  function () { return Object.keys(headerMap); },
+    raw:    headerMap,
+  };
+}
+
+function _splitHeaderLines(buf, ctx) {
+  var s = buf.toString("utf8");
+  var rawLines = s.split(/\r?\n/);
+  var unfolded = [];
+  for (var i = 0; i < rawLines.length; i += 1) {
+    var line = rawLines[i];
+    if (line.length === 0) continue;
+    if (line.length > ctx.maxHeaderLine) {
+      throw new SafeMimeError("safe-mime/oversize-header-line",
+        "safeMime.parse: header line " + line.length +
+        " bytes exceeds maxHeaderLineBytes=" + ctx.maxHeaderLine +
+        " (RFC 5322 §2.1.1)");
+    }
+    if ((line.charCodeAt(0) === 0x20 || line.charCodeAt(0) === 0x09) &&
+        unfolded.length > 0) {
+      unfolded[unfolded.length - 1] += " " + line.replace(/^[\s]+/, "");
+    } else {
+      unfolded.push(line);
+    }
+  }
+  return unfolded;
+}
+
+function _parseContentType(value) {
+  var parts = String(value).split(";");
+  var type  = parts[0].toLowerCase().trim();
+  var params = Object.create(null);
+  for (var i = 1; i < parts.length; i += 1) {
+    var p = parts[i].trim();
+    if (p.length === 0) continue;
+    var eq = p.indexOf("=");
+    if (eq < 0) continue;
+    var k = p.slice(0, eq).toLowerCase().trim();
+    var v = p.slice(eq + 1).trim();
+    if (v.length >= 2 && v.charAt(0) === '"' && v.charAt(v.length - 1) === '"') {
+      v = v.slice(1, -1).replace(/\\(.)/g, "$1");
+    }
+    if (k === "__proto__" || k === "constructor" || k === "prototype") continue;
+    params[k] = v;
+  }
+  return { type: type, params: params };
+}
+
+function _splitMultipart(buf, boundary) {
+  var delimiter = Buffer.from("--" + boundary);
+  var parts = [];
+  var pos = 0;
+  while (pos < buf.length) {
+    // Per RFC 2046 §5.1.1 a boundary delimiter is `--<value>` preceded
+    // by CRLF (or LF) — OR at the very start of the body. A boundary-
+    // shaped sequence elsewhere in a part's body MUST NOT be treated
+    // as a delimiter. Per Codex P1 on PR #49.
+    var idx = _findBoundaryAtLineStart(buf, delimiter, pos);
+    if (idx < 0) break;
+    if (buf[idx + delimiter.length] === 0x2D && buf[idx + delimiter.length + 1] === 0x2D) {
+      // Final delimiter — close out preceding part.
+      if (parts.length > 0) {
+        var prev = parts[parts.length - 1];
+        var prevEnd = idx;
+        if (prevEnd >= 2 && buf[prevEnd - 2] === 0x0D && buf[prevEnd - 1] === 0x0A) prevEnd -= 2;
+        else if (prevEnd >= 1 && buf[prevEnd - 1] === 0x0A) prevEnd -= 1;
+        parts[parts.length - 1] = buf.subarray(prev.start, prevEnd);
+      }
+      break;
+    }
+    var lineEnd = _indexOfLineEnd(buf, idx);
+    if (lineEnd < 0) break;
+    if (parts.length > 0) {
+      var prev2 = parts[parts.length - 1];
+      var prevEnd2 = idx;
+      if (prevEnd2 >= 2 && buf[prevEnd2 - 2] === 0x0D && buf[prevEnd2 - 1] === 0x0A) prevEnd2 -= 2;
+      else if (prevEnd2 >= 1 && buf[prevEnd2 - 1] === 0x0A) prevEnd2 -= 1;
+      parts[parts.length - 1] = buf.subarray(prev2.start, prevEnd2);
+    }
+    parts.push({ start: lineEnd });
+    pos = lineEnd;
+  }
+  return parts.map(function (p) {
+    if (Buffer.isBuffer(p)) return p;
+    return buf.subarray(p.start);
+  });
+}
+
+// Find `--<boundary>` at a position preceded by CRLF, LF, or buf start.
+// Walks via indexOf scans + verifies the line-start invariant; loops
+// past non-line-start hits.
+function _findBoundaryAtLineStart(buf, delimiter, from) {
+  var pos = from;
+  while (pos < buf.length) {
+    var idx = buf.indexOf(delimiter, pos);
+    if (idx < 0) return -1;
+    var atLineStart =
+      idx === 0 ||
+      (idx >= 1 && buf[idx - 1] === 0x0A) ||
+      (idx >= 2 && buf[idx - 2] === 0x0D && buf[idx - 1] === 0x0A);
+    if (atLineStart) return idx;
+    pos = idx + 1;
+  }
+  return -1;
+}
+
+function _indexOfLineEnd(buf, fromIndex) {
+  for (var i = fromIndex; i < buf.length; i += 1) {
+    if (buf[i] === 0x0A) return i + 1;
+    if (buf[i] === 0x0D && buf[i + 1] === 0x0A) return i + 2;
+  }
+  return -1;
+}
+
+function _decodeBody(buf, encoding) {
+  switch (encoding) {
+    case "7bit":
+    case "8bit":
+    case "binary":
+      return buf;
+    case "base64":
+      var compact = buf.toString("ascii").replace(/[\s]+/g, "");
+      return Buffer.from(compact, "base64");
+    case "quoted-printable":
+      return _decodeQuotedPrintable(buf);
+    /* istanbul ignore next */
+    default:
+      throw new SafeMimeError("safe-mime/unknown-transfer-encoding",
+        "safeMime.parse: unknown encoding '" + encoding + "'");
+  }
+}
+
+function _decodeQuotedPrintable(buf) {
+  var s = buf.toString("binary");
+  s = s.replace(/=\r?\n/g, "");
+  s = s.replace(/=([0-9A-Fa-f]{2})/g, function (_, hex) {
+    return String.fromCharCode(parseInt(hex, 16));                                                 // allow:raw-byte-literal — parseInt radix 16, not bytes
+  });
+  return Buffer.from(s, "binary");
+}
+
+function _decodeRfc2047Words(value) {
+  return value.replace(
+    /=\?([^?]+)\?([QqBb])\?([^?]*)\?=/g,
+    function (_, charset, mode, text) {
+      var raw;
+      if (mode === "B" || mode === "b") {
+        raw = Buffer.from(text, "base64");
+      } else {
+        raw = Buffer.from(text.replace(/_/g, " ").replace(/=([0-9A-Fa-f]{2})/g,
+          function (__, hex) { return String.fromCharCode(parseInt(hex, 16)); }), "binary");      // allow:raw-byte-literal — parseInt radix 16, not bytes
+      }
+      return _decodeBufferAs(raw, charset);
+    }
+  );
+}
+
+function _decodeBufferAs(buf, charset) {
+  var c = String(charset || "us-ascii").toLowerCase();
+  if (c === "utf-8" || c === "utf8") return buf.toString("utf8");
+  if (c === "us-ascii" || c === "ascii") return buf.toString("ascii");
+  if (c === "iso-8859-1" || c === "latin1") return buf.toString("latin1");
+  if (c === "utf-16le") return buf.toString("utf16le");
+  return buf.toString("utf8");
+}
+
+function _materializeText(part) {
+  return {
+    contentType: part.leaf.contentType,
+    charset:     part.leaf.charset,
+    body:        _materializeTextValue(part.leaf.body, part.leaf.charset),
+  };
+}
+
+function _materializeTextValue(buf, charset) {
+  return _decodeBufferAs(buf, charset);
+}
+
+function _ct(part) {
+  return part && part._contentType ? part._contentType : "";
+}
+
+function _filenameFromHeaders(headers) {
+  var cd = headers.get("content-disposition");
+  if (cd) {
+    var m = /filename\*?=([^;]+)/i.exec(cd);
+    if (m) {
+      var raw = m[1].trim();
+      if (raw.length >= 2 && raw.charAt(0) === '"' && raw.charAt(raw.length - 1) === '"') {
+        raw = raw.slice(1, -1);
+      }
+      if (/^[A-Za-z0-9_-]+'[A-Za-z0-9_-]*'/.test(raw)) {
+        var enc = raw.split("'");
+        return decodeURIComponent(enc[2]);
+      }
+      return raw;
+    }
+  }
+  var ct = headers.get("content-type");
+  if (ct) {
+    var m2 = /name=([^;]+)/i.exec(ct);
+    if (m2) {
+      var v = m2[1].trim();
+      if (v.length >= 2 && v.charAt(0) === '"' && v.charAt(v.length - 1) === '"') {
+        v = v.slice(1, -1);
+      }
+      return v;
+    }
+  }
+  return null;
+}
+
+function _toBuffer(input) {
+  if (Buffer.isBuffer(input)) return input;
+  if (typeof input === "string") return Buffer.from(input, "utf8");
+  if (input instanceof Uint8Array) return Buffer.from(input);
+  throw new SafeMimeError("safe-mime/bad-input",
+    "safeMime.parse: input must be Buffer, Uint8Array, or string (got " + typeof input + ")");
+}
+
+function _intOpt(opts, key, fallback) {
+  if (opts[key] === undefined || opts[key] === null) return fallback;
+  if (typeof opts[key] !== "number" || !isFinite(opts[key]) || opts[key] <= 0 || Math.floor(opts[key]) !== opts[key]) {
+    throw new SafeMimeError("safe-mime/bad-opt",
+      "safeMime.parse: opts." + key + " must be a positive finite integer (got " + opts[key] + ")");
+  }
+  return opts[key];
+}
+
+function _normalizeStringSet(arr) {
+  var set = Object.create(null);
+  for (var i = 0; i < arr.length; i += 1) {
+    set[String(arr[i]).toLowerCase()] = true;
+  }
+  return set;
+}
+
+function _normalizeCharsetName(c) {
+  var s = String(c).toLowerCase().trim();
+  if (s === "utf8") return "utf-8";
+  if (s === "ascii") return "us-ascii";
+  if (s === "latin1") return "iso-8859-1";
+  if (s === "cp1252") return "windows-1252";
+  if (s === "shift-jis") return "shift_jis";
+  return s;
+}
+
+function _previewBytes(line) {
+  if (typeof line !== "string") line = String(line);
+  return line.length > 64 ? line.slice(0, 64) + "..." : line;                                       // allow:raw-byte-literal — log-preview length cap
+}
+
+module.exports = {
+  parse:               parse,
+  walk:                walk,
+  findFirst:           findFirst,
+  extractText:         extractText,
+  extractAttachments:  extractAttachments,
+  SafeMimeError:       SafeMimeError,
+  DEFAULTS: Object.freeze({
+    maxParts:                  DEFAULT_MAX_PARTS,
+    maxNestingDepth:           DEFAULT_MAX_NESTING_DEPTH,
+    maxBoundary:               DEFAULT_MAX_BOUNDARY,
+    maxHeaderBytes:            DEFAULT_MAX_HEADER_BYTES,
+    maxHeaderLineBytes:        DEFAULT_MAX_HEADER_LINE,
+    maxBodyBytes:              DEFAULT_MAX_BODY_BYTES,
+    maxMessageBytes:           DEFAULT_MAX_MESSAGE_BYTES,
+    charsetAllowlist:          DEFAULT_CHARSETS,
+    transferEncodingAllowlist: DEFAULT_TRANSFER_ENCODINGS,
+  }),
+};