imapflow 1.0.100 → 1.0.101

package/README.md

@@ -1,14 +1,16 @@
 # ImapFlow
 
+ImapFlow is a modern and easy-to-use IMAP client library for Node.js.
+
 ---
 
-> Managing IMAP connections is cool, but if you are only looking for an easy way to integrate email accounts, then ImapFlow was built for [EmailEngine Email API](https://emailengine.app/). It's a self-hosted software that converts all IMAP accounts to easy-to-use REST interfaces.
+> Managing an IMAP connection is cool, but if you are only looking for an easy way to integrate email accounts, then ImapFlow was built for [EmailEngine Email API](https://emailengine.app/). It's a self-hosted software that converts all IMAP accounts to easy-to-use REST interfaces.
 
 ---
 
 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-EXT1` 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.2] latest Node.js defaults to *'TLSv1.2'*, for older mail servers you might need to use something else, eg *'TLSv1'*
+     * @param {String} [options.tls.minVersion=TLSv1] 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
@@ -731,7 +731,8 @@ class ImapFlow extends EventEmitter {
                     socket: this.socket,
                     servername: this.servername,
                     port: this.port,
-                    minVersion: 'TLSv1'
+                    minVersion: 'TLSv1',
+                    minDHSize: 1024
                 },
                 this.options.tls || {}
             );
@@ -1140,7 +1141,8 @@ class ImapFlow extends EventEmitter {
                 host: this.host,
                 servername: this.servername,
                 port: this.port,
-                minVersion: 'TLSv1'
+                minVersion: 'TLSv1',
+                minDHSize: 1024
             },
             this.options.tls || {}
         );

package/lib/search-compiler.js

@@ -120,6 +120,10 @@ module.exports.searchCompiler = (connection, query) => {
                 case 'GMRAW':
                     if (connection.capabilities.has('X-GM-EXT-1')) {
                         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');
+                        error.code = 'MissingServerExtension';
+                        throw error;
                     }
                     break;
 

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.2] - latest Node.js defaults to *'TLSv1.2'*, for older mail servers you might need to use something else, eg *'TLSv1'*
+     * @param [options.tls.minVersion = TLSv1] - 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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "imapflow",
-    "version": "1.0.100",
+    "version": "1.0.101",
     "description": "IMAP Client for Node",
     "main": "./lib/imap-flow.js",
     "scripts": {
@@ -27,20 +27,20 @@
     },
     "homepage": "https://imapflow.com/",
     "devDependencies": {
-        "@babel/eslint-parser": "7.18.2",
-        "@babel/eslint-plugin": "7.17.7",
+        "@babel/eslint-parser": "7.18.9",
+        "@babel/eslint-plugin": "7.18.10",
         "@babel/plugin-syntax-class-properties": "7.12.13",
-        "@babel/preset-env": "7.18.2",
-        "@types/node": "18.0.0",
+        "@babel/preset-env": "7.18.10",
+        "@types/node": "18.6.5",
         "braintree-jsdoc-template": "3.3.0",
-        "eslint": "8.18.0",
+        "eslint": "8.21.0",
         "eslint-config-nodemailer": "1.2.0",
         "eslint-config-prettier": "8.5.0",
         "grunt": "1.5.3",
         "grunt-cli": "1.4.3",
         "grunt-contrib-nodeunit": "4.0.0",
         "grunt-eslint": "24.0.0",
-        "jsdoc": "3.6.10",
+        "jsdoc": "3.6.11",
         "st": "3.0.0",
         "tsd-jsdoc": "2.5.0"
     },
@@ -51,8 +51,8 @@
         "libmime": "5.1.0",
         "libqp": "1.1.0",
         "mailsplit": "5.3.2",
-        "nodemailer": "6.7.5",
-        "pino": "8.0.0",
-        "socks": "2.6.2"
+        "nodemailer": "6.7.7",
+        "pino": "8.4.0",
+        "socks": "2.7.0"
     }
 }