werift 0.24.4 → 0.25.0

package/README.md

@@ -1,12 +1,20 @@
 # werift
 
-werift (**We**b**r**tc **I**mplementation **f**or **T**ypeScript)
+werift (**We**b**R**TC **I**mplementation **f**or **T**ypeScript) is a WebRTC implementation for Node.js written in TypeScript with a browser-compatible WebRTC API.
 
-werift is a WebRTC Implementation for TypeScript (Node.js)
+For the project overview, current features, examples, architecture, and interoperability information, see the [repository README](../../README.md).
 
-# install
+## Install
 
-`npm install werift`
+```sh
+npm install werift
+```
+
+## Browser-compatible WebRTC API
+
+werift is designed so application code can use the familiar browser WebRTC model in Node.js: `RTCPeerConnection`, tracks and transceivers, `RTCDataChannel`, standard events, ICE configuration, offer/answer negotiation, and `getStats()`.
+
+A small number of intentional or known edge-case differences remain for backward compatibility or unsupported legacy APIs. See [Browser API compatibility](../../docs/browser-api-compatibility.md) for those differences and the WPT strategy used to track exact browser behavior.
 
 ## Development setup
 
@@ -23,6 +31,8 @@ npm run wpt --workspace packages/webrtc
 npm run wpt:coverage --workspace packages/webrtc
 ```
 
+WPT reports use `v8-to-istanbul` directly to retain the V8 metrics used by the committed coverage baseline, independently of Vitest's AST-based coverage provider. Only observed TypeScript sources and source-mapped lines are measured.
+
 Refresh the committed baselines when intentionally expanding upstream coverage:
 
 ```sh
@@ -30,133 +40,126 @@ npm run wpt --workspace packages/webrtc -- --update-baseline
 WPT_UPDATE_COVERAGE_BASELINE=1 npm run wpt:coverage --workspace packages/webrtc
 ```
 
-# Documentation (WIP)
+## Rejected, stopped and reused m-lines
 
-- [Website](https://shinyoshiaki.github.io/werift-webrtc/website/build/)
-- [API Reference](https://shinyoshiaki.github.io/werift-webrtc/website/build/docs/api)
+A remote offer can contain audio/video sections that the local `codecs` cannot handle. `setRemoteDescription()` still succeeds and the answer rejects only those sections with port 0 at the same position (Issue #705). For example, an audio-only peer can answer a browser offer that bundles video without adding VP8:
 
-# examples
+```ts
+const pc = new RTCPeerConnection({
+  codecs: { audio: [useOPUS()], video: [] },
+});
+await pc.setRemoteDescription(browserOffer); // audio + video in BUNDLE
+await pc.setLocalDescription(await pc.createAnswer()); // video: m=video 0 ...
+```
 
-https://github.com/shinyoshiaki/werift-webrtc/tree/master/examples
+`mLineReuse` selects how inactive and stopped m-lines are written. It is fixed at construction time.
 
-### SFU
+```ts
+new RTCPeerConnection(); // mLineReuse: "compatible" (default)
+new RTCPeerConnection({ mLineReuse: "aggressive" }); // legacy: inactive also uses port 0
+```
 
-https://github.com/shinyoshiaki/node-sfu
+| `mLineReuse` | accepted `inactive` | rejected / stopped |
+| --- | --- | --- |
+| `"compatible"` (default) | non-zero port | port 0 |
+| `"aggressive"` | port 0 | port 0 |
+
+With `"aggressive"`, the remote side (browsers included) treats an inactive port 0 m-line as rejected, so once it is negotiated the transceiver becomes `stopped` and cannot be resumed by setting `direction` back to `"sendrecv"`. Add a new transceiver instead; it reuses that position. This differs from older werift versions. Use the default `"compatible"` if you need to pause and resume with `inactive`.
+
+In `"compatible"`, `inactive` m-lines are kept and not reused. To reuse an m-line position, release it explicitly: call `transceiver.stop()` on the side that owns the track (in the browser, after `pc.removeTrack(sender)`) and renegotiate. The m-line is negotiated as port 0 and both sides stop it, then the next `addTransceiver()` / `addTrack()` of the same kind (browser or werift) takes that position with a new MID, so the number of m-lines does not grow. Choose `"aggressive"` only when you cannot change the remote side to call `stop()`.
+
+- Rejected (`transceiver.rejected`): no common codec or remote port 0. No sender/receiver pipeline, router registration, `ontrack` or TWCC is set up for it.
+- Stopped: `transceiver.stop()` releases media immediately and is negotiated as port 0 in the next local offer; `transceiver.stopped` becomes `true` when the answer is applied. An answerer that calls `stop()` answers `inactive` first and negotiates the stop in its own next offer.
+- Reused: after the port 0 negotiation completes, `addTransceiver()` of the same kind takes that position with a new MID and a new transceiver, so the number of m-lines does not grow. Positions that are only stopping are not reused.
+- `removeTrack(sender)` only detaches the track. `sender.replaceTrack(track)` plus `transceiver.direction = "sendrecv"` resumes sending on the same sender.
+
+See [the design note](../../docs/design/705-media-rejection-and-removetrack.md) for BUNDLE, ICE candidate and rollback details.
+
+## Documentation
+
+- [Website](https://shinyoshiaki.github.io/werift-webrtc/website/build/)
+- [API Reference](https://shinyoshiaki.github.io/werift-webrtc/website/build/docs/api)
+- [Examples](../../examples)
+- [Polyfill guide](../../docs/polyfill/README.md)
+- [Browser API compatibility differences](../../docs/browser-api-compatibility.md)
 
-# demo
+## Demos
 
-## MediaChannel
+### MediaChannel
+
+From the repository root:
 
 ```sh
-yarn media
+npm run media
 ```
 
-open
+Open:
+
 https://shinyoshiaki.github.io/werift-webrtc/examples/mediachannel/pubsub/answer
 
-see console & chrome://webrtc-internals/
+Use the browser console and `chrome://webrtc-internals/` for inspection.
 
-## DataChannel
+### DataChannel
 
-run
+From the repository root:
 
 ```sh
-yarn datachannel
+npm run datachannel
 ```
 
-open
+Open:
+
 https://shinyoshiaki.github.io/werift-webrtc/examples/datachannel/answer
 
