postal-mime 2.6.1 → 2.7.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [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

@@ -426,6 +426,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.0",
     "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

@@ -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;