appium-ios-tuntap 0.4.3 → 0.4.4

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [0.4.4](https://github.com/appium/appium-ios-tuntap/compare/v0.4.3...v0.4.4) (2026-06-12)
+
+### Bug Fixes
+
+* Update tunnel backpressure handling ([#50](https://github.com/appium/appium-ios-tuntap/issues/50)) ([28b8bce](https://github.com/appium/appium-ios-tuntap/commit/28b8bce8edcf2a0446a653bbec759e6b4a199827))
+
 ## [0.4.3](https://github.com/appium/appium-ios-tuntap/compare/v0.4.2...v0.4.3) (2026-06-10)
 
 ### Bug Fixes

package/README.md

@@ -272,13 +272,13 @@ Most tests for this module require **root privileges** (sudo) to create and mana
 From the project root, run:
 
 ```sh
-sudo npx mocha test/tuntap-unit.spec.js
+sudo npm run test:unit
 ```
 
-Or, to run all tests in the `test/` directory:
+Or, to run all tests:
 
 ```sh
-sudo npx mocha
+sudo npm test
 ```
 
 If you are **not** running as root, you will see a message that tests are skipped.

package/lib/tunnel/constants.d.ts

@@ -16,3 +16,5 @@ export declare const IPV6_HEADER_SIZE = 40;
 export declare const IPV6_VERSION = 6;
 export declare const IPPROTO_TCP = 6;
 export declare const IPPROTO_UDP = 17;
+/** Pause device ingress when the reassembly buffer exceeds this size. */
+export declare const MAX_DEVICE_INGRESS_BUFFER: number;

package/lib/tunnel/constants.js

@@ -16,3 +16,5 @@ export const IPV6_HEADER_SIZE = 40;
 export const IPV6_VERSION = 6;
 export const IPPROTO_TCP = 6;
 export const IPPROTO_UDP = 17;
+/** Pause device ingress when the reassembly buffer exceeds this size. */
+export const MAX_DEVICE_INGRESS_BUFFER = 8 * 1024 * 1024;

package/lib/tunnel/manager.d.ts

@@ -15,6 +15,7 @@ export declare class TunnelManager extends EventEmitter<TunnelManagerEvents> {
     private deviceConn;
     private cleanupPromise;
     private tunReadPausedForBackpressure;
+    private deviceIngressPausedForTun;
     /**
      * Register a listener for parsed tunnel packets (in addition to the `data` event).
      *
@@ -59,6 +60,9 @@ export declare class TunnelManager extends EventEmitter<TunnelManagerEvents> {
     private hasPacketTap;
     private processBuffer;
     private writeDeviceFrameToTun;
+    private shouldResumeDeviceIngress;
+    private pauseDeviceIngress;
+    private resumeDeviceIngress;
     private tapL4Packet;
     private dispatchPacketData;
     private startTunReadLoop;

package/lib/tunnel/manager.js

@@ -2,7 +2,7 @@ import { log } from '../logger.js';
 import { TunTap } from '../TunTap.js';
 import { EventEmitter } from 'node:events';
 import { Buffer } from 'node:buffer';
-import { CD_TUNNEL_HANDSHAKE_TIMEOUT_MS, CD_TUNNEL_HEADER_SIZE, CD_TUNNEL_MAGIC, CD_TUNNEL_MAGIC_SIZE, CD_TUNNEL_MTU, DEFAULT_TUN_POLL_QUEUE_DEPTH, FAST_TUN_POLL_QUEUE_DEPTH, IPV6_HEADER_SIZE, LARGE_TUN_POLL_BUFFER, MAX_TUN_POLL_BUFFER, IPV6_VERSION, IPPROTO_TCP, IPPROTO_UDP, } from './constants.js';
+import { CD_TUNNEL_HANDSHAKE_TIMEOUT_MS, CD_TUNNEL_HEADER_SIZE, CD_TUNNEL_MAGIC, CD_TUNNEL_MAGIC_SIZE, CD_TUNNEL_MTU, DEFAULT_TUN_POLL_QUEUE_DEPTH, FAST_TUN_POLL_QUEUE_DEPTH, IPV6_HEADER_SIZE, LARGE_TUN_POLL_BUFFER, MAX_DEVICE_INGRESS_BUFFER, MAX_TUN_POLL_BUFFER, IPV6_VERSION, IPPROTO_TCP, IPPROTO_UDP, } from './constants.js';
 import { appendBuffer } from './buffer-utils.js';
 /**
  * Bridges a CoreDevice tunnel `Socket` and a {@link TunTap} interface: IPv6 framing, TUN I/O, and packet fan-out.
@@ -17,6 +17,7 @@ export class TunnelManager extends EventEmitter {
     deviceConn = null;
     cleanupPromise = null;
     tunReadPausedForBackpressure = false;
+    deviceIngressPausedForTun = false;
     /**
      * Register a listener for parsed tunnel packets (in addition to the `data` event).
      *
@@ -136,7 +137,9 @@ export class TunnelManager extends EventEmitter {
             }
             try {
                 this.buffer = appendBuffer(this.buffer, data);
-                // Process IPv6 packets
+                if (this.buffer.length > MAX_DEVICE_INGRESS_BUFFER) {
+                    this.pauseDeviceIngress();
+                }
                 this.processBuffer();
             }
             catch (err) {
@@ -208,17 +211,40 @@ export class TunnelManager extends EventEmitter {
                 this.buffer = this.buffer.subarray(offset);
             }
         }
+        if (this.deviceIngressPausedForTun && this.shouldResumeDeviceIngress()) {
+            this.resumeDeviceIngress();
+        }
     }
     writeDeviceFrameToTun(tun, packet, nextHeader) {
         tun.write(packet);
         if (!this.hasPacketTap()) {
             return;
         }
-        const bytesWritten = packet.length;
         const { src, dst } = ipv6Endpoints(packet);
-        log.debug(`Device → TUN: ${bytesWritten} bytes, IPv6 src=${src}, dst=${dst}`);
+        log.debug(`Device → TUN: ${packet.length} bytes, IPv6 src=${src}, dst=${dst}`);
         this.tapL4Packet(packet, nextHeader, src, dst);
     }
+    shouldResumeDeviceIngress() {
+        if (this.buffer.length === 0) {
+            return true;
+        }
+        // All complete frames were written; waiting on more socket bytes to finish the tail frame.
+        return nextIpv6Frame(this.buffer, 0).kind === 'incomplete';
+    }
+    pauseDeviceIngress() {
+        if (this.deviceIngressPausedForTun || !this.deviceConn || this.deviceConn.destroyed) {
+            return;
+        }
+        this.deviceIngressPausedForTun = true;
+        this.deviceConn.pause();
+    }
+    resumeDeviceIngress() {
+        if (!this.deviceIngressPausedForTun || !this.deviceConn || this.deviceConn.destroyed) {
+            return;
+        }
+        this.deviceIngressPausedForTun = false;
+        this.deviceConn.resume();
+    }
     tapL4Packet(packet, nextHeader, src, dst) {
         let packetData = null;
         if (nextHeader === IPPROTO_UDP) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appium-ios-tuntap",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "Native TUN/TAP interface module for Node.js",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -18,8 +18,8 @@
     "refresh:wintun": "node scripts/fetch-wintun.mjs",
     "prepare": "npm run build",
     "test": "npm run test:integration && npm run test:unit",
-    "test:unit": "mocha \"test/unit/**/*.spec.mjs\" --exit --timeout 2m",
-    "test:integration": "mocha \"test/integration/**/*.spec.mjs\" --exit --timeout 2m"
+    "test:unit": "node --test --test-force-exit --test-timeout=120000 \"test/unit/**/*.spec.mjs\"",
+    "test:integration": "node --test --test-force-exit --test-timeout=120000 \"test/integration/**/*.spec.mjs\""
   },
   "files": [
     "src/tuntap.cc",
@@ -61,7 +61,6 @@
     "@types/node": "^25.0.1",
     "commander": "^14.0.3",
     "conventional-changelog-conventionalcommits": "^9.0.0",
-    "mocha": "^11.7.5",
     "prebuildify": "^6.0.1",
     "prettier": "^3.0.0",
     "semantic-release": "^25.0.2"

package/src/native/tun_backend_darwin.cc

@@ -134,6 +134,9 @@ public:
 
     ssize_t bytes_written = write(fd_.get(), write_frame_.data(), write_frame_.size());
     if (bytes_written < 0) {
+      if (errno == EAGAIN || errno == EWOULDBLOCK) {
+        return 0;
+      }
       error = std::string("Write error: ") + strerror(errno);
       return -1;
     }

package/src/native/tun_backend_linux.cc

@@ -104,6 +104,9 @@ public:
     }
     ssize_t bytes_written = write(fd_.get(), data, length);
     if (bytes_written < 0) {
+      if (errno == EAGAIN || errno == EWOULDBLOCK) {
+        return 0;
+      }
       error = std::string("Write error: ") + strerror(errno);
       return -1;
     }