npm - imapflow - Versions diffs - 1.0.163 → 1.0.165 - Mend

imapflow 1.0.163 → 1.0.165

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/CHANGELOG.md +45 -59
package/lib/commands/idle.js +1 -1
package/lib/handler/imap-compiler.js +1 -1
package/lib/imap-flow.js +42 -11
package/lib/tools.js +1 -1
package/lib/types.d.ts +33 -8
package/package.json +9 -9
package/test/imap-parser-test.js +59 -0

package/CHANGELOG.md CHANGED Viewed

@@ -1,196 +1,182 @@
 # Changelog
-## [1.0.163](https://github.com/postalsys/imapflow/compare/v1.0.162...v1.0.163) (2024-07-06)
+## [1.0.165](https://github.com/postalsys/imapflow/compare/v1.0.164...v1.0.165) (2024-11-01)
 ### Bug Fixes
-* **parser:** parse subfolders with square brackets ([0d0e8a6](https://github.com/postalsys/imapflow/commit/0d0e8a6ea379adf11594684d49a1ce5031339939))
-* **socket:** Use destroy() instead of destroySoon() ([830c2d1](https://github.com/postalsys/imapflow/commit/830c2d18f3d27eb12dc6babe4edd37fed5f65490))
+* **imap:** Support invalid servers that return a full partial instead of starting byte for a FETCH property ([7281ce9](https://github.com/postalsys/imapflow/commit/7281ce98683946f825b5bfec197beecad7867a70))
-## [1.0.162](https://github.com/postalsys/imapflow/compare/v1.0.161...v1.0.162) (2024-05-07)
+## [1.0.164](https://github.com/postalsys/imapflow/compare/v1.0.163...v1.0.164) (2024-07-09)
+### Bug Fixes
+-   **api:** Add fetchAll method ([#207](https://github.com/postalsys/imapflow/issues/207)) ([bc09998](https://github.com/postalsys/imapflow/commit/bc09998270006ea6ff8430b3461619dd9b3e91c8))
+## [1.0.163](https://github.com/postalsys/imapflow/compare/v1.0.162...v1.0.163) (2024-07-06)
 ### Bug Fixes
-* **idle:** Do not clear preCheck from other command ([cdf7643](https://github.com/postalsys/imapflow/commit/cdf7643952c975556e11a03ceca85f8a57fe1420))
+-   **parser:** parse subfolders with square brackets ([0d0e8a6](https://github.com/postalsys/imapflow/commit/0d0e8a6ea379adf11594684d49a1ce5031339939))
+-   **socket:** Use destroy() instead of destroySoon() ([830c2d1](https://github.com/postalsys/imapflow/commit/830c2d18f3d27eb12dc6babe4edd37fed5f65490))
-## [1.0.161](https://github.com/postalsys/imapflow/compare/v1.0.160...v1.0.161) (2024-05-06)
+## [1.0.162](https://github.com/postalsys/imapflow/compare/v1.0.161...v1.0.162) (2024-05-07)
+### Bug Fixes
+-   **idle:** Do not clear preCheck from other command ([cdf7643](https://github.com/postalsys/imapflow/commit/cdf7643952c975556e11a03ceca85f8a57fe1420))
+## [1.0.161](https://github.com/postalsys/imapflow/compare/v1.0.160...v1.0.161) (2024-05-06)
 ### Bug Fixes
-* **listTree:** pass listing options as an optional argument ([917ba80](https://github.com/postalsys/imapflow/commit/917ba80f21b2fe485154acd252d6565b838e73e6))
+-   **listTree:** pass listing options as an optional argument ([917ba80](https://github.com/postalsys/imapflow/commit/917ba80f21b2fe485154acd252d6565b838e73e6))
 ## [1.0.160](https://github.com/postalsys/imapflow/compare/v1.0.159...v1.0.160) (2024-04-22)
 ### Bug Fixes
-* **copy:** Updated cipyright year to 2024 ([e3f5040](https://github.com/postalsys/imapflow/commit/e3f5040e8f90523e12108e978ac5002f8caa9e1e))
+-   **copy:** Updated cipyright year to 2024 ([e3f5040](https://github.com/postalsys/imapflow/commit/e3f5040e8f90523e12108e978ac5002f8caa9e1e))
 ## [1.0.159](https://github.com/postalsys/imapflow/compare/v1.0.158...v1.0.159) (2024-04-12)
 ### Bug Fixes
-* **deps:** Bumped deps ([53ccd8b](https://github.com/postalsys/imapflow/commit/53ccd8b1027782dcd2af6dd1f7d337007a7f79c0))
+-   **deps:** Bumped deps ([53ccd8b](https://github.com/postalsys/imapflow/commit/53ccd8b1027782dcd2af6dd1f7d337007a7f79c0))
 ## [1.0.158](https://github.com/postalsys/imapflow/compare/v1.0.157...v1.0.158) (2024-03-19)
 ### Bug Fixes
-* **locking:** log extra information about locks ([9790ec5](https://github.com/postalsys/imapflow/commit/9790ec575f405820d05dd4777987a88e0a4e819d))
+-   **locking:** log extra information about locks ([9790ec5](https://github.com/postalsys/imapflow/commit/9790ec575f405820d05dd4777987a88e0a4e819d))
 ## [1.0.157](https://github.com/postalsys/imapflow/compare/v1.0.156...v1.0.157) (2024-03-19)
 ### Bug Fixes
-* **logs:** Log mailbox lock description ([ce87cf5](https://github.com/postalsys/imapflow/commit/ce87cf5a256ddc324624893a1c17992475fafeb3))
+-   **logs:** Log mailbox lock description ([ce87cf5](https://github.com/postalsys/imapflow/commit/ce87cf5a256ddc324624893a1c17992475fafeb3))
 ## [1.0.156](https://github.com/postalsys/imapflow/compare/v1.0.155...v1.0.156) (2024-03-07)
 ### Bug Fixes
-* micro-optimizations for parser ([3451ad2](https://github.com/postalsys/imapflow/commit/3451ad235532ca1a64a829f9f2f8e77bcef3a17d))
+-   micro-optimizations for parser ([3451ad2](https://github.com/postalsys/imapflow/commit/3451ad235532ca1a64a829f9f2f8e77bcef3a17d))
 ## [1.0.155](https://github.com/postalsys/imapflow/compare/v1.0.154...v1.0.155) (2024-03-06)
 ### Bug Fixes
-* **exchange:** handle special error response from exchange ([3ed4198](https://github.com/postalsys/imapflow/commit/3ed4198c1b5504ab0b46926fec179c682988b2e3))
+-   **exchange:** handle special error response from exchange ([3ed4198](https://github.com/postalsys/imapflow/commit/3ed4198c1b5504ab0b46926fec179c682988b2e3))
 ## [1.0.154](https://github.com/postalsys/imapflow/compare/v1.0.153...v1.0.154) (2024-03-05)
 ### Bug Fixes
-* **FETCH:** throw on failing FETCH ([12f9a45](https://github.com/postalsys/imapflow/commit/12f9a45530c6f3a2f35ba2968819011eea9c32b2))
+-   **FETCH:** throw on failing FETCH ([12f9a45](https://github.com/postalsys/imapflow/commit/12f9a45530c6f3a2f35ba2968819011eea9c32b2))
 ## [1.0.153](https://github.com/postalsys/imapflow/compare/v1.0.152...v1.0.153) (2024-02-29)
 ### Bug Fixes
-* **deps:** Bumped deps ([559aa72](https://github.com/postalsys/imapflow/commit/559aa72337018f21a3675f4521ce4aae87e0aabb))
+-   **deps:** Bumped deps ([559aa72](https://github.com/postalsys/imapflow/commit/559aa72337018f21a3675f4521ce4aae87e0aabb))
 ## [1.0.152](https://github.com/postalsys/imapflow/compare/v1.0.151...v1.0.152) (2024-02-12)
 ### Bug Fixes
-* **address:** do not use '@' instead of empyt address if a field does not contain a value ([aeabbde](https://github.com/postalsys/imapflow/commit/aeabbded3bf3c6ba7266f79d4bc001980644da0d))
+-   **address:** do not use '@' instead of empyt address if a field does not contain a value ([aeabbde](https://github.com/postalsys/imapflow/commit/aeabbded3bf3c6ba7266f79d4bc001980644da0d))
 ## [1.0.151](https://github.com/postalsys/imapflow/compare/v1.0.150...v1.0.151) (2024-02-12)
 ### Bug Fixes
-* **filename:** Fixed filename decoding for the download method ([68a8159](https://github.com/postalsys/imapflow/commit/68a8159a0988245bf3f7c9b002823b01d9d24876))
+-   **filename:** Fixed filename decoding for the download method ([68a8159](https://github.com/postalsys/imapflow/commit/68a8159a0988245bf3f7c9b002823b01d9d24876))
 ## [1.0.150](https://github.com/postalsys/imapflow/compare/v1.0.149...v1.0.150) (2024-02-01)
 ### Bug Fixes
-* **deps:** Bumped Nodemailer version ([ee02764](https://github.com/postalsys/imapflow/commit/ee0276493494ecf08be557cc0c486fe309d359bf))
+-   **deps:** Bumped Nodemailer version ([ee02764](https://github.com/postalsys/imapflow/commit/ee0276493494ecf08be557cc0c486fe309d359bf))
 ## [1.0.149](https://github.com/postalsys/imapflow/compare/v1.0.148...v1.0.149) (2024-01-31)
 ### Bug Fixes
-* **flag-colors:** added a method to set Flag Color. The color is also included in the Fetch response structure ([d840951](https://github.com/postalsys/imapflow/commit/d8409513075b864e9131665af3f1670a0714d05c))
+-   **flag-colors:** added a method to set Flag Color. The color is also included in the Fetch response structure ([d840951](https://github.com/postalsys/imapflow/commit/d8409513075b864e9131665af3f1670a0714d05c))
 ## [1.0.148](https://github.com/postalsys/imapflow/compare/v1.0.147...v1.0.148) (2024-01-16)
 ### Bug Fixes
-* **logout:** Fixed race condition for logout and TCP close. Fixes [#161](https://github.com/postalsys/imapflow/issues/161) ([39a7333](https://github.com/postalsys/imapflow/commit/39a7333a39499e4876abb29149f7c72f2f99a63d))
+-   **logout:** Fixed race condition for logout and TCP close. Fixes [#161](https://github.com/postalsys/imapflow/issues/161) ([39a7333](https://github.com/postalsys/imapflow/commit/39a7333a39499e4876abb29149f7c72f2f99a63d))
 ## [1.0.147](https://github.com/postalsys/imapflow/compare/v1.0.146...v1.0.147) (2023-10-26)
 ### Bug Fixes
-* **idle:** removed unneeded variable ([da59d9a](https://github.com/postalsys/imapflow/commit/da59d9a960dd0992b22335902808a315b1cb6ded))
+-   **idle:** removed unneeded variable ([da59d9a](https://github.com/postalsys/imapflow/commit/da59d9a960dd0992b22335902808a315b1cb6ded))
 ## [1.0.146](https://github.com/postalsys/imapflow/compare/v1.0.145...v1.0.146) (2023-10-26)
 ### Bug Fixes
-* **throttling:** automatically retry throttled FETCH commands a few times ([07a9aea](https://github.com/postalsys/imapflow/commit/07a9aea37ae55ed885ccc4c0e3732b367ad82cd3))
+-   **throttling:** automatically retry throttled FETCH commands a few times ([07a9aea](https://github.com/postalsys/imapflow/commit/07a9aea37ae55ed885ccc4c0e3732b367ad82cd3))
 ## [1.0.145](https://github.com/postalsys/imapflow/compare/v1.0.144...v1.0.145) (2023-10-26)
 ### Bug Fixes
-* **docs:** Fixed mailbox property name in AppendResponseObject ([ca6d789](https://github.com/postalsys/imapflow/commit/ca6d789b761d3117f733ed7b026122098f4d9142))
-* **special-use:** support custom special use flags for the Archive folder ([17aa6a8](https://github.com/postalsys/imapflow/commit/17aa6a8baf180a7349fe30f897184eb8e359a498))
+-   **docs:** Fixed mailbox property name in AppendResponseObject ([ca6d789](https://github.com/postalsys/imapflow/commit/ca6d789b761d3117f733ed7b026122098f4d9142))
+-   **special-use:** support custom special use flags for the Archive folder ([17aa6a8](https://github.com/postalsys/imapflow/commit/17aa6a8baf180a7349fe30f897184eb8e359a498))
 ## [1.0.144](https://github.com/postalsys/imapflow/compare/v1.0.143...v1.0.144) (2023-09-13)
 ### Bug Fixes
-* **MS365:** Wait until responding with a throttling response ([#142](https://github.com/postalsys/imapflow/issues/142)) ([09bfb3e](https://github.com/postalsys/imapflow/commit/09bfb3e1b90bdd37bc1c9b40e9284ad4afbd5c72))
+-   **MS365:** Wait until responding with a throttling response ([#142](https://github.com/postalsys/imapflow/issues/142)) ([09bfb3e](https://github.com/postalsys/imapflow/commit/09bfb3e1b90bdd37bc1c9b40e9284ad4afbd5c72))
 ## [1.0.143](https://github.com/postalsys/imapflow/compare/v1.0.142...v1.0.143) (2023-09-04)
 ### Bug Fixes
-* **release:** updated provenance setting ([e178629](https://github.com/postalsys/imapflow/commit/e1786296569e5a0acfb997b007091925519c7d79))
+-   **release:** updated provenance setting ([e178629](https://github.com/postalsys/imapflow/commit/e1786296569e5a0acfb997b007091925519c7d79))
 ## [1.0.142](https://github.com/postalsys/imapflow/compare/v1.0.141...v1.0.142) (2023-09-04)
 ### Bug Fixes
-* **release:** updated provenance setting ([4fd5fa8](https://github.com/postalsys/imapflow/commit/4fd5fa8aa74756c1b9ff166febf294acda4792b8))
+-   **release:** updated provenance setting ([4fd5fa8](https://github.com/postalsys/imapflow/commit/4fd5fa8aa74756c1b9ff166febf294acda4792b8))
 ## [1.0.141](https://github.com/postalsys/imapflow/compare/v1.0.140...v1.0.141) (2023-09-04)
 ### Bug Fixes
-* **readme:** testing note format ([3038c4d](https://github.com/postalsys/imapflow/commit/3038c4d9740af0a5161bbc45dd13b86d4febc0ac))
+-   **readme:** testing note format ([3038c4d](https://github.com/postalsys/imapflow/commit/3038c4d9740af0a5161bbc45dd13b86d4febc0ac))
 ## [1.0.140](https://github.com/postalsys/imapflow/compare/v1.0.139...v1.0.140) (2023-09-04)
 ### Bug Fixes
-* **license:** bumped license timeframe in README ([9a04730](https://github.com/postalsys/imapflow/commit/9a047309d10c0ef056c53fba3493df9f2fea5a1d))
+-   **license:** bumped license timeframe in README ([9a04730](https://github.com/postalsys/imapflow/commit/9a047309d10c0ef056c53fba3493df9f2fea5a1d))
 ## [1.0.139](https://github.com/postalsys/imapflow/compare/v1.0.138...v1.0.139) (2023-09-04)
 ### Bug Fixes
-* **license:** Bumped license timeframe ([ce308b6](https://github.com/postalsys/imapflow/commit/ce308b66e5d30819c6bab7d75752528abc4b8436))
+-   **license:** Bumped license timeframe ([ce308b6](https://github.com/postalsys/imapflow/commit/ce308b66e5d30819c6bab7d75752528abc4b8436))
 ## [1.0.138](https://github.com/postalsys/imapflow/compare/v1.0.137...v1.0.138) (2023-09-04)
 ### Bug Fixes
-* **release:** Added package-lock ([e35bda8](https://github.com/postalsys/imapflow/commit/e35bda8a2b14503ba30a46b555df82ab1084cf5a))
-* **release:** updated package-lock ([b59220f](https://github.com/postalsys/imapflow/commit/b59220f54a58111e0b3259c502ff51b2a624f397))
+-   **release:** Added package-lock ([e35bda8](https://github.com/postalsys/imapflow/commit/e35bda8a2b14503ba30a46b555df82ab1084cf5a))
+-   **release:** updated package-lock ([b59220f](https://github.com/postalsys/imapflow/commit/b59220f54a58111e0b3259c502ff51b2a624f397))
 ## [1.0.137](https://github.com/postalsys/imapflow/compare/v1.0.136...v1.0.137) (2023-09-04)
 ### Bug Fixes
-* **deps:** Bumped dependencies ([e8f5e8c](https://github.com/postalsys/imapflow/commit/e8f5e8ce431debddeecf523fa8739ae5ad23c659))
+-   **deps:** Bumped dependencies ([e8f5e8c](https://github.com/postalsys/imapflow/commit/e8f5e8ce431debddeecf523fa8739ae5ad23c659))
 ## CHANGELOG
@@ -240,7 +226,7 @@
 -   1.0.112 - 2022-10-16
-    -   Improved ID compatiblity with servers that allow ID only after login
+    -   Improved ID compatibility with servers that allow ID only after login
 -   1.0.111 - 2022-10-13
@@ -448,7 +434,7 @@
 -   1.0.42 - 2020-04-13
-    -   Try to hande edge case when authenticating against Exchange IMAP
+    -   Try to handle edge case when authenticating against Exchange IMAP
 -   1.0.41 - 2020-04-12

package/lib/commands/idle.js CHANGED Viewed

@@ -105,7 +105,7 @@ async function runIdle(connection) {
     }
 }
-// Listes for changes in mailbox
+// Listens for changes in mailbox
 module.exports = async (connection, maxIdleTime) => {
     if (connection.state !== connection.states.SELECTED) {
         // nothing to do here

package/lib/handler/imap-compiler.js CHANGED Viewed

@@ -61,7 +61,7 @@ module.exports = async (response, options) => {
             lastType = 'LIST';
             resp.push(formatRespEntry('('));
-            // check if we need to skip separtor WS between two arrays
+            // check if we need to skip separator WS between two arrays
             let subArray = node.length > 1 && Array.isArray(node[0]);
             for (let child of node) {

package/lib/imap-flow.js CHANGED Viewed

@@ -1330,7 +1330,7 @@ class ImapFlow extends EventEmitter {
                 this.greetingTimeout = setTimeout(() => {
                     let err = new Error(`Failed to receive greeting from server in required time${!this.secureConnection ? '. Maybe should use TLS?' : ''}`);
-                    err.code = 'GREEETING_TIMEOUT';
+                    err.code = 'GREETING_TIMEOUT';
                     err.details = {
                         greetingTimeout: this.options.greetingTimeout || GREETING_TIMEOUT
                     };
@@ -1371,7 +1371,7 @@ class ImapFlow extends EventEmitter {
             };
             if (socket) {
-                // socket is already establised via proxy
+                // socket is already established via proxy
                 if (this.secureConnection) {
                     // TLS socket requires a handshake
                     opts.socket = socket;
@@ -1841,7 +1841,7 @@ class ImapFlow extends EventEmitter {
      * @property {Date|string} [sentSince] Matches messages sent after date
      * @property {String} [keyword] Matches messages that have the custom flag set
      * @property {String} [unKeyword] Matches messages that do not have the custom flag set
-     * @property {Object.<string, Boolean|String>} [header] Mathces messages with header key set if value is `true` (**NB!** not supported by all servers) or messages where header partially matches a string value
+     * @property {Object.<string, Boolean|String>} [header] Matches messages with header key set if value is `true` (**NB!** not supported by all servers) or messages where header partially matches a string value
      * @property {SearchObject[]} [or] An array of 2 or more {@link SearchObject} objects. At least on of these must match
      */
@@ -2010,7 +2010,7 @@ class ImapFlow extends EventEmitter {
     }
     /**
-     * Delete messages from currently opened mailbox. Method does not indicate info about deleted messages,
+     * Delete messages from the currently opened mailbox. Method does not indicate info about deleted messages,
      * instead you should be using {@link ImapFlow#expunge} event for this
      *
      * @param {SequenceString | Number[] | SearchObject} range Range to filter the messages
@@ -2121,7 +2121,7 @@ class ImapFlow extends EventEmitter {
     }
     /**
-     * Search messages from currently opened mailbox
+     * Search messages from the currently opened mailbox
      *
      * @param {SearchObject} query Query to filter the messages
      * @param {Object} [options]
@@ -2213,7 +2213,7 @@ class ImapFlow extends EventEmitter {
      * @property {Number} [size] Expected size of the node
      * @property {MessageEnvelopeObject} [envelope] message envelope of embedded RFC822 message
      * @property {String} [disposition] Content disposition
-     * @property {Object} [dispositionParameters] Additional parameters for Conent-Disposition
+     * @property {Object} [dispositionParameters] Additional parameters for Content-Disposition
      * @property {MessageStructureObject[]} childNodes An array of child nodes if this is a multipart node. Not present for normal nodes
      */
@@ -2240,7 +2240,7 @@ class ImapFlow extends EventEmitter {
      */
     /**
-     * Fetch messages from currently opened mailbox
+     * Fetch messages from the currently opened mailbox
      *
      * @param {SequenceString | Number[] | SearchObject} range Range of messages to fetch
      * @param {FetchQueryObject} query Fetch query
@@ -2353,7 +2353,38 @@ class ImapFlow extends EventEmitter {
     }
     /**
-     * Fetch a single message from currently opened mailbox
+     * Fetch messages from the currently opened mailbox.
+     *
+     * This method will fetch all messages before resolving the promise, unlike .fetch(), which
+     * is an async generator. Do not use large ranges like 1:*, as this might exhaust all available
+     * memory if the mailbox contains a large number of emails.
+     * @param {SequenceString | Number[] | SearchObject} range Range of messages to fetch
+     * @param {FetchQueryObject} query Fetch query
+     * @param {Object} [options]
+     * @param {Boolean} [options.uid] If `true` then uses UID numbers instead of sequence numbers for `range`
+     * @param {BigInt} [options.changedSince] If set then only messages with a higher modseq value are returned. Ignored if server does not support `CONDSTORE` extension.
+     * @param {Boolean} [options.binary=false] If `true` then requests a binary response if the server supports this
+     * @returns {Promise<FetchMessageObject[]>} Array of Message data object
+     *
+     * @example
+     * let mailbox = await client.mailboxOpen('INBOX');
+     * // fetch UID for all messages in a mailbox
+     * const messages = await client.fetchAll('1:*', {uid: true});
+     * for (let msg of messages){
+     *     console.log(msg.uid);
+     * }
+     */
+    async fetchAll(range, query, options) {
+        const results = [];
+        const generator = this.fetch(range, query, options);
+        for await (const message of generator) {
+            results.push(message);
+        }
+        return results;
+    }
+    /**
+     * Fetch a single message from the currently opened mailbox
      *
      * @param {SequenceString} seq Single UID or sequence number of the message to fetch for
      * @param {FetchQueryObject} query Fetch query
@@ -2397,14 +2428,14 @@ class ImapFlow extends EventEmitter {
      * @property {Object} meta content metadata
      * @property {number} meta.expectedSize The fetch response size
      * @property {String} meta.contentType Content-Type of the streamed file. If part was not set then this value is "message/rfc822"
-     * @property {String} [meta.charset] Charset of the body part. Text parts are automaticaly converted to UTF-8, attachments are kept as is
+     * @property {String} [meta.charset] Charset of the body part. Text parts are automatically converted to UTF-8, attachments are kept as is
      * @property {String} [meta.disposition] Content-Disposition of the streamed file
      * @property {String} [meta.filename] Filename of the streamed body part
      * @property {ReadableStream} content Streamed content
      */
     /**
-     * Download either full rfc822 formated message or a specific bodystructure part as a Stream.
+     * Download either full rfc822 formatted message or a specific bodystructure part as a Stream.
      * Bodystructure parts are decoded so the resulting stream is a binary file. Text content
      * is automatically converted to UTF-8 charset.
      *
@@ -3062,7 +3093,7 @@ class ImapFlow extends EventEmitter {
 }
 /**
- * Connection close event. **NB!** ImapFlow does not handle reconncts automatically.
+ * Connection close event. **NB!** ImapFlow does not handle reconnects automatically.
  * So whenever a 'close' event occurs you must create a new connection yourself.
  *
  * @event module:imapflow~ImapFlow#close

package/lib/tools.js CHANGED Viewed

@@ -250,7 +250,7 @@ module.exports = {
                 )
                     .toString()
                     .toLowerCase()
-                    .replace(/<\d+>$/, '');
+                    .replace(/<\d+(\.\d+)?>$/, '');
                 continue;
             }
             if (typeof key !== 'string') {

package/lib/types.d.ts CHANGED Viewed

@@ -355,7 +355,7 @@ declare module "imapflow" {
             unchangedSince?: bigint;
         }): Promise<Boolean>;
         /**
-         * Delete messages from currently opened mailbox. Method does not indicate info about deleted messages,
+         * Delete messages from the currently opened mailbox. Method does not indicate info about deleted messages,
          * instead you should be using {@link ImapFlow#expunge} event for this
          * @example
          * let mailbox = await client.mailboxOpen('INBOX');
@@ -410,7 +410,7 @@ declare module "imapflow" {
             uid?: boolean;
         }): Promise<CopyResponseObject>;
         /**
-         * Search messages from currently opened mailbox
+         * Search messages from the currently opened mailbox
          * @example
          * let mailbox = await client.mailboxOpen('INBOX');
          * // find all unseen messages
@@ -431,7 +431,7 @@ declare module "imapflow" {
             uid?: boolean;
         }): Promise<Number[]>;
         /**
-         * Fetch messages from currently opened mailbox
+         * Fetch messages from the currently opened mailbox
          * @example
          * let mailbox = await client.mailboxOpen('INBOX');
          * // fetch UID for all messages in a mailbox
@@ -452,7 +452,32 @@ declare module "imapflow" {
             binary?: boolean;
         }): void;
         /**
-         * Fetch a single message from currently opened mailbox
+         * Fetch messages from the currently opened mailbox.
+         *
+         * This method will fetch all messages before resolving the promise, unlike .fetch(), which
+         * is an async generator. Do not use large ranges like 1:*, as this might exhaust all available
+         * memory if the mailbox contains a large number of emails.
+         * @example
+         * let mailbox = await client.mailboxOpen('INBOX');
+         * // fetch UID for all messages in a mailbox
+         * const messages = await client.fetchAll('1:*', {uid: true});
+         * for (let msg of messages){
+         *     console.log(msg.uid);
+         * }
+         * @param range - Range of messages to fetch
+         * @param query - Fetch query
+         * @param [options.uid] - If `true` then uses UID numbers instead of sequence numbers for `range`
+         * @param [options.changedSince] - If set then only messages with a higher modseq value are returned. Ignored if server does not support `CONDSTORE` extension.
+         * @param [options.binary = false] - If `true` then requests a binary response if the server supports this
+         * @returns Array of Message data object
+         */
+        fetchAll(range: SequenceString | Number[] | SearchObject, query: FetchQueryObject, options?: {
+            uid?: boolean;
+            changedSince?: bigint;
+            binary?: boolean;
+        }): Promise<FetchMessageObject[]>;
+        /**
+         * Fetch a single message from the currently opened mailbox
          * @example
          * let mailbox = await client.mailboxOpen('INBOX');
          * // fetch UID for the last email in the selected mailbox
@@ -469,7 +494,7 @@ declare module "imapflow" {
             binary?: boolean;
         }): Promise<FetchMessageObject>;
         /**
-         * Download either full rfc822 formated message or a specific bodystructure part as a Stream.
+         * Download either full rfc822 formatted message or a specific bodystructure part as a Stream.
          * Bodystructure parts are decoded so the resulting stream is a binary file. Text content
          * is automatically converted to UTF-8 charset.
          * @example
@@ -787,7 +812,7 @@ declare type SequenceString = string;
  * @property [sentSince] - Matches messages sent after date
  * @property [keyword] - Matches messages that have the custom flag set
  * @property [unKeyword] - Matches messages that do not have the custom flag set
- * @property [header] - Mathces messages with header key set if value is `true` (**NB!** not supported by all servers) or messages where header partially matches a string value
+ * @property [header] - Matches messages with header key set if value is `true` (**NB!** not supported by all servers) or messages where header partially matches a string value
  * @property [or] - An array of 2 or more {@link SearchObject} objects. At least on of these must match
  */
 declare type SearchObject = {
@@ -931,7 +956,7 @@ declare type MessageEnvelopeObject = {
  * @property [size] - Expected size of the node
  * @property [envelope] - message envelope of embedded RFC822 message
  * @property [disposition] - Content disposition
- * @property [dispositionParameters] - Additional parameters for Conent-Disposition
+ * @property [dispositionParameters] - Additional parameters for Content-Disposition
  * @property childNodes - An array of child nodes if this is a multipart node. Not present for normal nodes
  */
 declare type MessageStructureObject = {
@@ -987,7 +1012,7 @@ declare type FetchMessageObject = {
  * @property meta - content metadata
  * @property meta.expectedSize - The fetch response size
  * @property meta.contentType - Content-Type of the streamed file. If part was not set then this value is "message/rfc822"
- * @property [meta.charset] - Charset of the body part. Text parts are automaticaly converted to UTF-8, attachments are kept as is
+ * @property [meta.charset] - Charset of the body part. Text parts are automatically converted to UTF-8, attachments are kept as is
  * @property [meta.disposition] - Content-Disposition of the streamed file
  * @property [meta.filename] - Filename of the streamed body part
  * @property content - Streamed content

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
     "name": "imapflow",
-    "version": "1.0.163",
+    "version": "1.0.165",
     "description": "IMAP Client for Node",
     "main": "./lib/imap-flow.js",
     "scripts": {
@@ -28,21 +28,21 @@
     },
     "homepage": "https://imapflow.com/",
     "devDependencies": {
-        "@babel/eslint-parser": "7.24.7",
-        "@babel/eslint-plugin": "7.24.7",
+        "@babel/eslint-parser": "7.25.9",
+        "@babel/eslint-plugin": "7.25.9",
         "@babel/plugin-syntax-class-properties": "7.12.13",
-        "@babel/preset-env": "7.24.7",
-        "@types/node": "20.14.10",
+        "@babel/preset-env": "7.26.0",
+        "@types/node": "22.8.6",
         "eslint": "8.57.0",
         "eslint-config-nodemailer": "1.2.0",
         "eslint-config-prettier": "9.1.0",
         "grunt": "1.6.1",
-        "grunt-cli": "1.4.3",
+        "grunt-cli": "1.5.0",
         "grunt-contrib-nodeunit": "5.0.0",
         "grunt-eslint": "24.3.0",
         "imapflow-jsdoc-template": "3.4.0-imapflow.1",
         "jsdoc": "3.6.11",
-        "st": "3.0.0",
+        "st": "3.0.1",
         "tsd-jsdoc": "2.5.0"
     },
     "dependencies": {
@@ -52,8 +52,8 @@
         "libmime": "5.3.5",
         "libqp": "2.1.0",
         "mailsplit": "5.4.0",
-        "nodemailer": "6.9.14",
-        "pino": "9.2.0",
+        "nodemailer": "6.9.16",
+        "pino": "9.5.0",
         "socks": "2.8.3"
     }
 }

package/test/imap-parser-test.js CHANGED Viewed

@@ -1002,3 +1002,62 @@ module.exports['IMAP Parser, subfolder square bracket'] = test =>
             { type: 'ATOM', value: 'INBOX.[Airmail].Snooze' }
         ]);
     });
+module.exports['IMAP Parser, FETCH with full range'] = test =>
+    asyncWrapper(test, async test => {
+        let parsed = await parser('* 32 FETCH (UID 32 RFC822.SIZE 3991 BODY[2.MIME] "(* 61B literal *)" BODY[2]<0.65536> "(* 6B literal *)")');
+        console.log(JSON.stringify(parsed.attributes));
+        test.deepEqual(parsed.attributes, [
+            {
+                type: 'ATOM',
+                value: 'FETCH'
+            },
+            [
+                {
+                    type: 'ATOM',
+                    value: 'UID'
+                },
+                {
+                    type: 'ATOM',
+                    value: '32'
+                },
+                {
+                    type: 'ATOM',
+                    value: 'RFC822.SIZE'
+                },
+                {
+                    type: 'ATOM',
+                    value: '3991'
+                },
+                {
+                    type: 'ATOM',
+                    value: 'BODY',
+                    section: [
+                        {
+                            type: 'ATOM',
+                            value: '2.MIME'
+                        }
+                    ]
+                },
+                {
+                    type: 'STRING',
+                    value: '(* 61B literal *)'
+                },
+                {
+                    type: 'ATOM',
+                    value: 'BODY',
+                    section: [
+                        {
+                            type: 'ATOM',
+                            value: '2'
+                        }
+                    ],
+                    partial: [0, 65536]
+                },
+                {
+                    type: 'STRING',
+                    value: '(* 6B literal *)'
+                }
+            ]
+        ]);
+    });