@bobfrankston/iflow-direct 0.1.50 → 0.1.51

package/imap-native.js

@@ -132,8 +132,29 @@ export class NativeImapClient {
             }
         });
         this.transport.onError((err) => {
+            // Diagnose transport-level errors fully. Node emits socket errors
+            // with a populated `.message` in normal cases (ECONNRESET, ETIMEDOUT,
+            // etc.) — but TLS-layer errors, abrupt FINs surfaced as errors,
+            // and some wrapper paths produce an Error with empty `.message`
+            // and the useful info on `.code` / `.errno` / `.syscall` instead.
+            // Logging only `.message` left "Transport error: " in the log
+            // with no diagnostic content, which masked why bobma INBOX prefetch
+            // kept dying (2026-05-27). Build a richer description.
+            const errAny = err;
+            const parts = [];
+            if (errAny?.message)
+                parts.push(String(errAny.message));
+            if (errAny?.code)
+                parts.push(`code=${errAny.code}`);
+            if (errAny?.errno !== undefined)
+                parts.push(`errno=${errAny.errno}`);
+            if (errAny?.syscall)
+                parts.push(`syscall=${errAny.syscall}`);
+            const desc = parts.length > 0
+                ? parts.join(" ")
+                : `<no message> ${typeof err} ${err?.constructor?.name || ""}`.trim();
             if (this.verbose)
-                console.error(`  [imap] Transport error: ${err.message}`);
+                console.error(`  [imap] Transport error: ${desc}`);
             // Transport errors (DNS failure, ECONNRESET, TLS failure, etc.) mean
             // the connection is dead — clear the flag so ensureConnected() will
             // reconnect on the next call, and drop the stale IDLE state so we
@@ -149,7 +170,17 @@ export class NativeImapClient {
             if (this.pendingCommand) {
                 const { reject } = this.pendingCommand;
                 this.pendingCommand = null;
-                reject(err);
+                // Make sure the error that propagates to upper-layer catches
+                // (prefetch, sync, etc.) has a non-empty message — wrap if
+                // the underlying err has a blank message.
+                if (err instanceof Error && !err.message) {
+                    const wrapped = new Error(desc);
+                    wrapped.cause = err;
+                    reject(wrapped);
+                }
+                else {
+                    reject(err);
+                }
             }
         });
         await this.transport.connect(this.config.server, this.config.port, useTls, this.config.server);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/iflow-direct",
-  "version": "0.1.50",
+  "version": "0.1.51",
   "description": "Direct IMAP client — transport-agnostic, no Node.js dependencies, browser-ready",
   "main": "index.js",
   "types": "index.ts",