node-datachannel 0.12.0 → 0.20.0-alpha.2

package/src/polyfill/Events.ts

@@ -0,0 +1,33 @@
+import RTCDataChannel from './RTCDataChannel';
+import RTCIceCandidate from './RTCIceCandidate';
+
+
+export class RTCPeerConnectionIceEvent extends Event implements globalThis.RTCPeerConnectionIceEvent {
+    #candidate: RTCIceCandidate;
+
+    constructor(candidate: RTCIceCandidate) {
+        super('icecandidate');
+
+        this.#candidate = candidate;
+    }
+
+    get candidate(): RTCIceCandidate {
+        return this.#candidate;
+    }
+}
+
+export class RTCDataChannelEvent extends Event implements globalThis.RTCDataChannelEvent {
+    #channel: RTCDataChannel;
+
+    constructor(type: string, eventInitDict: globalThis.RTCDataChannelEventInit) {
+        super(type);
+
+        if (type && !eventInitDict.channel) throw new TypeError('channel member is required');
+
+        this.#channel = eventInitDict?.channel as RTCDataChannel;
+    }
+
+    get channel(): RTCDataChannel {
+        return this.#channel;
+    }
+}

package/src/polyfill/Exception.ts

@@ -0,0 +1,37 @@
+/// <reference lib="dom" />
+
+export class InvalidStateError extends DOMException {
+    constructor(msg: string) {
+        super(msg, 'InvalidStateError');
+    }
+};
+
+export class TypeError extends DOMException {
+    constructor(msg: string) {
+        super(msg, 'TypeError');
+    }
+};
+
+export class OperationError extends DOMException {
+    constructor(msg: string) {
+        super(msg, 'OperationError');
+    }
+};
+
+export class NotFoundError extends DOMException {
+    constructor(msg: string) {
+        super(msg, 'NotFoundError');
+    }
+};
+
+export class InvalidAccessError extends DOMException {
+    constructor(msg: string) {
+        super(msg, 'InvalidAccessError');
+    }
+};
+
+export class SyntaxError extends DOMException {
+    constructor(msg: string) {
+        super(msg, 'SyntaxError');
+    }
+};

package/src/polyfill/RTCCertificate.ts

@@ -0,0 +1,17 @@
+export default class RTCCertificate implements globalThis.RTCCertificate {
+    #expires: number;
+    #fingerprints: globalThis.RTCDtlsFingerprint[];
+
+    constructor() {
+        this.#expires = null;
+        this.#fingerprints = [];
+    }
+
+    get expires(): number {
+        return this.#expires;
+    }
+
+    getFingerprints(): globalThis.RTCDtlsFingerprint[] {
+        return this.#fingerprints;
+    }
+}

package/{polyfill/RTCDataChannel.js → src/polyfill/RTCDataChannel.ts}

@@ -1,26 +1,29 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
 import 'node-domexception';
