imapflow 2.0.6 → 2.0.8

package/dist/esm/commands/fetch.js

@@ -1,4 +1,4 @@
-import { formatMessageResponse, isRev2Active } from '../tools.js';
+import { formatMessageResponse, isRev2Active, getSelectedMailbox } from '../tools.js';
 /**
  * Fetches emails from the server.
  *
@@ -9,23 +9,23 @@ import { formatMessageResponse, isRev2Active } from '../tools.js';
  * @returns Object with message count and list, or undefined if not in SELECTED state
  */
 export default async function fetch(connection, range, query, options) {
-    if (connection.state !== connection.states.SELECTED || !range) {
+    let mailbox = getSelectedMailbox(connection);
+    if (!mailbox || !range) {
         // nothing to do here
         return;
     }
     options = options || {};
-    let mailbox = connection.mailbox;
     // Use BINARY extension for fetching if supported and requested, otherwise fall back to BODY.
     // RFC 9051 folds the FETCH side of the BINARY extension into base IMAP4rev2, so an active
     // rev2 session can use it even without the BINARY capability token (the APPEND side is NOT
     // folded in and stays gated on the token in append.ts)
     const canUseBinary = connection.capabilities.has('BINARY') || isRev2Active(connection);
     const commandKey = canUseBinary && options.binary && !connection.disableBinary ? 'BINARY' : 'BODY';
-    // Retry logic for ETHROTTLE errors (server rate limiting) with exponential backoff
-    let retryCount = 0;
+    // Retry logic for ETHROTTLE errors (server rate limiting) with exponential backoff.
+    // Every pass returns or throws: the last throttled attempt throws instead of retrying.
     const maxRetries = 4;
     const baseDelay = 1000; // Start with 1 second delay
-    while (retryCount < maxRetries) {
+    for (let retryCount = 0;; retryCount++) {
         let messages = {
             count: 0,
             list: []
@@ -202,15 +202,18 @@ export default async function fetch(connection, range, query, options) {
             return messages;
         }
         catch (err) {
-            if (err.code === 'ETHROTTLE') {
+            // The last throttled attempt falls through and throws, so running out of retries
+            // is never mistaken for an empty result
+            if (err.code === 'ETHROTTLE' && retryCount < maxRetries - 1) {
                 // Server returned a throttle error (rate limiting). Retry with exponential backoff.
-                // Delay doubles each retry: 1s, 2s, 4s, 8s (capped at 30s).
+                // Delay doubles each retry: 1s, 2s, 4s.
                 // If server provides a throttleReset hint, use that if longer.
                 const backoffDelay = Math.min(baseDelay * Math.pow(2, retryCount), 30000); // Cap at 30 seconds
                 // Use throttle reset time if provided and longer than backoff. The hint is
                 // server-controlled, so the wait goes through connection.throttleWait(), which caps
-                // it and keeps the timer tracked and abortable.
-                const delay = err.throttleReset && err.throttleReset > backoffDelay ? err.throttleReset : backoffDelay;
+                // it and keeps the timer tracked and abortable. The connection already waited
+                // part of the back-off before rejecting (throttleWaited), so only the rest is left.
+                const delay = Math.max(err.throttleReset || 0, backoffDelay) - (err.throttleWaited || 0);
                 connection.log.warn({
                     msg: 'Retrying throttled request with exponential backoff',
                     cid: connection.id,
@@ -226,7 +229,6 @@ export default async function fetch(connection, range, query, options) {
                 if (aborted) {
                     throw connection.createNoConnectionError(connection.byeReason, { rejectedFrom: 'throttleAbort', command: 'FETCH' });
                 }
-                retryCount++;
                 continue;
             }
             connection.log.warn({ err, cid: connection.id });

package/dist/esm/commands/idle.js

@@ -1,4 +1,4 @@
-import { guardedPromise, hasCapability, logConnectionError, restampConnectionError, unrefTimer, clearTimer } from '../tools.js';
+import { guardedPromise, hasCapability, logConnectionError, restampConnectionError, unrefTimer, clearTimer, getSelectedMailbox } from '../tools.js';
 const NOOP_INTERVAL = 2 * 60 * 1000;
 /**
  * Marks the connection as idling on behalf of one session and returns a release function.
@@ -121,7 +121,11 @@ async function runIdle(connection) {
     }
     catch (err) {
         logConnectionError(connection, 'IDLE session failed', err);
-        if (preCheckWaitQueue.length) {
+        // A tagged NO or BAD only means the server refused IDLE; the connection is still usable,
+        // so the waiters are released by the finally block below and their own commands run.
+        // Anything else (close, lost socket, parser failure) fails the waiters too.
+        let refusedByServer = ['NO', 'BAD'].includes(err.responseStatus);
+        if (preCheckWaitQueue.length && !refusedByServer) {
             // One error for the whole queue: every waiter failed at the same site, for the same
             // reason. Built inside the guard so a teardown with nothing queued - the common case -
             // does not pay for an Error and its stack capture.
@@ -237,7 +241,7 @@ async function runPollingFallback(connection, maxIdleTime) {
                     return;
                 }
                 // The transport or the mailbox may be gone by the time the timer fires
-                if (!connection.socket || connection.socket.destroyed || connection.state !== connection.states.SELECTED || !connection.mailbox) {
+                if (!connection.socket || connection.socket.destroyed || !getSelectedMailbox(connection)) {
                     return cancel();
                 }
                 pollOnce(connection, session)

package/dist/esm/commands/list.js

@@ -181,7 +181,7 @@ export default async function list(connection, reference, mailbox, options) {
                             entry.path = entry.path.slice(1);
                         }
                         // Build parent path hierarchy for tree construction and sorting
-                        entry.parentPath = entry.delimiter && entry.path ? entry.path.substr(0, entry.path.lastIndexOf(entry.delimiter)) : '';
+                        entry.parentPath = entry.delimiter && entry.path ? entry.path.substring(0, entry.path.lastIndexOf(entry.delimiter)) : '';
                         entry.parent = entry.delimiter ? entry.path.split(entry.delimiter) : [entry.path];
                         entry.name = entry.parent.pop();
                         // Try to detect special-use from server flags or well-known names
@@ -392,7 +392,7 @@ export default async function list(connection, reference, mailbox, options) {
                         if (entry.delimiter && entry.path.charAt(0) === entry.delimiter) {
                             entry.path = entry.path.slice(1);
                         }
-                        entry.parentPath = entry.delimiter && entry.path ? entry.path.substr(0, entry.path.lastIndexOf(entry.delimiter)) : '';
+                        entry.parentPath = entry.delimiter && entry.path ? entry.path.substring(0, entry.path.lastIndexOf(entry.delimiter)) : '';
                         entry.parent = entry.delimiter ? entry.path.split(entry.delimiter) : [entry.path];
                         entry.name = entry.parent.pop();
                         // Merge LSUB data into existing LIST entry if found

package/dist/esm/commands/move.js

@@ -1,4 +1,4 @@
-import { normalizePath, encodePath, enhanceCommandError, hasCapability } from '../tools.js';
+import { normalizePath, encodePath, hasCapability, reportCommandError, getSelectedMailbox } from '../tools.js';
 import { parseCopyUid } from './copyuid-parser.js';
 /**
  * Moves messages from the current mailbox to another mailbox.
@@ -11,7 +11,8 @@ import { parseCopyUid } from './copyuid-parser.js';
  * @returns Move result with UID mapping if available, false on failure, or undefined if preconditions not met
  */
 export default async function move(connection, range, destination, options) {
-    if (connection.state !== connection.states.SELECTED || !range || !destination) {
+    let mailbox = getSelectedMailbox(connection);
+    if (!mailbox || !range || !destination) {
         // nothing to do here
         return;
     }
@@ -21,13 +22,18 @@ export default async function move(connection, range, destination, options) {
         { type: 'SEQUENCE', value: range },
         { type: 'ATOM', value: encodePath(connection, destination) }
     ];
-    let map = { path: connection.mailbox.path, destination };
+    let map = { path: mailbox.path, destination };
     // Fallback for servers without the MOVE extension (RFC 6851):
     // emulate MOVE using COPY + flag as \Deleted + EXPUNGE.
     if (!hasCapability(connection, 'MOVE')) {
         let result = await connection.messageCopy(range, destination, options);
-        await connection.messageDelete(range, Object.assign({ silent: true }, options));
-        return result;
+        if (!result) {
+            // The source must stay untouched when the copy failed, otherwise the messages are lost
+            return result;
+        }
+        let deleted = await connection.messageDelete(range, Object.assign({ silent: true }, options));
+        // Messages that were copied but not removed from the source mean the move did not complete
+        return deleted ? result : false;
     }
     let response;
     try {
@@ -45,8 +51,7 @@ export default async function move(connection, range, destination, options) {
         return map;
     }
     catch (err) {
-        await enhanceCommandError(err);
-        connection.log.warn({ err, cid: connection.id });
+        await reportCommandError(connection, err);
         return false;
     }
 }

package/dist/esm/commands/namespace.js

@@ -1,4 +1,4 @@
-import { hasCapability, getStringList } from '../tools.js';
+import { hasCapability, getStringList, isAuthenticatedState } from '../tools.js';
 /**
  * Requests NAMESPACE info from the server.
  *
@@ -6,7 +6,7 @@ import { hasCapability, getStringList } from '../tools.js';
  * @returns The primary personal namespace, or an error object on failure
  */
 export default async function namespace(connection) {
-    if (![connection.states.AUTHENTICATED, connection.states.SELECTED].includes(connection.state)) {
+    if (!isAuthenticatedState(connection)) {
         // nothing to do here
         return;
     }

package/dist/esm/commands/quota.js

@@ -1,4 +1,4 @@
-import { encodePath, normalizePath, enhanceCommandError, parseUintValue, isUnsafeKey } from '../tools.js';
+import { encodePath, normalizePath, parseUintValue, isUnsafeKey, isAuthenticatedState, reportCommandError } from '../tools.js';
 /**
  * Requests quota information for a mailbox.
  *
@@ -7,7 +7,7 @@ import { encodePath, normalizePath, enhanceCommandError, parseUintValue, isUnsaf
  * @returns Quota information object, false if QUOTA not supported or on failure, or undefined if preconditions not met
  */
 export default async function quota(connection, path) {
-    if (![connection.states.AUTHENTICATED, connection.states.SELECTED].includes(connection.state) || !path) {
+    if (!isAuthenticatedState(connection) || !path) {
         // nothing to do here
         return;
     }
@@ -47,19 +47,21 @@ export default async function quota(connection, path) {
             if (isUnsafeKey(key) || key === 'path' || key === 'quotaroot') {
                 return;
             }
-            if (!map[key]) {
-                map[key] = {};
+            let resource = map[key];
+            if (typeof resource !== 'object') {
+                resource = {};
+                map[key] = resource;
             }
             // Storage quota is reported in KB by IMAP; convert to bytes for consistency
             const multiplier = key === 'storage' ? 1024 : 1;
             if (position === 1) {
-                map[key].usage = value * multiplier;
+                resource.usage = value * multiplier;
             }
             else if (position === 2) {
-                map[key].limit = value * multiplier;
+                resource.limit = value * multiplier;
                 // Calculate usage percentage for convenient display
-                if (map[key].limit) {
-                    map[key].status = Math.round(((map[key].usage || 0) / map[key].limit) * 100) + '%';
+                if (resource.limit) {
+                    resource.status = Math.round(((resource.usage || 0) / resource.limit) * 100) + '%';
                 }
             }
         });
@@ -107,8 +109,7 @@ export default async function quota(connection, path) {
         return map;
     }
     catch (err) {
-        await enhanceCommandError(err);
-        connection.log.warn({ err, cid: connection.id });
+        await reportCommandError(connection, err);
         return false;
     }
 }

package/dist/esm/commands/rename.js

@@ -1,4 +1,4 @@
-import { encodePath, normalizePath, enhanceCommandError } from '../tools.js';
+import { encodePath, normalizePath, isAuthenticatedState, reportCommandError, getSelectedMailbox } from '../tools.js';
 /**
  * Renames an existing mailbox.
  *
@@ -9,7 +9,7 @@ import { encodePath, normalizePath, enhanceCommandError } from '../tools.js';
  * @throws If the RENAME command fails
  */
 export default async function rename(connection, path, newPath) {
-    if (![connection.states.AUTHENTICATED, connection.states.SELECTED].includes(connection.state)) {
+    if (!isAuthenticatedState(connection)) {
         // nothing to do here
         return;
     }
@@ -19,7 +19,8 @@ export default async function rename(connection, path, newPath) {
     newPath = normalizePath(connection, newPath);
     // Must close/deselect the mailbox before renaming if it's currently selected,
     // as IMAP servers will not rename an active mailbox.
-    if (connection.state === connection.states.SELECTED && connection.mailbox.path === path) {
+    let selected = getSelectedMailbox(connection);
+    if (selected && selected.path === path) {
         await connection.run('CLOSE');
     }
     let response;
@@ -36,8 +37,7 @@ export default async function rename(connection, path, newPath) {
         return map;
     }
     catch (err) {
-        await enhanceCommandError(err);
-        connection.log.warn({ err, cid: connection.id });
+        await reportCommandError(connection, err);
         throw err;
     }
 }

package/dist/esm/commands/search.js

@@ -1,4 +1,4 @@
-import { enhanceCommandError, hasCapability, isValidSequenceValue, EXPANDED_RANGE_LIMIT } from '../tools.js';
+import { hasCapability, isValidSequenceValue, EXPANDED_RANGE_LIMIT, reportCommandError, getSelectedMailbox } from '../tools.js';
 import { searchCompiler } from '../search-compiler.js';
 import { parseEsearchResponse } from './esearch-parser.js';
 /**
@@ -31,7 +31,8 @@ const stripEsearchPrefix = (attrs) => {
  *   When server lacks ESEARCH, falls back to plain SEARCH and returns number[].
  */
 export default async function search(connection, query, options) {
-    if (connection.state !== connection.states.SELECTED) {
+    const mailbox = getSelectedMailbox(connection);
+    if (!mailbox) {
         // nothing to do here
         return false;
     }
@@ -89,8 +90,7 @@ export default async function search(connection, query, options) {
                 return esearchResult;
             }
             catch (err) {
-                await enhanceCommandError(err);
-                connection.log.warn({ err, cid: connection.id });
+                await reportCommandError(connection, err);
                 return false;
             }
         }
@@ -160,7 +160,7 @@ export default async function search(connection, query, options) {
                         // for message sequence numbers, while server-sent UID sets may
                         // not contain '*' at all (RFC 9051 section 4.1.1), so UID
                         // parts with '*' are dropped
-                        let existsCount = () => (connection.mailbox && connection.mailbox.exists) || 0;
+                        let existsCount = () => mailbox.exists || 0;
                         // The mailbox EXISTS count is itself server-supplied and can be
                         // absurdly large, so the budget is additionally capped at the same
                         // absolute ceiling expandRange() uses - a hostile server cannot
@@ -185,8 +185,8 @@ export default async function search(connection, query, options) {
                                 results.add(value);
                                 continue;
                             }
-                            let first = resolveId(part.substr(0, colon));
-                            let second = resolveId(part.substr(colon + 1));
+                            let first = resolveId(part.substring(0, colon));
+                            let second = resolveId(part.slice(colon + 1));
                             if (!isValidSequenceValue(first) || !isValidSequenceValue(second)) {
                                 discarded = true;
                                 continue;
@@ -216,8 +216,7 @@ export default async function search(connection, query, options) {
         return Array.from(results).sort((a, b) => a - b);
     }
     catch (err) {
-        await enhanceCommandError(err);
-        connection.log.warn({ err, cid: connection.id });
+        await reportCommandError(connection, err);
         return false;
     }
 }

package/dist/esm/commands/select.js

@@ -1,4 +1,4 @@
-import { encodePath, normalizePath, enhanceCommandError, parseBigIntValue, parseUintValue, getStringList, MAX_UINT32_DIGITS } from '../tools.js';
+import { encodePath, normalizePath, parseBigIntValue, parseUintValue, getStringList, MAX_UINT32_DIGITS, emitSafe, isAuthenticatedState, reportCommandError } from '../tools.js';
 // Response codes carrying a value that SELECT/EXAMINE may write to the mailbox object, keyed by
 // the lowercased code, mapped to the fixed public property name and the parser for the value.
 // Every parser returns false for a value it cannot use, and the field is then left unset.
@@ -56,7 +56,7 @@ const VALUED_RESPONSE_CODES = Object.assign(Object.create(null), {
  * @throws If the SELECT/EXAMINE command fails
  */
 export default async function select(connection, pathInput, options) {
-    if (![connection.states.AUTHENTICATED, connection.states.SELECTED].includes(connection.state)) {
+    if (!isAuthenticatedState(connection)) {
         // nothing to do here
         return;
     }
@@ -212,7 +212,7 @@ export default async function select(connection, pathInput, options) {
         // Emit mailboxClose if we're switching from a different mailbox.
         // Re-selecting the same mailbox (e.g., for resync) does not trigger close/open.
         if (currentMailbox && currentMailbox.path !== path) {
-            connection.emit('mailboxClose', currentMailbox);
+            emitSafe(connection, 'mailboxClose', currentMailbox);
         }
         connection.mailbox = map;
         // Save the SELECT command for potential re-use (e.g., NOOP fallback polling
@@ -220,13 +220,13 @@ export default async function select(connection, pathInput, options) {
         connection.currentSelectCommand = selectCommand;
         connection.state = connection.states.SELECTED;
         if (!currentMailbox || currentMailbox.path !== path) {
-            connection.emit('mailboxOpen', connection.mailbox);
+            emitSafe(connection, 'mailboxOpen', connection.mailbox);
         }
         response.next();
         return map;
     }
     catch (err) {
-        await enhanceCommandError(err);
+        await reportCommandError(connection, err);
         // If SELECT/EXAMINE fails while a mailbox was already selected, we must
         // reset to AUTHENTICATED state since the server has implicitly deselected
         // the previous mailbox on failure (RFC 3501 Section 6.3.1).
@@ -236,10 +236,9 @@ export default async function select(connection, pathInput, options) {
             connection.currentSelectCommand = false;
             connection.state = connection.states.AUTHENTICATED;
             if (currentMailbox) {
-                connection.emit('mailboxClose', currentMailbox);
+                emitSafe(connection, 'mailboxClose', currentMailbox);
             }
         }
-        connection.log.warn({ err, cid: connection.id });
         throw err;
     }
 }

package/dist/esm/commands/status.js

@@ -1,21 +1,20 @@
-import { encodePath, normalizePath, buildStatusQueryAttributes, isRev2Active } from '../tools.js';
+import { encodePath, normalizePath, buildStatusQueryAttributes, isRev2Active, isAuthenticatedState, emitSafe, getSelectedMailbox } from '../tools.js';
 import { parseStatusList } from './status-fields.js';
 // STATUS fields that also refresh the live mailbox state when the queried mailbox is the
 // currently selected one. Keyed by the output property name parseStatusList() reports.
 const MAILBOX_UPDATERS = {
-    messages: (value, connection, path) => {
-        let mailbox = connection.mailbox;
+    messages: (value, mailbox, connection, path) => {
         let prevCount = mailbox.exists;
         if (prevCount !== value) {
             mailbox.exists = value;
-            connection.emit('exists', { path, count: value, prevCount });
+            emitSafe(connection, 'exists', { path, count: value, prevCount });
         }
     },
-    uidNext: (value, connection) => {
-        connection.mailbox.uidNext = value;
+    uidNext: (value, mailbox) => {
+        mailbox.uidNext = value;
     },
-    highestModseq: (value, connection) => {
-        connection.mailbox.highestModseq = value;
+    highestModseq: (value, mailbox) => {
+        mailbox.highestModseq = value;
     }
 };
 /**
@@ -28,7 +27,7 @@ const MAILBOX_UPDATERS = {
  * @throws {Error} If the mailbox does not exist
  */
 export default async function status(connection, path, query) {
-    if (![connection.states.AUTHENTICATED, connection.states.SELECTED].includes(connection.state) || !path) {
+    if (!isAuthenticatedState(connection) || !path) {
         // nothing to do here
         return false;
     }
@@ -59,7 +58,8 @@ export default async function status(connection, path, query) {
                 STATUS: async (untagged) => {
                     // If querying the currently selected mailbox, also update the
                     // connection's live mailbox state and emit events for changes.
-                    let updateCurrent = connection.state === connection.states.SELECTED && path === connection.mailbox.path;
+                    let selected = getSelectedMailbox(connection);
+                    let currentMailbox = selected && selected.path === path ? selected : false;
                     let list = untagged.attributes && Array.isArray(untagged.attributes[1]) ? untagged.attributes[1] : false;
                     if (!list) {
                         return;
@@ -67,8 +67,8 @@ export default async function status(connection, path, query) {
                     parseStatusList(list, (key, value) => {
                         map[key] = value;
                         let updater = MAILBOX_UPDATERS[key];
-                        if (updateCurrent && updater) {
-                            updater(value, connection, path);
+                        if (currentMailbox && updater) {
+                            updater(value, currentMailbox, connection, path);
                         }
                     });
                 }

package/dist/esm/commands/store.js

@@ -1,4 +1,4 @@
-import { formatFlag, canUseFlag, enhanceCommandError } from '../tools.js';
+import { formatFlag, canUseFlag, reportCommandError, getSelectedMailbox } from '../tools.js';
 /**
  * Updates flags or labels for messages in the selected mailbox.
  *
@@ -9,7 +9,8 @@ import { formatFlag, canUseFlag, enhanceCommandError } from '../tools.js';
  * @returns True on success, false on failure or if nothing to do
  */
 export default async function store(connection, range, flags, options) {
-    if (connection.state !== connection.states.SELECTED || !range || (options.useLabels && !connection.capabilities.has('X-GM-EXT-1'))) {
+    let mailbox = getSelectedMailbox(connection);
+    if (!mailbox || !range || (options.useLabels && !connection.capabilities.has('X-GM-EXT-1'))) {
         // nothing to do here
         return false;
     }
@@ -45,7 +46,7 @@ export default async function store(connection, range, flags, options) {
     flags = (Array.isArray(flags) ? flags : [].concat(flags || []))
         .map(flag => {
         let formatted = formatFlag(flag);
-        if (!canUseFlag(connection.mailbox, formatted) && options.operation !== 'remove') {
+        if (!canUseFlag(mailbox, formatted) && options.operation !== 'remove') {
             return false;
         }
         return formatted;
@@ -62,7 +63,7 @@ export default async function store(connection, range, flags, options) {
     ];
     // CONDSTORE (RFC 7162): UNCHANGEDSINCE modifier prevents updating messages whose
     // mod-sequence is higher than the specified value, avoiding overwriting concurrent changes.
-    if (options.unchangedSince && connection.enabled.has('CONDSTORE') && !connection.mailbox.noModseq) {
+    if (options.unchangedSince && connection.enabled.has('CONDSTORE') && !mailbox.noModseq) {
         attributes.push([
             {
                 type: 'ATOM',
@@ -81,8 +82,7 @@ export default async function store(connection, range, flags, options) {
         return true;
     }
     catch (err) {
-        await enhanceCommandError(err);
-        connection.log.warn({ err, cid: connection.id });
+        await reportCommandError(connection, err);
         return false;
     }
 }

package/dist/esm/commands/subscribe.js

@@ -1,4 +1,4 @@
-import { encodePath, normalizePath, enhanceCommandError } from '../tools.js';
+import { setSubscription } from './subscription.js';
 /**
  * Subscribes to a mailbox.
  *
@@ -7,20 +7,5 @@ import { encodePath, normalizePath, enhanceCommandError } from '../tools.js';
  * @returns True on success, false on failure, or undefined if preconditions not met
  */
 export default async function subscribe(connection, path) {
-    if (![connection.states.AUTHENTICATED, connection.states.SELECTED].includes(connection.state)) {
-        // nothing to do here
-        return;
-    }
-    path = normalizePath(connection, path);
-    let response;
-    try {
-        response = await connection.exec('SUBSCRIBE', [{ type: 'ATOM', value: encodePath(connection, path) }]);
-        response.next();
-        return true;
-    }
-    catch (err) {
-        await enhanceCommandError(err);
-        connection.log.warn({ err, cid: connection.id });
-        return false;
-    }
+    return await setSubscription(connection, 'SUBSCRIBE', path);
 }

package/dist/esm/commands/subscription.d.ts

@@ -0,0 +1,10 @@
+import type { ImapFlow } from '../imap-flow.js';
+/**
+ * Runs SUBSCRIBE or UNSUBSCRIBE for a mailbox, the shared body of the two commands.
+ *
+ * @param connection - IMAP connection instance
+ * @param command - SUBSCRIBE or UNSUBSCRIBE
+ * @param path - Mailbox path
+ * @returns True on success, false on failure, or undefined if preconditions not met
+ */
+export declare function setSubscription(connection: ImapFlow, command: 'SUBSCRIBE' | 'UNSUBSCRIBE', path: string | string[]): Promise<boolean | undefined>;

package/dist/esm/commands/subscription.js

@@ -0,0 +1,26 @@
+import { encodePath, normalizePath, isAuthenticatedState, reportCommandError } from '../tools.js';
+/**
+ * Runs SUBSCRIBE or UNSUBSCRIBE for a mailbox, the shared body of the two commands.
+ *
+ * @param connection - IMAP connection instance
+ * @param command - SUBSCRIBE or UNSUBSCRIBE
+ * @param path - Mailbox path
+ * @returns True on success, false on failure, or undefined if preconditions not met
+ */
+export async function setSubscription(connection, command, path) {
+    if (!isAuthenticatedState(connection)) {
+        // nothing to do here
+        return;
+    }
+    path = normalizePath(connection, path);
+    let response;
+    try {
+        response = await connection.exec(command, [{ type: 'ATOM', value: encodePath(connection, path) }]);
+        response.next();
+        return true;
+    }
+    catch (err) {
+        await reportCommandError(connection, err);
+        return false;
+    }
+}

package/dist/esm/commands/unsubscribe.js

@@ -1,4 +1,4 @@
-import { encodePath, normalizePath, enhanceCommandError } from '../tools.js';
+import { setSubscription } from './subscription.js';
 /**
  * Unsubscribes from a mailbox.
  *
@@ -7,20 +7,5 @@ import { encodePath, normalizePath, enhanceCommandError } from '../tools.js';
  * @returns True on success, false on failure, or undefined if preconditions not met
  */
 export default async function unsubscribe(connection, path) {
-    if (![connection.states.AUTHENTICATED, connection.states.SELECTED].includes(connection.state)) {
-        // nothing to do here
-        return;
-    }
-    path = normalizePath(connection, path);
-    let response;
-    try {
-        response = await connection.exec('UNSUBSCRIBE', [{ type: 'ATOM', value: encodePath(connection, path) }]);
-        response.next();
-        return true;
-    }
-    catch (err) {
-        await enhanceCommandError(err);
-        connection.log.warn({ err, cid: connection.id });
-        return false;
-    }
+    return await setSubscription(connection, 'UNSUBSCRIBE', path);
 }

package/dist/esm/download.d.ts

@@ -0,0 +1,22 @@
+import type { ImapFlow } from './imap-flow.js';
+import type { DownloadManyOptions, DownloadManyResult, DownloadNotFound, DownloadObject, DownloadOptions, SequenceString } from './types.js';
+/**
+ * Implements ImapFlow.download(), see its documentation
+ *
+ * @param client - Connection to download from
+ * @param range - UID or sequence number of the message
+ * @param part - Body part to download, the whole message when not set
+ * @param options - Download options
+ * @returns The download, or an empty object when there is nothing to download
+ */
+export declare function downloadMessage(client: ImapFlow, range: SequenceString, part?: string | undefined, options?: DownloadOptions | undefined): Promise<DownloadObject | DownloadNotFound>;
+/**
+ * Implements ImapFlow.downloadMany(), see its documentation
+ *
+ * @param client - Connection to download from
+ * @param range - UID or sequence number of the message
+ * @param parts - Body parts to download
+ * @param options - Download options
+ * @returns Downloaded parts keyed by part number
+ */
+export declare function downloadMessageParts(client: ImapFlow, range: SequenceString, parts: string[], options?: DownloadManyOptions | undefined): Promise<DownloadManyResult>;