imapflow 2.0.0 → 2.0.2

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [2.0.2](https://github.com/postalsys/imapflow/compare/v2.0.1...v2.0.2) (2026-09-10)
+
+
+### Bug Fixes
+
+* skip LSUB once a server has rejected ENABLE over the IMAP4rev2 it advertises ([1c4bca2](https://github.com/postalsys/imapflow/commit/1c4bca2349ed05d5cb61a85abb4152630ceb3d73))
+
+## [2.0.1](https://github.com/postalsys/imapflow/compare/v2.0.0...v2.0.1) (2026-09-10)
+
+
+### Bug Fixes
+
+* stop acting on an IMAP4rev2 advertisement once the server rejects ENABLE over it ([227355f](https://github.com/postalsys/imapflow/commit/227355fee56a10913af8feb8e52a74364eb90ca2))
+
 ## [2.0.0](https://github.com/postalsys/imapflow/compare/v1.7.8...v2.0.0) (2026-09-07)
 
 

package/dist/cjs/commands/list.js

@@ -53,8 +53,10 @@ async function list(connection, reference, mailbox, options) {
         // advertisement alone (not hasCapability/isRev2Active): the staged retry below
         // handles servers that advertise but reject RETURN options, so the wider gate
         // is safe for anything it covers, while gates without a retry ladder stay
-        // conservative.
-        let supportsExtendedList = connection.capabilities.has('LIST-EXTENDED') || connection.capabilities.has('IMAP4rev2');
+        // conservative. The rev2 advertisement stops counting once the session has
+        // been told not to act on it (skipRev2), because the ladder costs one rejected
+        // command per stage and a server that has disowned rev2 may not grant that many.
+        let supportsExtendedList = connection.capabilities.has('LIST-EXTENDED') || (connection.capabilities.has('IMAP4rev2') && !connection.skipRev2);
         // RETURN options for the LIST command. Servers occasionally advertise the
         // extensions but still reject RETURN options - the staged retry below then
         // re-runs the LIST with fewer options and latches a skip flag for the option

package/dist/cjs/imap-flow.js

@@ -290,6 +290,7 @@ class ImapFlow extends node_events_1.EventEmitter {
         this.skipListStatusArgs = false;
         this.skipListAuxArgs = false;
         this.skipLsub = false;
+        this.skipRev2 = !!this.options.disableIMAP4rev2;
         // Named error handler for proper cleanup. Certain error codes represent
         // expected socket/network issues (buffer exhaustion, connection reset, broken pipe,
         // timeout, unreachable host) that just need a silent connection close rather
@@ -1190,9 +1191,16 @@ class ImapFlow extends node_events_1.EventEmitter {
     // ENABLE call is used so the enabled set is built in one round trip.
     /** @internal */
     async autoEnable() {
-        let enableList = ['CONDSTORE', 'UTF8=ACCEPT'].concat(this.options.qresync ? 'QRESYNC' : []).concat(this.options.disableIMAP4rev2 ? [] : 'IMAP4rev2');
+        let enableList = ['CONDSTORE', 'UTF8=ACCEPT'].concat(this.options.qresync ? 'QRESYNC' : []).concat(this.skipRev2 ? [] : 'IMAP4rev2');
         let enableResult = await this.run('ENABLE', enableList);
         if (enableResult === false && enableList.includes('IMAP4rev2')) {
+            if (this.capabilities.has('IMAP4rev2') && !(0, tools_js_1.isRev2Active)(this)) {
+                // The one command that would have made this a rev2 session was
+                // rejected, so it stays an IMAP4rev1 session (RFC 9051 Appendix A)
+                // with an advertisement the server does not implement - see skipRev2
+                this.skipRev2 = true;
+                this.skipLsub = true;
+            }
             // RFC 5161 requires servers to ignore unknown ENABLE arguments, but a
             // broken implementation may reject the whole command over IMAP4rev2 -
             // retry without it so CONDSTORE/QRESYNC are not lost as collateral

package/dist/cjs/package-info.d.ts

@@ -1,3 +1,3 @@
 export declare const name = "imapflow";
-export declare const version = "2.0.0";
+export declare const version = "2.0.2";
 export declare const homepage = "https://imapflow.com/";

package/dist/cjs/package-info.js

@@ -3,5 +3,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.homepage = exports.version = exports.name = void 0;
 exports.name = 'imapflow';
-exports.version = '2.0.0';
+exports.version = '2.0.2';
 exports.homepage = 'https://imapflow.com/';

package/dist/cjs/types.d.ts

@@ -97,7 +97,7 @@ export interface ImapFlowOptions {
     disableBinary?: boolean | undefined;
     /** If true, do not enable supported extensions */
     disableAutoEnable?: boolean | undefined;
-    /** If true, do not enable IMAP4rev2 mode even if the server supports it */
+    /** If true, do not enable IMAP4rev2 mode even if the server advertises it, and do not treat the advertisement as support for anything IMAP4rev2 implies, such as the extended LIST syntax */
     disableIMAP4rev2?: boolean | undefined;
     /**
      * How long to wait for a usable transport, covering DNS resolution, proxy negotiation and the

package/dist/esm/commands/list.js

@@ -50,8 +50,10 @@ export default async function list(connection, reference, mailbox, options) {
         // advertisement alone (not hasCapability/isRev2Active): the staged retry below
         // handles servers that advertise but reject RETURN options, so the wider gate
         // is safe for anything it covers, while gates without a retry ladder stay
-        // conservative.
-        let supportsExtendedList = connection.capabilities.has('LIST-EXTENDED') || connection.capabilities.has('IMAP4rev2');
+        // conservative. The rev2 advertisement stops counting once the session has
+        // been told not to act on it (skipRev2), because the ladder costs one rejected
+        // command per stage and a server that has disowned rev2 may not grant that many.
+        let supportsExtendedList = connection.capabilities.has('LIST-EXTENDED') || (connection.capabilities.has('IMAP4rev2') && !connection.skipRev2);
         // RETURN options for the LIST command. Servers occasionally advertise the
         // extensions but still reject RETURN options - the staged retry below then
         // re-runs the LIST with fewer options and latches a skip flag for the option

package/dist/esm/imap-flow.js

@@ -21,7 +21,7 @@ import { proxyConnection, detachEarlyErrorHandler } from './proxy-connection.js'
 import { ConnectionDeadline } from './connection-deadline.js';
 import { AuthenticationFailure } from './errors.js';
 import imapCommands from './imap-commands.js';
-import { comparePaths, updateCapabilities, getFolderTree, formatMessageResponse, getDecoder, packMessageRange, normalizePath, expandRange, getColorFlags, hasCapability, logConnectionError, unrefTimer, clearTimer, parseUintValue, isUnsafeKey, getStringList, buildConnectionError, guardedPromise, guardedReject, MAX_UINT32_DIGITS } from './tools.js';
+import { comparePaths, updateCapabilities, getFolderTree, formatMessageResponse, getDecoder, packMessageRange, normalizePath, expandRange, getColorFlags, hasCapability, isRev2Active, logConnectionError, unrefTimer, clearTimer, parseUintValue, isUnsafeKey, getStringList, buildConnectionError, guardedPromise, guardedReject, MAX_UINT32_DIGITS } from './tools.js';
 export { AuthenticationFailure } from './errors.js';
 const GREETING_TIMEOUT = 16 * 1000;
 const UPGRADE_TIMEOUT = 10 * 1000;
@@ -250,6 +250,7 @@ export class ImapFlow extends EventEmitter {
         this.skipListStatusArgs = false;
         this.skipListAuxArgs = false;
         this.skipLsub = false;
+        this.skipRev2 = !!this.options.disableIMAP4rev2;
         // Named error handler for proper cleanup. Certain error codes represent
         // expected socket/network issues (buffer exhaustion, connection reset, broken pipe,
         // timeout, unreachable host) that just need a silent connection close rather
@@ -1150,9 +1151,16 @@ export class ImapFlow extends EventEmitter {
     // ENABLE call is used so the enabled set is built in one round trip.
     /** @internal */
     async autoEnable() {
-        let enableList = ['CONDSTORE', 'UTF8=ACCEPT'].concat(this.options.qresync ? 'QRESYNC' : []).concat(this.options.disableIMAP4rev2 ? [] : 'IMAP4rev2');
+        let enableList = ['CONDSTORE', 'UTF8=ACCEPT'].concat(this.options.qresync ? 'QRESYNC' : []).concat(this.skipRev2 ? [] : 'IMAP4rev2');
         let enableResult = await this.run('ENABLE', enableList);
         if (enableResult === false && enableList.includes('IMAP4rev2')) {
+            if (this.capabilities.has('IMAP4rev2') && !isRev2Active(this)) {
+                // The one command that would have made this a rev2 session was
+                // rejected, so it stays an IMAP4rev1 session (RFC 9051 Appendix A)
+                // with an advertisement the server does not implement - see skipRev2
+                this.skipRev2 = true;
+                this.skipLsub = true;
+            }
             // RFC 5161 requires servers to ignore unknown ENABLE arguments, but a
             // broken implementation may reject the whole command over IMAP4rev2 -
             // retry without it so CONDSTORE/QRESYNC are not lost as collateral

package/dist/esm/package-info.d.ts

@@ -1,3 +1,3 @@
 export declare const name = "imapflow";
-export declare const version = "2.0.0";
+export declare const version = "2.0.2";
 export declare const homepage = "https://imapflow.com/";

package/dist/esm/package-info.js

@@ -1,4 +1,4 @@
 // Generated by scripts/build.js from package.json. Do not edit by hand.
 export const name = 'imapflow';
-export const version = '2.0.0';
+export const version = '2.0.2';
 export const homepage = 'https://imapflow.com/';

package/dist/esm/types.d.ts

@@ -97,7 +97,7 @@ export interface ImapFlowOptions {
     disableBinary?: boolean | undefined;
     /** If true, do not enable supported extensions */
     disableAutoEnable?: boolean | undefined;
-    /** If true, do not enable IMAP4rev2 mode even if the server supports it */
+    /** If true, do not enable IMAP4rev2 mode even if the server advertises it, and do not treat the advertisement as support for anything IMAP4rev2 implies, such as the extended LIST syntax */
     disableIMAP4rev2?: boolean | undefined;
     /**
      * How long to wait for a usable transport, covering DNS resolution, proxy negotiation and the

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "imapflow",
-    "version": "2.0.0",
+    "version": "2.0.2",
     "description": "IMAP Client for Node",
     "type": "module",
     "main": "./dist/cjs/imap-flow.js",