@bobfrankston/iflow-direct 0.1.52 → 0.1.54

package/imap-native.js

@@ -7,6 +7,13 @@
  * Existing callers are not affected.
  */
 import * as proto from "./imap-protocol.js";
+// Yield the event loop between buffer slices. Node has setImmediate (drains
+// I/O + timers + IPC before resuming); browser / Android (BridgeTransport)
+// runtimes don't, so fall back to a 0 ms timer. Reached via globalThis so this
+// transport-agnostic package needs no node type dependency.
+const yieldToEventLoop = typeof globalThis.setImmediate === "function"
+    ? globalThis.setImmediate
+    : (cb) => { setTimeout(cb, 0); };
 export class NativeImapClient {
     transport;
     transportFactory;
@@ -1208,7 +1215,7 @@ export class NativeImapClient {
         const TIME_BUDGET_MS = 10;
         while (true) {
             if (performance.now() - t0 > TIME_BUDGET_MS) {
-                setImmediate(() => this.processBuffer());
+                yieldToEventLoop(() => this.processBuffer());
                 return;
             }
             // Check for literal — `{N}` announces N octets of arbitrary data
@@ -1237,6 +1244,23 @@ export class NativeImapClient {
                 // decode happens once per literal, not once per chunk that
                 // arrives during the literal's transit.
                 let literal = this.utf8Decoder.decode(literalBytes);
+                // DESYNC CAPTURE (Bob 2026-06-16, overnight debug). A BODY[]
+                // literal whose content is itself an IMAP command tag means the
+                // byte-buffer parser misaligned: the declared {N} didn't match
+                // reality and we swallowed a later command's bytes. Dump the
+                // declared size + the misaligned content + the raw bytes that
+                // PRECEDED the literal, so the mechanism (how the {N} boundary
+                // slipped) is finally visible. Cheap; only fires on the desync.
+                if (this.pendingCommand.currentLiteralKey?.startsWith("BODY")
+                    && /^[A-Za-z]+\d+\s+(SELECT|FETCH|UID|LOGIN|STATUS|EXAMINE|LIST|IDLE|NOOP|STORE|SEARCH|CAPABILITY|CLOSE|LOGOUT|APPEND|COPY|MOVE|EXPUNGE|CREATE|DELETE|RENAME|SUBSCRIBE|ENABLE|STARTTLS)\b/i.test(literal.slice(0, 80).replace(/^[\s*]+/, ""))) {
+                    const litStart = this.bufferOffset - neededBytes;
+                    const ctxStart = Math.max(0, litStart - 256);
+                    const ctx = this.buffer.subarray(ctxStart, litStart);
+                    const ascii = Array.from(ctx).map(b => (b >= 32 && b < 127) ? String.fromCharCode(b) : (b === 13 ? "\\r" : b === 10 ? "\\n" : ".")).join("");
+                    console.error(`  [imap] DESYNC CAPTURE key=${this.pendingCommand.currentLiteralKey} declaredLiteral=${neededBytes}B bufferOffset=${this.bufferOffset} bufferLength=${this.bufferLength} litStart=${litStart}`);
+                    console.error(`  [imap] DESYNC literal[0..200]=${JSON.stringify(literal.slice(0, 200))}`);
+                    console.error(`  [imap] DESYNC preceding[${ctx.length}B]=${JSON.stringify(ascii)}`);
+                }
                 // For non-BODY literals (e.g. display names in ENVELOPE), wrap in quotes
                 // so tokenizeParenList treats them as a single token
                 if (!this.pendingCommand.currentLiteralKey) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/iflow-direct",
-  "version": "0.1.52",
+  "version": "0.1.54",
   "description": "Direct IMAP client — transport-agnostic, no Node.js dependencies, browser-ready",
   "main": "index.js",
   "types": "index.ts",
@@ -19,7 +19,7 @@
   "author": "Bob Frankston",
   "license": "ISC",
   "dependencies": {
-    "@bobfrankston/tcp-transport": "^0.1.6"
+    "@bobfrankston/tcp-transport": "^0.1.7"
   },
   "exports": {
     ".": {
@@ -50,7 +50,7 @@
   },
   ".transformedSnapshot": {
     "dependencies": {
-      "@bobfrankston/tcp-transport": "^0.1.6"
+      "@bobfrankston/tcp-transport": "^0.1.7"
     }
   }
 }