@bobfrankston/iflow-direct 0.1.55 → 0.1.57

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/fetched-message.d.ts

@@ -19,6 +19,7 @@ export declare class FetchedMessage implements NativeFetchedMessage {
     uid: number;
     flags: Set<string>;
     date: Date | null;
+    sentDate?: Date;
     subject: string;
     messageId: string;
     from: AddressData[];

package/fetched-message.js

@@ -24,6 +24,7 @@ export class FetchedMessage {
     uid;
     flags;
     date;
+    sentDate;
     subject;
     messageId;
     from;

package/imap-native.d.ts

@@ -14,6 +14,7 @@ export interface NativeFetchedMessage {
     uid: number;
     flags: Set<string>;
     date: Date | null;
+    sentDate?: Date;
     subject: string;
     messageId: string;
     from: proto.AddressData[];

package/imap-native.js

@@ -706,6 +706,17 @@ export class NativeImapClient {
                 return proto.parseSearchResponse(r.text);
             }
         }
+        // No untagged * SEARCH seen. If the tagged status is anything but OK,
+        // the search FAILED — throw so callers can tell "failed" from "no
+        // matches". Silently returning [] here let a failed HEADER search read
+        // as "message missing from server", and mailx's sent-sweep then
+        // re-APPENDed a copy every 5-minute tick — 3,704 duplicates of one
+        // message over ~13 days (2026-07-02). Empty-but-OK still returns []
+        // (some servers omit the * SEARCH line when there are zero hits).
+        const tagged = responses.find(r => r.tag === tag);
+        if (!tagged || tagged.type !== "OK") {
+            throw new Error(`SEARCH failed: ${tagged ? `${tagged.type} ${tagged.text || ""}` : "no tagged response"}`);
+        }
         return [];
     }
     /** Set flags on a message */
@@ -1513,6 +1524,11 @@ export class NativeImapClient {
             if (envMatch) {
                 const env = proto.parseEnvelope(envMatch[1]);
                 msg.date = msg.date || env.date;
+                // Expose the ENVELOPE Date: header (the SENT time) separately
+                // from msg.date (INTERNALDATE = server-received time). Callers
+                // that want messages to cluster by when they were sent — not by
+                // per-account delivery time — use sentDate. Additive/optional.
+                msg.sentDate = env.date || undefined;
                 msg.subject = env.subject;
                 msg.messageId = env.messageId;
                 msg.from = env.from;

package/imap-protocol.js

@@ -302,8 +302,16 @@ export function parseEnvelope(envStr) {
             result.to = parseAddressList(tokens[5]);
             result.cc = parseAddressList(tokens[6]);
             result.bcc = parseAddressList(tokens[7]);
-            result.inReplyTo = unquote(tokens[8]);
-            result.messageId = unquote(tokens[9]);
+            // Trim fold whitespace. Servers hand back the ENVELOPE msg-id /
+            // in-reply-to with the original header's folding intact when the
+            // Message-ID sat on a continuation line ("Message-ID:\r\n\t<...>")
+            // — the value arrives as "\t<...>". Stored untrimmed, that tab
+            // poisoned every later HEADER search ("missing on server") and
+            // fueled mailx's sent-sweep re-APPEND loop: 3,707 duplicates of
+            // one Outlook-composed reply (2026-07-02). Trim here so no
+            // consumer ever sees the fold whitespace.
+            result.inReplyTo = unquote(tokens[8]).trim();
+            result.messageId = unquote(tokens[9]).trim();
         }
     }
     catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/iflow-direct",
-  "version": "0.1.55",
+  "version": "0.1.57",
   "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": "^0.1.8"
   },
   "exports": {
     ".": {
@@ -50,7 +50,7 @@
   },
   ".transformedSnapshot": {
     "dependencies": {
-      "@bobfrankston/tcp-transport": "^0.1.7"
+      "@bobfrankston/tcp-transport": "^0.1.8"
     }
   }
 }