-see console & chrome://webrtc-internals/
-
-# RoadMap
-
-## Work in Progress Towards 1.0
-
-- [x] STUN
-- [x] TURN
-  - [x] UDP
-- [x] ICE
-  - [x] Vanilla ICE
-  - [x] Trickle ICE
-- [x] DTLS
-  - [x] DTLS-SRTP
-  - [x] Curve25519
-  - [x] P-256
-- [x] DataChannel
-- [x] MediaChannel
-  - [x] sendonly
-  - [x] recvonly
-  - [x] sendrecv
-  - [x] multi track
-- [x] RTP
-- [x] RTCP
-  - [x] SR/RR
-  - [x] Picture Loss Indication
-  - [x] ReceiverEstimatedMaxBitrate
-  - [x] GenericNack
-  - [x] TransportWideCC
-- [x] SRTP
-- [x] SRTCP
-- [x] SDP
-- [x] PeerConnection
-- [x] Simulcast
-  - [x] recv
-- [x] BWE
-  - [x] sender side BWE
-- [ ] Documentation
-- [x] Compatibility
-  - [x] Chrome
-  - [x] FireFox
-  - [x] Pion
-  - [x] aiortc
-  - [x] sipsorcery
-- [x] Interop E2E test
-  - [x] Chrome
-  - ↓↓↓ https://github.com/sipsorcery/webrtc-echoes
-  - [x] Pion
-  - [x] aiortc
-  - [x] sipsorcery
-- [ ] Unit Tests
-  - [ ] follow [Web Platform Tests](https://github.com/web-platform-tests/wpt)
-
-## Road Map Towards 2.0
-
-- [ ] API compatible with browser RTCPeerConnection
-- [ ] ICE
-  - [ ] ICE restart
-- [ ] SDP
-  - [ ] reuse inactive m-line
-- [ ] Simulcast
-  - [ ] send
-- [ ] support more cipher suites
-
-## RTCPeerConnection W3C compatibility notes
-
-API reference markdown can be regenerated with `cd packages/webrtc && npm run doc`.
-For this task, the reviewable compatibility notes live in this README and in
-`src/peerConnection.ts`; the generated `packages/webrtc/doc/` output is not
-tracked in git, so it is not committed as part of this change.
-
-| Status | API | Notes |
-| --- | --- | --- |
-| Added | `currentLocalDescription`, `pendingLocalDescription`, `currentRemoteDescription`, `pendingRemoteDescription`, `canTrickleIceCandidates`, `sctp` | Public getters now follow W3C-style pending/current description visibility and expose SCTP/canTrickle state. |
-| Added | `setLocalDescription()` input compatibility | Accepts omitted `type`, empty `sdp`, and provisional `pranswer`. |
-| Added | `setRemoteDescription()` input compatibility | Accepts `pranswer` and `rollback`, updating pending/current descriptions accordingly. |
-| Added | `addIceCandidate()` input compatibility | Accepts omitted input, `null`, and `{ candidate: "" }` as end-of-candidates, validates `sdpMid` / `sdpMLineIndex` / `usernameFragment`, updates the matching remote m-section, rejects calls before `remoteDescription` is set, and rejects malformed candidate strings. |
-| Added | `RTCConfiguration` compatibility | Accepts `iceServers`, `iceTransportPolicy`, `bundlePolicy`, `rtcpMuxPolicy: "require"`, `iceCandidatePoolSize: 0`, and `certificates`; `setConfiguration(getConfiguration())` round-trips without changing certificates. |
-| Deferred | `bundlePolicy: "balanced"` round-trip | `"balanced"` is accepted for input compatibility, but it is internally normalized to werift's `"max-compat"` behavior, so `getConfiguration()` returns `"max-compat"`. |
-| Added | `RTCIceServer.urls: string \| string[]` | Arrays are accepted and parsed in order. |
-| Added | Standard event names | `signalingstatechange`, `iceconnectionstatechange`, `icegatheringstatechange`, `connectionstatechange`, `negotiationneeded`, `icecandidate`, `track`, and `datachannel` are emitted for `addEventListener`. |
-| Not implemented | Legacy callback overloads | Kept out of scope because they are legacy browser APIs. |
-| Not implemented | `addStream`, `removeStream`, `createDTMFSender` | These are obsolete; use `addTrack`, `removeTrack`, and transceiver/sender APIs instead. |
-| Deferred | `close()` return type | Remains async for backward compatibility even though W3C defines synchronous `undefined`. |
-| Deferred | `setLocalDescription()` return type | Non-rollback calls still return the applied `SessionDescription` instead of `Promise<void>` for backward compatibility; the local `rollback` path resolves with `undefined`. |
-| Compatible | `setRemoteDescription()` return type | `setRemoteDescription()` resolves `Promise<void>` like the W3C API. |
-| Deferred | `RTCPeerConnection.generateCertificate()` | `RTCCertificate` and `RTCConfiguration.certificates` are supported, but the static W3C helper is still optional work. |
-
-# reference
-
-- aiortc https://github.com/aiortc/aiortc
-- pion/webrtc https://github.com/pion/webrtc
-- etc ....
+The outbound SCTP packet MTU can be configured independently from the
+negotiated DataChannel message-size limit:
+
+```typescript
+const peerConnection = new RTCPeerConnection({
+  sctp: { mtu: 1052 },
+});
+```
+
+`sctp.mtu` defaults to 1191 bytes (a maximum DATA payload of 1160 bytes per
+fragment). It cannot be changed to a different value after the SCTP transport
+has been created.
+
+## Current implementation highlights
+
+- Browser-compatible `RTCPeerConnection` API and standard WebRTC events
+- STUN and TURN relay support, including TURN control transports over UDP, TCP, and TLS
+- Full ICE, trickle ICE, ICE-Lite support/interoperability, ICE restart, and ICE-TCP
+- DTLS-SRTP, SRTP, and SRTCP
+- DataChannel over SCTP/DTLS
+- Media sendonly / recvonly / sendrecv and multiple tracks
+- RTP/RTCP feedback including SR/RR, PLI, REMB, Generic NACK, and Transport-Wide CC
+- RTX and RED
+- Receive-side simulcast
+- Sender-side bandwidth estimation
+- Browser-compatible `getStats()` reporting
+- Compatibility validation backed by an allowlisted upstream WPT runner
+
+See the [repository README](../../README.md#protocol-coverage-at-a-glance) for the broader feature checklist.
+
+## Interoperability
+
+The repository contains Chromium-focused browser E2E tests and a Firefox test runner. Safari interoperability is also community-verified: users have reported extensive real-world use with Safari in [Issue #346](https://github.com/shinyoshiaki/werift-webrtc/issues/346). Safari is not currently part of the automated browser E2E matrix, so this is community validation rather than a CI guarantee.
+
+werift also participates in the independent [`sipsorcery/webrtc-interop`](https://github.com/sipsorcery/webrtc-interop) Peer Connection and Data Channel Echo matrices.
+
+## Roadmap
+
+Current work is focused on:
+
+- improving documentation and WPT coverage
+- closing remaining documented browser API edge-case differences
+- simulcast send support
+- additional cipher suites
+- richer WebRTC statistics coverage
+- continued unit, E2E, interoperability, and long-running reliability testing
+
+## References
+
+- [aiortc](https://github.com/aiortc/aiortc)
+- [Pion WebRTC](https://github.com/pion/webrtc)
+- [sipsorcery/webrtc-interop](https://github.com/sipsorcery/webrtc-interop)

package/lib/common/src/transport.d.ts

@@ -4,6 +4,10 @@ import * as tls from "node:tls";
 import { type AddressInfo } from "node:net";
 import { type Address, type InterfaceAddresses } from "./network";
 export type TlsConnectionOptions = Omit<tls.ConnectionOptions, "host" | "port" | "socket">;
+export interface StreamTransportOptions {
+    /** Maximum time to wait for TCP/TLS connection establishment, in milliseconds. */
+    connectTimeoutMs?: number;
+}
 export declare class UdpTransport implements Transport {
     private socketType;
     private options;
@@ -21,6 +25,8 @@ export declare class UdpTransport implements Transport {
     private init;
     send: (data: Buffer, addr?: Address) => Promise<void>;
     get address(): net.AddressInfo;
+    /** IP family of the bound socket: 4 for udp4, 6 for udp6. */
+    get addressFamily(): IpAddressFamily;
     get host(): string;
     get port(): number;
     close: () => Promise<void>;
@@ -29,9 +35,10 @@ export declare class TcpTransport implements Transport {
     readonly type: "tcp";
     private readonly stream;
     private constructor();
-    static init(addr: Address): Promise<TcpTransport>;
+    static init(addr: Address, options?: StreamTransportOptions): Promise<TcpTransport>;
     private init;
     get address(): net.AddressInfo;
+    get remoteAddress(): readonly [string, number] | undefined;
     get closed(): boolean;
     get onData(): (data: Buffer, addr: Address) => void;
     set onData(handler: (data: Buffer, addr: Address) => void);
@@ -42,15 +49,17 @@ export declare class TlsTransport implements Transport {
     readonly type: "tls";
     private readonly stream;
     private constructor();
-    static init(addr: Address, options?: TlsConnectionOptions): Promise<TlsTransport>;
+    static init(addr: Address, options?: TlsConnectionOptions, streamOptions?: StreamTransportOptions): Promise<TlsTransport>;
     private init;
     get address(): net.AddressInfo;
+    get remoteAddress(): readonly [string, number] | undefined;
     get closed(): boolean;
     get onData(): (data: Buffer, addr: Address) => void;
     set onData(handler: (data: Buffer, addr: Address) => void);
     send: (data: Buffer, addr?: Address) => Promise<void>;
     close: () => Promise<void>;
 }
+export type IpAddressFamily = 4 | 6;
 export interface Transport {
     type: string;
     address: AddressInfo;
@@ -58,4 +67,15 @@ export interface Transport {
     onData: (data: Buffer, addr: Address) => void;
     send: (data: Buffer, addr?: Address) => Promise<void>;
     close: () => Promise<void>;
+    /**
+     * IP family of a datagram socket. A datagram transport can only reach
+     * addresses of this family. Built-in UDP transports always set it; a custom
+     * transport that leaves it unset gets no family preference.
+     */
+    addressFamily?: IpAddressFamily;
+    /**
+     * The peer a connected (stream) transport is talking to. Responses arrive
+     * from this address. Built-in TCP/TLS transports set it once connected.
+     */
+    remoteAddress?: Address;
 }

package/lib/common/src/transport.js

@@ -41,6 +41,7 @@ const node_net_1 = require("node:net");
 const log_1 = require("./log");
 const network_1 = require("./network");
 const log = (0, log_1.debug)("werift-ice:packages/ice/src/transport.ts");
+const DEFAULT_CONNECT_TIMEOUT_MS = 8000;
 class UdpTransport {
     constructor(socketType, options = {}) {
         Object.defineProperty(this, "socketType", {
@@ -163,6 +164,10 @@ class UdpTransport {
     get address() {
         return this.socket.address();
     }
+    /** IP family of the bound socket: 4 for udp4, 6 for udp6. */
+    get addressFamily() {
+        return this.socketType === "udp6" ? 6 : 4;
+    }
     get host() {
         return this.socket.address().address;
     }
@@ -172,7 +177,7 @@ class UdpTransport {
 }
 exports.UdpTransport = UdpTransport;
 class TcpTransport {
-    constructor(addr) {
+    constructor(addr, options = {}) {
         Object.defineProperty(this, "type", {
             enumerable: true,
             configurable: true,
@@ -201,12 +206,18 @@ class TcpTransport {
                 await this.stream.close();
             }
         });
-        this.stream = new StreamTransport("tcp", () => (0, node_net_1.connect)({ port: addr[1], host: addr[0] }));
+        this.stream = new StreamTransport("tcp", () => (0, node_net_1.connect)({ port: addr[1], host: addr[0] }), undefined, options.connectTimeoutMs);
     }
-    static async init(addr) {
-        const transport = new TcpTransport(addr);
-        await transport.init();
-        return transport;
+    static async init(addr, options = {}) {
+        const transport = new TcpTransport(addr, options);
+        try {
+            await transport.init();
+            return transport;
+        }
+        catch (error) {
+            await transport.close();
+            throw error;
+        }
     }
     async init() {
         await this.stream.waitForConnect();
@@ -214,6 +225,9 @@ class TcpTransport {
     get address() {
         return this.stream.address;
     }
+    get remoteAddress() {
+        return this.stream.remoteAddress;
+    }
     get closed() {
         return this.stream.closed;
     }
@@ -226,7 +240,7 @@ class TcpTransport {
 }
 exports.TcpTransport = TcpTransport;
 class TlsTransport {
-    constructor(addr, options = {}) {
+    constructor(addr, options = {}, streamOptions = {}) {
         Object.defineProperty(this, "type", {
             enumerable: true,
             configurable: true,
@@ -259,12 +273,18 @@ class TlsTransport {
             ...options,
             host: addr[0],
             port: addr[1],
-        }));
+        }), undefined, streamOptions.connectTimeoutMs);
     }
-    static async init(addr, options = {}) {
-        const transport = new TlsTransport(addr, options);
-        await transport.init();
-        return transport;
+    static async init(addr, options = {}, streamOptions = {}) {
+        const transport = new TlsTransport(addr, options, streamOptions);
+        try {
+            await transport.init();
+            return transport;
+        }
+        catch (error) {
+            await transport.close();
+            throw error;
+        }
     }
     async init() {
         await this.stream.waitForConnect();
@@ -272,6 +292,9 @@ class TlsTransport {
     get address() {
         return this.stream.address;
     }
+    get remoteAddress() {
+        return this.stream.remoteAddress;
+    }
     get closed() {
         return this.stream.closed;
     }
@@ -286,7 +309,7 @@ exports.TlsTransport = TlsTransport;
 class StreamTransport {
     constructor(type, createClient, connectEvent = type === "tls"
         ? "secureConnect"
-        : "connect") {
+        : "connect", connectTimeoutMs = DEFAULT_CONNECT_TIMEOUT_MS) {
         Object.defineProperty(this, "createClient", {
             enumerable: true,
             configurable: true,
@@ -299,6 +322,12 @@ class StreamTransport {
             writable: true,
             value: connectEvent
         });
+        Object.defineProperty(this, "connectTimeoutMs", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: connectTimeoutMs
+        });
         Object.defineProperty(this, "type", {
             enumerable: true,
             configurable: true,
@@ -329,6 +358,12 @@ class StreamTransport {
             writable: true,
             value: false
         });
+        Object.defineProperty(this, "rejectConnecting", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "send", {
             enumerable: true,
             configurable: true,
@@ -353,6 +388,7 @@ class StreamTransport {
             writable: true,
             value: async () => {
                 this.closed = true;
+                this.rejectConnecting?.(new Error(`${this.type} transport closed`));
                 this.client?.destroy();
             }
         });
@@ -368,27 +404,37 @@ class StreamTransport {
         }
         const client = this.createClient();
         this.client = client;
-        this.connecting = new Promise((r, f) => {
-            const onConnect = () => {
+        this.connecting = new Promise((resolve, reject) => {
+            let settled = false;
+            const settle = (error) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                client.off(this.connectEvent, onConnect);
                 client.off("error", onConnectError);
-                r();
+                this.rejectConnecting = undefined;
+                error ? reject(error) : resolve();
+            };
+            const onConnect = () => {
+                settle();
             };
             const onConnectError = (error) => {
-                client.off(this.connectEvent, onConnect);
-                f(error);
+                this.closed = true;
+                settle(error);
+                client.destroy();
             };
+            const timer = setTimeout(() => {
+                this.closed = true;
+                settle(new Error(`${this.type} connect timed out after ${this.connectTimeoutMs}ms`));
+                client.destroy();
+            }, this.connectTimeoutMs);
+            this.rejectConnecting = (error) => settle(error);
             client.once(this.connectEvent, onConnect);
             client.once("error", onConnectError);
         });
         client.on("data", (data) => {
-            const addr = [
-                this.client.remoteAddress,
-                this.client.remotePort,
-            ];
-            this.onData(data, addr);
-        });
-        client.on("end", () => {
-            this.connect();
+            this.onData(data, this.remoteAddress);
         });
         client.on("error", (error) => {
             log(`${this.type} transport error`, error);
@@ -400,5 +446,17 @@ class StreamTransport {
     get address() {
         return {};
     }
+    /** The peer the stream is connected to, once connected. */
+    get remoteAddress() {
+        const { remoteAddress, remotePort } = this.client;
+        if (!remoteAddress || !remotePort) {
+            return undefined;
+        }
+        return [stripZoneId(remoteAddress), remotePort];
+    }
+}
+/** Strip an IPv6 zone identifier, e.g. fe80::1%eth0 -> fe80::1. */
+function stripZoneId(address) {
+    return address.split("%")[0];
 }
 //# sourceMappingURL=transport.js.map

package/lib/common/src/transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../../common/src/transport.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,iCAKe;AAEf,8CAAgC;AAChC,8CAAgC;AAEhC,uCAA+E;AAC/E,+BAA8B;AAC9B,uCAMmB;AAEnB,MAAM,GAAG,GAAG,IAAA,WAAK,EAAC,0CAA0C,CAAC,CAAC;AAW9D,MAAa,YAAY;IAOvB,YACU,UAAsB,EACtB,UAIJ,EAAE;QALN;;;;mBAAQ,UAAU;WAAY;QAC9B;;;;mBAAQ,OAAO;WAIT;QAZC;;;;mBAAO,KAAK;WAAC;QACb;;;;;WAAe;QACxB;;;;;WAAsD;QACtD;;;;mBAAgD,GAAG,EAAE,GAAE,CAAC;WAAC;QACzD;;;;mBAAkB,KAAK;WAAC;QA0DxB;;;;mBAAO,KAAK,EAAE,IAAY,EAAE,IAAc,EAAE,EAAE;gBAC5C,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC/B,+EAA+E;oBAC/E,OAAO,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;wBAChC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAK,CAAC,CAAC,CAAC,EAAE,IAAK,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE;4BACnD,IAAI,KAAK,EAAE,CAAC;gCACV,GAAG,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;gCAC9B,CAAC,CAAC,KAAK,CAAC,CAAC;4BACX,CAAC;iCAAM,CAAC;gCACN,CAAC,EAAE,CAAC;4BACN,CAAC;wBACH,CAAC,CAAC,CAAC;oBACL,CAAC,CAAC,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACN,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,OAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,IAAK,CAAC,CAAC;oBACzD,0EAA0E;oBAC1E,4DAA4D;oBAC5D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC3C,CAAC;YACH,CAAC;WAAC;QAcF;;;;mBAAQ,GAAG,EAAE,CACX,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE;gBACtB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;gBACnB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBAC7B,IAAI,CAAC;oBACH,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBACtB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,CAAC,EAAE,CAAC;gBACN,CAAC;YACH,CAAC,CAAC;WAAC;QA1FH,IAAI,CAAC,MAAM,GAAG,IAAA,oBAAY,EAAC,UAAU,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;YACvC,IAAI,IAAA,gCAAsB,EAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9C,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,4CAA4C;YACxF,CAAC;YACD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAClB,IAAI,CAAC;gBACH,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAC/C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,IAAI,CACf,IAAgB,EAChB,UAII,EAAE;QAEN,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAClD,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,KAAK,CAAC,IAAI;QAChB,MAAM,OAAO,GAAG,IAAA,0BAAgB,EAC9B,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAChC,CAAC;QACF,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACtB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACzD,CAAC;aAAM,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,MAAM,IAAA,kBAAQ,EACzB,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EACzB,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EACzB,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAChC,CAAC;YACF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QAChC,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IAuBD,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;IAC/B,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC;IACvC,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC;IACpC,CAAC;CAYF;AA1GD,oCA0GC;AAED,MAAa,YAAY;IAIvB,YAAoB,IAAa;QAHxB;;;;mBAAO,KAAc;WAAC;QACd;;;;;WAAwB;QAkCzC;;;;mBAAO,KAAK,EAAE,IAAY,EAAE,IAAc,EAAE,EAAE;gBAC5C,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACrC,CAAC;WAAC;QAEF;;;;mBAAQ,KAAK,IAAI,EAAE;gBACjB,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAC5B,CAAC;WAAC;QArCA,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,CAC5C,IAAA,kBAAO,EAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAC1C,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAa;QAC7B,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,KAAK,CAAC,IAAI;QAChB,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;IACrC,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IAC7B,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED,IAAI,MAAM,CAAC,OAA8C;QACvD,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC;IAC/B,CAAC;CASF;AA3CD,oCA2CC;AAED,MAAa,YAAY;IAIvB,YAAoB,IAAa,EAAE,UAAgC,EAAE;QAH5D;;;;mBAAO,KAAc;WAAC;QACd;;;;;WAAwB;QAsCzC;;;;mBAAO,KAAK,EAAE,IAAY,EAAE,IAAc,EAAE,EAAE;gBAC5C,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACrC,CAAC;WAAC;QAEF;;;;mBAAQ,KAAK,IAAI,EAAE;gBACjB,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAC5B,CAAC;WAAC;QAzCA,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,CAC5C,GAAG,CAAC,OAAO,CAAC;YACV,GAAG,OAAO;YACV,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;YACb,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;SACd,CAAC,CACH,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAa,EAAE,UAAgC,EAAE;QACjE,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAClD,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,KAAK,CAAC,IAAI;QAChB,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;IACrC,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IAC7B,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED,IAAI,MAAM,CAAC,OAA8C;QACvD,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC;IAC/B,CAAC;CASF;AA/CD,oCA+CC;AAED,MAAM,eAAe;IAOnB,YACE,IAAyB,EACjB,YAAgC,EAChC,eAAmC,IAAI,KAAK,KAAK;QACvD,CAAC,CAAC,eAAe;QACjB,CAAC,CAAC,SAAS;QAHb;;;;mBAAQ,YAAY;WAAoB;QACxC;;;;mBAAQ,YAAY;WAEP;QAXN;;;;;WAA0B;QAC3B;;;;;WAA2B;QAC3B;;;;;WAAsB;QAC9B;;;;mBAAgD,GAAG,EAAE,GAAE,CAAC;WAAC;QACzD;;;;mBAAS,KAAK;WAAC;QA2Df;;;;mBAAO,KAAK,EAAE,IAAY,EAAE,IAAc,EAAE,EAAE;gBAC5C,KAAK,IAAI,CAAC;gBACV,MAAM,IAAI,CAAC,UAAU,CAAC;gBACtB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;oBAC1C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE;wBAC9B,IAAI,GAAG,EAAE,CAAC;4BACR,MAAM,CAAC,GAAG,CAAC,CAAC;4BACZ,OAAO;wBACT,CAAC;wBACD,OAAO,EAAE,CAAC;oBACZ,CAAC,CAAC,CAAC;gBACL,CAAC,CAAC,CAAC;YACL,CAAC;WAAC;QAEF;;;;mBAAQ,KAAK,IAAI,EAAE;gBACjB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;gBACnB,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YACzB,CAAC;WAAC;QAnEA,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAEO,OAAO;QACb,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACxB,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACrC,MAAM,SAAS,GAAG,GAAG,EAAE;gBACrB,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;gBACpC,CAAC,EAAE,CAAC;YACN,CAAC,CAAC;YACF,MAAM,cAAc,GAAG,CAAC,KAAY,EAAE,EAAE;gBACtC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;gBACzC,CAAC,CAAC,KAAK,CAAC,CAAC;YACX,CAAC,CAAC;YACF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;YAC1C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,MAAM,IAAI,GAAG;gBACX,IAAI,CAAC,MAAM,CAAC,aAAc;gBAC1B,IAAI,CAAC,MAAM,CAAC,UAAW;aACb,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;YACpB,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC3B,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,kBAAkB,EAAE,KAAK,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,MAAM,IAAI,CAAC,UAAU,CAAC;IACxB,CAAC;IAED,IAAI,OAAO;QACT,OAAO,EAAiB,CAAC;IAC3B,CAAC;CAoBF","sourcesContent":["import {\n  type RemoteInfo,\n  type Socket,\n  type SocketType,\n  createSocket,\n} from \"dgram\";\n\nimport * as net from \"node:net\";\nimport * as tls from \"node:tls\";\n\nimport { type AddressInfo, type Socket as TcpSocket, connect } from \"node:net\";\nimport { debug } from \"./log\";\nimport {\n  type Address,\n  type InterfaceAddresses,\n  findPort,\n  interfaceAddress,\n  normalizeFamilyNodeV18,\n} from \"./network\";\n\nconst log = debug(\"werift-ice:packages/ice/src/transport.ts\");\n\ntype StreamTransportType = \"tcp\" | \"tls\";\ntype StreamSocket = TcpSocket | tls.TLSSocket;\ntype StreamConnectEvent = \"connect\" | \"secureConnect\";\n\nexport type TlsConnectionOptions = Omit<\n  tls.ConnectionOptions,\n  \"host\" | \"port\" | \"socket\"\n>;\n\nexport class UdpTransport implements Transport {\n  readonly type = \"udp\";\n  readonly socket: Socket;\n  rinfo?: Partial<Pick<RemoteInfo, \"address\" | \"port\">>;\n  onData: (data: Buffer, addr: Address) => void = () => {};\n  closed: boolean = false;\n\n  private constructor(\n    private socketType: SocketType,\n    private options: {\n      portRange?: [number, number];\n      interfaceAddresses?: InterfaceAddresses;\n      port?: number;\n    } = {},\n  ) {\n    this.socket = createSocket(socketType);\n    this.socket.on(\"message\", (data, info) => {\n      if (normalizeFamilyNodeV18(info.family) === 6) {\n        [info.address] = info.address.split(\"%\"); // example fe80::1d3a:8751:4ffd:eb80%wlp82s0\n      }\n      this.rinfo = info;\n      try {\n        this.onData(data, [info.address, info.port]);\n      } catch (error) {\n        log(\"onData error\", error);\n      }\n    });\n  }\n\n  static async init(\n    type: SocketType,\n    options: {\n      portRange?: [number, number];\n      port?: number;\n      interfaceAddresses?: InterfaceAddresses;\n    } = {},\n  ) {\n    const transport = new UdpTransport(type, options);\n    await transport.init();\n    return transport;\n  }\n\n  private async init() {\n    const address = interfaceAddress(\n      this.socketType,\n      this.options.interfaceAddresses,\n    );\n    if (this.options.port) {\n      this.socket.bind({ port: this.options.port, address });\n    } else if (this.options.portRange) {\n      const port = await findPort(\n        this.options.portRange[0],\n        this.options.portRange[1],\n        this.socketType,\n        this.options.interfaceAddresses,\n      );\n      this.socket.bind({ port, address });\n    } else {\n      this.socket.bind({ address });\n    }\n    await new Promise((r) => this.socket.once(\"listening\", r));\n  }\n\n  send = async (data: Buffer, addr?: Address) => {\n    if (addr && !net.isIP(addr[0])) {\n      // if address is not resolved, need to use send callback to handle dns failure.\n      return new Promise<void>((r, f) => {\n        this.socket.send(data, addr![1], addr![0], (error) => {\n          if (error) {\n            log(\"send error\", addr, data);\n            f(error);\n          } else {\n            r();\n          }\n        });\n      });\n    } else {\n      addr = addr ?? [this.rinfo?.address!, this.rinfo?.port!];\n      // a preestablished remote address does not need a callback to verify dns.\n      // this is faster because event loop is not used per packet.\n      this.socket.send(data, addr[1], addr[0]);\n    }\n  };\n\n  get address() {\n    return this.socket.address();\n  }\n\n  get host() {\n    return this.socket.address().address;\n  }\n\n  get port() {\n    return this.socket.address().port;\n  }\n\n  close = () =>\n    new Promise<void>((r) => {\n      this.closed = true;\n      this.socket.once(\"close\", r);\n      try {\n        this.socket.close();\n      } catch (error) {\n        r();\n      }\n    });\n}\n\nexport class TcpTransport implements Transport {\n  readonly type = \"tcp\" as const;\n  private readonly stream: StreamTransport;\n\n  private constructor(addr: Address) {\n    this.stream = new StreamTransport(\"tcp\", () =>\n      connect({ port: addr[1], host: addr[0] }),\n    );\n  }\n\n  static async init(addr: Address) {\n    const transport = new TcpTransport(addr);\n    await transport.init();\n    return transport;\n  }\n\n  private async init() {\n    await this.stream.waitForConnect();\n  }\n\n  get address() {\n    return this.stream.address;\n  }\n\n  get closed() {\n    return this.stream.closed;\n  }\n\n  get onData() {\n    return this.stream.onData;\n  }\n\n  set onData(handler: (data: Buffer, addr: Address) => void) {\n    this.stream.onData = handler;\n  }\n\n  send = async (data: Buffer, addr?: Address) => {\n    await this.stream.send(data, addr);\n  };\n\n  close = async () => {\n    await this.stream.close();\n  };\n}\n\nexport class TlsTransport implements Transport {\n  readonly type = \"tls\" as const;\n  private readonly stream: StreamTransport;\n\n  private constructor(addr: Address, options: TlsConnectionOptions = {}) {\n    this.stream = new StreamTransport(\"tls\", () =>\n      tls.connect({\n        ...options,\n        host: addr[0],\n        port: addr[1],\n      }),\n    );\n  }\n\n  static async init(addr: Address, options: TlsConnectionOptions = {}) {\n    const transport = new TlsTransport(addr, options);\n    await transport.init();\n    return transport;\n  }\n\n  private async init() {\n    await this.stream.waitForConnect();\n  }\n\n  get address() {\n    return this.stream.address;\n  }\n\n  get closed() {\n    return this.stream.closed;\n  }\n\n  get onData() {\n    return this.stream.onData;\n  }\n\n  set onData(handler: (data: Buffer, addr: Address) => void) {\n    this.stream.onData = handler;\n  }\n\n  send = async (data: Buffer, addr?: Address) => {\n    await this.stream.send(data, addr);\n  };\n\n  close = async () => {\n    await this.stream.close();\n  };\n}\n\nclass StreamTransport implements Transport {\n  readonly type: StreamTransportType;\n  private connecting!: Promise<void>;\n  private client!: StreamSocket;\n  onData: (data: Buffer, addr: Address) => void = () => {};\n  closed = false;\n\n  constructor(\n    type: StreamTransportType,\n    private createClient: () => StreamSocket,\n    private connectEvent: StreamConnectEvent = type === \"tls\"\n      ? \"secureConnect\"\n      : \"connect\",\n  ) {\n    this.type = type;\n    this.connect();\n  }\n\n  private connect() {\n    if (this.closed) {\n      return;\n    }\n\n    if (this.client) {\n      this.client.destroy();\n    }\n    const client = this.createClient();\n    this.client = client;\n    this.connecting = new Promise((r, f) => {\n      const onConnect = () => {\n        client.off(\"error\", onConnectError);\n        r();\n      };\n      const onConnectError = (error: Error) => {\n        client.off(this.connectEvent, onConnect);\n        f(error);\n      };\n      client.once(this.connectEvent, onConnect);\n      client.once(\"error\", onConnectError);\n    });\n\n    client.on(\"data\", (data) => {\n      const addr = [\n        this.client.remoteAddress!,\n        this.client.remotePort!,\n      ] as Address;\n      this.onData(data, addr);\n    });\n    client.on(\"end\", () => {\n      this.connect();\n    });\n    client.on(\"error\", (error) => {\n      log(`${this.type} transport error`, error);\n    });\n  }\n\n  async waitForConnect() {\n    await this.connecting;\n  }\n\n  get address() {\n    return {} as AddressInfo;\n  }\n\n  send = async (data: Buffer, addr?: Address) => {\n    void addr;\n    await this.connecting;\n    await new Promise<void>((resolve, reject) => {\n      this.client.write(data, (err) => {\n        if (err) {\n          reject(err);\n          return;\n        }\n        resolve();\n      });\n    });\n  };\n\n  close = async () => {\n    this.closed = true;\n    this.client?.destroy();\n  };\n}\n\nexport interface Transport {\n  type: string;\n  address: AddressInfo;\n  closed: boolean;\n  onData: (data: Buffer, addr: Address) => void;\n  send: (data: Buffer, addr?: Address) => Promise<void>;\n  close: () => Promise<void>;\n}\n"]}
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../../common/src/transport.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  type RemoteInfo,\n  type Socket,\n  type SocketType,\n  createSocket,\n} from \"dgram\";\n\nimport * as net from \"node:net\";\nimport * as tls from \"node:tls\";\n\nimport { type AddressInfo, type Socket as TcpSocket, connect } from \"node:net\";\nimport { debug } from \"./log\";\nimport {\n  type Address,\n  type InterfaceAddresses,\n  findPort,\n  interfaceAddress,\n  normalizeFamilyNodeV18,\n} from \"./network\";\n\nconst log = debug(\"werift-ice:packages/ice/src/transport.ts\");\n\ntype StreamTransportType = \"tcp\" | \"tls\";\ntype StreamSocket = TcpSocket | tls.TLSSocket;\ntype StreamConnectEvent = \"connect\" | \"secureConnect\";\n\nexport type TlsConnectionOptions = Omit<\n  tls.ConnectionOptions,\n  \"host\" | \"port\" | \"socket\"\n>;\n\nexport interface StreamTransportOptions {\n  /** Maximum time to wait for TCP/TLS connection establishment, in milliseconds. */\n  connectTimeoutMs?: number;\n}\n\nconst DEFAULT_CONNECT_TIMEOUT_MS = 8000;\n\nexport class UdpTransport implements Transport {\n  readonly type = \"udp\";\n  readonly socket: Socket;\n  rinfo?: Partial<Pick<RemoteInfo, \"address\" | \"port\">>;\n  onData: (data: Buffer, addr: Address) => void = () => {};\n  closed: boolean = false;\n\n  private constructor(\n    private socketType: SocketType,\n    private options: {\n      portRange?: [number, number];\n      interfaceAddresses?: InterfaceAddresses;\n      port?: number;\n    } = {},\n  ) {\n    this.socket = createSocket(socketType);\n    this.socket.on(\"message\", (data, info) => {\n      if (normalizeFamilyNodeV18(info.family) === 6) {\n        [info.address] = info.address.split(\"%\"); // example fe80::1d3a:8751:4ffd:eb80%wlp82s0\n      }\n      this.rinfo = info;\n      try {\n        this.onData(data, [info.address, info.port]);\n      } catch (error) {\n        log(\"onData error\", error);\n      }\n    });\n  }\n\n  static async init(\n    type: SocketType,\n    options: {\n      portRange?: [number, number];\n      port?: number;\n      interfaceAddresses?: InterfaceAddresses;\n    } = {},\n  ) {\n    const transport = new UdpTransport(type, options);\n    await transport.init();\n    return transport;\n  }\n\n  private async init() {\n    const address = interfaceAddress(\n      this.socketType,\n      this.options.interfaceAddresses,\n    );\n    if (this.options.port) {\n      this.socket.bind({ port: this.options.port, address });\n    } else if (this.options.portRange) {\n      const port = await findPort(\n        this.options.portRange[0],\n        this.options.portRange[1],\n        this.socketType,\n        this.options.interfaceAddresses,\n      );\n      this.socket.bind({ port, address });\n    } else {\n      this.socket.bind({ address });\n    }\n    await new Promise((r) => this.socket.once(\"listening\", r));\n  }\n\n  send = async (data: Buffer, addr?: Address) => {\n    if (addr && !net.isIP(addr[0])) {\n      // if address is not resolved, need to use send callback to handle dns failure.\n      return new Promise<void>((r, f) => {\n        this.socket.send(data, addr![1], addr![0], (error) => {\n          if (error) {\n            log(\"send error\", addr, data);\n            f(error);\n          } else {\n            r();\n          }\n        });\n      });\n    } else {\n      addr = addr ?? [this.rinfo?.address!, this.rinfo?.port!];\n      // a preestablished remote address does not need a callback to verify dns.\n      // this is faster because event loop is not used per packet.\n      this.socket.send(data, addr[1], addr[0]);\n    }\n  };\n\n  get address() {\n    return this.socket.address();\n  }\n\n  /** IP family of the bound socket: 4 for udp4, 6 for udp6. */\n  get addressFamily(): IpAddressFamily {\n    return this.socketType === \"udp6\" ? 6 : 4;\n  }\n\n  get host() {\n    return this.socket.address().address;\n  }\n\n  get port() {\n    return this.socket.address().port;\n  }\n\n  close = () =>\n    new Promise<void>((r) => {\n      this.closed = true;\n      this.socket.once(\"close\", r);\n      try {\n        this.socket.close();\n      } catch (error) {\n        r();\n      }\n    });\n}\n\nexport class TcpTransport implements Transport {\n  readonly type = \"tcp\" as const;\n  private readonly stream: StreamTransport;\n\n  private constructor(addr: Address, options: StreamTransportOptions = {}) {\n    this.stream = new StreamTransport(\n      \"tcp\",\n      () => connect({ port: addr[1], host: addr[0] }),\n      undefined,\n      options.connectTimeoutMs,\n    );\n  }\n\n  static async init(addr: Address, options: StreamTransportOptions = {}) {\n    const transport = new TcpTransport(addr, options);\n    try {\n      await transport.init();\n      return transport;\n    } catch (error) {\n      await transport.close();\n      throw error;\n    }\n  }\n\n  private async init() {\n    await this.stream.waitForConnect();\n  }\n\n  get address() {\n    return this.stream.address;\n  }\n\n  get remoteAddress() {\n    return this.stream.remoteAddress;\n  }\n\n  get closed() {\n    return this.stream.closed;\n  }\n\n  get onData() {\n    return this.stream.onData;\n  }\n\n  set onData(handler: (data: Buffer, addr: Address) => void) {\n    this.stream.onData = handler;\n  }\n\n  send = async (data: Buffer, addr?: Address) => {\n    await this.stream.send(data, addr);\n  };\n\n  close = async () => {\n    await this.stream.close();\n  };\n}\n\nexport class TlsTransport implements Transport {\n  readonly type = \"tls\" as const;\n  private readonly stream: StreamTransport;\n\n  private constructor(\n    addr: Address,\n    options: TlsConnectionOptions = {},\n    streamOptions: StreamTransportOptions = {},\n  ) {\n    this.stream = new StreamTransport(\n      \"tls\",\n      () =>\n        tls.connect({\n          ...options,\n          host: addr[0],\n          port: addr[1],\n        }),\n      undefined,\n      streamOptions.connectTimeoutMs,\n    );\n  }\n\n  static async init(\n    addr: Address,\n    options: TlsConnectionOptions = {},\n    streamOptions: StreamTransportOptions = {},\n  ) {\n    const transport = new TlsTransport(addr, options, streamOptions);\n    try {\n      await transport.init();\n      return transport;\n    } catch (error) {\n      await transport.close();\n      throw error;\n    }\n  }\n\n  private async init() {\n    await this.stream.waitForConnect();\n  }\n\n  get address() {\n    return this.stream.address;\n  }\n\n  get remoteAddress() {\n    return this.stream.remoteAddress;\n  }\n\n  get closed() {\n    return this.stream.closed;\n  }\n\n  get onData() {\n    return this.stream.onData;\n  }\n\n  set onData(handler: (data: Buffer, addr: Address) => void) {\n    this.stream.onData = handler;\n  }\n\n  send = async (data: Buffer, addr?: Address) => {\n    await this.stream.send(data, addr);\n  };\n\n  close = async () => {\n    await this.stream.close();\n  };\n}\n\nclass StreamTransport implements Transport {\n  readonly type: StreamTransportType;\n  private connecting!: Promise<void>;\n  private client!: StreamSocket;\n  onData: (data: Buffer, addr: Address) => void = () => {};\n  closed = false;\n  private rejectConnecting?: (error: Error) => void;\n\n  constructor(\n    type: StreamTransportType,\n    private createClient: () => StreamSocket,\n    private connectEvent: StreamConnectEvent = type === \"tls\"\n      ? \"secureConnect\"\n      : \"connect\",\n    private connectTimeoutMs = DEFAULT_CONNECT_TIMEOUT_MS,\n  ) {\n    this.type = type;\n    this.connect();\n  }\n\n  private connect() {\n    if (this.closed) {\n      return;\n    }\n\n    if (this.client) {\n      this.client.destroy();\n    }\n    const client = this.createClient();\n    this.client = client;\n    this.connecting = new Promise((resolve, reject) => {\n      let settled = false;\n      const settle = (error?: Error) => {\n        if (settled) return;\n        settled = true;\n        clearTimeout(timer);\n        client.off(this.connectEvent, onConnect);\n        client.off(\"error\", onConnectError);\n        this.rejectConnecting = undefined;\n        error ? reject(error) : resolve();\n      };\n      const onConnect = () => {\n        settle();\n      };\n      const onConnectError = (error: Error) => {\n        this.closed = true;\n        settle(error);\n        client.destroy();\n      };\n      const timer = setTimeout(() => {\n        this.closed = true;\n        settle(\n          new Error(\n            `${this.type} connect timed out after ${this.connectTimeoutMs}ms`,\n          ),\n        );\n        client.destroy();\n      }, this.connectTimeoutMs);\n      this.rejectConnecting = (error) => settle(error);\n      client.once(this.connectEvent, onConnect);\n      client.once(\"error\", onConnectError);\n    });\n\n    client.on(\"data\", (data) => {\n      this.onData(data, this.remoteAddress!);\n    });\n    client.on(\"error\", (error) => {\n      log(`${this.type} transport error`, error);\n    });\n  }\n\n  async waitForConnect() {\n    await this.connecting;\n  }\n\n  get address() {\n    return {} as AddressInfo;\n  }\n\n  /** The peer the stream is connected to, once connected. */\n  get remoteAddress(): Address | undefined {\n    const { remoteAddress, remotePort } = this.client;\n    if (!remoteAddress || !remotePort) {\n      return undefined;\n    }\n    return [stripZoneId(remoteAddress), remotePort];\n  }\n\n  send = async (data: Buffer, addr?: Address) => {\n    void addr;\n    await this.connecting;\n    await new Promise<void>((resolve, reject) => {\n      this.client.write(data, (err) => {\n        if (err) {\n          reject(err);\n          return;\n        }\n        resolve();\n      });\n    });\n  };\n\n  close = async () => {\n    this.closed = true;\n    this.rejectConnecting?.(new Error(`${this.type} transport closed`));\n    this.client?.destroy();\n  };\n}\n\n/** Strip an IPv6 zone identifier, e.g. fe80::1%eth0 -> fe80::1. */\nfunction stripZoneId(address: string) {\n  return address.split(\"%\")[0];\n}\n\nexport type IpAddressFamily = 4 | 6;\n\nexport interface Transport {\n  type: string;\n  address: AddressInfo;\n  closed: boolean;\n  onData: (data: Buffer, addr: Address) => void;\n  send: (data: Buffer, addr?: Address) => Promise<void>;\n  close: () => Promise<void>;\n  /**\n   * IP family of a datagram socket. A datagram transport can only reach\n   * addresses of this family. Built-in UDP transports always set it; a custom\n   * transport that leaves it unset gets no family preference.\n   */\n  addressFamily?: IpAddressFamily;\n  /**\n   * The peer a connected (stream) transport is talking to. Responses arrive\n   * from this address. Built-in TCP/TLS transports set it once connected.\n   */\n  remoteAddress?: Address;\n}\n"]}

package/lib/ice/src/exceptions.d.ts

@@ -13,3 +13,12 @@ export declare class TransactionFailed extends TransactionError {
 export declare class TransactionTimeout extends TransactionError {
     get str(): string;
 }
+/**
+ * The request target is an IP literal of a different family than the socket
+ * that would carry it, so it can never be delivered.
+ */
+export declare class AddressFamilyMismatch extends Error {
+    addr: Address;
+    socketFamily: 4 | 6;
+    constructor(addr: Address, socketFamily: 4 | 6);
+}