@bobfrankston/msgapidefs 0.1.32 → 0.1.33

package/README.md

@@ -111,6 +111,14 @@ window.close();  // Instead of msgapi.close() if not passing result
 | `udp.listen()` | ✅ | ✅ | ✅ | Background receive loop in all hosts |
 | `udp.sendReceive()` | ✅ | ✅ | ✅ | Send + wait with timeout |
 | `udp.broadcast()` | ✅ | ✅ | ✅ | 255.255.255.255 broadcast |
+| **TCP Networking** | | | | **`window.msgapi.tcp.*`** |
+| `tcp.connect()` | ✅ | ✅ | ✅ | Node net/tls / Rust TcpStream+native-tls / C# TcpClient+SslStream |
+| `tcp.write()` | ✅ | ✅ | ✅ | UTF-8 string data |
+| `tcp.onData()` | ✅ | ✅ | ✅ | Persistent callback, fires multiple times |
+| `tcp.onClose()` | ✅ | ✅ | ✅ | Connection closed notification |
+| `tcp.onError()` | ✅ | ✅ | ✅ | Error notification |
+| `tcp.upgradeTLS()` | ✅ | ✅ | ✅ | STARTTLS — upgrade plaintext to TLS |
+| `tcp.close()` | ✅ | ✅ | ✅ | Close connection |
 | **HTTP Fetch** | | | | **`window.msgapi.http.*`** |
 | `http.fetch()` | ✅ | ✅ | ✅ | Native HTTP — bypasses CORS/mixed-content |
 
@@ -178,6 +186,36 @@ Native UDP socket access — no WebSocket proxy needed when running inside a msg
 - `udp.sendReceive(host, port, data, timeoutMs?)` - Send and wait for response
 - `udp.broadcast(port, data)` - Broadcast to local network
 
+### TCP Networking
+
+Native TCP/TLS socket access — for IMAP, SMTP, and other stream protocols. Connections are long-lived; use stream IDs to manage multiple connections. TLS is handled natively — JS never sees the raw TLS handshake.
+
+- `tcp.connect(host, port, tls)` - Connect to host:port. If `tls` is true, connect with TLS directly (port 993). Returns a `streamId` (number).
+- `tcp.write(streamId, data)` - Write UTF-8 string data to stream.
+- `tcp.onData(streamId, callback)` - Register handler for incoming data. Persistent — fires multiple times as data arrives.
+- `tcp.onClose(streamId, callback)` - Register handler for connection close. `hadError` is true if closed due to error.
+- `tcp.onError(streamId, callback)` - Register handler for errors.
+- `tcp.upgradeTLS(streamId, servername)` - Upgrade a plaintext connection to TLS (STARTTLS). Used by IMAP/SMTP after negotiating capabilities on plaintext.
+- `tcp.close(streamId)` - Close the connection.
+
+```javascript
+// Connect to Gmail IMAP (direct TLS on port 993)
+const id = await window.msgapi.tcp.connect('imap.gmail.com', 993, true);
+window.msgapi.tcp.onData(id, (data) => console.log('Server:', data));
+window.msgapi.tcp.onClose(id, (hadError) => console.log('Closed', hadError));
+window.msgapi.tcp.onError(id, (msg) => console.error('Error:', msg));
+
+// STARTTLS example (connect plaintext, then upgrade)
+const id2 = await window.msgapi.tcp.connect('imap.example.com', 143, false);
+// ... negotiate STARTTLS capability ...
+await window.msgapi.tcp.upgradeTLS(id2, 'imap.example.com');
+// ... now on encrypted connection ...
+```
+
+**Platform implementations:** msgview uses Node.js `net`/`tls`, msger uses Rust `std::net::TcpStream` + `native-tls`, msga uses C# `TcpClient` + `SslStream`.
+
+**Used by:** `@bobfrankston/iflow-direct` `BridgeTransport` — enables browser/WebView IMAP without a Node.js server.
+
 ### Shell / Process Execution
 
 Native process execution — run commands, open files with default handler. msga only currently.

package/msgapi-plan.md

@@ -45,6 +45,14 @@ Shared planning document for msgapi across implementations:
 | udp.listen() | ✅ | ✅ | ✅ | Background receive loop in all hosts |
 | udp.sendReceive() | ✅ | ✅ | ✅ | Send + wait with timeout |
 | udp.broadcast() | ✅ | ✅ | ✅ | 255.255.255.255 broadcast |
+| **TCP** |
+| tcp.connect() | ✅ | ✅ | ✅ | Node net/tls / Rust TcpStream+native-tls / C# TcpClient+SslStream |
+| tcp.write() | ✅ | ✅ | ✅ | UTF-8 string data |
+| tcp.onData() | ✅ | ✅ | ✅ | Persistent callback for incoming data |
+| tcp.onClose() | ✅ | ✅ | ✅ | Connection closed notification |
+| tcp.onError() | ✅ | ✅ | ✅ | Error notification |
+| tcp.upgradeTLS() | ✅ | ✅ | ✅ | STARTTLS — plaintext to TLS upgrade |
+| tcp.close() | ✅ | ✅ | ✅ | Close connection |
 | **HTTP** |
 | http.fetch() | ✅ | ✅ | ✅ | CORS/mixed-content bypass via native HTTP; returns real Response object |
 | **Configuration** |
