postal-mime 2.6.1 → 2.7.1

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [2.7.1](https://github.com/postalsys/postal-mime/compare/v2.7.0...v2.7.1) (2025-12-22)
+
+
+### Bug Fixes
+
+* Add null checks for contentDisposition.parsed access ([fd54c37](https://github.com/postalsys/postal-mime/commit/fd54c37093cc64737c6bb17986bc9d052d2d5add))
+
+## [2.7.0](https://github.com/postalsys/postal-mime/compare/v2.6.1...v2.7.0) (2025-12-22)
+
+
+### Features
+
+* add headerLines property exposing raw header lines ([c79a02a](https://github.com/postalsys/postal-mime/commit/c79a02ab05d9cac44e05e95a433752ff292aa5eb))
+
 ## [2.6.1](https://github.com/postalsys/postal-mime/compare/v2.6.0...v2.6.1) (2025-11-26)
 
 

package/README.md

@@ -39,7 +39,7 @@ The source code is available on [GitHub](https://github.com/postalsys/postal-mim
 
 ## Demo
 
-Try out a live demo using the [example page](https://kreata.ee/postal-mime/example/).
+Try out a live demo using the [example page](https://postal-mime.postalsys.com/demo).
 
 ## Installation
 

package/dist/mime-node.cjs

@@ -193,31 +193,40 @@ class MimeNode {
       if (i && /^\s/.test(line)) {
         this.headerLines[i - 1] += "\n" + line;
         this.headerLines.splice(i, 1);
-      } else {
-        line = line.replace(/\s+/g, " ");
-        let sep = line.indexOf(":");
-        let key = sep < 0 ? line.trim() : line.substr(0, sep).trim();
-        let value = sep < 0 ? "" : line.substr(sep + 1).trim();
-        this.headers.push({ key: key.toLowerCase(), originalKey: key, value });
-        switch (key.toLowerCase()) {
-          case "content-type":
-            if (this.contentType.default) {
-              this.contentType = { value, parsed: {} };
-            }
-            break;
-          case "content-transfer-encoding":
-            this.contentTransferEncoding = { value, parsed: {} };
-            break;
-          case "content-disposition":
-            this.contentDisposition = { value, parsed: {} };
-            break;
-          case "content-id":
-            this.contentId = value;
-            break;
-          case "content-description":
-            this.contentDescription = value;
-            break;
-        }
+      }
+    }
+    this.rawHeaderLines = [];
+    for (let i = this.headerLines.length - 1; i >= 0; i--) {
+      let rawLine = this.headerLines[i];
+      let sep = rawLine.indexOf(":");
+      let rawKey = sep < 0 ? rawLine.trim() : rawLine.substr(0, sep).trim();
+      this.rawHeaderLines.push({
+        key: rawKey.toLowerCase(),
+        line: rawLine
+      });
+      let normalizedLine = rawLine.replace(/\s+/g, " ");
+      sep = normalizedLine.indexOf(":");
+      let key = sep < 0 ? normalizedLine.trim() : normalizedLine.substr(0, sep).trim();
+      let value = sep < 0 ? "" : normalizedLine.substr(sep + 1).trim();
+      this.headers.push({ key: key.toLowerCase(), originalKey: key, value });
+      switch (key.toLowerCase()) {
+        case "content-type":
+          if (this.contentType.default) {
+            this.contentType = { value, parsed: {} };
+          }
+          break;
+        case "content-transfer-encoding":
+          this.contentTransferEncoding = { value, parsed: {} };
+          break;
+        case "content-disposition":
+          this.contentDisposition = { value, parsed: {} };
+          break;
+        case "content-id":
+          this.contentId = value;
+          break;
+        case "content-description":
+          this.contentDescription = value;
+          break;
       }
     }
     this.contentType.parsed = this.parseStructuredHeader(this.contentType.value);

package/dist/postal-mime.cjs

@@ -134,6 +134,7 @@ class PostalMime {
     let textMap = this.textMap = /* @__PURE__ */ new Map();
     let forceRfc822Attachments = this.forceRfc822Attachments();
     let walk = async (node, alternative, related) => {
+      var _a, _b, _c, _d, _e;
       alternative = alternative || false;
       related = related || false;
       if (!node.contentType.multipart) {
@@ -173,11 +174,11 @@ class PostalMime {
           textEntry[textType].push({ type: "text", value: node.getTextContent() });
           textTypes.add(textType);
         } else if (node.content) {
-          const filename = node.contentDisposition.parsed.params.filename || node.contentType.parsed.params.name || null;
+          const filename = ((_c = (_b = (_a = node.contentDisposition) == null ? void 0 : _a.parsed) == null ? void 0 : _b.params) == null ? void 0 : _c.filename) || node.contentType.parsed.params.name || null;
           const attachment = {
             filename: filename ? (0, import_decode_strings.decodeWords)(filename) : null,
             mimeType: node.contentType.parsed.value,
-            disposition: node.contentDisposition.parsed.value || null
+            disposition: ((_e = (_d = node.contentDisposition) == null ? void 0 : _d.parsed) == null ? void 0 : _e.value) || null
           };
           if (related && node.contentId) {
             attachment.related = true;
@@ -285,7 +286,8 @@ class PostalMime {
     this.textContent = textContent;
   }
   isInlineTextNode(node) {
-    if (node.contentDisposition.parsed.value === "attachment") {
+    var _a, _b;
+    if (((_b = (_a = node.contentDisposition) == null ? void 0 : _a.parsed) == null ? void 0 : _b.value) === "attachment") {
       return false;
     }
     switch (node.contentType.parsed.value) {
@@ -299,10 +301,11 @@ class PostalMime {
     }
   }
   isInlineMessageRfc822(node) {
+    var _a, _b;
     if (node.contentType.parsed.value !== "message/rfc822") {
       return false;
     }
-    let disposition = node.contentDisposition.parsed.value || (this.options.rfc822Attachments ? "attachment" : "inline");
+    let disposition = ((_b = (_a = node.contentDisposition) == null ? void 0 : _a.parsed) == null ? void 0 : _b.value) || (this.options.rfc822Attachments ? "attachment" : "inline");
     return disposition === "inline";
   }
   // Check if this is a specially crafted report email where message/rfc822 content should not be inlined
@@ -426,6 +429,7 @@ class PostalMime {
       message.text = this.textContent.plain;
     }
     message.attachments = this.attachments;
+    message.headerLines = (this.root.rawHeaderLines || []).slice().reverse();
     switch (this.attachmentEncoding) {
       case "arraybuffer":
         break;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "postal-mime",
-    "version": "2.6.1",
+    "version": "2.7.1",
     "description": "Email parser for browser environments",
     "main": "./dist/postal-mime.cjs",
     "module": "./src/postal-mime.js",
@@ -34,6 +34,7 @@
     "bugs": {
         "url": "https://github.com/postalsys/postal-mime/issues"
     },
+    "homepage": "https://postal-mime.postalsys.com",
     "author": "Andris Reinman",
     "license": "MIT-0",
     "devDependencies": {

package/postal-mime.d.ts

@@ -6,6 +6,13 @@ export type Header = {
     value: string;
 };
 
+export type HeaderLine = {
+    /** Lowercase header name */
+    key: string;
+    /** Complete raw header line including key and value (with folded lines merged) */
+    line: string;
+};
+
 export type Mailbox = {
     name: string;
     address: string;
@@ -34,6 +41,7 @@ export type Attachment = {
 
 export type Email = {
     headers: Header[];
+    headerLines: HeaderLine[];
     from?: Address;
     sender?: Address;
     replyTo?: Address[];

package/src/mime-node.js

@@ -208,38 +208,59 @@ export default class MimeNode {
     }
 
     processHeaders() {
+        // First pass: merge folded headers (backward iteration)
         for (let i = this.headerLines.length - 1; i >= 0; i--) {
             let line = this.headerLines[i];
             if (i && /^\s/.test(line)) {
                 this.headerLines[i - 1] += '\n' + line;
                 this.headerLines.splice(i, 1);
-            } else {
-                // remove folding and extra WS
-                line = line.replace(/\s+/g, ' ');
-                let sep = line.indexOf(':');
-                let key = sep < 0 ? line.trim() : line.substr(0, sep).trim();
-                let value = sep < 0 ? '' : line.substr(sep + 1).trim();
-                this.headers.push({ key: key.toLowerCase(), originalKey: key, value });
-
-                switch (key.toLowerCase()) {
-                    case 'content-type':
-                        if (this.contentType.default) {
-                            this.contentType = { value, parsed: {} };
-                        }
-                        break;
-                    case 'content-transfer-encoding':
-                        this.contentTransferEncoding = { value, parsed: {} };
-                        break;
-                    case 'content-disposition':
-                        this.contentDisposition = { value, parsed: {} };
-                        break;
-                    case 'content-id':
-                        this.contentId = value;
-                        break;
-                    case 'content-description':
-                        this.contentDescription = value;
-                        break;
-                }
+            }
+        }
+
+        // Initialize rawHeaderLines to store unmodified lines
+        this.rawHeaderLines = [];
+
+        // Second pass: process headers (MUST be backward to maintain this.headers order)
+        // The existing code iterates backward and postal-mime.js calls .reverse()
+        // We must preserve this behavior to avoid breaking changes
+        for (let i = this.headerLines.length - 1; i >= 0; i--) {
+            let rawLine = this.headerLines[i];
+
+            // Extract key from raw line for rawHeaderLines
+            let sep = rawLine.indexOf(':');
+            let rawKey = sep < 0 ? rawLine.trim() : rawLine.substr(0, sep).trim();
+
+            // Store raw line with lowercase key
+            this.rawHeaderLines.push({
+                key: rawKey.toLowerCase(),
+                line: rawLine
+            });
+
+            // Normalize for this.headers (existing behavior - order preserved)
+            let normalizedLine = rawLine.replace(/\s+/g, ' ');
+            sep = normalizedLine.indexOf(':');
+            let key = sep < 0 ? normalizedLine.trim() : normalizedLine.substr(0, sep).trim();
+            let value = sep < 0 ? '' : normalizedLine.substr(sep + 1).trim();
+            this.headers.push({ key: key.toLowerCase(), originalKey: key, value });
+
+            switch (key.toLowerCase()) {
+                case 'content-type':
+                    if (this.contentType.default) {
+                        this.contentType = { value, parsed: {} };
+                    }
+                    break;
+                case 'content-transfer-encoding':
+                    this.contentTransferEncoding = { value, parsed: {} };
+                    break;
+                case 'content-disposition':
+                    this.contentDisposition = { value, parsed: {} };
+                    break;
+                case 'content-id':
+                    this.contentId = value;
+                    break;
+                case 'content-description':
+                    this.contentDescription = value;
+                    break;
             }
         }
 

package/src/postal-mime.js

@@ -200,11 +200,11 @@ export default class PostalMime {
                 // is it an attachment
                 else if (node.content) {
                     const filename =
-                        node.contentDisposition.parsed.params.filename || node.contentType.parsed.params.name || null;
+                        node.contentDisposition?.parsed?.params?.filename || node.contentType.parsed.params.name || null;
                     const attachment = {
                         filename: filename ? decodeWords(filename) : null,
                         mimeType: node.contentType.parsed.value,
-                        disposition: node.contentDisposition.parsed.value || null
+                        disposition: node.contentDisposition?.parsed?.value || null
                     };
 
                     if (related && node.contentId) {
@@ -333,7 +333,7 @@ export default class PostalMime {
     }
 
     isInlineTextNode(node) {
-        if (node.contentDisposition.parsed.value === 'attachment') {
+        if (node.contentDisposition?.parsed?.value === 'attachment') {
             // no matter the type, this is an attachment
             return false;
         }
@@ -355,7 +355,7 @@ export default class PostalMime {
             return false;
         }
         let disposition =
-            node.contentDisposition.parsed.value || (this.options.rfc822Attachments ? 'attachment' : 'inline');
+            node.contentDisposition?.parsed?.value || (this.options.rfc822Attachments ? 'attachment' : 'inline');
         return disposition === 'inline';
     }
 
@@ -517,6 +517,9 @@ export default class PostalMime {
 
         message.attachments = this.attachments;
 
+        // Expose raw header lines (reversed to match headers array order)
+        message.headerLines = (this.root.rawHeaderLines || []).slice().reverse();
+
         switch (this.attachmentEncoding) {
             case 'arraybuffer':
                 break;