mailauth 4.6.9 → 4.7.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [4.7.0](https://github.com/postalsys/mailauth/compare/v4.6.9...v4.7.0) (2024-10-02)
+
+
+### Features
+
+* **dkim-sign:** Added new Transfor stream class DkimSignStream to sign emails in a stream processing pipeline ([130a1a3](https://github.com/postalsys/mailauth/commit/130a1a3812fac2ad710f244510ca60887c2d33a9))
+
 ## [4.6.9](https://github.com/postalsys/mailauth/compare/v4.6.8...v4.6.9) (2024-08-22)
 
 

package/README.md

@@ -157,6 +157,52 @@ DKIM-Signature: a=rsa-sha256; v=1; c=relaxed/relaxed; d=tahvel.info;
 From: ...
 ```
 
+### Signing as a PassThrough Stream
+
+Use `DkimSignStream` stream if you want to use DKIM signing as part of a stream processing pipeline.
+
+```js
+const { DkimSignStream } = require('mailauth/lib/dkim/sign');
+
+const dkimSignStream = new DkimSignStream({
+    // Optional, default canonicalization, default is "relaxed/relaxed"
+    canonicalization: 'relaxed/relaxed', // c=
+
+    // Optional, default signing and hashing algorithm
+    // Mostly useful when you want to use rsa-sha1, otherwise no need to set
+    algorithm: 'rsa-sha256',
+
+    // Optional, default is current time
+    signTime: new Date(), // t=
+
+    // Keys for one or more signatures
+    // Different signatures can use different algorithms (mostly useful when
+    // you want to sign a message both with RSA and Ed25519)
+    signatureData: [
+        {
+            signingDomain: 'tahvel.info', // d=
+            selector: 'test.rsa', // s=
+            // supported key types: RSA, Ed25519
+            privateKey: fs.readFileSync('./test/fixtures/private-rsa.pem'),
+
+            // Optional algorithm, default is derived from the key.
+            // Overrides whatever was set in parent object
+            algorithm: 'rsa-sha256',
+
+            // Optional signature specifc canonicalization, overrides whatever was set in parent object
+            canonicalization: 'relaxed/relaxed' // c=
+
+            // Maximum number of canonicalized body bytes to sign (eg. the "l=" tag).
+            // Do not use though. This is available only for compatibility testing.
+            // maxBodyLength: 12345
+        }
+    ]
+});
+
+// Writes a signed message to the output
+process.stdin.pipe(dkimSignStream).pipe(process.stdout);
+```
+
 ### Verifying
 
 ```js

package/lib/dkim/sign.js

@@ -2,6 +2,7 @@
 
 const { writeToStream } = require('../../lib/tools');
 const { DkimSigner } = require('./dkim-signer');
+const { Transform } = require('node:stream');
 
 const dkimSign = async (input, options) => {
     let dkimSigner = new DkimSigner(options);
@@ -10,4 +11,67 @@ const dkimSign = async (input, options) => {
     return { signatures: dkimSigner.signatureHeaders.join('\r\n') + '\r\n', arc: dkimSigner.arc, errors: dkimSigner.errors };
 };
 
-module.exports = { dkimSign };
+class DkimSignStream extends Transform {
+    constructor(options) {
+        super(options);
+        this.signer = new DkimSigner(options);
+
+        this.chunks = [];
+        this.chunklen = 0;
+
+        this.errors = null;
+
+        this.finished = false;
+        this.finishCb = null;
+        this.signer.on('end', () => this.finishStream());
+        this.signer.on('finish', () => this.finishStream());
+        this.signer.on('error', err => {
+            this.finished = true;
+            this.destroy(err);
+        });
+    }
+
+    finishStream() {
+        if (this.finished || !this.finishCb) {
+            return;
+        }
+        this.finished = true;
+        let done = this.finishCb;
+        this.finishCb = null;
+
+        this.errors = this.signer.errors;
+
+        this.push(Buffer.from(this.signer.signatureHeaders.join('\r\n') + '\r\n'));
+        this.push(Buffer.concat(this.chunks, this.chunklen));
+        done();
+    }
+
+    _transform(chunk, encoding, done) {
+        if (!chunk || !chunk.length || this.finished) {
+            return done();
+        }
+
+        if (typeof chunk === 'string') {
+            chunk = Buffer.from(chunk, encoding);
+        }
+
+        this.chunks.push(chunk);
+        this.chunklen += chunk.length;
+
+        if (this.signer.write(chunk) === false) {
+            // wait for drain
+            return this.signer.once('drain', done);
+        }
+        done();
+    }
+
+    _flush(done) {
+        if (this.finished) {
+            return done();
+        }
+        this.finishCb = done;
+        this.signer.end();
+    }
+}
+
+module.exports = { dkimSign, DkimSignStream };

package/lib/gatherer-stream.js

@@ -41,9 +41,9 @@ class GathererStream extends Transform {
         return stream;
     }
 
-    _transform(chunk, encodng, done) {
+    _transform(chunk, encoding, done) {
         if (typeof chunk === 'string') {
-            chunk = Buffer.from(chunk, encodng);
+            chunk = Buffer.from(chunk, encoding);
         }
 
         if (!chunk || !chunk.length) {

package/man/mailauth.1

@@ -1,4 +1,4 @@
-.TH "MAILAUTH" "1" "August 2024" "v4.6.9" "Mailauth Help"
+.TH "MAILAUTH" "1" "October 2024" "v4.7.0" "Mailauth Help"
 .SH "NAME"
 \fBmailauth\fR
 .QP

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mailauth",
-    "version": "4.6.9",
+    "version": "4.7.0",
     "description": "Email authentication library for Node.js",
     "main": "lib/mailauth.js",
     "scripts": {
@@ -38,7 +38,7 @@
         "eslint-config-nodemailer": "1.2.0",
         "eslint-config-prettier": "9.1.0",
         "js-yaml": "4.1.0",
-        "license-report": "6.5.0",
+        "license-report": "6.7.0",
         "marked": "0.7.0",
         "marked-man": "0.7.0",
         "mbox-reader": "1.2.0",
@@ -46,13 +46,13 @@
     },
     "dependencies": {
         "@postalsys/vmc": "1.0.8",
-        "fast-xml-parser": "4.4.1",
+        "fast-xml-parser": "4.5.0",
         "ipaddr.js": "2.2.0",
         "joi": "17.13.3",
         "libmime": "5.3.5",
-        "nodemailer": "6.9.14",
+        "nodemailer": "6.9.15",
         "punycode.js": "2.3.1",
-        "tldts": "6.1.40",
+        "tldts": "6.1.49",
         "undici": "5.28.4",
         "yargs": "17.7.2"
     },