@agentdance/node-webrtc-ice 1.0.0

package/dist/transport.js

@@ -0,0 +1,70 @@
+import * as dgram from 'node:dgram';
+import { EventEmitter } from 'node:events';
+// ---------------------------------------------------------------------------
+// Packet type detection (RFC 7983 / RFC 5764)
+// STUN:  first byte 0x00-0x03
+// DTLS:  first byte 0x14-0x19 (ContentType: change_cipher_spec=20...23=heartbeat)
+// RTP/RTCP: first byte 0x80-0xFF (version 2 flag set)
+// ---------------------------------------------------------------------------
+export function detectPacketType(buf) {
+    if (buf.length === 0)
+        return 'unknown';
+    const b = buf[0];
+    if (b <= 0x03)
+        return 'stun';
+    if (b >= 0x14 && b <= 0x19)
+        return 'dtls';
+    if (b >= 0x80)
+        return 'rtp';
+    return 'unknown';
+}
+export class UdpTransport extends EventEmitter {
+    _socket;
+    _localPort = 0;
+    _localAddress = '0.0.0.0';
+    get localPort() {
+        return this._localPort;
+    }
+    get localAddress() {
+        return this._localAddress;
+    }
+    async bind(port = 0, address = '0.0.0.0') {
+        return new Promise((resolve, reject) => {
+            const socket = dgram.createSocket('udp4');
+            socket.on('error', (err) => {
+                this.emit('error', err);
+            });
+            socket.on('message', (buf, rinfo) => {
+                const type = detectPacketType(buf);
+                this.emit(type, buf, rinfo);
+            });
+            socket.bind(port, address, () => {
+                const addr = socket.address();
+                this._localPort = addr.port;
+                this._localAddress = addr.address;
+                this._socket = socket;
+                resolve();
+            });
+            socket.once('error', reject);
+        });
+    }
+    send(buf, port, address) {
+        return new Promise((resolve, reject) => {
+            this._socket.send(buf, port, address, (err) => {
+                if (err)
+                    reject(err);
+                else
+                    resolve();
+            });
+        });
+    }
+    close() {
+        try {
+            this._socket.close();
+        }
+        catch {
+            // already closed
+        }
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,8EAA8E;AAC9E,8CAA8C;AAC9C,8BAA8B;AAC9B,kFAAkF;AAClF,sDAAsD;AACtD,8EAA8E;AAE9E,MAAM,UAAU,gBAAgB,CAC9B,GAAW;IAEX,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACvC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;IAClB,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,MAAM,CAAC;IAC7B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,MAAM,CAAC;IAC1C,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC;IAC5B,OAAO,SAAS,CAAC;AACnB,CAAC;AAcD,MAAM,OAAO,YAAa,SAAQ,YAAY;IACpC,OAAO,CAAgB;IACvB,UAAU,GAAG,CAAC,CAAC;IACf,aAAa,GAAG,SAAS,CAAC;IAElC,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS;QACtC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YAE1C,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACzB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAC1B,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAW,EAAE,KAAuB,EAAE,EAAE;gBAC5D,MAAM,IAAI,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;gBACnC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YAC9B,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE;gBAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC;gBAC5B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC;gBAClC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;gBACtB,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,GAAW,EAAE,IAAY,EAAE,OAAe;QAC7C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBAC5C,IAAI,GAAG;oBAAE,MAAM,CAAC,GAAG,CAAC,CAAC;;oBAChB,OAAO,EAAE,CAAC;YACjB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK;QACH,IAAI,CAAC;YACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;IACH,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,77 @@
+export type CandidateType = 'host' | 'srflx' | 'relay' | 'prflx';
+export type TransportProtocol = 'udp' | 'tcp';
+export type IceRole = 'controlling' | 'controlled';
+export declare enum IceAgentState {
+    New = "new",
+    Gathering = "gathering",
+    Complete = "complete",
+    Failed = "failed",
+    Closed = "closed"
+}
+export declare enum IceConnectionState {
+    New = "new",
+    Checking = "checking",
+    Connected = "connected",
+    Completed = "completed",
+    Failed = "failed",
+    Disconnected = "disconnected",
+    Closed = "closed"
+}
+export interface IceCandidate {
+    foundation: string;
+    component: 1 | 2;
+    transport: TransportProtocol;
+    priority: number;
+    address: string;
+    port: number;
+    type: CandidateType;
+    relatedAddress?: string;
+    relatedPort?: number;
+    tcpType?: 'active' | 'passive' | 'so';
+    generation?: number;
+    ufrag?: string;
+    networkId?: number;
+}
+export interface IceParameters {
+    usernameFragment: string;
+    password: string;
+    iceLite?: boolean;
+}
+export interface CandidatePair {
+    id: string;
+    local: IceCandidate;
+    remote: IceCandidate;
+    state: CandidatePairState;
+    priority: bigint;
+    nominated: boolean;
+    valid: boolean;
+    nominateOnSuccess: boolean;
+    lastBindingRequestReceived?: number;
+    lastBindingResponseReceived?: number;
+    retransmitCount: number;
+    retransmitTimer?: NodeJS.Timeout;
+}
+export declare enum CandidatePairState {
+    Waiting = "waiting",
+    InProgress = "in-progress",
+    Succeeded = "succeeded",
+    Failed = "failed",
+    Frozen = "frozen"
+}
+export interface IceAgentOptions {
+    ufrag?: string;
+    password?: string;
+    role?: IceRole;
+    tiebreaker?: bigint;
+    stunServers?: Array<{
+        host: string;
+        port: number;
+    }>;
+    lite?: boolean;
+    portRange?: {
+        min: number;
+        max: number;
+    };
+    nomination?: 'regular' | 'aggressive';
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AACjE,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,KAAK,CAAC;AAC9C,MAAM,MAAM,OAAO,GAAG,aAAa,GAAG,YAAY,CAAC;AAEnD,oBAAY,aAAa;IACvB,GAAG,QAAQ;IACX,SAAS,cAAc;IACvB,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAED,oBAAY,kBAAkB;IAC5B,GAAG,QAAQ;IACX,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,YAAY,iBAAiB;IAC7B,MAAM,WAAW;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC;IACjB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,aAAa,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,iBAAiB,EAAE,OAAO,CAAC;IAC3B,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;CAClC;AAED,oBAAY,kBAAkB;IAC5B,OAAO,YAAY;IACnB,UAAU,gBAAgB;IAC1B,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,UAAU,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;CACvC"}

package/dist/types.js

@@ -0,0 +1,27 @@
+export var IceAgentState;
+(function (IceAgentState) {
+    IceAgentState["New"] = "new";
+    IceAgentState["Gathering"] = "gathering";
+    IceAgentState["Complete"] = "complete";
+    IceAgentState["Failed"] = "failed";
+    IceAgentState["Closed"] = "closed";
+})(IceAgentState || (IceAgentState = {}));
+export var IceConnectionState;
+(function (IceConnectionState) {
+    IceConnectionState["New"] = "new";
+    IceConnectionState["Checking"] = "checking";
+    IceConnectionState["Connected"] = "connected";
+    IceConnectionState["Completed"] = "completed";
+    IceConnectionState["Failed"] = "failed";
+    IceConnectionState["Disconnected"] = "disconnected";
+    IceConnectionState["Closed"] = "closed";
+})(IceConnectionState || (IceConnectionState = {}));
+export var CandidatePairState;
+(function (CandidatePairState) {
+    CandidatePairState["Waiting"] = "waiting";
+    CandidatePairState["InProgress"] = "in-progress";
+    CandidatePairState["Succeeded"] = "succeeded";
+    CandidatePairState["Failed"] = "failed";
+    CandidatePairState["Frozen"] = "frozen";
+})(CandidatePairState || (CandidatePairState = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAIA,MAAM,CAAN,IAAY,aAMX;AAND,WAAY,aAAa;IACvB,4BAAW,CAAA;IACX,wCAAuB,CAAA;IACvB,sCAAqB,CAAA;IACrB,kCAAiB,CAAA;IACjB,kCAAiB,CAAA;AACnB,CAAC,EANW,aAAa,KAAb,aAAa,QAMxB;AAED,MAAM,CAAN,IAAY,kBAQX;AARD,WAAY,kBAAkB;IAC5B,iCAAW,CAAA;IACX,2CAAqB,CAAA;IACrB,6CAAuB,CAAA;IACvB,6CAAuB,CAAA;IACvB,uCAAiB,CAAA;IACjB,mDAA6B,CAAA;IAC7B,uCAAiB,CAAA;AACnB,CAAC,EARW,kBAAkB,KAAlB,kBAAkB,QAQ7B;AAuCD,MAAM,CAAN,IAAY,kBAMX;AAND,WAAY,kBAAkB;IAC5B,yCAAmB,CAAA;IACnB,gDAA0B,CAAA;IAC1B,6CAAuB,CAAA;IACvB,uCAAiB,CAAA;IACjB,uCAAiB,CAAA;AACnB,CAAC,EANW,kBAAkB,KAAlB,kBAAkB,QAM7B"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@agentdance/node-webrtc-ice",
+  "version": "1.0.0",
+  "description": "RFC 8445 ICE agent — host/srflx/prflx candidates, connectivity checks, nomination. Part of the @agentdance/node-webrtc stack.",
+  "keywords": [
+    "webrtc",
+    "ice",
+    "rfc8445",
+    "stun",
+    "p2p",
+    "typescript",
+    "node"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/agent-dance/node-webrtc#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agent-dance/node-webrtc.git",
+    "directory": "packages/ice"
+  },
+  "bugs": {
+    "url": "https://github.com/agent-dance/node-webrtc/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@agentdance/node-webrtc-stun": "1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "*",
+    "vitest": "*",
+    "@types/node": "*"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}