postal-mime 2.0.1 → 2.1.0

package/.prettierrc.cjs

@@ -0,0 +1,8 @@
+module.exports = {
+    printWidth: 160,
+    tabWidth: 4,
+    singleQuote: true,
+    endOfLine: 'lf',
+    trailingComma: 'none',
+    arrowParens: 'avoid'
+};

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## [2.1.0](https://github.com/postalsys/postal-mime/compare/v2.0.2...v2.1.0) (2024-02-22)
+
+
+### Features
+
+* **workers:** Support Cloudflare Email Workers out of the box ([4904708](https://github.com/postalsys/postal-mime/commit/49047089bf779931dacb4a7b31816b48d1b00840))
+
+
+### Bug Fixes
+
+* **module:** add types to module exports ([#23](https://github.com/postalsys/postal-mime/issues/23)) ([1ee4a42](https://github.com/postalsys/postal-mime/commit/1ee4a427643d71f6a4bda0db0ebe0b5b280e52ae))
+
+## [2.0.2](https://github.com/postalsys/postal-mime/compare/v2.0.1...v2.0.2) (2023-12-08)
+
+
+### Bug Fixes
+
+* **test:** Added a tests runner and some tests ([8c6f7fb](https://github.com/postalsys/postal-mime/commit/8c6f7fb495b0158756fc11482a717e8081cede86))
+* **test:** Added test action ([c43c086](https://github.com/postalsys/postal-mime/commit/c43c0865dae74a7f20e32885a5860d8654f0c932))
+
 ## [2.0.1](https://github.com/postalsys/postal-mime/compare/v2.0.0...v2.0.1) (2023-11-05)
 
 

package/README.md

@@ -67,6 +67,25 @@ Content-Type: text/html; charset=utf-8
 console.log(util.inspect(email, false, 22, true));
 ```
 
+#### Cloudflare [Email Workers](https://developers.cloudflare.com/email-routing/email-workers/)
+
+Pretty much the same as in Node.js. Use `message.raw` as the raw message for parsing.
+
+```js
+import PostalMime from 'postal-mime';
+
+export default {
+    async email(message, env, ctx) {
+        const parser = new PostalMime();
+        const email = await parser.parse(message.raw);
+
+        console.log('Subject: ', email.subject);
+        console.log('HTML: ', email.html);
+        console.log('Text: ', email.text);
+    }
+};
+```
+
 #### parser.parse()
 
 ```js

package/package.json

@@ -1,15 +1,16 @@
 {
     "name": "postal-mime",
-    "version": "2.0.1",
+    "version": "2.1.0",
     "description": "Email parser for browser environments",
     "main": "./src/postal-mime.js",
     "exports": {
-        "import": "./src/postal-mime.js"
+        "import": "./src/postal-mime.js",
+        "types": "./postal-mime.d.ts"
     },
     "type": "module",
     "types": "postal-mime.d.ts",
     "scripts": {
-        "test": "eslint",
+        "test": "eslint && node --test",
         "update": "rm -rf node_modules package-lock.json && ncu -u && npm install"
     },
     "keywords": [
@@ -27,9 +28,9 @@
     "license": "MIT-0",
     "devDependencies": {
         "cross-blob": "3.0.2",
-        "eslint": "8.52.0",
+        "eslint": "8.56.0",
         "eslint-cli": "1.1.1",
-        "iframe-resizer": "4.3.7",
+        "iframe-resizer": "4.3.9",
         "cross-env": "7.0.3"
     }
 }

package/postal-mime.d.ts

@@ -23,7 +23,7 @@ export type Email = {
 	replyTo?: Address[];
 	deliveredTo?: string;
 	returnPath?: string;
-	to: Address[];
+	to?: Address[];
 	cc?: Address[];
 	bcc?: Address[];
 	subject?: string;

package/src/address-parser.js

@@ -109,6 +109,14 @@ function _handleAddress(tokens) {
         data.text = data.text.join(' ');
         data.address = data.address.join(' ');
 
+        if (!data.address && /^=\?[^=]+?=$/.test(data.text.trim())) {
+            // try to extract words from text content
+            const parsedSubAddresses = addressParser(decodeWords(data.text));
+            if (parsedSubAddresses && parsedSubAddresses.length) {
+                return parsedSubAddresses;
+            }
+        }
+
         if (!data.address && isGroup) {
             return [];
         } else {

package/src/postal-mime.js

@@ -287,12 +287,41 @@ export default class PostalMime {
         this.textContent = textContent;
     }
 
+    async resolveStream(stream) {
+        let chunkLen = 0;
+        let chunks = [];
+        const reader = stream.getReader();
+
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done) {
+                break;
+            }
+            chunks.push(value);
+            chunkLen += value.length;
+        }
+
+        const result = new Uint8Array(chunkLen);
+        let chunkPointer = 0;
+        for (let chunk of chunks) {
+            result.set(chunk, chunkPointer);
+            chunkPointer += chunk.length;
+        }
+
+        return result;
+    }
+
     async parse(buf) {
         if (this.started) {
             throw new Error('Can not reuse parser, create a new PostalMime object');
         }
         this.started = true;
 
+        // check if the input is a readable stream and resolve it into an ArrayBuffer
+        if (buf && typeof buf.getReader === 'function') {
+            buf = await this.resolveStream(buf);
+        }
+
         // should it thrown on empty value instead?
         buf = buf || ArrayBuffer(0);