@bobfrankston/iflow-direct 0.1.56 → 0.1.58

package/README.md

@@ -11,19 +11,25 @@ and the desktop/browser architecture diagram.
 
 ```bash
 npm install @bobfrankston/iflow-direct
-# desktop TCP transport:
-npm install @bobfrankston/tcp-transport
+# desktop (Node) TCP transport implementation:
+npm install @bobfrankston/node-tcp-transport
 ```
 
-## Quick start (desktop)
+`@bobfrankston/tcp-transport` is the *interface* package (`TcpTransport` is a
+type, plus the browser/Android `BridgeTcpTransport`); the class you instantiate
+in Node is `NodeTcpTransport` from `@bobfrankston/node-tcp-transport`
+(node:net/tls). `@bobfrankston/iflow-node` is a back-compat shim re-exporting
+it as `NodeTransport` — new code should not use it.
+
+## Quick start (Node)
 
 ```typescript
 import { NativeImapClient } from "@bobfrankston/iflow-direct";
-import { TcpTransport } from "@bobfrankston/tcp-transport";
+import { NodeTcpTransport } from "@bobfrankston/node-tcp-transport";
 
 const client = new NativeImapClient(
     { server: "imap.example.com", port: 993, username: "me", password: "..." },
-    () => new TcpTransport(),
+    () => new NodeTcpTransport(),
 );
 await client.connect();
 await client.select("INBOX");
@@ -31,6 +37,23 @@ const msgs = await client.fetchMessages("1:50", { source: false });
 await client.logout();
 ```
 
+For OAuth (Gmail, Office 365), omit `password` and supply a `tokenProvider` —
+an async function returning a current access token; the client calls it at
+authentication time, so refresh logic lives in the provider:
+
+```typescript
+const client = new NativeImapClient(
+    {
+        server: "imap.gmail.com", port: 993, username: "me@gmail.com",
+        tokenProvider: async () => myOauth.getFreshAccessToken(),
+    },
+    () => new NodeTcpTransport(),
+);
+```
+
+(mailx pairs this with `@bobfrankston/oauthsupport`, but any source of a valid
+token works.)
+
 For the legacy API shape (`getFolderList`, etc.) use `CompatImapClient` from the
 same package.
 

package/imap-native.js

@@ -588,13 +588,19 @@ export class NativeImapClient {
         }
         const allMessages = [];
         let chunkSize = this.fetchChunkSize;
-        for (let i = 0; i < uids.length; i += chunkSize) {
+        // Advance by the chunk ACTUALLY fetched, then grow. The old
+        // `i += chunkSize` used the post-growth size, so after chunk 1
+        // (say 25 UIDs) the index jumped 100 — UIDs 25..99 were silently
+        // skipped on every multi-chunk fetch (imail "skips some letters",
+        // Bob 2026-07-17; mailx relied on set-diff sweeps to mop up).
+        for (let i = 0; i < uids.length;) {
             const chunk = uids.slice(i, i + chunkSize);
             const msgs = await this.fetchMessages(chunk.join(","), options);
             allMessages.push(...msgs);
             // console.log(`  [fetch] ${allMessages.length}/${uids.length} (chunk of ${chunk.length})`);
             if (onChunk)
                 onChunk(msgs);
+            i += chunk.length;
             if (chunkSize < this.fetchChunkSizeMax)
                 chunkSize = Math.min(chunkSize * 4, this.fetchChunkSizeMax);
         }
@@ -622,7 +628,9 @@ export class NativeImapClient {
         const allMessages = [];
         let chunkSize = this.fetchChunkSize;
         let chunkIndex = 0;
-        for (let i = 0; i < uids.length; i += chunkSize) {
+        // Advance by the chunk ACTUALLY fetched, then grow — same skipped-
+        // UIDs bug as fetchSinceUid (see comment there).
+        for (let i = 0; i < uids.length;) {
             const chunk = uids.slice(i, i + chunkSize);
             const msgs = await this.fetchMessages(chunk.join(","), options);
             allMessages.push(...msgs);
@@ -635,6 +643,7 @@ export class NativeImapClient {
             }
             if (onChunk)
                 onChunk(msgs);
+            i += chunk.length;
             if (chunkSize < this.fetchChunkSizeMax)
                 chunkSize = Math.min(chunkSize * 4, this.fetchChunkSizeMax);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/iflow-direct",
-  "version": "0.1.56",
+  "version": "0.1.58",
   "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.7"
+    "@bobfrankston/tcp-transport": "file:../tcp-transport"
   },
   "exports": {
     ".": {
@@ -44,13 +44,5 @@
   },
   "devDependencies": {
     "@types/node": "^25.6.0"
-  },
-  ".dependencies": {
-    "@bobfrankston/tcp-transport": "file:../tcp-transport"
-  },
-  ".transformedSnapshot": {
-    "dependencies": {
-      "@bobfrankston/tcp-transport": "^0.1.7"
-    }
   }
 }