imapflow 2.6.0 → 2.7.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [2.7.0](https://github.com/postalsys/imapflow/compare/v2.6.0...v2.7.0) (2026-10-21)
+
+
+### Features
+
+* expose idlingAtClose so a consumer can tell a session dropped in IDLE ([eb5ac6c](https://github.com/postalsys/imapflow/commit/eb5ac6c5307a735d4f2526c8e8a266e488dbe17f))
+
 ## [2.6.0](https://github.com/postalsys/imapflow/compare/v2.5.9...v2.6.0) (2026-10-21)
 
 

package/README.md

@@ -135,6 +135,7 @@ Besides `mailbox`, `usable`, `authenticated` and `capabilities`, a client expose
 - `client.context` - data of the application's own, never read by ImapFlow. It starts as the `context` option (`new ImapFlow({ ..., context: { account: 'a1' } })`) and can be replaced at any time. Its type is `unknown`, cast it to what you store there.
 - `client.connectedAt` - when the TCP or TLS connection was established, in milliseconds since the epoch, `null` before that.
 - `client.lastClientWrite` - when the client last wrote to the server (a command, a literal, the `DONE` that ends IDLE), in milliseconds since the epoch, `null` before the first write. Useful for staying ahead of server inactivity timers.
+- `client.idlingAtClose` - whether the connection was in IDLE (or the polling fallback) when it closed. `idling` is already cleared when the `close` event fires, so this tells a server dropping an idle session from one dropping a session mid-command.
 - `client.mailboxList` - with `verifyOnly` and `includeMailboxes`, the mailboxes listed before the connection logged out; `undefined` otherwise.
 
 See the [Quick Start guide](https://imapflow.com/docs/getting-started/quick-start) for more examples, including Gmail, Outlook, and Yahoo configuration.

package/dist/cjs/imap-flow.d.ts

@@ -151,6 +151,12 @@ export declare class ImapFlow extends EventEmitter {
      * (RFC 9051 allows 30 minutes), and this is what their timer measures
      */
     lastClientWrite: number | null;
+    /**
+     * Whether the connection was in IDLE (or the polling fallback) when it closed, `false` while it
+     * is open. `idling` itself is already cleared by the time the 'close' event fires, so this is
+     * what tells a server dropping an idle session from one dropping a session mid-command
+     */
+    idlingAtClose: boolean;
     /** Whether log entries are also emitted as 'log' events, see the `emitLogs` option */
     emitLogs: boolean;
     /** Hash algorithm for the fallback message id, see `ImapFlowOptions.idHashAlgorithm` */

package/dist/cjs/imap-flow.js

@@ -302,6 +302,7 @@ class ImapFlow extends node_events_1.EventEmitter {
         this.context = this.options.context;
         this.connectedAt = null;
         this.lastClientWrite = null;
+        this.idlingAtClose = false;
         this.emitLogs = !!this.options.emitLogs;
         this.lo = 0;
         this.untaggedHandlers = {};
@@ -2464,6 +2465,8 @@ class ImapFlow extends node_events_1.EventEmitter {
             // poll or IDLE that unwinds after this point sees that it no longer owns the flag and
             // leaves it alone (see claimIdling() in commands/idle.ts).
             this._idleSession = null;
+            // a later close() finds idling already cleared and keeps what the first one saw
+            this.idlingAtClose = this.idlingAtClose || this.idling;
             this.idling = false;
             this.closeConnectSteps();
             if (typeof this.preCheck === 'function') {

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

@@ -1,3 +1,3 @@
 export declare const name = "imapflow";
-export declare const version = "2.6.0";
+export declare const version = "2.7.0";
 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.6.0";
+exports.version = "2.7.0";
 exports.homepage = "https://imapflow.com/";

package/dist/esm/imap-flow.d.ts

@@ -151,6 +151,12 @@ export declare class ImapFlow extends EventEmitter {
      * (RFC 9051 allows 30 minutes), and this is what their timer measures
      */
     lastClientWrite: number | null;
+    /**
+     * Whether the connection was in IDLE (or the polling fallback) when it closed, `false` while it
+     * is open. `idling` itself is already cleared by the time the 'close' event fires, so this is
+     * what tells a server dropping an idle session from one dropping a session mid-command
+     */
+    idlingAtClose: boolean;
     /** Whether log entries are also emitted as 'log' events, see the `emitLogs` option */
     emitLogs: boolean;
     /** Hash algorithm for the fallback message id, see `ImapFlowOptions.idHashAlgorithm` */

package/dist/esm/imap-flow.js

@@ -259,6 +259,7 @@ export class ImapFlow extends EventEmitter {
         this.context = this.options.context;
         this.connectedAt = null;
         this.lastClientWrite = null;
+        this.idlingAtClose = false;
         this.emitLogs = !!this.options.emitLogs;
         this.lo = 0;
         this.untaggedHandlers = {};
@@ -2421,6 +2422,8 @@ export class ImapFlow extends EventEmitter {
             // poll or IDLE that unwinds after this point sees that it no longer owns the flag and
             // leaves it alone (see claimIdling() in commands/idle.ts).
             this._idleSession = null;
+            // a later close() finds idling already cleared and keeps what the first one saw
+            this.idlingAtClose = this.idlingAtClose || this.idling;
             this.idling = false;
             this.closeConnectSteps();
             if (typeof this.preCheck === 'function') {

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

@@ -1,3 +1,3 @@
 export declare const name = "imapflow";
-export declare const version = "2.6.0";
+export declare const version = "2.7.0";
 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.6.0";
+export const version = "2.7.0";
 export const homepage = "https://imapflow.com/";

package/package.json

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