-import * as exceptions from './Exception.js';
-
-export default class _RTCDataChannel extends EventTarget {
-    #dataChannel;
-    #readyState;
-    #bufferedAmountLowThreshold;
-    #binaryType;
-    #maxPacketLifeTime;
-    #maxRetransmits;
-    #negotiated;
-    #ordered;
+import * as exceptions from './Exception';
+import { DataChannel } from '../lib/index';
+
+export default class RTCDataChannel extends EventTarget implements globalThis.RTCDataChannel {
+    #dataChannel: DataChannel;
+    #readyState: RTCDataChannelState;
+    #bufferedAmountLowThreshold: number;
+    #binaryType: BinaryType;
+    #maxPacketLifeTime: number | null;
+    #maxRetransmits: number | null;
+    #negotiated: boolean;
+    #ordered: boolean;
 
     #closeRequested = false;
 
-    onbufferedamountlow;
-    onclose;
-    onclosing;
-    onerror;
-    onmessage;
-    onopen;
+    // events
+    onbufferedamountlow: ((this: RTCDataChannel, ev: Event) => any) | null;
+    onclose: ((this: RTCDataChannel, ev: Event) => any) | null;
+    onclosing: ((this: RTCDataChannel, ev: Event) => any) | null;
+    onerror: ((this: RTCDataChannel, ev: Event) => any) | null;
+    onmessage: ((this: RTCDataChannel, ev: MessageEvent) => any) | null;
+    onopen: ((this: RTCDataChannel, ev: Event) => any) | null;
 
-    constructor(dataChannel, opts = {}) {
+    constructor(dataChannel: DataChannel, opts: globalThis.RTCDataChannelInit = {}) {
         super();
 
         this.#dataChannel = dataChannel;
@@ -35,25 +38,25 @@ export default class _RTCDataChannel extends EventTarget {
         // forward dataChannel events
         this.#dataChannel.onOpen(() => {
             this.#readyState = 'open';
-            this.dispatchEvent(new Event('open', { channel: this }));
+            this.dispatchEvent(new Event('open', {}));
         });
 
         this.#dataChannel.onClosed(() => {
             // Simulate closing event
             if (!this.#closeRequested) {
                 this.#readyState = 'closing';
-                this.dispatchEvent(new Event('closing', { channel: this }));
+                this.dispatchEvent(new Event('closing'));
             }
 
             setImmediate(() => {
                 this.#readyState = 'closed';
-                this.dispatchEvent(new Event('close', { channel: this }));
+                this.dispatchEvent(new Event('close'));
             });
         });
 
         this.#dataChannel.onError((msg) => {
             this.dispatchEvent(
-                new RTCErrorEvent('error', {
+                new globalThis.RTCErrorEvent('error', {
                     error: new RTCError(
                         {
                             errorDetail: 'data-channel-failure',
@@ -65,20 +68,20 @@ export default class _RTCDataChannel extends EventTarget {
         });
 
         this.#dataChannel.onBufferedAmountLow(() => {
-            this.dispatchEvent(new Event('bufferedamountlow', { channel: this }));
+            this.dispatchEvent(new Event('bufferedamountlow'));
         });
 
         this.#dataChannel.onMessage((data) => {
             if (ArrayBuffer.isView(data)) {
-                data = data.buffer;
+                data = Buffer.from(data.buffer);
             }
 
-            this.dispatchEvent(new MessageEvent('message', { data, channel: this }));
+            this.dispatchEvent(new MessageEvent('message', { data }));
         });
 
         // forward events to properties
         this.addEventListener('message', (e) => {
-            if (this.onmessage) this.onmessage(e);
+            if (this.onmessage) this.onmessage(e as MessageEvent);
         });
         this.addEventListener('bufferedamountlow', (e) => {
             if (this.onbufferedamountlow) this.onbufferedamountlow(e);
@@ -107,15 +110,15 @@ export default class _RTCDataChannel extends EventTarget {
         this.#binaryType = type;
     }
 
-    get binaryType() {
+    get binaryType(): BinaryType {
         return this.#binaryType;
     }
 
-    get bufferedAmount() {
+    get bufferedAmount(): number {
         return this.#dataChannel.bufferedAmount();
     }
 
-    get bufferedAmountLowThreshold() {
+    get bufferedAmountLowThreshold(): number {
         return this.#bufferedAmountLowThreshold;
     }
 
@@ -125,41 +128,41 @@ export default class _RTCDataChannel extends EventTarget {
         this.#dataChannel.setBufferedAmountLowThreshold(number);
     }
 
-    get id() {
+    get id(): number | null {
         return this.#dataChannel.getId();
     }
 
-    get label() {
+    get label(): string {
         return this.#dataChannel.getLabel();
     }
 
-    get maxPacketLifeTime() {
+    get maxPacketLifeTime(): number | null {
         return this.#maxPacketLifeTime;
     }
 
-    get maxRetransmits() {
+    get maxRetransmits(): number | null {
         return this.#maxRetransmits;
     }
 
-    get negotiated() {
+    get negotiated(): boolean {
         return this.#negotiated;
     }
 
-    get ordered() {
+    get ordered(): boolean {
         return this.#ordered;
     }
 
-    get protocol() {
+    get protocol(): string {
         return this.#dataChannel.getProtocol();
     }
 
-    get readyState() {
+    get readyState(): globalThis.RTCDataChannelState {
         return this.#readyState;
     }
 
-    send(data) {
+    send(data): void {
         if (this.#readyState !== 'open') {
-            throw exceptions.InvalidStateError(
+            throw new exceptions.InvalidStateError(
                 "Failed to execute 'send' on 'RTCDataChannel': RTCDataChannel.readyState is not 'open'",
             );
         }
@@ -176,7 +179,7 @@ export default class _RTCDataChannel extends EventTarget {
         }
     }
 
-    close() {
+    close(): void {
         this.#closeRequested = true;
         this.#dataChannel.close();
     }

package/src/polyfill/RTCDtlsTransport.ts

@@ -0,0 +1,47 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import RTCIceTransport from './RTCIceTransport';
+import RTCPeerConnection from './RTCPeerConnection';
+
+export default class RTCDtlsTransport extends EventTarget implements globalThis.RTCDtlsTransport {
+    #pc: RTCPeerConnection = null;
+    #iceTransport = null;
+
+    onstatechange: ((this: RTCDtlsTransport, ev: Event) => any) | null = null;
+    onerror: ((this: RTCDtlsTransport, ev: Event) => any) | null = null;
+
+    constructor(init: { pc: RTCPeerConnection, extraFunctions }) {
+        super();
+        this.#pc = init.pc;
+
+        this.#iceTransport = new RTCIceTransport({ pc: init.pc, extraFunctions: init.extraFunctions });
+
+        // forward peerConnection events
+        this.#pc.addEventListener('connectionstatechange', () => {
+            this.dispatchEvent(new Event('statechange'));
+        });
+
+        // forward events to properties
+        this.addEventListener('statechange', (e) => {
+            if (this.onstatechange) this.onstatechange(e);
+        });
+    }
+
+    get iceTransport(): RTCIceTransport {
+        return this.#iceTransport;
+    }
+
+    get state(): RTCDtlsTransportState {
+        // reduce state from new, connecting, connected, disconnected, failed, closed, unknown
+        // to RTCDtlsTRansport states new, connecting, connected, closed, failed
+        let state = this.#pc ? this.#pc.connectionState : 'new';
+        if (state === 'disconnected') {
+            state = 'closed';
+        }
+        return state;
+    }
+
+    getRemoteCertificates(): ArrayBuffer[] {
+        // TODO: implement
+        return [new ArrayBuffer(0)];
+    }
+}

package/src/polyfill/RTCError.ts

@@ -0,0 +1,71 @@
+export default class RTCError extends DOMException implements globalThis.RTCError {
+    #errorDetail: RTCErrorDetailType;
+    #receivedAlert: number | null;
+    #sctpCauseCode: number | null;
+    #sdpLineNumber: number | null;
+    #sentAlert: number | null;
+
+    constructor(init: globalThis.RTCErrorInit, message?: string) {
+        super(message, 'OperationError');
+
+        if (!init || !init.errorDetail) throw new TypeError('Cannot construct RTCError, errorDetail is required');
+        if (
+            [
+                'data-channel-failure',
+                'dtls-failure',
+                'fingerprint-failure',
+                'hardware-encoder-error',
+                'hardware-encoder-not-available',
+                'sctp-failure',
+                'sdp-syntax-error',
+            ].indexOf(init.errorDetail) === -1
+        )
+            throw new TypeError('Cannot construct RTCError, errorDetail is invalid');
+
+        this.#errorDetail = init.errorDetail;
+        this.#receivedAlert = init.receivedAlert ?? null;
+        this.#sctpCauseCode = init.sctpCauseCode ?? null;
+        this.#sdpLineNumber = init.sdpLineNumber ?? null;
+        this.#sentAlert = init.sentAlert ?? null;
+    }
+
+    get errorDetail(): globalThis.RTCErrorDetailType {
+        return this.#errorDetail;
+    }
+
+    set errorDetail(_value) {
+        throw new TypeError('Cannot set errorDetail, it is read-only');
+    }
+
+    get receivedAlert(): number | null {
+        return this.#receivedAlert;
+    }
+
+    set receivedAlert(_value) {
+        throw new TypeError('Cannot set receivedAlert, it is read-only');
+    }
+
+    get sctpCauseCode(): number | null {
+        return this.#sctpCauseCode;
+    }
+
+    set sctpCauseCode(_value) {
+        throw new TypeError('Cannot set sctpCauseCode, it is read-only');
+    }
+
+    get sdpLineNumber(): number | null {
+        return this.#sdpLineNumber;
+    }
+
+    set sdpLineNumber(_value) {
+        throw new TypeError('Cannot set sdpLineNumber, it is read-only');
+    }
+
+    get sentAlert(): number | null {
+        return this.#sentAlert;
+    }
+
+    set sentAlert(_value) {
+        throw new TypeError('Cannot set sentAlert, it is read-only');
+    }
+}

package/{polyfill/RTCIceCandidate.js → src/polyfill/RTCIceCandidate.ts}

@@ -4,23 +4,23 @@
 
 import 'node-domexception';
 
-export default class _RTCIceCandidate {
-    #address;
-    #candidate;
-    #component;
-    #foundation;
-    #port;
-    #priority;
-    #protocol;
-    #relatedAddress;
-    #relatedPort;
-    #sdpMLineIndex;
-    #sdpMid;
-    #tcpType;
-    #type;
-    #usernameFragment;
-
-    constructor({ candidate, sdpMLineIndex, sdpMid, usernameFragment }) {
+export default class RTCIceCandidate implements globalThis.RTCIceCandidate {
+    #address: string | null;
+    #candidate: string;
+    #component: globalThis.RTCIceComponent | null;
+    #foundation: string | null;
+    #port: number | null;
+    #priority: number | null;
+    #protocol: globalThis.RTCIceProtocol | null;
+    #relatedAddress: string | null;
+    #relatedPort: number | null;
+    #sdpMLineIndex: number | null;
+    #sdpMid: string | null;
+    #tcpType: globalThis.RTCIceTcpCandidateType | null;
+    #type: globalThis.RTCIceCandidateType | null;
+    #usernameFragment: string | null;
+
+    constructor({ candidate, sdpMLineIndex, sdpMid, usernameFragment }: globalThis.RTCIceCandidateInit) {
         if (sdpMLineIndex == null && sdpMid == null)
             throw new TypeError('At least one of sdpMLineIndex or sdpMid must be specified');
 
@@ -33,11 +33,11 @@ export default class _RTCIceCandidate {
             const fields = candidate.split(' ');
             this.#foundation = fields[0].replace('candidate:', ''); // remove text candidate:
             this.#component = fields[1] == '1' ? 'rtp' : 'rtcp';
-            this.#protocol = fields[2];
+            this.#protocol = fields[2] as globalThis.RTCIceProtocol;
             this.#priority = parseInt(fields[3], 10);
             this.#address = fields[4];
             this.#port = parseInt(fields[5], 10);
-            this.#type = fields[7];
+            this.#type = fields[7] as globalThis.RTCIceCandidateType;
             this.#tcpType = null;
             this.#relatedAddress = null;
             this.#relatedPort = null;
@@ -52,69 +52,69 @@ export default class _RTCIceCandidate {
                 }
 
                 if (this.#protocol === 'tcp' && field === 'tcptype') {
-                    this.#tcpType = fields[i + 1];
+                    this.#tcpType = fields[i + 1] as globalThis.RTCIceTcpCandidateType;
                 }
             }
         }
     }
 
-    get address() {
+    get address(): string | null {
         return this.#address || null;
     }
 
-    get candidate() {
+    get candidate(): string {
         return this.#candidate;
     }
 
-    get component() {
+    get component(): globalThis.RTCIceComponent | null {
         return this.#component;
     }
 
-    get foundation() {
+    get foundation(): string | null {
         return this.#foundation || null;
     }
 
-    get port() {
+    get port(): number | null {
         return this.#port || null;
     }
 
-    get priority() {
+    get priority(): number | null {
         return this.#priority || null;
     }
 
-    get protocol() {
+    get protocol(): globalThis.RTCIceProtocol | null {
         return this.#protocol || null;
     }
 
-    get relatedAddress() {
+    get relatedAddress(): string | null {
         return this.#relatedAddress;
     }
 
-    get relatedPort() {
+    get relatedPort(): number | null {
         return this.#relatedPort || null;
     }
 
-    get sdpMLineIndex() {
+    get sdpMLineIndex(): number | null {
         return this.#sdpMLineIndex;
     }
 
-    get sdpMid() {
+    get sdpMid(): string | null {
         return this.#sdpMid;
     }
 
-    get tcpType() {
+    get tcpType(): globalThis.RTCIceTcpCandidateType | null {
         return this.#tcpType;
     }
 
-    get type() {
+    get type(): globalThis.RTCIceCandidateType | null {
         return this.#type || null;
     }
 
-    get usernameFragment() {
+    get usernameFragment(): string | null {
         return this.#usernameFragment;
     }
 
-    toJSON() {
+    toJSON(): globalThis.RTCIceCandidateInit {
         return {
             candidate: this.#candidate,
             sdpMLineIndex: this.#sdpMLineIndex,

package/{polyfill/RTCIceTransport.js → src/polyfill/RTCIceTransport.ts}

@@ -1,17 +1,19 @@
-import RTCIceCandidate from './RTCIceCandidate.js';
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import RTCIceCandidate from './RTCIceCandidate';
+import RTCPeerConnection from './RTCPeerConnection';
 
-export default class _RTCIceTransport extends EventTarget {
-    #pc = null;
+export default class RTCIceTransport extends EventTarget implements globalThis.RTCIceTransport {
+    #pc: RTCPeerConnection = null;
     #extraFunctions = null;
 
-    ongatheringstatechange = null;
-    onselectedcandidatepairchange = null;
-    onstatechange = null;
+    ongatheringstatechange: ((this: RTCIceTransport, ev: Event) => any) | null = null;
+    onselectedcandidatepairchange: ((this: RTCIceTransport, ev: Event) => any) | null = null;
+    onstatechange: ((this: RTCIceTransport, ev: Event) => any) | null = null;
 
-    constructor({ pc, extraFunctions }) {
+    constructor(init: { pc: RTCPeerConnection, extraFunctions }) {
         super();
-        this.#pc = pc;
-        this.#extraFunctions = extraFunctions;
+        this.#pc = init.pc;
+        this.#extraFunctions = init.extraFunctions;
 
         // forward peerConnection events
         this.#pc.addEventListener('icegatheringstatechange', () => {
@@ -30,42 +32,42 @@ export default class _RTCIceTransport extends EventTarget {
         });
     }
 
-    get component() {
-        let cp = this.getSelectedCandidatePair();
+    get component(): globalThis.RTCIceComponent {
+        const cp = this.getSelectedCandidatePair();
         if (!cp) return null;
         return cp.local.component;
     }
 
-    get gatheringState() {
+    get gatheringState(): globalThis.RTCIceGatheringState {
         return this.#pc ? this.#pc.iceGatheringState : 'new';
     }
 
-    get role() {
+    get role(): string {
         return this.#pc.localDescription.type == 'offer' ? 'controlling' : 'controlled';
     }
 
-    get state() {
+    get state(): globalThis.RTCIceTransportState {
         return this.#pc ? this.#pc.iceConnectionState : 'new';
     }
 
-    getLocalCandidates() {
+    getLocalCandidates(): RTCIceCandidate[] {
         return this.#pc ? this.#extraFunctions.localCandidates() : [];
     }
 
-    getLocalParameters() {
+    getLocalParameters(): any {
         /** */
     }
 
-    getRemoteCandidates() {
+    getRemoteCandidates(): RTCIceCandidate[] {
         return this.#pc ? this.#extraFunctions.remoteCandidates() : [];
     }
 
-    getRemoteParameters() {
+    getRemoteParameters(): any {
         /** */
     }
 
-    getSelectedCandidatePair() {
-        let cp = this.#extraFunctions.selectedCandidatePair();
+    getSelectedCandidatePair(): globalThis.RTCIceCandidatePair | null {
+        const cp = this.#extraFunctions.selectedCandidatePair();
         if (!cp) return null;
         return {
             local: new RTCIceCandidate({