appium-ios-tuntap 0.2.1 → 0.2.3

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+## [0.2.3](https://github.com/appium/appium-ios-tuntap/compare/v0.2.2...v0.2.3) (2026-05-13)
+
+## [0.2.2](https://github.com/appium/appium-ios-tuntap/compare/v0.2.1...v0.2.2) (2026-04-30)
+
+### Bug Fixes
+
+* linter ([#38](https://github.com/appium/appium-ios-tuntap/issues/38)) ([8dfed52](https://github.com/appium/appium-ios-tuntap/commit/8dfed527cc557856025bba6070b2686414d582a2))
+
 ## [0.2.1](https://github.com/appium/appium-ios-tuntap/compare/v0.2.0...v0.2.1) (2026-04-13)
 
 ### Miscellaneous Chores

package/README.md

@@ -291,11 +291,6 @@ To manually verify the fix for signal handling (introduced in v0.0.4):
 
 This ensures the signal handler works as intended.
 
-Apache-2.0
->>>>>>> upstream/main
 ## License
 
 Apache-2.0
-=======
-Apache-2.0
->>>>>>> upstream/main

package/lib/TunTap.d.ts

@@ -25,6 +25,10 @@ export declare class TunTap {
     get isOpen(): boolean;
     /** Whether {@link TunTap.close} has been called (device cannot be reopened). */
     get isClosed(): boolean;
+    /** OS-assigned interface name (e.g. `utun4` on macOS). */
+    get name(): string;
+    /** File descriptor for the open TUN device (for advanced use). */
+    get fd(): number;
     /**
      * Open the TUN device via the native addon.
      *
@@ -70,10 +74,6 @@ export declare class TunTap {
      * @throws {RangeError} if `bufferSize` is out of range
      */
     startPolling(callback: PacketCallback, bufferSize?: number): void;
-    /** OS-assigned interface name (e.g. `utun4` on macOS). */
-    get name(): string;
-    /** File descriptor for the open TUN device (for advanced use). */
-    get fd(): number;
     /**
      * Configure IPv6 address and MTU on this interface using the platform backend (must run as root on Darwin/Linux).
      *

package/lib/TunTap.js

@@ -13,22 +13,6 @@ const MAX_BUFFER_SIZE = 0xffff; // 65535
 const DEFAULT_MTU = 1500;
 const MIN_MTU = 1280;
 const nativeTuntap = require('node-gyp-build')(pkgRoot);
-/**
- * Validates an IPv6 route destination (address with optional CIDR prefix).
- */
-function isValidIPv6Route(destination) {
-    const parts = destination.split('/');
-    if (parts.length > 2) {
-        return false;
-    }
-    if (parts.length === 2) {
-        const prefix = parseInt(parts[1], 10);
-        if (isNaN(prefix) || prefix < 0 || prefix > 128 || parts[1] !== String(prefix)) {
-            return false;
-        }
-    }
-    return isIPv6(parts[0]);
-}
 /**
  * High-level wrapper around the native TUN device with IPv6-only configuration helpers.
  *
@@ -75,6 +59,14 @@ export class TunTap {
     get isClosed() {
         return this._isClosed;
     }
+    /** OS-assigned interface name (e.g. `utun4` on macOS). */
+    get name() {
+        return this.device.getName();
+    }
+    /** File descriptor for the open TUN device (for advanced use). */
+    get fd() {
+        return this.device.getFd();
+    }
     /**
      * Open the TUN device via the native addon.
      *
@@ -202,14 +194,6 @@ export class TunTap {
         }
         this.device.startPolling(callback, bufferSize);
     }
-    /** OS-assigned interface name (e.g. `utun4` on macOS). */
-    get name() {
-        return this.device.getName();
-    }
-    /** File descriptor for the open TUN device (for advanced use). */
-    get fd() {
-        return this.device.getFd();
-    }
     /**
      * Configure IPv6 address and MTU on this interface using the platform backend (must run as root on Darwin/Linux).
      *
@@ -318,3 +302,19 @@ export class TunTap {
         }
     }
 }
+/**
+ * Validates an IPv6 route destination (address with optional CIDR prefix).
+ */
+function isValidIPv6Route(destination) {
+    const parts = destination.split('/');
+    if (parts.length > 2) {
+        return false;
+    }
+    if (parts.length === 2) {
+        const prefix = parseInt(parts[1], 10);
+        if (isNaN(prefix) || prefix < 0 || prefix > 128 || parts[1] !== String(prefix)) {
+            return false;
+        }
+    }
+    return isIPv6(parts[0]);
+}

package/lib/tunnel.d.ts

@@ -2,15 +2,6 @@ import { TunTap } from './TunTap.js';
 import { EventEmitter } from 'node:events';
 import { Socket } from 'node:net';
 import { Buffer } from 'node:buffer';
-interface TunnelClientParameters {
-    address: string;
-    mtu: number;
-}
-interface TunnelInfo {
-    clientParameters: TunnelClientParameters;
-    serverAddress: string;
-    serverRSDPort?: number;
-}
 export interface PacketData {
     protocol: 'TCP' | 'UDP';
     src: string;
@@ -28,9 +19,6 @@ export interface PacketData {
  *   // `packet` is PacketData
  * });
  */
-export interface TunnelManagerEvents {
-    data: [packet: PacketData];
-}
 export interface PacketConsumer {
     /**
      * Invoked for each parsed TCP/UDP payload extracted from the tunnel stream.
@@ -39,6 +27,9 @@ export interface PacketConsumer {
      */
     onPacket(packet: PacketData): void;
 }
+export interface TunnelManagerEvents {
+    data: [packet: PacketData];
+}
 export interface TunnelConnection {
     Address: string;
     RsdPort?: number;
@@ -52,6 +43,15 @@ export interface TunnelConnection {
     /** @returns async iterator of packets until the tunnel is stopped */
     getPacketStream(): AsyncIterable<PacketData>;
 }
+interface TunnelClientParameters {
+    address: string;
+    mtu: number;
+}
+interface TunnelInfo {
+    clientParameters: TunnelClientParameters;
+    serverAddress: string;
+    serverRSDPort?: number;
+}
 /**
  * Bridges a CoreDevice tunnel `Socket` and a {@link TunTap} interface: IPv6 framing, TUN I/O, and packet fan-out.
  * Emits {@link TunnelManagerEvents} (currently `data` with {@link PacketData}) for TCP/UDP packets, same as registered consumers.

package/lib/tunnel.js

@@ -362,16 +362,6 @@ export class TunnelManager extends EventEmitter {
         log.debug(`Tunnel for ${tunName} closed successfully`);
     }
 }
-function formatIPv6Address(buffer) {
-    if (!buffer || buffer.length !== 16) {
-        return 'invalid-address';
-    }
-    const parts = [];
-    for (let i = 0; i < 16; i += 2) {
-        parts.push(buffer.readUInt16BE(i).toString(16));
-    }
-    return parts.join(':');
-}
 /**
  * Perform the CDTunnel JSON handshake (8-byte magic + length-prefixed JSON) over `socket`.
  *
@@ -499,3 +489,13 @@ export async function connectToTunnelLockdown(secureServiceSocket) {
         throw err;
     }
 }
+function formatIPv6Address(buffer) {
+    if (!buffer || buffer.length !== 16) {
+        return 'invalid-address';
+    }
+    const parts = [];
+    for (let i = 0; i < 16; i += 2) {
+        parts.push(buffer.readUInt16BE(i).toString(16));
+    }
+    return parts.join(':');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appium-ios-tuntap",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Native TUN/TAP interface module for Node.js",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -16,9 +16,9 @@
     "format:check": "prettier --check ./src ./test",
     "install": "node-gyp-build",
     "prepare": "npm run build",
-    "test": "sudo npm run test:integration && npm run test:unit",
-    "test:unit": "sudo npx mocha 'test/tuntap-unit.spec.mjs' --exit --timeout 2m",
-    "test:integration": "sudo npx mocha 'test/tuntap-integration.spec.mjs' --exit --timeout 2m"
+    "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"
   },
   "files": [
     "src/tuntap.cc",
@@ -57,9 +57,10 @@
     "@semantic-release/git": "^10.0.1",
     "@types/node": "^25.0.1",
     "conventional-changelog-conventionalcommits": "^9.0.0",
-    "semantic-release": "^25.0.2",
+    "mocha": "^11.7.5",
+    "prebuildify": "^6.0.1",
     "prettier": "^3.0.0",
-    "prebuildify": "^6.0.1"
+    "semantic-release": "^25.0.2"
   },
   "prettier": {
     "bracketSpacing": false,