imapflow 1.0.125 → 1.0.127

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # CHANGELOG
 
+-   1.0.127 - 2023-04-10
+
+    -   Use default Node.js TLS settings
+
 -   1.0.123 - 2023-03-22
 
     -   Do not throw if server responds with `tag BYE`

package/README.md

@@ -10,7 +10,7 @@ ImapFlow is a modern and easy-to-use IMAP client library for Node.js.
 
 The focus for ImapFlow is to provide easy to use API over IMAP. Using ImapFlow does not expect knowledge about specific IMAP details. A general understanding is good enough.
 
-IMAP extensions are handled in the background, so, for example, you can always request `labels` value from a {@link FetchQueryObject|fetch()} call, but if the IMAP server does not support `X-GM-EXT1` extension, then `labels` value is not included in the response.
+IMAP extensions are handled in the background, so, for example, you can always request `labels` value from a {@link FetchQueryObject|fetch()} call, but if the IMAP server does not support `X-GM-EXT-1` extension, then `labels` value is not included in the response.
 
 ## Source
 

package/lib/imap-flow.js

@@ -121,7 +121,7 @@ class ImapFlow extends EventEmitter {
      * @param {Boolean} [options.disableAutoIdle=false] if `true` then IDLE is not started automatically. Useful if you only need to perform specific tasks over the connection
      * @param {Object} [options.tls] Additional TLS options (see [Node.js TLS connect](https://nodejs.org/api/tls.html#tls_tls_connect_options_callback) for all available options)
      * @param {Boolean} [options.tls.rejectUnauthorized=true] if `false` then client accepts self-signed and expired certificates from the server
-     * @param {String} [options.tls.minVersion=TLSv1] To improvde security you might need to use something newer, eg *'TLSv1.2'*
+     * @param {String} [options.tls.minVersion=TLSv1.2] To improvde security you might need to use something newer, eg *'TLSv1.2'*
      * @param {Number} [options.tls.minDHSize=1024] Minimum size of the DH parameter in bits to accept a TLS connection
      * @param {Object} [options.logger] Custom logger instance with `debug(obj)`, `info(obj)`, `warn(obj)` and `error(obj)` methods. If not provided then ImapFlow logs to console using pino format
      * @param {Boolean} [options.logRaw=false] If true then log data read from and written to socket encoded in base64
@@ -782,9 +782,7 @@ class ImapFlow extends EventEmitter {
                 {
                     socket: this.socket,
                     servername: this.servername,
-                    port: this.port,
-                    minVersion: 'TLSv1',
-                    minDHSize: 1024
+                    port: this.port
                 },
                 this.options.tls || {}
             );
@@ -1213,9 +1211,7 @@ class ImapFlow extends EventEmitter {
             {
                 host: this.host,
                 servername: this.servername,
-                port: this.port,
-                minVersion: 'TLSv1',
-                minDHSize: 1024
+                port: this.port
             },
             this.options.tls || {}
         );
@@ -2224,7 +2220,7 @@ class ImapFlow extends EventEmitter {
      *
      * @example
      * let mailbox = await client.mailboxOpen('INBOX');
-     * // fetch UID for all messages in a mailbox
+     * // fetch UID for the last email in the selected mailbox
      * let lastMsg = await client.fetchOne('*', {uid: true})
      * console.log(lastMsg.uid);
      */
@@ -2555,7 +2551,7 @@ class ImapFlow extends EventEmitter {
      *
      * @example
      * let mailbox = await client.mailboxOpen('INBOX');
-     * // download body part nr '1.2' from latest message
+     * // download body parts '2', and '3' from all messages in the selected mailbox
      * let response = await client.downloadMany('*', ['2', '3]);
      * process.stdout.write(response[2].content)
      * process.stdout.write(response[3].content)

package/lib/search-compiler.js

@@ -39,9 +39,18 @@ let processDateField = (attributes, term, value) => {
     setOpt(attributes, term, date);
 };
 
+let isUnicodeString = str => {
+    if (!str || typeof str !== 'string') {
+        return false;
+    }
+
+    return Buffer.byteLength(str) !== str.length;
+};
+
 module.exports.searchCompiler = (connection, query) => {
     const attributes = [];
 
+    let hasUnicode = false;
     const mailbox = connection.mailbox;
 
     const walk = params => {
@@ -82,16 +91,24 @@ module.exports.searchCompiler = (connection, query) => {
                     }
                     break;
 
+                case 'LARGER':
+                case 'SMALLER':
+                case 'MODSEQ':
+                    if (params[term]) {
+                        setOpt(attributes, term, params[term]);
+                    }
+                    break;
+
                 case 'BCC':
                 case 'BODY':
                 case 'CC':
                 case 'FROM':
-                case 'LARGER':
-                case 'SMALLER':
                 case 'SUBJECT':
                 case 'TEXT':
                 case 'TO':
-                case 'MODSEQ':
+                    if (isUnicodeString(params[term])) {
+                        hasUnicode = true;
+                    }
                     if (params[term]) {
                         setOpt(attributes, term, params[term]);
                     }
@@ -110,6 +127,7 @@ module.exports.searchCompiler = (connection, query) => {
                         setOpt(attributes, 'X-GM-MSGID', params[term]);
                     }
                     break;
+
                 case 'THREADID':
                     if (connection.capabilities.has('OBJECTID')) {
                         setOpt(attributes, 'THREADID', params[term]);
@@ -117,9 +135,13 @@ module.exports.searchCompiler = (connection, query) => {
                         setOpt(attributes, 'X-GM-THRID', params[term]);
                     }
                     break;
+
                 case 'GMRAW':
                 case 'GMAILRAW': // alias for GMRAW
                     if (connection.capabilities.has('X-GM-EXT-1')) {
+                        if (isUnicodeString(params[term])) {
+                            hasUnicode = true;
+                        }
                         setOpt(attributes, 'X-GM-RAW', params[term]);
                     } else {
                         let error = new Error('Server does not support X-GM-EXT-1 extension required for X-GM-RAW');
@@ -159,6 +181,10 @@ module.exports.searchCompiler = (connection, query) => {
                                 return;
                             }
 
+                            if (isUnicodeString(value)) {
+                                hasUnicode = true;
+                            }
+
                             setOpt(attributes, term, [header.toUpperCase().trim(), value]);
                         });
                     }
@@ -233,5 +259,10 @@ module.exports.searchCompiler = (connection, query) => {
 
     walk(query);
 
+    if (hasUnicode) {
+        attributes.unshift({ type: 'ATOM', value: 'UTF-8' });
+        attributes.unshift({ type: 'ATOM', value: 'CHARSET' });
+    }
+
     return attributes;
 };

package/lib/types.d.ts

@@ -20,7 +20,7 @@ declare module "imapflow" {
      * @param [options.disableAutoIdle = false] - if `true` then IDLE is not started automatically. Useful if you only need to perform specific tasks over the connection
      * @param [options.tls] - Additional TLS options (see [Node.js TLS connect](https://nodejs.org/api/tls.html#tls_tls_connect_options_callback) for all available options)
      * @param [options.tls.rejectUnauthorized = true] - if `false` then client accepts self-signed and expired certificates from the server
-     * @param [options.tls.minVersion = TLSv1] - To improvde security you might need to use something newer, eg *'TLSv1.2'*
+     * @param [options.tls.minVersion = TLSv1.2] - To improvde security you might need to use something newer, eg *'TLSv1.2'*
      * @param [options.tls.minDHSize = 1024] - Minimum size of the DH parameter in bits to accept a TLS connection
      * @param [options.logger] - Custom logger instance with `debug(obj)`, `info(obj)`, `warn(obj)` and `error(obj)` methods. If not provided then ImapFlow logs to console using pino format
      * @param [options.logRaw = false] - If true then log data read from and written to socket encoded in base64
@@ -461,7 +461,7 @@ declare module "imapflow" {
          * Fetch a single message from currently opened mailbox
          * @example
          * let mailbox = await client.mailboxOpen('INBOX');
-         * // fetch UID for all messages in a mailbox
+         * // fetch UID for the last email in the selected mailbox
          * let lastMsg = await client.fetchOne('*', {uid: true})
          * console.log(lastMsg.uid);
          * @param seq - Single UID or sequence number of the message to fetch for
@@ -499,7 +499,7 @@ declare module "imapflow" {
          * Fetch multiple attachments as Buffer values
          * @example
          * let mailbox = await client.mailboxOpen('INBOX');
-         * // download body part nr '1.2' from latest message
+         * // download body parts '2', and '3' from all messages in the selected mailbox
          * let response = await client.downloadMany('*', ['2', '3]);
          * process.stdout.write(response[2].content)
          * process.stdout.write(response[3].content)

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "imapflow",
-    "version": "1.0.125",
+    "version": "1.0.127",
     "description": "IMAP Client for Node",
     "main": "./lib/imap-flow.js",
     "scripts": {
@@ -30,10 +30,10 @@
         "@babel/eslint-parser": "7.21.3",
         "@babel/eslint-plugin": "7.19.1",
         "@babel/plugin-syntax-class-properties": "7.12.13",
-        "@babel/preset-env": "7.20.2",
-        "@types/node": "18.15.10",
+        "@babel/preset-env": "7.21.4",
+        "@types/node": "18.15.11",
         "braintree-jsdoc-template": "3.3.0",
-        "eslint": "8.36.0",
+        "eslint": "8.38.0",
         "eslint-config-nodemailer": "1.2.0",
         "eslint-config-prettier": "8.8.0",
         "grunt": "1.6.1",