@@ -244,6 +252,14 @@ interface MsgAPI {
 1. ✅ msger (Rust) — `std::net::UdpSocket` via NativeEvent + thread::spawn
 2. ✅ msgview (Electron) — Node.js `dgram` via ipcMain.handle + preload
 
+### Phase 2b: TCP in all three hosts ✅ Done
+1. ✅ TCP interface added to msgapidefs.ts (connect/write/onData/onClose/onError/upgradeTLS/close)
+2. ✅ msgview (Electron) — Node.js net/tls via ipcMain.handle, push events via webContents.send
+3. ✅ msger (Rust) — std::net::TcpStream + native-tls, thread-per-connection with cancel flags
+4. ✅ msga (MAUI) — TcpService.cs (ported from MailxApp TcpBridgeService), msgapi:// URL routing
+5. ✅ iflow bridge-transport updated: mailxapi.tcp → msgapi.tcp
+6. Used by: @bobfrankston/iflow-direct BridgeTransport for browser/WebView IMAP
+
 ### Phase 3: File System + Shell in msga ✅ Done
 1. ✅ fs.read with encoding options (utf8/base64/binary)
 2. ✅ fs.readAsDataUrl with MIME auto-detection

package/msgapidefs.ts

@@ -121,6 +121,21 @@ export interface MsgAPI {
         broadcast(port: number, data: string | Uint8Array): Promise<void>;  // Broadcast to local network
     };
 
+    // ── TCP Networking ──────────────────────────────────────────
+    // Native TCP/TLS — for IMAP, SMTP, and other stream protocols.
+    // Connections are long-lived; use stream IDs to manage multiple connections.
+    // TLS is handled natively — JS never sees raw TLS handshake.
+
+    tcp?: {
+        connect(host: string, port: number, tls: boolean): Promise<number>;              // Connect to host:port (TLS if tls=true), returns streamId
+        write(streamId: number, data: string): Promise<void>;                             // Write UTF-8 data to stream
+        onData(streamId: number, callback: (data: string) => void): void;                 // Register handler for incoming data (persistent, fires multiple times)
+        onClose(streamId: number, callback: (hadError: boolean) => void): void;           // Register handler for connection close
+        onError(streamId: number, callback: (message: string) => void): void;             // Register handler for errors
+        upgradeTLS(streamId: number, servername: string): Promise<void>;                  // Upgrade plaintext connection to TLS (STARTTLS)
+        close(streamId: number): void;                                                     // Close connection
+    };
+
     // ── HTTP Fetch (CORS/mixed-content bypass) ──────────────────
     // Routes requests through the native host — no mixed-content or CORS restrictions
     // Returns a real Response object: .ok, .status, .json(), .text(), .headers, .clone()

package/package.json

@@ -1,41 +1,41 @@
-{
-  "name": "@bobfrankston/msgapidefs",
-  "version": "0.1.32",
-  "description": "TypeScript definitions for msgapi JavaScript API (msgview/msger)",
-  "type": "module",
-  "main": "./msgapidefs.js",
-  "types": "./msgapidefs.d.ts",
-  "exports": {
-    ".": {
-      "import": "./msgapidefs.js",
-      "types": "./msgapidefs.d.ts"
-    }
-  },
-  "keywords": [
-    "msgapi",
-    "msgview",
-    "msger",
-    "typescript",
-    "definitions",
-    "types",
-    "webview"
-  ],
-  "author": "Bob Frankston",
-  "license": "ISC",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/BobFrankston/msgapidefs.git"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "prerelease:local": "git add -A && (git diff-index --quiet HEAD || git commit -m \"Pre-release commit\")",
-    "preversion": "git add -A",
-    "postversion": "git push && git push --tags",
-    "release": "npm run prerelease:local && npm version patch && npm publish --quiet"
-  },
-  "devDependencies": {
-    "@types/node": "^25.2.1"
-  }
-}
+{
+  "name": "@bobfrankston/msgapidefs",
+  "version": "0.1.33",
+  "description": "TypeScript definitions for msgapi JavaScript API (msgview/msger)",
+  "type": "module",
+  "main": "./msgapidefs.js",
+  "types": "./msgapidefs.d.ts",
+  "exports": {
+    ".": {
+      "import": "./msgapidefs.js",
+      "types": "./msgapidefs.d.ts"
+    }
+  },
+  "keywords": [
+    "msgapi",
+    "msgview",
+    "msger",
+    "typescript",
+    "definitions",
+    "types",
+    "webview"
+  ],
+  "author": "Bob Frankston",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BobFrankston/msgapidefs.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "prerelease:local": "git add -A && (git diff-index --quiet HEAD || git commit -m \"Pre-release commit\")",
+    "preversion": "git add -A",
+    "release": "npm run prerelease:local && npm version patch && npm publish --quiet",
+    "postversion": "git push && git push --tags"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.1"
+  }
+}

package/.claude/settings.local.json

@@ -1,14 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(tsc:*)",
-      "Bash(npm init:*)",
-      "Bash(npm install:*)",
-      "Bash(node cli.js:*)",
-      "Bash(node --version:*)",
-      "Bash(cd:*)"
-    ],
-    "deny": [],
-    "ask": []
-  }
-}